クイックスタート

Tapjoy Unity プラグインパッケージをプロジェクトにインポートし、SDK キーを設定し、最初のシーンに Tapjoy ゲームオブジェクトを追加して統合を開始します。

読み終わるまでの所要時間 5 分

最終更新 7日前

最小要件

React Native: 0.71.6
Node 14 以降
Ruby 2.7.6
iOS: 13.0
Android: 5.0 (API 21)

SDK のインテグレーション

アプリと統合する最初のステップは、Tapjoy React Native プラグインをインストールすることです。NPM と Yarn がサポートされています。

npm

npm

を使用する場合は、Android アプリまたはプロジェクトレベルの build.gradle ファイルに Maven リポジトリを加える必要があります。


repositories {    maven {        url "https://sdk.tapjoy.com/"    }}

その後、プラグインをインストールできます。


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>

Tapjoy への接続

接続呼び出しは、Offerwall SDK を初期化する方法です。アプリの起動後、できるだけ早くこれを行います。


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, (event:TapjoyEvent) => {       // Handle Warning     },  );  // Handle Success} catch (error: any) {  // Handle Failure}

接続中にノンブロッキングの問題が起きた場合は警告が発生します。その後、成功となります。この機能は現在、ConnectFlags で送信されたときに UserId の問題のみを検出します。

Tapjoy の設定が完了したら、アプリケーションをビルドして実行できます。

ロギング

以下の方法を使用して、ロギングレベルを取得および設定できます。


// Set logging levelTapjoy.setLoggingLevel(TJLoggingLevel.Debug);// Get logging levelvar loggingLevel = await Tapjoy.getLoggingLevel();

最大ユーザーレベル

Tapjoy にゲーム内のレベル数を伝えることができます。この値は、connect を呼び出す前または後に設定できます。


Tapjoy.setMaxLevel(10);

ユーザーセグメント

setUserSegment

を呼び出すことで、ユーザーをセグメントの一部として識別できます。これは connect を呼び出す前または後に設定できます。


Tapjoy.setUserSegment(TJSegment.VIP);Tapjoy.setUserSegment(TJSegment.Payer);Tapjoy.setUserSegment(TJSegment.NonPayer);Tapjoy.setUserSegment(TJSegment.Unknown);

App Tracking Transparency 承認のリクエスト

アプリケーションが App Tracking Transparency を使用するように設計されている場合、IDFA へのアクセスをリクエストするダイアログを表示するには、アプリケーションで IDFA を使用するためのこの権限を説明するカスタムメッセージとともに NSUserTrackingUsageDescription キーを加えて Info.plist を更新します。

次に、

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);}

ドキュメント

Development

User Acquisition

Monetization

産業