Android SDK

21 min read

Android SDK実装ガイド #

Tenjin Android SDKを使用すると、Androidアプリ内でイベントやインストール状況をトラックできます。Tenjinおよび当社の製品の詳細については、https://www.tenjin.comをご覧ください。

過去のバージョン履歴については、こちらのリリースノートをご確認下さい。
Android SDKの実装には、最新のAndroid Studioを利用されることをお勧めします。
Unityの実装手順については、こちらをご確認ください。
ご質問がある方は、support@tenjin.comまでお問い合わせください。

基本実装 #

マニュアルインストール #

以下の「Android Studio」セクションに記載されている手順をご確認ください。

Maven #

Mavenを使用する場合は、com.tenjin:android-sdk:VERSIONをGradleの依存関係に追加し、ソースリポジトリにまだ存在しない場合はmavenCentral()を追加してください。

Android Studio #

最新のAndroid SDKをこちらよりダウンロードします。
Tenjin SDKをAndroid Studioプロジェクトに追加します。 Android Studioのプロジェクトナビゲータに移動します。プロジェクトナビゲータでオプションProjectを選択します。 Android Studioプロジェクトの appモジュールの下に libsフォルダーがあります。
ファイル tenjin.jarまたはtenjin.aarを libsフォルダに追加してください。

Android Studioプロジェクトのappモジュールで、 build.gradleファイルを選択し、依存関係ブロックの下に以下を追加します。

Java

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    implementation files('libs/tenjin.aar')
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    implementation files('libs/tenjin.aar')
}

> デモプロジェクトは、tenjin-android-sdkの実装サンプルです。

Google PlayまたはAmazonストア #

Google PlayストアまたはAmazonストアでアプリを配布する場合には、次の初期設定を実装してください。

パーミッション #

manifestファイルに下記のパーミッションを追加します。

XML

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

Google Play開発者サービスでは、広告ID(Android広告ID（AAID）)を使用するすべてのAPIレベル32(Android 13)アプリに対し、マニフェストファイル内でGoogle Play開発者サービスのAD_ID権限(下記参照)を宣言することを要求しています。

XML

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

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

Android広告ID (AAID)とインストールリファラ #

Android広告ID(AAID)とインストールリファラライブラリを下記の通り、build.gradleファイルに追加します。

Java

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

Metaインストールリファラーを収集できるようにするには、次のクエリをAndroid マニフェストに追加します。

XML

<queries>
  <package android:name="com.facebook.katana" />
</queries>

<queries>
  <package android:name="com.instagram.android" />
</queries>

<queries>
  <package android:name="com.facebook.katana" />
</queries>

<queries>
  <package android:name="com.instagram.android" />
</queries>

次に、下記をstrings.xmlファイルに記載してください。YOUR_META_APP_IDはお使いのアプリのMeta App IDになります。

XML

<string name="facebook_app_id" translatable="false">YOUR_META_APP_ID</string>

<string name="facebook_app_id" translatable="false">YOUR_META_APP_ID</string>

アプリストア設定 #

デフォルトでは, unspecifiedがアプリストアの設定になります。アプリに応じて、アプリストアの値をgoogleplayまたはamazonに更新します。

AndroidManifest.xml:

XML

<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="googleplay" />

<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="googleplay" />

setAppStore():

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.setAppStore(TenjinSDK.AppStoreType.googleplay);

TenjinSDK instance = TenjinSDK.getInstance(this, "");

instance.setAppStore(TenjinSDK.AppStoreType.googleplay);

アプリストアオプション #

Java

  TenjinSDK.AppStoreType.googleplay // Google Play App Store
  TenjinSDK.AppStoreType.amazon     // Amazon AppStore
  TenjinSDK.AppStoreType.other      // Other

  TenjinSDK.AppStoreType.googleplay // Google Play App Store
  TenjinSDK.AppStoreType.amazon     // Amazon AppStore
  TenjinSDK.AppStoreType.other      // Other

SDK初期化 #

AppsページからSDK_KEYを取得します。注: SDK_KEYはアプリごとに一意です。同じアプリに対して最大3つまでキーを作成できます。

Activityにおいて、Tenjinをインポートします: import com.tenjin.android.TenjinSDK;
各ActivityのonResumeメソッドにおいて、下記コードを追加してください。

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.connect();

