メインコンテンツまでスキップ

Pangle Gromore統合プラン

最終更新 2026/10/03
ヒント

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

概要​

インターフェースの概要​

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
集約データAPIAPI集約指標✅✅✅

Pangle Gromoreは集約データレポートAPIを提供しています。このインターフェースを通じて、マネタイズ広告の露出、クリック、収益の集約データを取得できます

統合の流れ​

  1. Pangleの管理画面で、集約データレポートAPIドキュメントのSecurity key、RoleId、およびユーザーのUserIdを取得します
  2. AE管理画面にログインし、サードパーティ統合モジュールでPangle Gromore統合を追加して、統合プランを作成します
  3. AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. 認証情報の取得​

Pangle Gromoreのデータを統合する最初のステップとして、Pangleの管理画面にログインし、左側のバーで【統合】-【API統合ドキュメント】を選択して、下図に示す部分をクリックし、ユーザーのSecurity keyとRoleIdを取得します

また、ユーザーのUserIdも取得する必要があります。ページ右上を確認すると、ユーザー名の下にあるIDフィールドがUserIdです

2. プランの設定​

Pangle Gromoreプラットフォームの認証情報を取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はPangle Gromore集約データAPIの設定画面です。本章の内容に従ってプランを作成してください：

2.1 認証情報の設定​

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップにPangle Gromoreプラットフォームで取得した情報を入力します

2.2 定期取得​

「定期取得」モジュールで、AEシステムがPangle Gromoreのデータを定期的に取得する方針を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします

2.3 取得タイムゾーン​

取得するデータのタイムゾーンも設定できます。デフォルトはUTC+8です

2.4 イベントデータの格納設定​

「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。

2.5 統合構成​

最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。

統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：

モジュール名前意味
sink_eventevent_name格納後のイベント名。カスタマイズ可能で、文字列型です。
source

report_types

データ取得のレポートタイプ。主に日単位のレポートと時間単位のレポートから選択します。選択できる値：

  • 日単位のレポート：day
  • 時間単位のレポート：hour
metrics対応するインターフェースの指標フィールド。リスト型で、カスタマイズ可能
group_by対応するインターフェースのディメンションフィールド。リスト型で、カスタマイズ可能

日単位のレポートと時間単位のレポートは大きく異なるため、対応するレポートの設定テンプレートをそのまま使用するか、テンプレートを微調整して使用することをお勧めします

2.5.1 時間単位のデータレポートのテンプレート​

時間単位のデータレポートは、デフォルトで取得するデータレポートでもあります。以下のテンプレートをそのまま使用できます：

{
  "sink_event": {
    "event_name": "csj_gromore_report"
  },
  "source": {
    "group_by": [
      "site_id",
      "adunittype",
      "adunit_id",
      "network",
      "code_id",
      "os",
      "sdk_version",
      "segment",
      "site_version",
      "channel"
    ],
    "report_types": [
      "hour"
    ],
    "metrics": [
      "req_cnt",
      "ret_cnt",
      "fill_rate",
      "clk_cnt",
      "clk_rate",
      "imp_cnt",
      "ssr",
      "ecpm",
      "revenue"
    ]
  }
}
  • 対象指標

以下は時間単位のデータレポートが対応している指標です。調整が必要な場合は、指標名をsource.metricsに追加してください：

フィールド説明備考デフォルトかどうか
api_ecpmReporting APIで取得した推定eCPM

code_idでグループ化した場合のみ使用できます

api_imp_cntReporting APIで取得した推定表示数
api_revenueReporting APIで取得した推定収益
waterfall_req_cntトラフィックのリクエスト数

networkとcode_idでグループ化した場合は返されません

waterfall_send_cntトラフィックのレスポンス数
waterfall_srトラフィックのフィル率
req_cnt広告リクエスト数はい
ret_cnt広告レスポンス数はい
fill_rate広告フィル率はい
clk_cntクリック数はい
clk_rateクリック率はい
imp_cnt表示数はい
ssr表示率はい
ecpm推定eCPMはい
revenue推定収益はい
  • 分析ディメンション

時間単位のデータレポートでは、以下の集計ディメンションを提供しています。調整が必要な場合は、ディメンション名をsource.group_byに追加してください：

ディメンションフィールド説明デフォルト
site_idsite_idgromoreの集約管理におけるアプリIDはい
adunittypeadunittype集約管理における広告ユニットのタイプはい

adunit_id

ad_unit_name広告枠名はい
adunit_id広告ユニットIDはい
networknetworkコード枠が属する広告ネットワークはい
code_idcode_nameコード枠名はい
code_idコード枠IDはい
ososOSの種類はい
sdk_versionsdk_versionSDKバージョン
segmentsegemt_idトラフィックグループID
site_versionsite_versionアプリバージョン
channelchannelチャンネル情報
必須フィールドuser_idメディアアカウントIDはい
role_idサブアカウントIDはい
currency通貨はい
  • 格納ルール

