Giter Site home page Giter Site logo

yurakruhlyk / react-native-tapjoy Goto Github PK

View Code? Open in Web Editor NEW

This project forked from reime005/react-native-tapjoy

0.0 1.0 0.0 1.3 MB

This module provides react-native bindings for the Tapjoy SDK.

License: MIT License

Java 44.38% JavaScript 24.19% Objective-C 28.42% Ruby 3.02%

react-native-tapjoy's Introduction

 

React Native Tapjoy

 

 

This module provides react-native bindings for the Tapjoy SDK.

 

npm GitHub Github Actions Status semantic-release

About Tapjoy

Tapjoy is a monetization and distribution services provider for mobile applications. Tapjoy’s goal is to maximize the value of every user for freemium mobile app publishers. Its Marketing Automation and Monetization Platform for mobile apps uses market leading data science, user segmentation and predictive analytics to drive deeper engagement and optimize revenue from every user.

About React Native

React Native lets you build mobile apps using only JavaScript. It uses the same design as React, letting you compose a rich mobile UI from declarative components. You don't build a “mobile web app”, an “HTML5 app”, or a “hybrid app”. You build a real mobile app that's indistinguishable from an app built using Objective-C or Java.

Install

Tested with react native version 0.60.0

npm install react-native-tapjoy --save

or:

yarn add react-native-tapjoy

Automatic Installation (react native version < 0.60.0)

react-native link
Manual Installation (react native version < 0.60.0)

iOS

  1. In the XCode's "Project navigator", right click on your project's Libraries folder ➜ Add Files to <...>
  2. Go to node_modulesreact-native-tapjoyios ➜ select RNTapjoy.xcodeproj
  3. Add libRNTapjoy.a to Build Phases -> Link Binary With Libraries
  4. Add the Tapjoy SDK to your XCode project as described on the Tapjoy website

Alertnatively, you may use the podspec file:

  ...
  pod 'RNTapjoy', :path => '../node_modules/react-native-tapjoy'
  ...

