Molocoデータ統合ソリューション

最終更新 2026/10/05

最終更新日：2022-05-18

1. 統合プランの紹介

ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要

本記事では、MolocoのデータをAgentic Engine（以下、AEシステム）にコールバックする方法を説明します。本プランは次に対応しています：

• Moloco Report APIで、露出、クリック、インストール、収益、コストの指標を含む集約指標データをコールバック
• Moloco Log APIで、露出、クリック、コンバージョンのデータを含むユーザー粒度のローデータをコールバック

Molocoのデータの統合を始める前に、AEシステムのデータルールを読み、AEのデータ構造を理解しておいてください。また、データの取得に必要な情報を担当のカスタマーサクセスマネージャーにお渡しいただくことをお勧めします。形式はデータ統合設定情報テンプレートを参考にしてください。

流れ

Molocoのデータの統合の流れは次のとおりです：

1. Molocoアカウントにログインし、Workplace IDを取得します

2. API呼び出しに使用するMolocoのアカウント、パスワード、Workplace IDをThinkingAIの担当者に提供します

3. データの取得方法を決めます：

   1. Moloco Report APIで集約指標データをコールバック
   2. Moloco Log APIでユーザー粒度のローデータをコールバック

4. 取得するデータのディメンション、指標タイプ、取得頻度、取得する時間範囲を決めます

5. ThinkingAIの担当者がデータ取得の開発作業を行います

6. AE管理画面でダッシュボードやレポートを作成し、データ検証を完了します

2. 統合前の準備

2.1 Workplace IDの取得

APIを呼び出す前に、まずWorkplace IDを取得する必要があります。Molocoアカウントにログインし、画面左側のサイドバーでSettingsボタンをクリックして設定ページに移動します。設定ページのInformationタブでWorkplace IDを取得できます。詳しくは下図を参照してください。

図1：Workplace IDの取得方法

2.2 MolocoのアカウントとパスワードおよびWorkplace IDの提供

Moloco APIの呼び出しにはTokenが必要です。Tokenの生成には、Molocoのアカウントとパスワード、および前のステップで取得したWorkplace IDが必要です。

Tokenの有効期間は1時間しかないため、Molocoのアカウント、パスワード、Workplace IDをThinkingAIの担当者に提供していただく必要があります。システムはデータの取得時に新しいTokenを同時に生成します。秘密保持の原則を厳守し、これらの情報の漏洩を防止します。Tokenの生成の詳細な仕組みについては、Molocoの公式ドキュメントを参照してください。

API呼び出し専用の新しいMolocoアカウントを作成することもできます。新しいアカウントの作成方法は下図を参照してください。また、新しいアカウントの作成について詳しくは、こちらのドキュメントも参照できます。

図2：新規ユーザー作成の説明図

3. データの取得

Molocoは2種類のデータ取得方法を提供しています。集約指標データをコールバックするReport APIと、ユーザー粒度のローデータをコールバックするLog APIです。

3.1 Report API

インターフェースの基本情報

インターフェース名	APIタイプ	製品化	データ粒度	アトリビューションデータ	コストデータ	収益データ	インプレッション	クリック	コンバージョン
Report API	プル型	いいえ	集計データ		はい	はい	はい	はい	はい

Report APIは集計データのインターフェースで、一定の時間範囲内の指標データを返します。詳しくはReport API公式ドキュメントを参照してください

3.1.1 対象指標

Report APIのデータには、次の5つの指標フィールドが含まれます：

• impressions：露出数
• clicks：クリック数
• installs：インストール数
• spend：ユーザー獲得コスト
• revenue：マネタイズ収益

3.1.2 インターフェースのパラメータ

• 広告アカウント：

  • Report APIでデータを取得する際は、データを取得する広告アカウントを指定する必要があります。デフォルトではすべての広告アカウントのデータの取得を試みます。取得する広告アカウントのリストを指定する必要がある場合は、データ統合設定情報テンプレートに明記してください

• 時間：

  • 日単位、UTC時間のデータを取得できます

• 選択可能なディメンション：

  • Moloco Report APIは以下の分析ディメンションを提供しています。デフォルトでは、最も細かいディメンションのデータを取得するために、すべてのディメンションを選択します：

    • DATE
    • APP_OR_SITE
    • CAMPAIGN
    • CREATIVE_GROUP
    • CREATIVE
    • EXCHANGE
    • SUB_PUBLISHER
    • TRAFFIC

3.1.3 格納データの構造

• Report APIは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
• データ内のdateフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
• Report APIのデータのイベント名は -- moloco_report
• 以下は、Report APIの格納フィールドです：

------------------------ディメンションフィールド------------------------
ad_account_currency
ad_account_id
ad_account_title
ad_group_id
ad_group_title
app_id
app_os
app_store_id
app_title
campaign_country
campaign_id
campaign_title
creative_id
creative_main_asset_location
creative_title
creative_type
creative_group_id
creative_group_title
exchange_id
site_domain
site_id
site_title
skan_conversion_value
skan_metric_conversion_count
sub_publisher_id
sub_publisher_title
traffic_is_lat
traffic_mmp_effective
traffic_skan_bid
------------------------指標フィールド（数値型）------------------------
clicks
impressions
installs
revenue
spend

3.2 Log API

インターフェース名	APIタイプ	製品化	データ粒度	アトリビューションデータ	コストデータ	収益データ	インプレッション	クリック	コンバージョン
Log API	プル型	いいえ	ユーザーレベル	はい	はい	はい	はい	はい	はい

