TalkingData統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| カスタムデータコールバック | コールバック | ユーザーレベル | ✅ | ✅ |
TalkingDataはカスタムデータコールバック機能を提供しており、この機能を使ってユーザーレベルのアクティベーションまたは登録データを取得できます
TalkingDataのモバイル広告データの統合を始める前に、AEシステムのユーザー識別ルールを読み、AEが#distinct_idと#account_idによってユーザーを識別する仕組みを理解しておいてください
統合の流れ
- TalkingDataクライアントSDKとAEクライアントSDKを導入し、TalkingData SDKでAEのユーザー識別IDを設定します
- AE管理画面にログインし、サードパーティ統合モジュールでTalkingData統合プランを追加して、関連する設定を完了し、コールバックURLをコピーします
- TalkingDataの管理画面にログインし、「管理センター」-「データ管理」ページで「データコールバックを追加」をクリックして、データをコールバックするプロジェクトとコールバックイベント（登録またはアクティベーション）を選択します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. クライアントSDKによるデータ送信
クライアントSDKでデータを送信する場合は、まずAppにTalkingData SDKとAE SDKを統合してください。TalkingDataのアクティベーションイベントをコールバックしたい場合は、次にTalkingData SDKの初期化時に、AE SDKのゲストIDをカスタムIDとして設定します：
// 先に AE SDK を初期化する
TDAnalytics.init(this, APPID, SERVER_URL);
// AE のゲスト ID を取得する（AE の #distinct_id に対応）
String distinctId = TDAnalytics.getDistinctId();
// TalkingData SDK を設定する
JLibrary.InitEntry(this); //1.0.13 移動安全聯盟（MSA）統一 SDK の初期化
TalkingDataSDK.init(this, "お使いの App ID", "チャネル ID", distinctId);
登録イベントをコールバックしたい場合は、AE SDKとTalkingData SDKに同じアカウントIDを設定します：
// アカウント ID を取得する
String accountId = "Account ID";
// AE SDK を設定する
TDAnalytics.login(accountId);
// TalkingData SDK を設定する
TalkingDataSDK.onRegister(accountId);
2. プランの設定
SDKの設定が完了したら、次にAEシステムの管理画面にログインし、「サードパーティ統合」モジュールでTalkingDataプランの設定を完了します。下図はTalkingDataカスタムデータコールバックプランの設定画面です：
2.1 ユーザー識別フィールド
TalkingDataのカスタムコールバックデータはユーザーレベルのデータであるため、ユーザー識別ルール、つまりTalkingData SDKで設定したAEシステムのユーザー識別IDを設定する必要があります。AEシステムはこの設定に基づき、コールバックデータを変換する際に、これらのフィールドをデータのユーザー識別フィールドとして設定します。
本ドキュメントの前のステップに従ってクライアントSDKを設定した場合は、次の設定を使用してください：
- アカウントIDの関連フィールド：ACCOUNTID
- ゲストIDの関連フィールド：CUSTOM
2.2 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、TalkingDataがコールバックしたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.3 ユーザープロパティの格納設定
デフォルトでは、AEシステムはTalkingDataのコールバックデータをユーザープロパティに書き込みません。ユーザーのアトリビューション情報フィールドなど、一部のフィールドをユーザーテーブルに書き込みたい場合は、まずルールをオンにして実行させ、プロパティマッピング機能でユーザーテーブルに書き込むフィールドを追加します。ソースプロパティ名にはフィールドの格納名を入力します：
格納するユーザープロパティは、以下のように追加することをお勧めします：
| ソースデータ名 | ターゲットプロパティ名 | 説明 |
|---|---|---|
| ADNETNAME | te_ads_object.media_source | メディアチャンネル |
| ADCAMPAIGN | te_ads_object.campaign_name | 広告キャンペーン名 |
| ADGROUP | te_ads_object.ad_group_name | 広告グループ名 |
| ADCREATIVE | te_ads_object.ad_name | 広告名 |
2.4 統合構成
統合構成モジュールでは、データ取得の詳細な設定を制御できます。たとえば、格納後のイベント名などです
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_mapping | 格納後のイベント名。カスタマイズできます。KeyはTalkingDataのコールバックデータの種類、Valueはそのイベントの格納後のイベント名です。Keyの選択肢：
|
2.5 ターミナルアドレス
システムレベルおよびプロジェクトレベルのデータ受信URLを設定している場合は、以下のようなリンクが表示されます。このアドレスをそのままコピーし、TalkingData管理画面のリアルタイムコールバック設定に貼り付けてください：
ここにアドレスが表示されない場合は、右上のメニュー「プロジェクト管理 → プロジェクト設定 → プロジェクト構成」でパブリックネットワークURLを設定してください。このアドレスは、AE SDKで設定するデータ受信URLです。設定後、TalkingDataのコールバック設定ページの「ターミナルアドレス」に戻ってターミナルアドレスをコピーしてください。
3. コールバックの設定
3.1 データコールバックの追加
TalkingDataのモバイル広告データを統合するには、TalkingDataのモバイル広告トラッキング管理画面にログインし、「管理センター」-「データ管理」タブで、すべてのデータコールバックを確認・設定できます。
- 次に「データコールバックを追加」をクリックすると、データコールバックの新規作成ページに移動します
- 続いて、データコールバックに名前を付け、データをコールバックするアプリを選択し、「コールバックイベント」でアクティベーション/登録イベントのいずれかを選択します。次に、AEシステムのTalkingDataプランのターミナルアドレスを「データ受信URL」に入力します
- 次にイベントパラメータを設定します。選択したコールバックイベントに応じて、3.2章の内容を参考に設定してください。設定が完了したら保存をクリックすると、コールバックの設定が完了します。
3.2 コールバックパラメータの設定
3.2.1 アクティベーションイベント
アクティベーションイベントをコールバックする場合は、下表のパラメータ名に従って各マクロの格納名を設定することをお勧めします：
| パラメータ名 | マクロ | 対応プラットフォーム | パラメータの説明 | サンプル |
|---|---|---|---|---|
| APPKEY | #APPKEY | 全プラットフォーム | Ad TrackingシステムにおけるAPPの一意な識別子 | 10691808c7dc494eba8afd44cdef1df7 |
| EVENTTIME | #EVENTTIME | 全プラットフォーム | イベントの発生時刻。13桁のunixタイムスタンプ | 1451379329000 |
| OSVERSION | #OSVERSION | 全プラットフォーム | デバイスのOSバージョン | 9.2 |
| DEVICETYPE | #DEVICETYPE | 全プラットフォーム | デバイスのタイプ | iPad4,4 |
| OAID | #OAID | Android | AndroidデバイスID | |
| OAID_MD5 | #OAID_MD5 | Android | Androidデバイスの暗号化ID | |
| OAID_MD5_1 | #OAID_MD5_1 | Android | Androidデバイスの暗号化ID | |
| ADVERTISINGID | #ADVERTISINGID | Android | 広告ID。Google Play Serviceが提供します | 4c30a866-30d6-4418-a6dc-0f702737bf58 |
| ADVERTISINGID_MD5 | #ADVERTISINGID_MD5 | Android | 広告の暗号化ID | |
| ANDROIDID | #ANDROIDID | Android | Androidデバイスの一意なデバイス識別番号 | |
| ANDROIDID_MD5 | #ANDROIDID_MD5 | Android | Androidデバイスの暗号化された一意なデバイス識別番号 | |
| ANDROIDID_MD5_1 | #ANDROIDID_MD5_1 | Android | Androidデバイスの暗号化された一意なデバイス識別番号 | |
| IMEI | #IMEI | Android | 移動体端末の国際識別番号 | 493002407599521 |
| IMEI2 | #IMEI2 | Android | 移動体端末の国際識別番号2 | |
| TDID | #TDID | 全プラットフォーム | TalkingDataの一意なデバイス識別番号 | hc5e59e1926ee0fe142b22610cdda14df |
| IP | #IP | 全プラットフォーム | イベント発生時のIP | 123.123.123.123 |
| SPREADURL | #SPREADURL | 全プラットフォーム | 6桁の短縮リンク。キャンペーンの一意な識別子 | Vx7b6c |
| SPREADNAME | #SPREADNAME | 全プラットフォーム | キャンペーン名 | “Domobプロモーション-素材1” |
| SPREADGROUP | #SPREADGROUP | 全プラットフォーム | キャンペーングループ名 | |
| UA | #UA | 全プラットフォーム | 広告をクリックしたデバイスのUA情報 | |
| CLICKIP | #CLICKIP | 全プラットフォーム | 広告をクリックしたデバイスのIP情報 | 123.123.123.123 |
| CLICKTIME | #CLICKTIME | 全プラットフォーム | 広告のクリック時刻。13桁のunixタイムスタンプ | 1451379329000 |
| ADNETNAME | #ADNETNAME | 全プラットフォーム | 広告ネットワークチャネル事業者の名前（英語の一意な識別子） | “Domob” |
| ADNETDESC | #ADNETDESC | 全プラットフォーム | 広告ネットワークチャネル事業者の説明（中国語の識別子。連携のアップグレードに伴い変更される場合があります） | “多盟” |
| CHANNELPACKAGEID | #CHANNELPACKAGEID | 全プラットフォーム | アプリに統合されたサブパッケージID。「channeled」とも呼ばれます | “jifeng_1” |
| CLICK | @_ | 全プラットフォーム | 関連するクリックのパラメータをjson形式で表したもの | {"a":"1","b":"2"} |
| ASSISTANT_CLICK_1 | #ASSISTANT_CLICK_1 | 全プラットフォーム | アシストクリック1のキャンペーン名 | |
| ASSISTANT_CLICK_2 | #ASSISTANT_CLICK_2 | 全プラットフォーム | アシストクリック2のキャンペーン名 | |
| ASSISTANT_CLICK_3 | #ASSISTANT_CLICK_3 | 全プラットフォーム | アシストクリック3のキャンペーン名 | |
| TD_SUBID | #TD_SUBID | 全プラットフォーム | サブチャネルID | |
| ACTIVE_TYPE | #ACTIVE_TYPE | 全プラットフォーム | アクティベーションタイプ | |
| FRAUD_PREVENTION | #FRAUD_PREVENTION | IOS Android | 不正防止フラグ | “0”は異常なし、“1”はIP異常のアクティベーション、“2”は時間差コンバージョン異常のアクティベーション、“3”は関連付け異常のアクティベーション、“4”はIP移動のアクティベーション（高度版不正防止のみ）、“5”はLAT異常のアクティベーション（高度版不正防止のみ）、“6”は新規デバイスのアクティベーション（高度版不正防止のみ）を表します。 |
| ATTRIBUTION_TYPE | #ATTRIBUTION_TYPE | IOS Android | アトリビューションソース | “click”はクリック由来、“impression”はインプレッション由来、“deeplink”はディープリンクによる起動由来を表します。 |
| ADCREATIVE | #ADCREATIVE | 全プラットフォーム | 広告クリエイティブ | |
| ADCAMPAIGN | #ADCAMPAIGN | 全プラットフォーム | キャンペーン | |
| ADGROUP | #ADGROUP | 全プラットフォーム | 広告グループ | |
| APPSTOREID | #APPSTOREID | IOS | App Store ID | 1046850159 |
| IDFA | #IDFA | IOS | iOSの広告トラッキング識別子 | 6C59CB5A-3091-4246-AA6E-9C025FE0E33B |
| MAC | #MAC | Android | IEEE 802規格に準拠したMACアドレス文字列 | AB:12:CD:34:EF:56 |
| CUSTOM | #CUSTOM | 全プラットフォーム | カスタムパラメータ | |
| CLICKTRACKID | #CLICKTRACKID | 全プラットフォーム | アクティベーションに対応するクリックのトラッキングID |
3.2.2 登録イベント
登録イベントをコールバックする場合は、下表のパラメータ名に従って各マクロの格納名を設定することをお勧めします：
| パラメータ分類名 | 置換マクロ | 対応プラットフォーム | パラメータの説明 | サンプル |
|---|---|---|---|---|
| SPREADURL | #SPREADURL | 全プラットフォーム | 6桁の短縮リンク。キャンペーンの一意な識別子 | Vx7b6c |
| SPREADNAME | #SPREADNAME | 全プラットフォーム | キャンペーン名 | “Domobプロモーション-素材1” |
| UA | #UA | 全プラットフォーム | 広告をクリックしたデバイスのUA情報 | |
| CLICKIP | #CLICKIP | 全プラットフォーム | 広告をクリックしたデバイスのIP情報 | 123.123.123.123 |
| CLICKTIME | #CLICKTIME | 全プラットフォーム | 広告のクリック時刻。13桁のunixタイムスタンプ | 1451379329000 |
| CLICK | @_ | 全プラットフォーム | 関連するクリックのパラメータをjson形式で表したもの | {"a":"1","b":"2"} |
| ACCOUNTID | #ACCOUNTID | 全プラットフォーム | イベント発生時のアプリ内のアカウント | |
| APPKEY | #APPKEY | 全プラットフォーム | Ad TrackingシステムにおけるAPPの一意な識別子 | 10691808c7dc494eba8afd44cdef1df7 |
| EVENTTIME | #EVENTTIME | 全プラットフォーム | イベントの発生時刻。13桁のunixタイムスタンプ | 1451379329000 |
| OSVERSION | #OSVERSION | 全プラットフォーム | デバイスのOSバージョン | 9.2 |
| DEVICETYPE | #DEVICETYPE | 全プラットフォーム | デバイスのタイプ | iPad4,4 |
| IDFA | #IDFA | IOS | iOSの広告トラッキング識別子 | 6C59CB5A-3091-4246-AA6E-9C025FE0E33B |
| MAC | #MAC | Android | IEEE 802規格に準拠したMACアドレス文字列 | AB:12:CD:34:EF:56 |
| ADVERTISINGID | #ADVERTISINGID | Android | 広告ID。Google Play Serviceが提供します | 4c30a866-30d6-4418-a6dc-0f702737bf58 |
| ANDROIDID | #ANDROIDID | Android | Androidデバイスの一意なデバイス識別番号 | |
| IMEI | #IMEI | Android | 移動体端末の国際識別番号 | 493002407599521 |
| TDID | #TDID | 全プラットフォーム | TalkingDataの一意なデバイス識別番号 | hc5e59e1926ee0fe142b22610cdda14df |
| IP | #IP | 全プラットフォーム | イベント発生時のIP | 123.123.123.123 |
| ADNETNAME | #ADNETNAME | 全プラットフォーム | 広告ネットワークチャネル事業者の名前（英語の一意な識別子） | “Domob” |
| ADNETDESC | #ADNETDESC | 全プラットフォーム | 広告ネットワークチャネル事業者の説明（中国語の識別子。連携のアップグレードに伴い変更される場合があります） | “多盟” |
| CHANNELPACKAGEID | #CHANNELPACKAGEID | 全プラットフォーム | アプリに統合されたサブパッケージID。「channeled」とも呼ばれます | “jifeng_1” |
| DEEPLINK | #DEEPLINK | 全プラットフォーム | ディープリンク |
4. データの格納ルール
4.1 アクティベーションイベントの格納ルール
- デフォルトでは、データ内のCUSTOMをデータのゲストIDとして使用します。このフィールドはAEプロジェクトのゲストIDに対応している必要があります
- データ内のEVENTTIMEフィールド、つまりデータの時間を、イベントの#event_timeとして使用します
- データのイベント名は talkingdata_init_data です
- コールバックリンクで設定したその他のフィールドはすべて格納されます
4.2 登録イベントの格納ルール
- デフォルトでは、データ内のACCOUNTIDをデータのアカウントIDとして使用します。このフィールドはAEプロジェクトのアカウントIDに対応している必要があります
- データ内のEVENTTIMEフィールド、つまりデータの時間を、イベントの#event_timeとして使用します
- データのイベント名は talkingdata_register_data です
- コールバックリンクで設定したその他のフィールドはすべて格納されます
4.3 標準化フィールド
TalkingDataのコールバックデータの一部のフィールドについて、AEシステムは標準化処理を行います：
| フィールド | 標準化フィールド | 意味 |
|---|---|---|
| ADCAMPAIGN | te_ads_object.campaign_name | 広告キャンペーン名 |
| ADGROUP | te_ads_object.ad_group_name | 広告グループ名 |
| ADCREATIVE | te_ads_object.ad_name | 広告名 |
| ADNETNAME | te_ads_object.media_source | メディアチャンネル |
| APPSTOREID | te_ads_object.app_id | アプリID |
5. 備考
アクティベーションイベントのCUSTOMまたは登録イベントのACCOUNTIDがAEプロジェクトのゲストID、アカウントIDと対応しない場合、これらのイベントは1人の仮想ユーザー（ゲストIDはwithout_id）に紐づけられます。仮想ユーザーに紐づいたこれらのイベントデータを後からAEプロジェクトの実際のユーザーに関連付けるには、TalkingDataのtd_idを該当ユーザーのユーザープロパティに設定し、その後データの遡及処理によってユーザーデータを連携させる必要があります。
String td_id = TalkingDataAppCpa.getDeviceId(this);
try {
// td_id をユーザープロパティとして設定する
JSONObject properties = new JSONObject();
properties.put("td_id",td_id);
TDAnalytics.userSet(properties);
} catch (JSONException e) {
e.printStackTrace();
}