NOTE: You have to manually integrate the Push notifications feature as described on the Tapjoy website, because it requires access to the didFinishLaunchingWithOptions:` method in your application’s app delegate file.

Android

  1. Add the following lines to android/settings.gradle:

    include ':react-native-tapjoy'
    project(':react-native-tapjoy').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-tapjoy/android')
    
  2. Update the android build tools version to 3.4.1 in android/build.gradle:

    buildscript {
        ...
        dependencies {
            classpath 'com.android.tools.build:gradle:3.4.1'
        }
        ...
    }
    ...
  3. Update the gradle version to 5.4.1 in android/gradle/wrapper/gradle-wrapper.properties:

    ...
    distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip
    
  4. Add the compile line to the dependencies in android/app/build.gradle:

    dependencies {
        compile project(':react-native-tapjoy')
    }
  5. Add the import and link the package in MainApplication.java:

    import com.mariusreimer.tapjoy.TapjoyPackage; // <-- add this import
    
    public class MainApplication extends Application implements ReactApplication {
        @Override
        protected List<ReactPackage> getPackages() {
            return Arrays.<ReactPackage>asList(
                new MainReactPackage(),
                new TapjoyPackage() // <-- add this line
            );
        }
    }
  6. Add the Tapjoy SDK to your Android project as described on the Tapjoy website.

Windows

Usage

TypeScript definitions are included.

Configuration

const options = {
    sdkKeyIos: "12345",
    sdkKeyAndroid: "12345",
    gcmSenderIdAndroid: "12345",
    debug: true
};

Initialization (without React Hooks)

import { Tapjoy } from 'react-native-tapjoy';

const tapjoy = new Tapjoy(options);

try {
    const initialized = await tapjoy.initialse();
    // tapjoy is initialized
} catch (e) {
    // error on initialization
}

Initialization (with React Hooks)

import { useEffect } from 'react';
import { useTapjoy } from 'react-native-tapjoy';

const [
    {
        tapjoyEvents
    },
    {
        initialiseTapjoy,
        listenToEvent,
        addTapjoyPlacement,
        showTapjoyPlacement,
        requestTapjoyPlacementContent,
        isTapjoyConnected,
        tapjoyListenForEarnedCurrency,
        getTapjoyCurrencyBalance,
        setTapjoyUserId,
        spendTapjoyCurrency,
    },
] = useTapjoy(tapjoyOptions);

useEffect(() => {
    try {
        const initialized = await initialiseTapjoy();
        // tapjoy is initialized
    } catch (e) {
        // error on initialization
    }
}, []);

List of Events

This is a list of events you may subscribe to:

Event Name Description
earnedCurrency Fired when currency was earned. The response contains the fields amount currencyName and currencyID (iOS only).
onPlacementDismiss Fired when a shown placement was dismissed. The response contains the field placementName.
onPlacementContentReady Fired when a placement's content is ready to be shown. The response contains the field placementName.
onPurchaseRequest Fired when a purchase is requested. The response contains the fields placementName, requestId, token and productId.
onRewardRequest Fired when a reward is requested. The response contains the fields placementName, requestId, token, itemId and quantity.

Listen for Events (without React Hooks)

tapjoy._on(eventName, () => {
    // event has fired
})

You may get a list of events from the constants: tapjoy.constants. It contains a events field.

Listen for Events (with React Hooks)

listenToEvent(eventName, () => {
    // event has fired
})

You may get a list of events from useTapjoy hook, named tapjoyEvents.

Add Placement (without React Hooks)

try {
    await tapjoy.addPlacement();
    // tapjoy placement was added
} catch (e) {
    // error
}

Add Placement (with React Hooks)

useEffect(() => {
    try {
        await addTapjoyPlacement('TestPlacement');
        // tapjoy placement was added
    } catch (e) {
        // error
    }
}, []);

Request Content (without React Hooks)

try {
    await tapjoy.requestContent('TestPlacement');
    // tapjoy placement content request was successful
} catch (e) {
    // request failed
}

Request Content (with React Hooks)

useEffect(() => {
    try {
        await requestTapjoyPlacementContent('TestPlacement');
        // tapjoy placement content request was successful
    } catch (e) {
        // request failed
    }
}, []);

Show Placement (without React Hooks)

try {
    await tapjoy.showPlacement('TestPlacement');
    // tapjoy placement content is showing
} catch (e) {
    // placement not added, or content not ready
}

Show Placement (with React Hooks)

useEffect(() => {
    try {
        await showTapjoyPlacement('TestPlacement');
        // tapjoy placement content is showing
    } catch (e) {
        // placement not added, or content not ready
    }
}, []);

Listen for Earned Currency (without React Hooks)

try {
    await tapjoy.listenForEarnedCurrency(({ amount, currencyName, currencyID }) => {
        // user earned currency
    });
} catch (e) {
    // error
}

Listen for Earned Currency (with React Hooks)

useEffect(() => {
    try {
        await tapjoyListenForEarnedCurrency(({ amount, currencyName, currencyID }) => {
            // user earned currency
        });
    } catch (e) {
    // error
    }
}, []);

Get Currency Balance (without React Hooks)

try {
    const { amount, currencyName } = await tapjoy.getCurrencyBalance();
} catch (e) {
    // error
}

Get Currency Balance (with React Hooks)

useEffect(() => {
    try {
        const { amount, currencyName } = await getTapjoyCurrencyBalance();
    } catch (e) {
        // error
    }
}, []);

Spend Currency (without React Hooks)

try {
    await tapjoy.spendCurrencyAction(42);
} catch (e) {
    // error
}

Spend Currency (with React Hooks)

useEffect(() => {
    try {
        await spendTapjoyCurrency(42);
    } catch (e) {
        // error
    }
}, []);

react-native-tapjoy's People

Contributors

dependabot[bot] avatar dmitry-orabey avatar reime005 avatar semantic-release-bot avatar yurakruhlyk avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.