TenjinSDK instance = TenjinSDK.getInstance(this, "");

instance.connect();

注: アプリ内でonCreateとonResumeの間でユーザーの同意を求めるロジックがある場合、同意しないユーザーは onResumeで追跡されないため、TenjinSDKの初期化にはonResumeではなくonCreateを使用してください。

注: アプリの初回起動だけでなく、すべてのonResumeにこのコードを実装するようにしてください。推奨事項に従わない場合は、適切なサポートを提供できないか、アカウントが停止される可能性があります。

その他のAndroidストア #

アプリをGooglePlayストアまたはAmazonストア以外(その他のAndroidストア)に配布する場合は、次の初期設定を実装します。

パーミッション #

XML

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

Google Playサービスは、広告 ID(Android広告 ID (AAID))を使用するすべての APIレベル 32(Android 13)アプリに対して、マニフェストファイル内で Google Playサービスの AD_ID権限(下記参照)を宣言することを要求します。

XML

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

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

Android広告ID (AAID)とインストールリファラ #

Android広告ID(AAID)とインストールリファラライブラリを下記の通り、build.gradleファイルに追加します。

Java

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

IMEIをターゲットとするアドネットワークを使用している場合は、以下の権限を有効にする必要があります。(Google Playでアプリを配布している場合は、この権限を追加しないでください。)

XML

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

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

OAID #

TenjinはAndroidのOAIDを使用したAndroidアプリストアのトラッキングをサポートしています。OAIDライブラリを実装した場合のオプションは下記の通りです。

MSA OAID #

MSA OAIDは、MSA (Mobile Security Alliance)が提供する、中国で製造されるデバイスで取得可能な広告IDです。MSA ライブラリを実装する場合は、oaid_sdk_1.0.25.aarとsupplierconfig.jsonをダウンロードします。

また、下記をgradleファイルに追加します。

Plaintext

implementation files('libs/oaid_sdk_1.0.25.aar')

implementation files('libs/oaid_sdk_1.0.25.aar')

必ずsupplierconfig.jsonをプロジェクトのassetsフォルダにコピーしてください。

Huawei OAID #

中国以外では、Huaweiによって提供されるOAIDを取得することが可能です。HuaweiOAIDライブラリを追加するには下記の手順を実施します。

build.gradleファイル内で、Huawei SDKに対するMavenのアドレスを追加します。

Java

