SDK実装をテストする方法 #
When sending events to Tenjin, it’s useful to use Tenjin’s Live Event Tool to debug if events are firing as expected. Any events sent through a test device (to the Live Event Tool) will not get recorded in the dashboard reporting.
ライブイベントツールはこちらにあります。
ライブイベントツールの使い方 #
ツールを使用してアプリからリアルタイムでイベントをデバッグおよびトラックするには:
- 管理画面のDIAGNOSEにカーソルを合わせ、Test Devicesをクリックします。

- + New Test Deviceをクリックし、イベントの送信に使用するデバイスを追加します。

- アプリを選択し、テストデバイスの広告IDを入力します。 iOSの場合はIDFAまたはIDFV、Androidの場合はGAID(Google Advertising ID)を使用します。

- Navigate back to the Live Event tool and open your app with the Tenjin SDK installed on the test device that you submitted your advertising ID for. If your events are firing correctly, you will see them appear in the event list, as shown below. If you register the test device just now, please allow upto 3 hours before you fire the event.

使用用途 Search, アプリ と Test Devices to narrow the list. Click an event to expand it and see its full details, such as the event, device, app and SDK, and Attribution information. Use Fields to choose which details are shown.

SDK実装チェック #
Tenjinのダッシュボードでは、各アプリにおいてTenjin SDKが正しく実装されているかどうかをリアルタイムで確認できます。Appsタブから対象のアプリを選択し、そのSDKタブを開くと、Tenjin SDK Integration Statusの表で関連するすべてのイベントを確認できます。これにより、実装の設定を行いながら、Tenjin SDKが適切にセットアップされているかを確認することが可能です。

アプリバージョンごとに、起動イベント、Apple Adsインストール(iOSの場合)/Androidリファラ(Androidの場合)、広告インプレッション、アプリ内課金イベントのレシート検証、カスタムイベントの送信有無が表示されています。
SDK実装チェックリスト #
アプリのサブミッションの前に、デバッグツールを用いて下記のチェックリストが網羅されていることを確認してください。
TestFlight アプリを使用している場合、advertising_idを登録しても、SDK Live Event ツールにイベントは表示されません。これは、Appleのポリシーによると、ユーザーがアプリを開くたびにTestFlightが新しいadvertising_idを使用するためです。
- アプリ起動
仕様どおりのタイミングで、アプリ起動イベントが発生することを確認します。アプリ起動イベントは、指定したアプリのアクティビティライフサイクルに従って、SDKの初期化のタイミングで自動的に発生します。
- Apple Searchによるインストール数 (iOS)
TenjinはSDKを通じてApple Adsアトリビューションを自動的に取得します。追加のキャンペーン設定(トラッキングリンク、コールバックなど)は不要です。手順: Tenjin iOS SDK
- Androidリファラーインストール
広告IDが利用できない場合、Androidリファラーがトラッキングに使用されます。以下の点をご確認ください。
- Googleのインストールリファラーライブラリを追加したことを確認してください。
dependencies {
implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
implementation 'com.android.installreferrer:installreferrer:{version}'
}- アプリ内課金
Tenjinには6種類のpurchase_stateがあります。サンドボックスアカウントで行われたアプリ内課金(IAP)のpurchase_stateは「4」となります。Tenjin SDK経由で受信したpurchase_stateが「3」の場合のみ、レポートダッシュボードに表示されます(S2Sで受信したpurchase_stateが「0」の課金もダッシュボードに反映されます)。そのため、SDK Live Toolを使用してテストを行うことが非常に重要です(サンドボックスでのIAPが確認できるのはこのツール上のみです)。IAPの購入金額は、1.99のような小数値として扱われます。
注: レシート検証のバイパス
アプリストア外での購入など、購入による収益をレシート検証の対象外とする場合は、アプリのEdit設定に移動し、Accept Unvalidated Purchasesのチェックボックスを有効にしてください。
購入時には、さまざまな購入パラメータの組み合わせを使用して、通貨コード、価格、product_id、数量が適切に送信されていることを確認してください。つまり、円、米ドル、またはカナダドルで購入してみてください。
The different purchase states in Tenjin are:
0 = UNKNOWABLE (there was no receipt and there is no way for tenjin to validate with the app store)
1 = UNVERIFIED (there was a receipt but there was an error with the app store validation)
2 = FRAUDULENT (the purchase was fraudulent)
3 = VERIFIED (the receipt was successfully validated with the app store)
4 = SANDBOX (this was a test purchase)
5 = DUPLICATE (there are duplicate purchases sent for the same transaction_id)
6 = STALE (the purchase event happened 3 days ago and not in real time)- サブスクリプション課金(存在する場合)
- カスタムイベント
すべての実装済みのカスタムイベントで、正しい値とイベント名が表示されていることを確認してください。
- 広告メディエーションインプレッション
Tenjinは、以下のプロバイダーとのImpression Level Ad Revenue (LRD)連携をサポートしています。
- AppLovin MAX
- Unity Level Play
- AdMob
- TopOn
- CAS
- Tradplus
この機能を使用すると、ユーザーに表示される各広告によって影響を受ける広告収益に対応するイベントを受け取ることができます。