手動での統合
Tapjoy Android SDK を手動で統合するには、.aar ファイルをダウンロードしてプロジェクトの libs フォルダーに追加し、Tapjoy および Google Play 開発者サービスを使用して Gradle の依存関係を更新します。
読み終わるまでの所要時間 2 分最終更新 10日前
SDK のダウンロード
SDK を手動で統合する最初のステップは、Android SDK をダウンロード することです。SDK をプロジェクトに追加する
SDK を解凍すると、ドキュメント、ライブラリ、TapjoyEasyApp があります。- ファイルをプロジェクトの /lib フォルダーにコピーします (このフォルダーがない場合は、最初に作成してください)
tapjoyconnectlibrary.aar - Tapjoy をアプリケーションの build.gradle に追加します。
dependencies { implementation files('libs/tapjoyconnectlibrary.aar')}
- build.gradle に Google Play 開発者サービスを追加します。
repositories { maven { url 'https://maven.google.com/' name 'Google' }}
dependencies { implementation 'com.google.android.gms:play-services-ads-identifier:17.1.0'}
アプリの権限とアクティビティの追加
以下の権限が必要です。- (任意)
ACCESS_WIFI_STATE
AD_ID と Google Play ファミリープログラム
play-services-adsAD_ID詳細については、広告 ID に関する Play Console のヘルプドキュメント を参照してください。<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
JAR の統合
AAR の代わりに JAR オプションを使用する場合は、以下の権限とアクティビティも必要です。INTERNETACCESS_NETWORK_STATE
現在の SDK バージョンで Tapjoy の全機能を使用するには、以下のアクティビティを<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
AndroidManifest.xmlアプリのマニフェストアクティビティにも同じ configChanges を追加する必要があります。<activity android:name="com.tapjoy.TJAdUnitActivity" android:configChanges="orientation|keyboardHidden|screenSize|uiMode" android:theme="@style/TranslucentTheme" android:enableOnBackInvokedCallback="true" android:hardwareAccelerated="true" tools:ignore="UnusedAttribute" /><activity android:name="com.tapjoy.TJWebViewActivity" android:configChanges="orientation|keyboardHidden|screenSize|uiMode" android:theme="@style/TranslucentTheme" android:enableOnBackInvokedCallback="true" android:hardwareAccelerated="true" tools:ignore="UnusedAttribute" />
この時点で、アプリケーションをコンパイルして実行し、アプリのすべてが動作していることを確認するようお勧めします。実際にはアプリケーションのコードに対して何も行っていないため、アプリケーションの機能にエラーや変更はありません。android:configChanges="orientation|keyboardHidden|screenSize|uiMode"
Tapjoy への接続
次のステップは、アプリケーションに Tapjoy Connect のコードを追加することです。このコードのキー ビットは、アプリケーションで Offerwall SDK を "オン" にします。
Tapjoy Connect 呼び出しを実装するには、統合するアプリケーション用の Offerwall SDK キーが必要です。これを見つけるには、Tapjoy ダッシュボードでアプリケーションに移動し、上部ナビゲーションバーにある "Settings" (設定) ボタンをクリックします。"App Settings" (アプリ設定) に移動すると、ページの下部に SDK キーがあります。
次に、コードを記述します。Tapjoy をアクティビティにインポートします。
次に、メインアクティビティのimport com.tapjoy.Tapjoy
onCreate()このコードでは、Tapjoy に接続し (成功、失敗、警告のコールバックをリッスン)、2 つの '接続フラグ' (ロギングとユーザー ID) を設定していることがわかります。Hashtable<String, Object> connectFlags = new Hashtable<String, Object>();connectFlags.put(TapjoyConnectFlag.TJC_OPTION_LOGGING_LEVEL, TJLogLevel.DEBUG); // Disable this in production buildsconnectFlags.put(TapjoyConnectFlag.USER_ID, "USER_ID_GOES_HERE"); // Important for self-managed currencyTapjoy.connect(getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() { @Override public void onConnectSuccess() { } @Override public void onConnectWarning(int code, String message) { } @Override public void onConnectFailure() { } });
onConnectSuccessonConnectWarningonConnectFailureフラグ | 説明 | ノート |
|---|---|---|
| このフラグを設定すると、広告 ID を使用できない場合、Offerwall SDK は永続化された ID を広告の目的に使用します。 | SDK バージョン 12.2.1 以降で使用できます。 |
| デフォルトでは、Tapjoy の Android SDK は Google Advertising Identifier の存在を確認し、見つからない場合は初期化に失敗します。このフラグを設定すると、このチェックが無効になり、Google Advertising Identifier が存在しない場合でも Offerwall SDK が初期化されます。 | これは、Google Play 開発者サービスがアプリにない場合 (Google Play 以外のアプリストアでリリースするためのビルドを作成する場合など) に便利です。 |