allprojects {
    repositories {
        google()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

allprojects {
    repositories {
        google()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

Java

dependencies {
    implementation 'com.huawei.hms:ads-identifier:{version}'
}

dependencies {
    implementation 'com.huawei.hms:ads-identifier:{version}'
}

Huaweiインストールリファラ #

Huaweiアプリギャラリーにてアプリをプロモーションする場合, 上記のHuawei OAID SDK及びインストールリファラライブラリを追加します。

Java

dependencies {
    implementation 'com.huawei.hms:ads-identifier:{version}'
    implementation 'com.huawei.hms:ads-installreferrer:{version}'
}

dependencies {

    implementation 'com.huawei.hms:ads-identifier:{version}'
    implementation 'com.huawei.hms:ads-installreferrer:{version}'

}

アプリストア設定 #

デフォルトでは, unspecifiedがアプリストアの設定になります。アプリストアの値をotherに更新します。

AndroidManifest.xml:

XML

<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="other" />

<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="other" />

setAppStore():

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.setAppStore(TenjinSDK.AppStoreType.other);

TenjinSDK instance = TenjinSDK.getInstance(this, "");

instance.setAppStore(TenjinSDK.AppStoreType.other);

SDK初期化 #

AppsページからSDK_KEYを取得します。注: SDK_KEYはアプリごとに一意です。同じアプリに対して最大3つまでキーを作成できます。

Activityにおいて、Tenjinをインポートします: import com.tenjin.android.TenjinSDK;
各ActivityのonResumeメソッドにおいて、下記コードを追加してください。

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.connect();

TenjinSDK instance = TenjinSDK.getInstance(this, "");

instance.connect();

注: アプリの初回起動だけでなく、すべてのonResumeにこのコードを実装するようにしてください。推奨事項に従わない場合は、適切なサポートを提供できないか、アカウントが停止される可能性があります。

難読化設定 #

JavaScript

-keep class com.tenjin.** { *; }
-keep public class com.google.android.gms.ads.identifier.** { *; }
-keep public class com.google.android.gms.common.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep class * extends java.util.ListResourceBundle {
    protected java.lang.Object[][] getContents();
}

# Keep the signatures that Gson/TypeToken rely on
-keepattributes Signature
-keepattributes *Annotation*

# General Gson/TypeToken protection
-keep class com.google.gson.reflect.TypeToken { *; }
-keep class * extends com.google.gson.reflect.TypeToken

-keep class com.tenjin.** { *; }
-keep public class com.google.android.gms.ads.identifier.** { *; }
-keep public class com.google.android.gms.common.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep class * extends java.util.ListResourceBundle {
    protected java.lang.Object[][] getContents();
}

# Keep the signatures that Gson/TypeToken rely on
-keepattributes Signature
-keepattributes *Annotation*

# General Gson/TypeToken protection
-keep class com.google.gson.reflect.TypeToken { *; }
-keep class * extends com.google.gson.reflect.TypeToken

OAIDのクラスについては難読化しないでください。

Java

-keep class XI.CA.XI.**{*;}
-keep class XI.K0.XI.**{*;}
-keep class XI.XI.K0.**{*;}
-keep class XI.xo.XI.XI.**{*;}
-keep class com.asus.msa.SupplementaryDID.**{*;}
-keep class com.asus.msa.sdid.**{*;}
-keep class com.bun.lib.**{*;}
-keep class com.bun.miitmdid.**{*;}
-keep class com.huawei.hms.ads.identifier.**{*;}
-keep class com.samsung.android.deviceidservice.**{*;}
-keep class com.zui.opendeviceidlibrary.**{*;}
-keep class org.json.**{*;}
-keep public class com.netease.nis.sdkwrapper.Utils {public <methods>;}

-keep class XI.CA.XI.**{*;}
-keep class XI.K0.XI.**{*;}
-keep class XI.XI.K0.**{*;}
-keep class XI.xo.XI.XI.**{*;}
-keep class com.asus.msa.SupplementaryDID.**{*;}
-keep class com.asus.msa.sdid.**{*;}
-keep class com.bun.lib.**{*;}
-keep class com.bun.miitmdid.**{*;}
-keep class com.huawei.hms.ads.identifier.**{*;}
-keep class com.samsung.android.deviceidservice.**{*;}
-keep class com.zui.opendeviceidlibrary.**{*;}
-keep class org.json.**{*;}
-keep public class com.netease.nis.sdkwrapper.Utils {public <methods>;}

Huaweiのライブラリを使用している場合は、下記の設定を行います。

Java

-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** { *; }

-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** { *; }

追加実装 #

一般データ保護規則(EU)(GDPR)は、欧州連合(EU)および欧州経済領域(EEA)におけるデータ保護とプライバシーに関するEU法の規則です。

アプリを初めて開いたときに、ユーザーがトラッキングを許可するかどうかの同意を得る必要があります。その後、結果をcheckOptInValue()に書き込みます。その後、以下の実装手順に従ってください。アプリで GDPR に準拠する必要がない場合は、このセクション全体を無視してください。

GDPR準拠の一環として、TenjinのSDKを使用すると、デバイス/ユーザーのオプトイン/オプトアウト、またはオプトインまたはオプトアウトする特定のデバイス関連パラメータを選択できます。optOut()はTenjinにAPIリクエストを送信せず、イベントも処理しません。

オプトイン/オプトアウトを実装するには:

Java

import com.tenjin.android.TenjinSDK;
public class TenjinDemo extends ActionBarActivity {
    @Override
    public void onResume() {
        //standard code
        super.onResume()
        //Integrate TenjinSDK connect call
        String apiKey = "<sdk_key>";
        TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);
        boolean userOptIn = checkOptInValue();
        if (userOptIn) {
            instance.optIn();
        }
        else {
            instance.optOut();
        }
        instance.connect();
        //Your other code...
        //...
    }
    protected boolean checkOptInValue(){
        // check opt-in value
        // return true; // if user opted-in
        return false;
    }
}

import com.tenjin.android.TenjinSDK;

public class TenjinDemo extends ActionBarActivity {
    @Override
    public void onResume() {
        //standard code
        super.onResume()

        //Integrate TenjinSDK connect call
        String apiKey = "";
        TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

        boolean userOptIn = checkOptInValue();

        if (userOptIn) {
            instance.optIn();
        }
        else {
            instance.optOut();
        }

        instance.connect();

        //Your other code...
        //...

    }

    protected boolean checkOptInValue(){
        // check opt-in value
        // return true; // if user opted-in
        return false;
    }
}

特定のデバイスパラメータをオプトイン,オプトアウトするにはoptInParams()または optOutParams()メソッドを使用します。

OptInParams()メソッドにより指定されたパラメータのみを送信します。OptOutParams()メソッドにより、指定されたパラーメータ以外のパラメータを送信します。
Tenjinシステムでデバイスを正しく追跡するためには、以下のパラメータが必要となりますのでご注意ください。必須パラメータが欠落している場合、イベントは処理または記録されません。
- advertising_id
If you are targeting IMEI and/or OAID Ad Networks, these params are required:
- imei
- oaid
Google Adsを使用する場合は、以下のパラメータが必要です。
- platform
- os_version
- app_version
- locale
- device_model
- build_id
- advertising_id

特定のデバイス関連パラメータのみを取得したい場合は、optInParams()を使用します。以下の例では、ip_address、advertising_id、limit_ad_tracking、および referrer というデバイス関連パラメータのみを取得します。

Java

String apiKey = "<sdk_key>";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);
String[] optInParams = {"ip_address", "advertising_id", "limit_ad_tracking", "referrer"};
instance.optInParams(optInParams);
instance.connect();

String apiKey = "";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

String[] optInParams = {"ip_address", "advertising_id", "limit_ad_tracking", "referrer"};
instance.optInParams(optInParams);

instance.connect();

特定のデバイス関連パラメータを除くすべてのパラメータを送信する場合は、optOutParams()を使用します。以下の例では、以下のパラメータを除くすべてのデバイス関連パラメータを送信します。

Java

String apiKey = "<sdk_key>";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);
String[] optOutParams = {"locale", "timezone", "build_id"};
instance.optOutParams(optOutParams);
instance.connect();

String apiKey = "";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

String[] optOutParams = {"locale", "timezone", "build_id"};
instance.optOutParams(optOutParams);

instance.connect();

CMPを用いたオプトイン/アウト #

ユーザーのデバイスにすでに保存されている CMP同意 (目的 1)の情報を使用して、Tenjin SDKを自動的にオプトインまたはオプトアウトできます。このメソッドは、オプトインかオプトアウトかを示すブール値を返します。

optInOutUsingCMP()

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
optInOut = instance.optInOutUsingCMP();

TenjinSDK instance = TenjinSDK.getInstance(this, "");
optInOut = instance.optInOutUsingCMP();

デバイスパラメータ #

パラメータ	説明
ip_address	IP Address
advertising_id	Google広告ID
limit_ad_tracking	limit ad tracking enabled
oaid	Open Advertising ID
imei	Device IMEI
platform	プラットフォーム
referrer	Google Play Install Referrer
os_version	OSバージョン
device	デバイス名
device_manufacturer	デバイス製造元
device_model	デバイスモデル
device_brand	デバイスブランド
device_product	デバイスプロダクト
carrier	キャリア
connection_type	セルラーまたはWifi
screen_width	デバイススクリーン幅
screen_height	デバイススクリーン高さ
os_version_release	OSバージョン
build_id	ビルドID
locale	デバイスロケール
country	ロケール国
タイムゾーン	タイムゾーン

アプリ内課金イベント #

ユーザーの収益と購入行動を把握するために、開発者はtransactionイベントをTenjin に送信できます。Tenjinはtransactionレシートを検証します。現在、Google PlayからのIAPトランザクションのみをサポートしていることにご注意ください。

重要: Tenjin dashboardのAppsタブ -> 該当のAndroidアプリ -> Editより、Public Keyを入力してください。 Publick KeyはBase64でエンコードされたRSA公開キーで、 Google Playデベロッパーコンソールの選択したアプリ > Monetize > Monetization setup > Google Play Billing > Licensing: Base64-encoded RSA public keyの箇所から取得できます。

Public Key入力後, 下記のTenjin SDKメソッドをご利用ください。

Java

public void transaction(String productId, String currencyCode, int quantity, double unitPrice, String purchaseData, String dataSignature)

public void transaction(String productId, String currencyCode, int quantity, double unitPrice, String purchaseData, String dataSignature)

例:

Java

public void sendPurchaseEvent(Purchase purchase, Double price, String currencyCode) {
    String sku = purchase.getSku();
    String purchaseData = purchase.getOriginalJson();
    String dataSignature = purchase.getSignature();
    TenjinSDK instance = getTenjinInstance();
    instance.transaction(sku, currencyCode, 1, price, purchaseData, dataSignature);
}


public void sendPurchaseEvent(Purchase purchase, Double price, String currencyCode) {
    String sku = purchase.getSku();
    String purchaseData = purchase.getOriginalJson();
    String dataSignature = purchase.getSignature();

    TenjinSDK instance = getTenjinInstance();
    instance.transaction(sku, currencyCode, 1, price, purchaseData, dataSignature);
}

IAP検証が正しく機能しているかどうかは、ライブテストデバイスデータツールで確認できます。以下のライブイベントが表示されるはずです。

Tenjinに送る前に必ず課金イベントを「承認」してください。詳しくはこちらをお読みください。

新しい設定により、アプリストアの収益手数料を0%、15%または30%の間で選択可能です。

CONFIGURE --> Appsをクリック。
アプリを選択。
App Store Commissionのセクションで、Editをクリック
アプリストア手数料として30%、15%、または0%を選択。
開始日と終了日を選択します。 (終了日を指定しない場合は、終了日を空白のままにすることもできます)
Saveをクリックします (注: 手数料は変更を加えた日付以降に適用され、過去日付には適用されません。そのため、変更を行う日付から以降の開始日を設定してください)。

Amazonアプリストア

Amazonアプリストアのレシート検証には、receiptIdパラメータとuserIdパラメータが必要です。

重要:: Amazonアプリの共有キーを Tenjin管理画面に追加する必要があります。共有キーは、Amazonアプリストアの開発者アカウントから取得できます。

カスタムイベント #

注: SDK初期化処理の前にカスタムイベントを送らないようにしてください。

重要：カスタムイベント名は80文字未満に制限してください。また、固有のカスタムイベント名は500個を超えないようにしてください。

Tenjin SDKを使用してカスタムイベントを渡すことができます。 eventWithName(String name).

カスタムイベントを利用して、特定のイベントを獲得したユーザの流入元のコスト情報などに紐付けることが可能です。下記が実装例となります。

Java

String apiKey = <sdk_key>;
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);
//Integrate a custom event with a distinct name - ie. swiping right on the screen
instance.eventWithName("swipe_right");