Log APIはユーザー粒度のローデータで、非常に豊富なユーザーデータを提供しています。主に次の3種類の詳細データを提供しています：

• IMP：露出データ（impression）です。表示データと表示のコストデータが含まれます
• CLICK：クリックデータです。クリックデータのほか、そのユーザーの過去の表示データと表示コストデータが含まれます
• CONVERSION：コンバージョンデータです。MMPから取得したコンバージョンデータ、アトリビューションデータ、コストデータ、収益データのほか、そのユーザーの過去の露出データとクリックデータが含まれます

警告

Log APIの詳細データはADID（つまりGAID）とIDFAで個々のユーザーを識別します。そのため、Molocoの詳細データをAEユーザーに関連付ける必要がある場合は、ADIDとIDFAをAEのユーザープロパティに記録するか、ADIDとIDFAをAEユーザーの#distinct_idとして設定する必要があります。そうしないと、詳細データを他のAEユーザーデータと関連付けることができません。

3.2.1 インターフェースのパラメータ

• 広告アカウント：
  • Log APIでデータを取得する際は、データを取得する広告アカウントを指定する必要があります。デフォルトではすべての広告アカウントのデータの取得を試みます。取得する広告アカウントのリストを指定する必要がある場合は、データ統合設定情報テンプレートに明記してください
• 時間：
  • 毎日3AM - 4AM (UTC)に、前日（UTC）のデータを取得できます

3.2.2 格納データの構造

• 3種類の詳細データの具体的な返却フィールドとその意味については、Molocoの公式ドキュメントを参照してください：https://help.moloco.com/hc/en-us/articles/360047856254-Log-data-field-specification
• 返却データのreq_device_ifaを、ユーザーを識別するIDとして使用します。ADIDとIDFAをAEユーザーの#distinct_idとして設定するか、AEのユーザープロパティに設定してください
• 以下は3種類の明細データに共通するフィールドです：

req_exchange
req_timestamp
req_app_bundle
req_app_publisher_id
req_device_ifa
req_device_os
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
req_device_lmt
req_device_geo_country
req_device_geo_utcoffset
req_device_geo_region
req_device_geo_metro
req_device_geo_city
req_device_geo_zip
req_imp_bidfloor
req_imp_tagid
req_imp_banner_w
req_imp_banner_h
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
req_imp_native_ext_has_video
req_imp_instl
bid_mtid
bid_adaccount_id
bid_adaccount_title
bid_app_id
bid_app_title
bid_app_store_id
bid_campaign_id
bid_campaign_title
bid_adgroup_id
bid_adgroup_title
bid_creativegroup_id
bid_creativegroup_title
bid_creative_id
bid_creative_title
bid_creative_type
bid_creative_w
bid_creative_h
bid_creative_size_in_bytes
bid_creative_video_duration
bid_user_bucket
bid_adslot_type
bid_adslot_w
bid_adslot_h
bid_traffic_skan

IMPデータ（Impression）

以下はIMPデータ固有のフィールドです：

• このうちimp_timestamp、つまり露出が発生した時間が、そのデータの#event_timeとして設定されます
• IMPデータのイベント名は -- moloco_log_imp
• 固有のフィールドは次のとおりです：

imp_timestamp
imp_cost_moloco_micro
imp_cost_currency
imp_cost_fee_percent
imp_cost_total_micro
imp_ip

CLICKデータ

以下はCLICKデータ固有のフィールドです：

• このうちclick_timestamp、つまりクリックが発生した時間が、そのデータの#event_timeとして設定されます
• CLICKデータのイベント名は -- moloco_log_click です
• 固有のフィールドは次のとおりです：

click_timestamp
click_type
click_ip

CONVERSIONデータ

以下はCONVERSIONデータ固有のフィールドです：

• このうちcv_attribution_timestamp、つまりアトリビューションが発生した時間が、そのデータの#event_timeとして設定されます
• CONVERSIONデータのイベント名は -- moloco_log_conversion です
• 固有のフィールドは次のとおりです：

cv_mmp
cv_event
cv_timestamp
cv_attribution_timestamp
cv_attribution_is_view_through
cv_revenue_amount
cv_revenue_currency
cv_revenue_amount_usd
cv_postback

3.2.3 ユーザープロパティの処理

現在、Moloco Log APIの詳細データのフィールドはユーザープロパティとして設定していません。一部のフィールドをユーザープロパティに書き込む必要がある場合は、データ統合設定情報テンプレートに明記してください。

4. データ統合設定情報テンプレート

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします。この情報テンプレートに基づいて、Molocoのデータ取得を行います：

データインターフェース：Moloco API
---------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
Molocoアカウント名：XXX
Molocoアカウントのパスワード：XXX
Moloco Workplace ID：XXX
広告主ID (ad_account_id）リスト：XXX, XXX
---------
Report API設定
時間範囲：yyyy/mm/dd - yyyy/mm/dd
グループ化ディメンション：DATE, APP_OR_SITE, CAMPAIGN, CREATIVE_GROUP, CREATIVE, EXCHANGE, SUB_PUBLISHER, TRAFFIC
---------
Log API設定
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
イベントタイプ：IMP, CLICK, CONVERSION
ユーザープロパティとして設定するフィールド：XXX

5. 連携テストとデータ利用

連携テスト

AEシステム管理画面の「データ管理」-「イベント管理」ページ、または「SQL IDE」ページで、次のイベントが格納されているかを検索できます：

• Report APIに対応するイベント：

  • moloco_report

• Log APIに対応するイベント：

  • moloco_log_imp
  • moloco_log_click
  • moloco_log_conversion