Moloco Log API
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
Moloco Log APIは廃止されており、AE管理画面では「Log API（廃止）」と表示されます。代わりにMoloco Report APIを使用することをお勧めします。
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Log API | API | ユーザーデータ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Log APIはユーザー粒度のローデータで、非常に豊富なユーザーデータを提供します。
統合の流れ
- Molocoアカウントにログインし、Workplace IDを取得します
- AE管理画面にログインし、サードパーティ統合モジュールでMoloco Log APIプランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 認証情報の取得
1.1 Workplace IDの取得
APIを呼び出す前に、まずWorkplace IDを取得する必要があります。Molocoアカウントにログインし、画面左側のサイドバーでSettingsボタンをクリックして設定ページに移動します。設定ページのInformationタブでWorkplace IDを取得できます。詳しくは下図を参照してください。
1.2 Molocoのアカウントとパスワードの準備
Moloco APIの呼び出しにはTokenが必要で、Tokenの生成にはMolocoのアカウントとパスワードが必要です。普段使用しているアカウントを直接使いたくない場合は、API呼び出し専用の新しいMolocoアカウントを作成することもできます。新しいアカウントの作成方法は下図を参照してください
1.3 広告アカウントIDの取得
最後に、データを取得するすべての広告アカウントのIDも取得する必要があります。広告アカウントIDの取得方法は下図を参照してください。複数の広告アカウントを設定できるため、データを取得するすべての広告アカウントのIDを取得しておくことをお勧めします
1.4 まとめ
Molocoの管理画面で以下の情報を取得する必要があります：
- Workplace ID
- Molocoのアカウント名（Email）
- Molocoアカウントのパスワード
- データを取得するすべての広告アカウントのID
2. プランの設定
Molocoの認証情報を取得したら、AEシステムの管理画面にログインし、「サードパーティ統合」モジュールでMoloco Log APIの設定を完了します。下図はMolocoの設定画面です：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに認証作業で取得した情報を入力します
以下を順に入力してください
- Workplace ID：先ほど取得したWorkplace ID
- Email：Molocoのアカウント名
- Password：Molocoアカウントのパスワード
- Ad Account ID：データを取得する広告アカウントのID。複数ある場合は "," で区切ってください
2.2 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.3 統合構成
統合構成モジュールでデータ取得の詳細な設定を制御できます。たとえば、格納後のイベント名やデータ取得のディメンションなどです。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_mapping | 格納後のイベント名。カスタマイズ可能で、レポートごとに異なる名前を付けられます。Keyの値はsource.report_typesに対応します |
| source | report_types | 取得するレポートのタイプ |
| transfer | double_columns | 格納する指標フィールドです。変更しないでください |
Log APIは、次の3種類の明細データを提供しています：
- IMP：露出データ（impression）です。表示データと表示のコストデータが含まれます
- CLICK：クリックデータです。クリックデータのほか、そのユーザーの過去の表示データと表示コストデータが含まれます
- CONVERSION：コンバージョンデータです。MMPから取得したコンバージョンデータ、アトリビューションデータ、コストデータ、収益データのほか、そのユーザーの過去の露出データとクリックデータが含まれます
- 3種類の明細データで返される具体的なフィールドとその意味については、Moloco公式ドキュメントを参照してください
Log APIの明細データはADID（GAID）とIDFAで個々のユーザーを識別しており、カスタムのユーザー識別フィールドを設定できません。そのため、AEシステムでは現在、ユーザー識別フィールドとユーザープロパティの格納機能を提供していません。Log APIで格納されるデータはイベントテーブルにのみ書き込まれ、すべてのデータは1人の仮想ユーザーに紐づきます。
デフォルトでは3種類のデータをすべて統合します。調整が必要な場合は、必要なレポート名をsource.report_typesに記述してください
2.3.1 共通フィールド
- 以下は3種類の明細データに共通するフィールドです：
| 格納フィールド名 | 説明 |
|---|---|
| req_exchange | 入札した広告取引プラットフォーム |
| req_timestamp | 入札リクエスト時間 |
| req_app_bundle | アプリパッケージ名 |
| req_app_publisher_id | パブリッシャーID |
| req_device_ifa | デバイスID（ADID、IDFAなど） |
| req_device_os | デバイスのプラットフォーム（ios、androidなど） |
| req_device_osv | デバイスのプラットフォームバージョン |
| req_device_carrier | デバイスの通信キャリア |
| req_device_connectiontype | デバイスのネットワーク状態 |
| req_device_hwv | デバイスのハードウェアバージョン |
| req_device_make | デバイスのメーカー |
| req_device_model | デバイスの機種 |
| req_device_devicetype | デバイスタイプ |
| req_device_language | デバイスの言語 |
| req_device_ip | デバイスのIPアドレス |
| req_device_lmt | LATが有効かどうか |
| req_device_geo_country | 国・地域コード |
| req_device_geo_utcoffset | タイムゾーンのオフセット（分） |
| req_device_geo_region | 米国の地域コード |
| req_device_geo_metro | Google metro code |
| req_device_geo_city | 都市 |
| req_device_geo_zip | 郵便番号 |
| req_imp_bidfloor | 最低入札価格 |
| req_imp_tagid | 広告PlacementまたはタグID |
| req_imp_banner_w | Bannerの幅 |
| req_imp_banner_h | Bannerの高さ |
| req_imp_video_maxduration | 動画の最長再生時間 |
| req_imp_video_minduration | 動画の最短再生時間 |
| req_imp_video_w | 動画の幅 |
| req_imp_video_h | 動画の高さ |
| req_imp_video_skip | 動画のスキップを許可するかどうか |
| req_imp_video_ext_is_rewarded | リワード動画かどうか |
| req_imp_native_ext_has_image | Banner広告を許可するかどうか |
| req_imp_native_ext_has_video | 動画広告を許可するかどうか |
| req_imp_instl | インタースティシャル広告を許可するかどうか |
| bid_mtid | Molocoの入札の一意なID |
| bid_advertiser_id | 広告主ID |
| bid_advertiser_title | 広告主名 |
| bid_campaign_id | Campaign ID |
| bid_campaign_title | Campaign名 |
| bid_adgroup_id | 広告グループID |
| bid_adgroup_title | 広告グループ名 |
| bid_creativegroup_id | 素材グループID |
| bid_creativegroup_title | 素材グループ名 |
| bid_creative_id | 素材ID |
| bid_creative_title | 素材名 |
| bid_creative_type | 素材タイプ |
| bid_creative_w | 素材の幅 |
| bid_creative_h | 素材の高さ |
| bid_creative_size_in_bytes | 素材のサイズ |
| bid_creative_video_duration | 動画の再生時間。動画でない場合は0 |
| bid_user_bucket | ユーザーのトラフィックグループ |
| bid_adslot_type | 広告スロットのタイプ |
| bid_adslot_w | 広告スロットの幅 |
| bid_adslot_h | 広告スロットの高さ |
2.3.2 IMPデータ（Impression）
以下はIMPデータ固有のフィールドです：
| 格納フィールド名 | 説明 |
|---|---|
| imp_timestamp | 露出時間 |
| imp_cost_moloco_micro | 露出の元の費用。米ドル建てで、100万倍した値 |
| imp_cost_currency | 露出の通貨 |
| imp_cost_fee_percent | 露出のサービス手数料。米ドル建てで、100万倍した値 |
| imp_cost_total_micro | 露出の総費用。米ドル建てで、100万倍した値 |
| imp_ip | IPアドレス |
- このうちimp_timestamp、つまり露出が発生した時間が、そのデータの#event_timeとして設定されます
- IMPデータのデフォルトのイベント名は -- moloco_log_imp です
2.3.3 CLICKデータ
以下はCLICKデータ固有のフィールドです：
| 格納フィールド名 | 説明 |
|---|---|
| click_timestamp | クリック時間 |
| click_type | クリックタイプ |
| click_ip | IPアドレス |
- このうちclick_timestamp、つまりクリックが発生した時間が、そのデータの#event_timeとして設定されます
- CLICKデータのイベント名は -- moloco_log_click です
2.3.4 CONVERSIONデータ
以下はCONVERSIONデータ固有のフィールドです：
| 格納フィールド名 | 説明 |
|---|---|
| conversion_mmp | パートナー |
| conversion_event | パートナーから取得したイベントのコールバック名 |
| conversion_timestamp | パートナーからデータを取得した時間 |
| conversion_attribution_timestamp | コンバージョンデータの時間 |
| conversion_attribution_is_view_through | ビュースルーコンバージョンかどうか |
| conversion_attribution_is_engaged_view_through | エンゲージビュースルーコンバージョンかどうか |
| conversion_revenue_amount | コールバックされた収益 |
| conversion_revenue_currency | コールバックされた収益の通貨 |
| conversion_revenue_amount_usd | コールバックされた米ドル建ての収益 |
| conversion_postback | 元のコールバックデータ |
- このうちconversion_attribution_timestamp、つまりアトリビューションが発生した時間が、そのデータの#event_timeとして設定されます
- CONVERSIONデータのイベント名は -- moloco_log_conversion です
2.4 標準化フィールド
次のイベントプロパティは標準化処理されます：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| bid_advertiser_id | te_ads_object.ad_account_id | 広告アカウントID |
| bid_campaign_title | te_ads_object.campaign_name | 広告キャンペーン名 |
| bid_campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| bid_adgroup_title | te_ads_object.ad_group_name | 広告グループ名、マネタイズ広告のUnit名 |
| bid_adgroup_id | te_ads_object.ad_group_id | 広告グループID、マネタイズ広告のUnit ID |
| bid_creativegroup_title | te_ads_object.ad_name | 広告名 |
| bid_creativegroup_id | te_ads_object.ad_id | 広告ID |
| req_device_os | te_ads_object.platform | プラットフォーム（Android、iOSなど） |
| req_device_geo_country | te_ads_object.country | 国・地域コード |
| 【USD】（固定値） | te_ads_object.currency | コストまたは収益の通貨 |
| imp_cost_total_micro | te_ads_object.cost | ユーザー獲得コスト |
| conversion_revenue_amount_usd | te_ads_object.revenue | マネタイズ収益 |