String apiKey = <SDK_KEY>;
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

//Integrate a custom event with a distinct name - ie. swiping right on the screen
instance.eventWithName("swipe_right");

INTEGER型の値をvalueをカスタムイベントに含める方法 #

カスタムイベントにはINTEGER型のvalueを含めることができます。 eventWithNameAndValue(String name, int value).

イベントのnameに整数値の valueを渡すことで、マーケターはTenjin ダッシュボードでそのメトリックに渡された値を合計し、平均値を追跡できます。DataVault を使用する場合は、これらの値を使用して、役立つ追加のメトリックを導き出すことができます。

Java

String sdkKey = <sdk_key>;
TenjinSDK.instance = TenjinSDK.getInstance(this, sdkKey);
//Integrate a custom event with a distinct name and value - ie. paying 100 virtual coins for an item
instance.eventWithNameAndValue("item", 100);

String sdkKey = <SDK_KEY>;
TenjinSDK.instance = TenjinSDK.getInstance(this, sdkKey);

//Integrate a custom event with a distinct name and value - ie. paying 100 virtual coins for an item
instance.eventWithNameAndValue("item", 100);

上記の例を使用すると、Tenjin管理画面では、名前が指定されたすべてのイベントの値を合計して平均します。 item.

渡された値が整数でない場合、このイベントは機能しないことに注意してください。

