Airbridgeリアルタイムコールバック統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 露出 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Callbacks | コールバック | ユーザーレベル | ✅ | ✅ | ✅ |
Callbacksインターフェースは、Airbridgeのユーザーレベルのデータをリアルタイムに提供しており、広告の露出、クリック、コンバージョンなどのデータが含まれます。
Airbridgeデータの統合を始める前に、AEシステムのユーザー識別ルールを読み、AEが#distinct_idと#account_idによってユーザーを識別する仕組みを理解しておいてください。
統合の流れ
- AirbridgeクライアントSDKとAE SDKを統合し、Airbridge SDKでAEのユーザー識別IDを設定します
- AE管理画面にログインし、サードパーティ統合モジュールでAirbridgeリアルタイムコールバックプランを追加して、関連する設定を完了します
- Airbridge管理画面にログインし、コールバックの設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. クライアントSDKの設定
Airbridgeデータを統合する最初のステップは、クライアント側でAE SDKとAirbridge SDKを連携させ、Airbridge SDKでAEシステムのユーザー識別IDを設定することです。
このステップはデータ連携全体の要となるもので、Airbridgeが収集するデータにAEのゲストIDまたはアカウントIDが含まれるようにします。
- IDの取得： Airbridge SDKの初期化前または初期化中に、ThinkingData SDKのインターフェースを呼び出して、現在のユーザーのゲストIDまたはアカウントIDを取得します。
- プロパティの設定： 取得したIDをAirbridgeのUser AliasまたはCustom User Propertyとして設定します。
各プラットフォームのSDKのコードサンプルは次のとおりです：
- Android
//Android // Default Auto Start Tracking Enabled = true
val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
.setAutoStartTrackingEnabled(false)
.build()
Airbridge.initializeSDK(this, option)
Airbridge.setDeviceAlias("ADD_YOUR_KEY", "AND_YOUR_VALUE");
Airbridge.startTracking()
- iOS
let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
.setAutoStartTrackingEnabled(true)
.build()
Airbridge.initializeSDK(option: option)
Airbridge.setDeviceAlias(key: "string", value: "string")
Airbridge.startTracking()
- Unity
Refer ：https://help.airbridge.io/en/developers/unity-sdk-v4
- Unreal
以上の設定を行うと、コールバックデータのcustom_dataにta_distinct_idフィールドが含まれるようになります。
2. プランの設定
SDKの設定が完了したら、次にAEシステムの管理画面にログインし、「サードパーティ統合」モジュールでAirbridgeの設定を行います。下図はAirbridgeの設定画面です：
2.1 ユーザー識別フィールド
Airbridgeがコールバックするのはユーザーレベルのデータであるため、ユーザー識別ルール、つまりAirbridgeのコールバックデータ内で#distinct_idと#account_idに対応するフィールドを設定する必要があります。AEシステムはこの設定に基づき、コールバックデータを変換する際に、これらのフィールドをデータのユーザー識別フィールドとして設定します。
本ドキュメントの前のステップに従ってクライアントSDKを設定した場合は、次の設定を使用してください：
- ゲストID関連フィールド：custom_data.ta_distinct_id
2.2 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータ（アクティベーションイベントとアプリ内イベントを含む）はすべてイベントテーブルに書き込まれます
イベントデータの格納を有効にすることをお勧めします。ただし、デフォルトではAirbridgeがコールバックするすべてのデータを受信します。コールバックするイベントタイプが多すぎると、AEプロジェクトのイベント量が過度に増加します。そのため、Airbridgeプラットフォームでコールバックを設定する際は、必要なイベントのみを選択してコールバックすることをお勧めします。
現在対応しているAirbridgeのイベント一覧は次のとおりです：
| イベント名 event_name | 説明 |
|---|---|
| airbridge_user_signin | ユーザーログイン |
| airbridge_user_signout | ユーザーログアウト |
| airbridge_user_signup | ユーザー登録 |
| airbridge_adclick | 広告クリック |
| app_open | アプリを開く |
| app_deeplink_open | アプリのリンクを開く |
| airbridge_adimpression | 広告露出 |
| app_install | アプリのインストール |
2.3 標準化ユーザープロパティの格納設定
デフォルトでは、AEシステムはAirbridgeのコールバックデータ内のアトリビューションフィールドを、標準化処理後のユーザープロパティに自動的に書き込みます。ユーザープロパティに書き込まれるフィールドとその意味は次のとおりです：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| attributedCampaign | te_ads_object.campaign_name | 広告キャンペーン名 |
| attributedCampaignId | te_ads_object.campaign_id | 広告キャンペーンID |
| attributedAdGroup | te_ads_object.ad_group_name | 広告グループ名 |
| attributedAdGroupId | te_ads_object.ad_group_id | 広告グループID |
| attributedChannel | te_ads_object.media_source | メディアチャンネルまたはマネタイズチャンネル |
| originalCurrency | te_ads_object.currency | コストまたは収益の通貨 |
変更が必要な場合は、「設定ルール」をクリックして、下図のような格納ルールの設定ページに移動します
ここでは、ユーザープロパティをどのイベントから取得するかを変更できます。ユーザープロパティが頻繁に書き込まれないようにしたい場合は、「すべてのイベントを含む」をオフにし、ソースイベント名をinstallに変更します。このように設定すると、AEシステムはAirbridgeがコールバックしたinstallイベントからのみ、ユーザープロパティに書き込む必要があるフィールドを抽出して書き込みます。格納の方法はデフォルトでuser_setOnceで、初回に送信された情報のみが保持されます。
ユーザープロパティの格納を無効にしたい場合は、すべてのルールを停止します：
2.4 ターミナルアドレス
ターミナルアドレスには、AEシステムがAirbridgeのコールバックデータを受信するアドレスが表示されます。このアドレスをそのままコピーし、この後のAirbridgeのコールバック設定で入力してください：
ここにアドレスが表示されない場合は、右上のメニュー「プロジェクト管理 → プロジェクト設定 → プロジェクト構成」でパブリックネットワークURLを設定してください。このアドレスは、AE SDKで設定するデータ受信URLです。設定後、Airbridge設定ページの「ターミナルアドレス」に戻ってターミナルアドレスをコピーしてください。
2.5 イベントの格納ルール
- データ内のevent_time_selected_timezoneフィールドを使用し、その時間とタイムゾーンの情報を取得して、時間を#event_time、タイムゾーンを#zone_offsetとして書き込みます。event_time_selected_timezoneが空の場合は、event_timeを#event_timeとして使用し、タイムゾーン#zone_offsetは0に設定されます
- データのイベント名は、そのイベントのAirbridgeでのイベント名です
- その他のフィールドはすべて格納されます
3. Airbridge Push APIの設定
AE管理画面での設定が完了したら、次に管理者アカウントでAirbridge管理画面にログインし、「Integration」-「Advertiser Postback」で図に示す部分を見つけて、次の方法でコールバックアドレスを設定します：
https://help.airbridge.io/en/guides/airbridge-event-types#list-of-standard-events
4. その後の利用
4.1 データ格納の確認
「データ管理」ページで、コールバックイベントやユーザープロパティが作成されているかどうかを確認できます。
また、イベント分析モデルやユーザープロパティ分析モデルなどの分析モデルで分析を行い、データが格納されているかどうかを確認することもできます。
4.2 レポートの提案
レポート作成に関するいくつかの提案を以下に示します：
- イベント分析モデルで、Airbridgeのコールバックデータを使用して広告配信と広告マネタイズの主要指標を構築し、広告分析レポートを作成します
- ファネル分析モデルで、インストールイベントを新規ユーザーのコンバージョンファネルに追加し、メディアチャンネルや広告キャンペーンなどの粒度で、流入元別のユーザーのコンバージョン状況を分析します