データ内のstart_dateとend_dateフィールド（データ集計の時間単位のフィールド）を、集計データの#event_timeとして設定します

デフォルトのイベント名は -- csj_gromore_report です

2.5.2 日単位のデータレポートのテンプレート​

日単位のデータレポートと時間単位のデータレポートにはいくつか違いがあります。以下のテンプレートを使用するか、本節の内容に沿って取得フィールドをカスタマイズできます：

{
    "sink_event":
    {
        "event_name": "csj_gromore_report"
    },
    "source":
    {
        "group_by":
        [
            "site_id",
            "ad_unit_type",
            "ad_unit_id",
            "network",
            "code_id"
        ],
        "report_types":
        [
            "day"
        ],
        "metrics":
        [
            "req_cnt",
            "ret_cnt",
            "fill_rate",
            "imp_cnt",
            "ssr",
            "clk_cnt",
            "clk_rate",
            "ecpm",
            "revenue",
            "api_ecpm",
            "api_revenue",
            "api_imp_cnt",
            "api_req_cnt",
            "api_ret_cnt",
            "api_clk_cnt",
            "api_ssr",
            "api_fill_rate",
            "api_show_gap_rate",
            "api_click_gap_rate"
        ]
    }
}
  • 対象指標

以下は日単位のデータレポートが対応している指標です。調整が必要な場合は、指標名をsource.metricsに追加してください：

フィールド説明備考デフォルトかどうか
waterfall_req_cntトラフィックのリクエスト数networkとcode_idでグループ化した場合は返されません
waterfall_send_cntトラフィックのレスポンス数
waterfall_srトラフィックのフィル率
req_cnt広告リクエスト数はい
ret_cnt広告レスポンス数はい
fill_rate広告フィル率はい
imp_cnt表示数はい
ssr表示率はい
clk_cntクリック数はい
clk_rateクリック率はい
ecpm推定eCPMはい
revenue推定収益はい
api_ecpmReporting APIで取得した推定eCPM

これらの指標を照会するには、Gromoreプラットフォームで広告ネットワークを設定する必要があります。設定後にデータが返されるようになります。

はい
api_revenueReporting APIで取得した推定収益はい
api_imp_cntReporting APIで取得した推定表示数はい
api_req_cntReporting APIで取得した広告リクエスト数はい
api_ret_cntReporting APIで取得した広告レスポンス数はい
api_clk_cntReporting APIで取得した広告クリック数はい
api_ssrReporting APIで取得した表示率はい
api_fill_rateReporting APIで取得したフィル率はい
api_show_gap_rateReporting APIで取得した表示数と広告プラットフォームで集計された表示数の差異。計算式は 表示gap = (imp_cnt - api_imp_cnt) / api_imp_cntはい
api_click_gap_rateReporting APIで取得したクリック数と広告プラットフォームで集計されたクリック数の差異。計算式は クリックgap = (clk_cnt - api_clk_cnt) / api_clk_cntはい
  • 分析ディメンション

日単位のデータレポートでは、以下の集計ディメンションを提供しています。調整が必要な場合は、ディメンション名をsource.group_byに追加してください：

ディメンションフィールド説明デフォルト
site_idsite_idgromoreの集約管理におけるアプリIDはい
ad_unit_typead_unit_type集約管理における広告ユニットのタイプはい

ad_unit_id

ad_unit_name広告枠名はい
ad_unit_id広告ユニットIDはい
networknetworkコード枠が属する広告ネットワークはい
code_idcode_nameコード枠名はい
code_idコード枠IDはい
segmentsegemt_idトラフィックグループ
sdk_versionsdk_versionSDKバージョン
site_versionsite_versionアプリバージョン
channelchannelチャンネル情報
user_typeuser_typeユーザータイプ
必須フィールドosOSの種類はい
user_idメディアアカウントIDはい
role_idサブアカウントIDはい
currency通貨はい
  • 格納ルール

データ内のdateフィールド（データ集計の日単位のフィールド）を、集計データの#event_timeとして設定します

デフォルトのイベント名は -- csj_gromore_report です

2.6 標準化フィールド​

フィールド標準化フィールド説明
currencyte_ads_object.currency通貨
ad_unit_namete_ads_object.ad_group_name広告枠名
ad_unit_idte_ads_object.ad_group_id広告ユニットID
adunit_idte_ads_object.ad_group_id広告ユニットID
networkte_ads_object.media_sourceコード枠が属する広告ネットワーク
code_namete_ads_object.ad_nameコード枠名
code_idte_ads_object.ad_idコード枠ID
oste_ads_object.platformOSの種類
user_idte_ads_object.ad_account_idメディアアカウントID
imp_cntte_ads_object.impressions表示数
clk_cntte_ads_object.clicksクリック数
revenuete_ads_object.revenue推定収益
このページは役に立ちましたか？
このページの内容