クイックスタート

1. 最小必要構成

• React Native: 0.71.6
• Node 14 またはそれ以降
• Ruby 2.7.6
• iOS: 12.4
• Android: 5.0 (API 21)

2. SDK 実装

アプリへの実装を行うには、まずはじめに Tapjoy React Native プラグインをインストールします。NPM と Yarn をサポートしています。

NPM

npm install tapjoy-react-native-sdk

Yarn

yarn add tapjoy-react-native-sdk

インストールが完了すると、Tapjoy をアプリにインポートしてプラグインを使用できます：

import {Tapjoy, TJPlacement} from 'tapjoy-react-native-sdk'

パーミッションを追加する (Android 用)

ACCESS_WIFI_STATE パーミッションをアプリのマニフェストに任意で追加してください:

<manifest ...>
  ...
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
  ...
</manifest>

3. Tapjoy Connect の実装

Tapjoy SDK を初期化するには、connect を呼び出します。アプリの起動後できるだけ早い時点で実行して下さい。

try {

    let sdkKey = Platform.OS === 'ios' ? 'ios-sdk-key' : 'android-sdk-key'
    let flags: object = {TJC_OPTION_USER_ID: 'userId'};

    await Tapjoy.connect(sdkKey, flags);

} catch (error) {
    console.error(error);            
}

Tapjoy の接続設定完了後は、アプリのビルドおよび実行が可能です。

Tapjoy ダッシュボードで、画面上部のナビゲーションバーから "アナリティクス" タブを選択し、画面左の "リアルタイムレポート" タブを選択すると、アプリを実行した直後に何らかのアクティビティが確認できるはずです。

これでTapjoyがアプリで起動するようになりました｡

4. App Tracking Transparency によるトラッキングの許可を求める

アプリがApp Tracking Transparencyを使用する場合、IDFA(広告ID)にアクセスするための許可を求めるダイアログを表示するには、Info.plistに NSUserTrackingUsageDescription キーとIDFAをアプリで使用する許可を求めるカスタムメッセージの値を追加します。

次に、 react-native-tracking-transparency パッケージ をインストールします:

yarn add react-native-tracking-transparency

インストールしたライブラリをインポートし、パーミッションダイアログを表示します:

import {
    getTrackingStatus,
    requestTrackingPermission,
} from 'react-native-tracking-transparency';

...

let trackingStatus = await getTrackingStatus();
if (trackingStatus === 'authorized' || trackingStatus === 'unavailable') {
    await Tapjoy.connect(sdkKey, flags);
}else{
    trackingStatus = await requestTrackingPermission();
    await Tapjoy.connect(sdkKey, flags);
}