Java

//Integrate a custom event with a distinct name and value - ie. paying 100 virtual coins for an item
instance.eventWithNameAndValue("item", "1");

//Integrate a custom event with a distinct name and value - ie. paying 100 virtual coins for an item
instance.eventWithNameAndValue("item", "1");

サーバ間連携 #

Tenjinはサーバー間連携を提供しています。これにより、SDK連携を必要とせずに、インストールイベントとインストール後イベントをサーバーからTenjinサーバーに直接送信できます。

アプリサブバージョン #

A/Bテストを実施する場合、appendAppSubversion() メソッドを用いて、アプリバージョンに固定の数値を付加することが可能です。例えば、アプリのバージョンが1.0.1でappendAppSubversion() : @8888をセットすると、レポートされるアプリバージョンは1.0.1.8888となります。

データボルトを用いれば、このアプリバージョンごとのパフォーマンスを分析することが可能です。

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.appendAppSubversion(8888);
instance.connect();

TenjinSDK instance = TenjinSDK.getInstance(this, "");
instance.appendAppSubversion(8888);
instance.connect();

LiveOpsキャンペーン #

アプリ開発者は、自社サーバーまたはTenjinと連携していないネットワークにカスタムでコールバックを送信できます。これにより、開発者はこれらのユーザーレベルのアトリビューションデータをリアルタイムで収集して分析できます。以下は、Tenjinのカスタムコールバックを使用した使用例です。

