クイックスタート

1. ダッシュボード実装ガイド

Tapjoy ダッシュボード に、Tapjoy の実装を手順を追って説明する 実装ガイド が組み込まれました。従来通り、この実装ガイドにしたがって実装を進める事も可能です。最後に登録したアプリの実装ガイドを直接参照するか、Tapjoy ダッシュボードでアプリを選択し、「ツール」メニューのドロップダウンから「実装方法」を選択してください。

2. SDK 実装

A. Maven (推奨)

Mavenを利用すれば、アプリの build.gradle ファイルに数行書き加えるだけでTapjoyを実装できるようになります。 Tapjoy を利用する場合には、アプリの build.gradle に下記のように付け加えます。使用するTapjoy SDKのバージョンに合わせてバージョン番号を修正して下さい。:

    repositories {
      maven {
        name "Tapjoy's maven repo"
        url "https://sdk.tapjoy.com/"
      }
      maven {
        name 'Google'
        url 'https://maven.google.com/'
      }

    }

    dependencies {
      implementation 'com.tapjoy:tapjoy-android-sdk:13.3.0'
    }

B. PermissionとActivityの追加

以下の Permission を設定します:

  • ACCESS_WIFI_STATE(任意)

また、アプリのアクティビティのマニフェストに configChanges を指定するようにして下さい:

  android:configChanges="orientation|keyboardHidden|screenSize"

この時点でプロジェクトのコンパイルが可能です。アプリをコンパイル、実行してアプリが正常に動作する事を確認してみるのも良いかもしれません。まだアプリのコードに何も手を入れていないため、アプリにエラーが発生したり動作が変わる事もないはずです。

AD_ID と Google Play ファミリー向けプログラム

Tapjoy 12.9.0 は play-services-ads v17.1.0 を含みます。 このバージョンの play-services-adsAD_ID パーミッションを含みますが、このパーミッションは Google Play ファミリー向けプログラム に加入している場合には削除しなければなりません。

マニフェストに以下の記述を追加すれば、このパーミッションを排除できます:

  <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>

詳細は こちら をご参照ください。

3. Tapjoy Connect実装

次に、Tapjoy connect をアプリに実装します。 これにより、アプリからTapjoy SDK を"起動"します。

Tapjoy connect の実装は非常に重要です。この実装が正常に行われていない場合、Tapjoyの機能がいっさい動作しなくなるからです

Tapjoy connect を実装するためには、実装を行うアプリのTapjoy SDK Keyが必要になります。この値を取得するには Tapjoyダッシュボードで実装するアプリを選択肢、"設定" - "アプリ設定" をクリックします。画面下部の SDK Keyの箇所に各プラットフォームのSDK Keyが表示されています。

コードを実装して行きます。 Tapjoy を Activity にインポートします:

java
  import com.tapjoy.Tapjoy

次に、メイン Activity の onCreate() メソッドに Tapjoy connect を実装します:

java
  Hashtable<String, Object> connectFlags = new Hashtable<String, Object>();
  connectFlags.put(TapjoyConnectFlag.ENABLE_LOGGING, "true"); // 用アプリではこの設定を外す事
  connectFlags.put(TapjoyConnectFlag.USER_ID, "USER_ID_GOES_HERE"); // 自社管理仮想通貨では必須

Tapjoy.connect(getContext().getApplicationContext(), "SDK_KEY_GOES_HERE", connectFlags, new TJConnectListener() {
    @Override
    public void onConnectSuccess() {
        
    }
    @Override
    public void onConnectWarning(int code, String message) {
        
    }
    @Override
    public void onConnectFailure(int code, String message) {
        
    }    
}); 

このコードでは、Tapjoy に connect をし(て成功、失敗、および警告のコールバックをリスニングし)、ふたつの connectFlags (ログおよびユーザID) を設定しています。onConnectSuccess は SDK が Tapjoy サーバへの接続が成功した事を示します。 connect が成功しつつも致命的でない問題が発生している場合は、先に onConnectWarning を呼びだします。現時点ではこの機能は ConnectFlags で指定した UserId に問題がある場合にのみ呼び出されます。サーバへの接続が成功しなかった場合は、 onConnectFailure が呼び出されます。

パブリッシャーにとって ENABLE_LOGGING および USER_ID の二つが重要かつ有用なフラグです。

ログ用フラグはデバッグ用ビルドでは有用ですが、製品版では無効にしておく必要があります。

USER_ID フラグを設定する事は自社管理仮想通貨を使用する場合には非常に重要です。この値はどのプレイスメントを呼び出すより前に設定する必要があるため、connect で設定する事は重要で、リワードでの問題が発生する可能性を回避できます。

いくつかのコネクトフラグは、TapjoyがAndroid OSから得られる各種IDをどのように使用するかをパブリッシャーが制御できます:

  • ALLOW_LEGACY_ID_FALLBACK (SDK 12.2.1 以降で使用可能) ラグがセットされた場合、Tapjoy SDK は広告IDが使用できない場合、永続IDを広告用途で使用します。
  • DISABLE_ANDROID_ID_AS_ANALYTICS_ID [SDK version 13.3.0 から非推奨] フラグがセットされた場合、Tapjoyがアナリティクス用途で使用するIDはAndroid IDを元にしたものではなく、ランダムに生成した文字列となります。既存のアプリのリリース後にこのフラグをセットしたビルドをリリースすると、既存のユーザーがTapjoyのアナリティクスツール上で新規ユーザーとして扱われる結果になります
  • DISABLE_ADVERTISING_ID_CHECK デフォルトでは、TapjoyのAndroid SDKは Google Advertising Identifier が利用できるかを確認し、利用できない場合には初期化が失敗します。 このフラグを設定すると、Tapjoy SDK は Google Advertising Identifier が利用可能かのチェックを行わないため、利用できない場合でも初期化が行われます。 これは、Google Play ストア以外のストアなど、Google Play Servicesが存在しない端末があるストアへのリリース用のビルドを作成する時に役に立ちます。

アプリをコンパイルして、実行してみて下さい。

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

ユーザー レベル の最大値

Tapjoy にゲーム内でのレベルの最大値を伝えられます。この値は Connectの前、および後で設定できます。

java
Tapjoy.setMaxLevel(10); 

ユーザー セグメント

setUserSegmentを呼び出して、ユーザーのセグメントを知らせられます。この値は Connectの前、および後で設定できます。

java
Tapjoy.setUserSegment(TJSegment.VIP);
Tapjoy.setUserSegment(TJSegment.PAYER);
Tapjoy.setUserSegment(TJSegment.NON_PAYER);
Tapjoy.setUserSegment(TJSegment.UNKNOWN);