Moloco Report API
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Report API | API | 集約指標 | ✅ | ✅ | ✅ | ✅ | ✅ |
Report APIは集計データのインターフェースです。一定期間内の指標データを返し、コスト、収益、表示、クリック、コンバージョンなどのデータが含まれます
統合の流れ
- Molocoアカウントにログインし、API Keyを作成します
- AE管理画面にログインし、サードパーティ統合モジュールでMoloco Report APIプランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. Moloco管理画面での情報の取得
1.1 API Keyの取得
APIを呼び出す前に、まずAPI Keyを取得する必要があります。Molocoアカウントにログインし、右上のユーザー設定メニューで「API Access」セクションを探します。
次に、「Create API Key」をクリックして新しいMoloco API Keyを作成します。以前にAPI Keyを作成したことがある場合は、既存のAPI Keyをそのまま使用することもできます。API Keyの値は控えておいてください。
1.2 広告アカウントIDの取得
続いて、データを取得するすべての広告アカウントのIDも取得する必要があります。広告アカウントIDの取得方法は下図を参照してください。複数の広告アカウントを設定できるため、データを取得するすべての広告アカウントのIDを取得しておくことをお勧めします
2. プランの設定
Molocoの認証情報を取得したら、AEシステムの管理画面にログインし、「サードパーティ統合」モジュールでMoloco Report APIの設定を完了します。下図はMolocoの設定画面です：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップにMolocoの管理画面で取得した情報を入力します
- API Key：Molocoで作成したAPI Keyを入力してください
- Ad Account ID：データを取得する広告アカウントのID。複数ある場合は "," で区切ってください
2.2 定期取得
「定期取得」モジュールで、AEシステムがMoloco Report APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、長すぎる期間のデータを定期取得しないことをお勧めします
2.3 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.4 統合構成
統合構成モジュールでデータ取得の詳細な設定を制御できます。たとえば、格納後のイベント名やデータ取得のディメンションなどです。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
| source | group_by | データ内のグループ化ディメンション。リスト型です |
| transfer | double_columns | 格納する指標フィールドです。変更しないでください |
- グループ化ディメンション
以下は対応しているグループ化ディメンションです。デフォルトではすべてのディメンションのデータを取得します。各ディメンションは複数の格納フィールドに対応しており、その対応関係は下表で確認できます。調整が必要な場合は、source.group_byを編集し、取得したいグループ化ディメンションのディメンション名を記述してください
| ディメンション | 格納フィールド名 | デフォルトかどうか | 説明 |
|---|---|---|---|
| デフォルトで含まれる | ad_account_currency | はい | 広告アカウントで使用している通貨 |
| ad_account_id | はい | 広告アカウントID | |
| ad_account_title | はい | 広告アカウント名 | |
| DATE | date | はい | 日付 |
| APP_OR_SITE | app_id | はい | Appの一意なID |
| app_os | はい | Appのプラットフォーム | |
| app_store_id | はい | APPのアプリストアID | |
| app_title | はい | App名 | |
| site_domain | はい | サイトのドメイン | |
| site_id | はい | サイトID | |
| site_title | はい | サイト名 | |
CAMPAIGN | campaign_country | はい | 広告キャンペーンの対象国・地域 |
| campaign_id | はい | 広告キャンペーンID | |
| campaign_title | はい | 広告キャンペーン名 | |
| AD_GROUP | ad_group_id | はい | 広告グループID |
| ad_group_title | はい | 広告グループ名 | |
| CREATIVE_GROUP | creative_group_id | はい | 素材グループID |
| creative_group_title | はい | 素材グループ名 | |
CREATIVE | creative_id | はい | 素材ID |
| creative_main_asset_location | はい | 素材のURL | |
| creative_title | はい | 素材名 | |
| creative_type | はい | 素材タイプ | |
| EXCHANGE | exchange_id | はい | 取引の一意なID |
SUB_PUBLISHER | sub_publisher_id | はい | Sub Publisher ID |
| sub_publisher_title | はい | Sub Publisher名 | |
| TRAFFIC | traffic_is_lat | はい | LATが有効かどうか（ブール値） |
| traffic_mmp_effective | はい | アトリビューション可能かどうか | |
| traffic_skan_bid | はい | SKANのレスポンスを含むかどうか |
- 指標フィールド
以下は対応している指標フィールドです：
| フィールド | 説明 |
|---|---|
| impressions | 露出数 |
| clicks | クリック数 |
| installs | インストール数 |
| spend | ユーザー獲得コスト |
| revenue | マネタイズ収益 |
2.5 格納ルール
- データ内のdateフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- Report APIデータのデフォルトのイベント名は -- moloco_report です
- その他のフィールドはすべて格納されます
2.6 標準化フィールド
次のイベントプロパティは標準化処理されます：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| ad_account_id | te_ads_object.ad_account_id | 広告アカウントID |
| campaign_title | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| ad_group_title | te_ads_object.ad_group_name | 広告グループ名、マネタイズ広告のUnit名 |
| ad_group_id | te_ads_object.ad_group_id | 広告グループID、マネタイズ広告のUnit ID |
| creative_group_title | te_ads_object.ad_name | 広告名 |
| creative_group_id | te_ads_object.ad_id | 広告ID |
| app_store_id | te_ads_object.app_id | アプリID |
| app_title | te_ads_object.app_name | アプリ名 |
| app_os | te_ads_object.platform | プラットフォーム（Android、iOSなど） |
| campaign_country | te_ads_object.country | 国・地域コード |
| ad_account_currency | te_ads_object.currency | コストまたは収益の通貨 |
| impressions | te_ads_object.impressions | 露出数 |
| clicks | te_ads_object.clicks | クリック数 |
| installs | te_ads_object.installs | コンバージョン数（インストール） |
| spend | te_ads_object.cost | ユーザー獲得コスト |
| revenue | te_ads_object.revenue | マネタイズ収益 |