独自のデータ分析ツールをお持ちの場合は、S2Sコールバックを使用することで、デバイスごとにアトリビューションデータをゲーム内データに紐付けることができます。
ユーザーのアトリビューションソースに応じて、さまざまなアプリコンテンツを表示します。たとえば、ユーザーAがオーガニックに関連付けられ、ユーザーBがMetaに関連付けられているとします。ユーザー Bの方がアプリに関心を持っている可能性が高いため、ユーザーがアプリをインストールした後に特別なゲーム内オファーを表示することができます。

LiveOpsの使用方法に関する詳細は、こちらをご覧ください。

カスタマーユーザーID #

イベントのパラメーターとして送信するカスタマーユーザー IDを設定および取得できます。

.setCustomerUserId(userId: "user_id")

.getCustomerUserId()

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.setCustomerUserId(userId: "user_id");
userId = instance.getCustomerUserId();

TenjinSDK instance = TenjinSDK.getInstance(this, "");
instance.setCustomerUserId(userId: "user_id");
userId = instance.getCustomerUserId();

Analytics Installation ID #

下記のメソッドを用いて、ランダムに生成され、デバイスのローカルストレージに保存されているユニークなAnalytics IDを取得できます。 getAnalyticsInstallationId()

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
analyticsId = instance.getAnalyticsInstallationId;

TenjinSDK instance = TenjinSDK.getInstance(this, "");
analyticsId = instance.getAnalyticsInstallationId;

ユーザープロファイル – LiveOpsメトリクス #

Tenjin Android SDKは、ユーザーエンゲージメント指標を自動的に追跡し、プレイヤーの行動や生涯価値を把握するのに役立ちます。これらの指標は自動的に収集され、プログラムからアクセスできます。

自動トラッキング #

SDKは下記をトラックします:

セッションメトリクスセッション数、期間、初回/最終セッション日
In-App Purchases (IAP): トランザクション件数、通貨別収益、購入プロダクトID
広告収益(ILRD): サポート対象のアドネットワークからのインプレッションレベルの収益

ユーザプロファイルデータの取得 #

フルプロファイルオブジェクトの取得 #

すべてのメトリックを含むUserProfileDataオブジェクトを返します。

Java

import com.tenjin.android.TenjinSDK;
import com.tenjin.android.userprofile.UserProfileData;

TenjinSDK instance = TenjinSDK.getInstance(this, "<SDK_KEY>");
UserProfileData profile = instance.getUserProfile();

// Session metrics
int sessionCount = profile.getSessionCount();
long totalTime = profile.getTotalSessionTime();
long avgLength = profile.getAverageSessionLength();
long lastSession = profile.getLastSessionLength();
long currentSession = profile.getCurrentSessionDuration();
Long firstSession = profile.getFirstSessionDate();
Long lastSessionDate = profile.getLastSessionDate();

// IAP metrics
int iapCount = profile.getIapTransactionCount();
Map<String, Double> revenueByCurrency = profile.getIapRevenueByCurrency();
List<String> productIDs = profile.getPurchasedProductIDs();

// ILRD metrics
double totalAdRevenue = profile.getTotalILRDRevenueUSD();
Map<String, Double> revenueByNetwork = profile.getIlrdRevenueByNetwork();

import com.tenjin.android.TenjinSDK;
import com.tenjin.android.userprofile.UserProfileData;

