Airbridge Actuals Report
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 露出 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Actuals Report | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
Airbridge Actuals Reportは、コスト、露出、クリック、コンバージョンなどの指標を含む集計レポートデータを提供します。この統合プランは、AE管理画面でAirbridgeのレポートデータを定期的に取得するためのもので、インターフェースは非同期タスク方式を採用しています：AEはまずレポートタスクを作成し、次にタスクのステータスをポーリングして、タスクの完了後に結果をページ単位で読み取ります。
統合の流れ
- Airbridge管理画面で認証情報
app_nameとapi_tokenを取得します - AE管理画面にログインし、サードパーティ統合モジュールでAirbridge Actuals Reportプランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. Airbridgeの認証情報の取得
Airbridge Actuals Reportを使用する前に、次の認証情報を用意する必要があります。
| 認証情報 | 必須 | 意味 |
|---|---|---|
| app_name | はい | Airbridgeのアプリ名。APIリクエストパスの組み立てに使用します |
| api_token | はい | AirbridgeのAPI呼び出し用クレデンシャル |
2. プランの設定
Airbridgeの認証情報を取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はAirbridge Actuals Reportの設定画面です。本章の内容に従ってプランを作成してください：
2.1 認証情報の設定
認証情報の設定で、Airbridgeから取得したapp_name、api_tokenを入力します。
2.2 定期取得
プランの定期取得の頻度を設定できます。有効にすると、AEシステムは設定した周期でAirbridgeにActuals Reportのデータ取得タスクを送信します。
Airbridge Actuals Reportで取得できる時間範囲は最大で過去1000日間で、1回あたり最大400日分を取得できます。
2.3 イベントデータの格納設定
データをイベントとして書き込むかどうかを制御できます。「イベントデータの格納設定」スイッチをオンにすると、AEシステムはAirbridge Actuals Reportで取得した集計データをイベントテーブルに書き込みます。
イベントデータの格納を有効にすることをお勧めします。この設定をオフにすると、取得したデータはイベントテーブルに書き込まれず、以降イベント分析で使用できなくなります。
2.4 統合構成
統合構成は、Airbridge Actuals Reportのデータ取得と格納の基準を定義するためのもので、指標、ディメンション、時間粒度、日付範囲、格納後のイベント名、拡張パラメータが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 必須 | 意味 |
|---|---|---|---|
source | metrics | はい | 取得する指標のリスト |
| group_by | はい | データを集計するディメンション | |
| time_granularity | はい | 時間粒度。現在はdayのみ対応しています | |
| ルート設定 | date_range | はい | 毎回取得する日付範囲 |
| sink_event | event_name | はい | 格納後のイベント名。カスタマイズ可能 |
| extra_params | filters | いいえ | Airbridgeのフィルター条件 |
| sorts | いいえ | Airbridgeの並べ替え条件 |
{
"source": {
"metrics": [
"app_events",
"app_installs",
"impressions",
"impressions_channel",
"clicks_channel",
"cost_channel"
],
"group_by": [
"ad_account_id",
"campaign_id",
"ad_group_id",
"ad_creative_id",
"event_date",
"channel"
],
"time_granularity": "day"
},
"date_range": "0,1",
"sink_event": {
"event_tracking": true,
"event_name": "airbridge_event_data"
},
"extra_params": {}
}
2.4.1 指標の設定
metricsは、取得するAirbridgeの指標を設定するために使用します。一般的な指標には、イベント数、インストール数、表示数、クリック数、コスト、収益などがあります。
| 指標フィールド | 意味 | 構成の説明 |
|---|---|---|
| app_events | アプリ内イベント数 | 設定例 |
| app_installs | アプリのインストール数 | 設定例 |
| impressions | 表示数 | 設定例 |
| impressions_channel | チャンネル表示数 | 設定例 |
| clicks_channel | チャンネルクリック数 | 設定例 |
| cost_channel | チャンネルコスト | 設定例 |
| app_total_revenue | アプリの総収益 | 任意設定 |
2.4.2 グループ化ディメンション
group_byは、レポートの集計ディメンションを設定するために使用します。Airbridgeのレスポンス内のgroupBysは、リクエスト内のgroup_byの順序で返されます。
| グループ化ディメンション | 格納フィールド名 | タイプ | 構成の説明 | 備考 |
|---|---|---|---|---|
| ad_account_id | ad_account_id | 文字列 | 設定例 | 広告アカウントID |
| campaign_id | campaign_id | 文字列 | 設定例 | 広告キャンペーンID |
| ad_group_id | ad_group_id | 文字列 | 設定例 | 広告グループID |
| ad_creative_id | ad_creative_id | 文字列 | 設定例 | 広告クリエイティブID |
| event_date | event_date | 日付 | 設定例 | データ日付 |
| channel | channel | 文字列 | 設定例 | チャネル |
| platform | platform | 文字列 | 任意設定 | プラットフォーム |
| event_type | event_type | 文字列 | 任意設定 | イベントタイプ |
| event_source | event_source | 文字列 | 任意設定 | イベントソース |
| event_category | event_category | 文字列 | 任意設定 | イベントカテゴリー |
解析時や格納時に
group_byの順序を変更しないでください。順序が変わると、ディメンション値がずれる可能性があります。
2.4.3 拡張パラメータ
Airbridge Actuals Reportはフィルターと並べ替えに対応しています。extra_paramsでfiltersとsortsを設定できます。
| 構成項目 | 必須 | 説明 |
|---|---|---|
| extra_params.filters | いいえ | フィルター条件。dimensionはsource.group_byに含まれている必要があります |
| extra_params.sorts | いいえ | 並べ替え条件。fieldNameはsource.group_byまたはsource.metricsに含まれている必要があります |
設定例：
{
"extra_params": {
"filters": [
{
"dimension": "channel",
"filterType": "IN",
"values": [
"App"
]
}
],
"sorts": [
{
"fieldName": "event_date",
"isAscending": true
}
]
}
}
2.5 設定の制限
| モジュール | 制限項目 | ルール |
|---|---|---|
| 定期取得 | 1回あたりのクエリ時間枠 | 最大400日 |
| クエリ時間範囲 | 最大1000日 | |
| 統合構成 | source.group_by | 最大10個 |
| source.metrics | 最大20個 | |
| extra_params.filters[].dimension | source.group_byに含まれている必要があります | |
| extra_params.sorts[].fieldName | source.group_byまたはsource.metricsに含まれている必要があります |
2.6 イベントの格納ルール
Airbridge Actuals Reportのレポート結果はフラットなフィールドオブジェクトではなく、groupBysとvaluesで構成されています。
- Actuals Reportが返すのは集計データであるため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えることができます。
- データ内の
event_dateフィールド（つまりデータ日付）を、集計データの#event_timeとして設定します。 - テンプレートで使用されるイベント名は
airbridge_event_dataです。変更する場合は、sink_event.event_nameを調整してください。 groupBysは、リクエスト内のsource.group_byの順序で返されます。- 格納時には、同じ順序で
groupBys配列内の値を対応するディメンションフィールドに書き込みます。 values.<metric>.valueは指標値としてイベントプロパティに書き込まれます。- その他の識別可能な指標フィールドとディメンションフィールドはすべて格納されます。
- 指標が
isMasked=trueを返した場合、その指標値はAirbridgeによってマスキングまたは非表示にされていることを示します。分析時には注意が必要です。 - レスポンスに
notificationsが含まれる場合、Airbridgeが集計結果に対して通知または処理を行ったことを示します。データの差異を調査する際の参考にすることをお勧めします。
例：
{
"groupBys": [
"2026-06-02",
"facebook.business",
"120239009297780452"
],
"values": {
"app_events": {
"value": 2,
"isMasked": false
}
}
}
リクエスト内のgroup_byが["event_date", "channel", "campaign_id"]の場合、上記のデータは次のようにマッピングされます：
| 格納フィールド | 格納値 |
|---|---|
| event_date | 2026-06-02 |
| channel | facebook.business |
| campaign_id | 120239009297780452 |
| app_events | 2 |
2.7 標準化フィールド
Airbridgeのフィールドは、AEシステムの広告標準オブジェクトte_ads_objectに従って標準化できます。ただし、最終的なマッピング関係は、Airbridgeのフィールドの意味とAEシステムの共通フィールドの定義を照らし合わせて確認したうえで公開する必要があります。
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| ad_account_id | te_ads_object.ad_account_id | 広告アカウントID |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| campaign | te_ads_object.campaign_name | 広告キャンペーン名 |
| ad_group_id | te_ads_object.ad_group_id | 広告グループID |
| ad_group | te_ads_object.ad_group_name | 広告グループ名 |
| ad_creative_id | te_ads_object.ad_id | 広告ID |
| ad_creative | te_ads_object.ad_name | 広告名 |
| channel | te_ads_object.media_source | メディアソース |
| platform | te_ads_object.platform | プラットフォーム |
| country | te_ads_object.country | 国・地域 |
| currency | te_ads_object.currency | 通貨 |
| agency_of_the_tracking_link_creator | te_ads_object.agency | 代理店 |
| app_package_name | te_ads_object.app_id | アプリID |
| airbridge_app_name | te_ads_object.app_name | アプリ名 |
| impressions_channel | te_ads_object.impressions | 露出 |
| clicks_channel | te_ads_object.clicks | クリック |
| cost_channel | te_ads_object.cost | 広告コスト |
| app_installs | te_ads_object.installs | インストール |
3. その後の利用
3.1 データ格納の確認
プランを保存して有効にした後、AEシステムでsink_event.event_nameに対応するイベントにデータが格納されているかどうかを確認できます。
3.2 単発のデータ取得
指定した日付範囲のデータを一時的に追加取得する必要がある場合は、一回取得機能を使用できます。追加取得の際も、Airbridge Actuals Reportの日付範囲の制限に従う必要があります。
1回の追加取得の日付範囲は400日を超えることはできません。
3.3 データ差異の調査
AEシステムのデータがAirbridge管理画面の表示と一致しない場合は、まず次の設定を確認することをお勧めします：
date_rangeと取得タイムゾーンがAirbridgeのレポートの集計基準に合っているか。metricsとgroup_byがAirbridge管理画面のレポートで選択した内容と一致しているか。filtersとsortsが返される結果に影響していないか。- ページ分割された結果をすべて読み取ったか。
- 返された結果に
isMasked=trueまたはnotificationsが含まれていないか。