TenjinSDK instance = TenjinSDK.getInstance(this, "<SDK_KEY>");
UserProfileData profile = instance.getUserProfile();

// Session metrics
int sessionCount = profile.getSessionCount();
long totalTime = profile.getTotalSessionTime();
long avgLength = profile.getAverageSessionLength();
long lastSession = profile.getLastSessionLength();
long currentSession = profile.getCurrentSessionDuration();
Long firstSession = profile.getFirstSessionDate();
Long lastSessionDate = profile.getLastSessionDate();

// IAP metrics
int iapCount = profile.getIapTransactionCount();
Map<String, Double> revenueByCurrency = profile.getIapRevenueByCurrency();
List<String> productIDs = profile.getPurchasedProductIDs();

// ILRD metrics
double totalAdRevenue = profile.getTotalILRDRevenueUSD();
Map<String, Double> revenueByNetwork = profile.getIlrdRevenueByNetwork();

利用可能なプロパティ(Javaゲッター)：

メソッド	返却型	説明
`getSessionCount()`	`int`	トータルセッション数
`getTotalSessionTime()`	`long`	ミリ秒単位のトータルセッション時間
`getAverageSessionLength()`	`long`	ミリ秒単位の平均セッション
`getLastSessionLength()`	`long`	ミリ秒単位の最終完了セッション
`getCurrentSessionDuration()`	`long`	現在のミリ秒単位のアクティブセッション
`getFirstSessionDate()`	`Long`	最初のセッションのタイムスタンプ(エポックからのミリ秒)
`getLastSessionDate()`	`Long`	最終セッションのタイムスタンプ(エポックからのミリ秒)
`getIapTransactionCount()`	`int`	トータルのIAPカウント
`getIapRevenueByCurrency()`	`Map<String, Double>`	通貨コードごとの収益
`getPurchasedProductIDs()`	`List<String>`	ソートされたプロダクトID
`getTotalILRDRevenueUSD()`	`double`	トータルのUSD単位の広告収益
`getIlrdRevenueByNetwork()`	`Map<String, Double>`	ネットワークごとの広告収益

Dictionaryとしてプロファイルを取得 #

すべてのメトリックを含むマップを返します。これにより、簡単にシリアル化できます。

Java

Map<String, Object> profileDict = instance.getUserProfileDictionary();

// Example usage
Integer sessionCount = (Integer) profileDict.get("session_count");
String firstSession = (String) profileDict.get("first_session_date");
Map<String, Double> iapRevenue = (Map<String, Double>) profileDict.get("iap_revenue_by_currency");
List<String> productIds = (List<String>) profileDict.get("purchased_product_ids");

Map<String, Object> profileDict = instance.getUserProfileDictionary();

// Example usage
Integer sessionCount = (Integer) profileDict.get("session_count");
String firstSession = (String) profileDict.get("first_session_date");
Map<String, Double> iapRevenue = (Map<String, Double>) profileDict.get("iap_revenue_by_currency");
List<String> productIds = (List<String>) profileDict.get("purchased_product_ids");

辞書キー(常に表示):

キー	型	説明
`session_count`	`Integer`	トータルセッション
`total_session_time`	`Long`	ミリ秒単位のトータルセッション時間
`average_session_length`	`Long`	ミリ秒単位の平均セッション
`last_session_length`	`Long`	ミリ秒単位の最終完了セッション
`iap_transaction_count`	`Integer`	トータルのIAPカウント
`total_ilrd_revenue_usd`	`Double`	トータルのUSD単位の広告収益

辞書キー(条件付き – 利用可能な場合のみ):

キー	型	説明
`first_session_date`	`String`	ISO8601形式の日付
`last_session_date`	`String`	ISO8601形式の日付
`current_session_length`	`Long`	アクティブセッションの継続時間(ミリ秒)
`iap_revenue_by_currency`	`Map<String, Double>`	通貨マップ → 収益
`purchased_product_ids`	`List<String>`	ソートされたプロダクトID
`ilrd_revenue_by_network`	`Map<String, Double>`	ネットワークマップ → 収益

プロファイルのリセット #

ユーザープロファイルデータをすべて消去します。

Java

instance.resetUserProfile();

instance.resetUserProfile();

セッション構成 #

セッションタイムアウトをカスタマイズする(デフォルトは30分):

Java

UserProfileManager.setSessionTimeoutMs(600000); // 10 minutes

UserProfileManager.setSessionTimeoutMs(600000); // 10 minutes

イベントのキャッシュ/リトライ #

リクエストが失敗した場合、またはユーザーがインターネットに接続していない場合のイベントとIAPの再試行とキャッシュを有効/無効にできます。これらのイベントは、新しいイベントがキューに追加され、ユーザーが接続を回復した後に送信されます。

.setCacheEventSetting(setting: true)

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.setCacheEventSetting(setting: true);

TenjinSDK instance = TenjinSDK.getInstance(this, "");
instance.setCacheEventSetting(setting: true);

インプレッションレベル広告収益 #

Tenjinでは下記のメディエーションプロバイダにおいて、インプレッションレベルの広告収益(ILRD)をサポートしています。

AppLovin MAX
Unity LevelPlay
HyperBid
AdMob
TopOn
CAS
TradPlus

この機能を使用すると、ユーザーに表示された広告ごとに広告収益が影響を受けることを示すイベントを受信できます。実装ガイドへのアクセスはこちらです。

Google DMAパラメータ #

すでに CMPが実装されている場合、Google DMAパラメータはTenjin SDKによって自動的に収集されます。 Tenjin SDKでの追加実装は必要ありません。 CMPをオーバーライドしたい場合、または独自の同意メカニズムを使用したい場合は、以下メソッドを使用できます。

setGoogleDMAParameters(boolean, boolean)

Java

TenjinSDK instance = TenjinSDK.getInstance(this, "<sdk_key>");
instance.setGoogleDMAParameters(adPersonalization, adUserData);

TenjinSDK instance = TenjinSDK.getInstance(this, "");
instance.setGoogleDMAParameters(adPersonalization, adUserData);

Google DMAパラメータの収集を明示的に管理するために、いつでも柔軟にオプトインまたはオプトアウトできます。デフォルト設定はオプトインですが、OptInGoogleDMAまたは OptOutGoogleDMAメソッドを使用して設定を簡単に調整でき、データプライバシー設定を完全に制御できます。

Java

instance.optInGoogleDMA(); 
instance.optOutGoogleDMA();

instance.optInGoogleDMA(); 
instance.optOutGoogleDMA();

テスト #

You can verify if the integration is working through our Live Test Device Data Tool. Add your advertising_id to the list of test devices. You can find this under Support -> Test Devices. Go to the Live Event Tool page and send the test events from your app. You should see live events come in:

ハイブリッドカジュアル向け予測LTV

60 Days to Scale: How SuperGaming...

Android SDK実装ガイド #

基本実装 #

マニュアルインストール #

Maven #

Android Studio #

Google PlayまたはAmazonストア #

パーミッション #

Android広告ID (AAID)とインストールリファラ #

アプリストア設定 #

アプリストアオプション #

SDK初期化 #

その他のAndroidストア #

パーミッション #

Android広告ID (AAID)とインストールリファラ #

OAID #

MSA OAID #

Huawei OAID #

Huaweiインストールリファラ #

アプリストア設定 #

SDK初期化 #

難読化設定 #

追加実装 #

GDPR #

CMPを用いたオプトイン/アウト #

デバイスパラメータ #

アプリ内課金イベント #

カスタムイベント #

INTEGER型の値をvalueをカスタムイベントに含める方法 #

サーバ間連携 #

アプリサブバージョン #

LiveOpsキャンペーン #

カスタマーユーザーID #

Analytics Installation ID #

ユーザープロファイル – LiveOpsメトリクス #

自動トラッキング #

ユーザプロファイルデータの取得 #

フルプロファイルオブジェクトの取得 #

Dictionaryとしてプロファイルを取得 #

プロファイルのリセット #

セッション構成 #

イベントのキャッシュ/リトライ #

インプレッションレベル広告収益 #

Google DMAパラメータ #

テスト #

あなたの気持ちは？

この記事を共有する：

クリエイターエコノミーとは？なぜマイクロインフルエンサー(Micro-Influencers)がモバイルのユーザー獲得を再定義するのか

Tenjin、トルコ政府のインセンティブプログラムに正式認定

F2Pゲームにおけるユニット・エコノミクス：利益を生むフリーToプレイのビジネスモデル

TenjinのMCPサーバー：データを直接照会し、分析をもっとスムーズに