Google AdMob統合プラン

最終更新 2026/10/03

ヒント

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

概要

インターフェースの概要

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

Google AdMobのReporting APIインターフェースは、集計されたマネタイズ広告データを返します。マネタイズ広告の表示、クリック、収入のデータが含まれます

統合の流れ

AdMobアカウントにログインし、Publisher IDを取得します
Google Cloud Platformの管理画面にログインし、AdMob API権限を持つプロジェクトを作成して、Client IDとClient Secretを生成します
AE管理画面にログインし、サードパーティ統合モジュールでGoogle AdMobプランを追加して、関連する設定を完了します
先ほど作成したGCP管理画面のプロジェクトに戻り、正しいコールバックURLを設定して、認証を完了します
AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. 統合前の準備

1.1 Publisher IDの取得

AdMob管理画面にログインし、下図のパスでPublisher IDを取得します

AdMob 后台 Settings 的 Account information 页，标出进入路径和 Publisher ID 一行

1.2 Google Cloud Platformでのプロジェクト作成

次に、Google Cloud Platformプロジェクトを作成する必要があります。GCPプロジェクトを作成したことがない場合は、Google Cloud Platformにログインし、「CREATE PROJECT」をクリックしてプロジェクトを作成します。すでにプロジェクトを作成している場合は、この手順をスキップできます。

Google Cloud Platform 新建项目页，填写项目名称和位置后点 CREATE

1.3 AdMob APIの有効化

次に、AdMob API権限を有効にする必要があります。GCPプロジェクトに入り、上部の検索バーで「AdMob API」を検索して、紹介ページに移動します。ページ内の下図に示す領域に「ENABLE」と表示されている場合は、プロジェクトでAdMob API権限が有効になっていないため、「ENABLE」をクリックして権限を有効にしてください。

Google Cloud 控制台的 AdMob API 介绍页，框出 ENABLE 和 TRY THIS API 按钮

AdMob API権限を有効にすると、次のページに移動します。このページに移動しない場合は、ページ左上のメニューバーで「APIs & Services」-「Enabled APIs & services」を開き、APIリストでAdMob APIを探してクリックし、設定ページに移動することもできます。

リストでAdMob APIを探してクリックしても、下図のページに移動できます。下図の矢印に従ってOauth consent screenを設定します。

AdMob API 详情页的 CREDENTIALS 标签，箭头指向 CONFIGURE CONSENT SCREEN 按钮

次に、「User Type」でExternalを選択し、「CREATE」を選択して次に進みます：

OAuth consent screen 的 User Type 选择，已选中 External

*印の付いた項目を設定したら（メールアドレスはGoogleアカウントのメールアドレスで構いません）、「SAVE AND CONTINUE」をクリックします

Edit app registration 的 OAuth consent screen 步骤，填写应用名称和联系邮箱

「Scopes」タブで「ADD OR REMOVE SCOPES」を選択し、AdMob APIのscopesからadmob.readonlyを選択して「UPDATE」をクリックして確定し、「SAVE AND CONTINUE」をクリックして続行します

Scopes 步骤点 ADD OR REMOVE SCOPES，在右侧面板勾选 admob.readonly

次に、「Test users」タブで「ADD USERS」をクリックし、AdMob管理画面へのログインに使用するGoogleアカウントのメールアドレスをテストユーザーに追加します。追加が完了したら、「SAVE AND CONTINUE」をクリックして続行します

Edit app registration 的 Test users 步骤，框出 ADD USERS 按钮

最後の「Summary」タブには、これまでに設定した内容が表示されます。そのまま確定すると、Oauth consent screenの設定が完了します

1.5 Client IDとClient Secretの作成

Oauth consent screenの設定が完了したら、AdMob APIに戻り、Client IDとClient Secretを作成します

このページが見つからない場合は、左上のメニューバーで「APIs & Services」-「Enabled APIs & services」を開き、APIリストでAdMob APIを探してクリックし、設定ページに移動します。

「CREDENTIALS」タブで「+ CREATE CREDENTIALS」をクリックし、「Help me choose」を選択して、Client IDとClient Secretの作成フローに進みます。

AdMob API 详情页的 CREATE CREDENTIALS 菜单，含 OAuth client ID 和 Help me choose

Credential Typeページで、AdMob API、User Dataを順に選択し、「NEXT」をクリックします

创建凭证的 Credential Type 步骤，选择 AdMob API 和 User data

Oauth consent screenの作成時にScopesの設定はすでに完了しているため、ここではそのまま「SAVE AND CONTINUE」で続行できます

创建凭证的 Scopes 步骤，已含 admob.readonly，可直接 SAVE AND CONTINUE

次に、Application typeでWeb applicationを選択します。Authorized redirect URIsの赤枠で示された箇所にはコールバックURLを設定する必要があります。現時点ではまだAEシステムでプランを作成していないため、認証アドレスにはひとまず「www.thinkingdata.cn」を入力し、プランの作成が完了してから正式なコールバックURLに変更します。

OAuth Client ID 步骤选择 Web application，框出 Authorized redirect URIs 的 ADD URI

すべての設定が完了したら、「CREATE」をクリックして認証情報を作成します。作成が完了すると、ページにClient IDとClient Secretが表示されます。この2つの情報は大切に保管してください

最後に、「OAuth consent screen」に入り、Publishing status欄で「PUBLISH APP」をクリックして、アプリを正式版として公開します

OAuth consent screen 页的 Publishing status 为 Testing，箭头指向 PUBLISH APP

1.6 まとめ

本章では主に、統合前にGoogleプラットフォームで完了しておく必要がある各作業を紹介しました。現在、次の情報を取得していることを確認してください：

AdMobのPublisher ID
AdMob APIが有効になっているGCPプロジェクト、およびそのプロジェクトのClient IDとClient Secret

2. プランの設定

Googleプラットフォームでの準備が完了したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランを設定します。下図はGoogle AdMobの設定画面です。本章の内容に従ってプランを作成してください

Google AdMob API 集成方案配置页，含方案配置、定时拉取、入库设置和集成配置

2.1 認証情報の設定

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した情報を入力します：

Google AdMob API 的授权信息弹窗，填写 Publisher ID、Client ID 和 Client Secret

2.2 定期取得

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

Google AdMob 方案配置里的定时拉取：开关打开，每天 8 时拉取最近 1 天的数据

2.3 格納設定

データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。

2.4 統合構成

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

Google AdMob 方案的集成配置区块，格式化后的 JSON 含事件映射、报表类型、指标和分组

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

モジュール	名前	意味
sink_event	event_mapping	格納後のイベント名。カスタマイズ可能。JSON型。Keyはsource.report_typesに対応し、Valueはそのレポートタイプの格納イベント名です。
source	report_types	取得するレポートタイプ。AdMob Reporting APIは2種類のレポートタイプに対応しています。リスト型です。要素は1つだけ入力すること、つまり一度に1つのレポートのデータのみを取得することをお勧めします選択可能な値：network_report、mediation_report。詳しくは以下の内容を参照してください
	metrics	データ内の指標。リスト型。レポートタイプによって対応するmetricsが異なるため、入力時に注意が必要です
	group_by	データ内のグループ化ディメンション。リスト型。レポートタイプによって対応するgroup_byが異なるため、入力時に注意が必要です

レポートタイプによってデータの設定が大きく異なるため、各レベルの設定テンプレートをそのまま使用するか、テンプレートを微調整することをお勧めします

2.4.1 Network Reportテンプレート

Network ReportにはAdMobのマネタイズ広告のデータのみが含まれます。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、本節の内容を参照してください：

{
  "sink_event": {
    "event_mapping": {
      "network_report": "admob_network_report",
      "mediation_report": "admob_mediation_report"
    }
  },
  "source": {
    "report_types": [
      "network_report"
    ],
    "metrics": [
      "AD_REQUESTS",
      "CLICKS",
      "ESTIMATED_EARNINGS",
      "IMPRESSIONS",
      "IMPRESSION_CTR",
      "IMPRESSION_RPM",
      "MATCHED_REQUESTS",
      "MATCH_RATE",
      "SHOW_RATE"
    ],
    "group_by": [
      "DATE",
      "AD_UNIT",
      "APP",
      "COUNTRY",
      "FORMAT",
      "PLATFORM",
      "MOBILE_OS_VERSION",
      "GMA_SDK_VERSION",
      "APP_VERSION_NAME",
      "SERVING_RESTRICTION"
    ]
  }
}

対象指標

AdMob APIのNetwork Reportデータでは、次の指標を取得できます。デフォルトではすべての指標を格納します。調整が必要な場合は、指標名をsource.metricsに追加してください：

指標	名前	備考
AD_REQUESTS	広告リクエスト数	分析ディメンションAD_TYPEとは互換性がありません
CLICKS	広告クリック数
ESTIMATED_EARNINGS	推定収入	推定総収入。この値は1000000倍に拡大されているため（たとえば$6.50の値は6500000）、使用時には1000000で割る必要があります
IMPRESSIONS	広告表示回数	総表示回数
IMPRESSION_CTR	クリック率
IMPRESSION_RPM	1000回広告表示あたりの収入	推定の1000回広告表示あたりの収入で、管理画面のeCPMに対応します。この値は1000000倍に拡大されているため（たとえば$1.03の値は1030000）、使用時には1000000で割る必要があります。分析ディメンションAD_TYPEとは互換性がありません
MATCHED_REQUESTS	広告リクエスト成功数	広告をリクエストした後にレスポンスを得た回数
MATCH_RATE	リクエスト成功率	広告リクエスト成功数 / 広告リクエスト数に等しい。分析ディメンションAD_TYPEとは互換性がありません
SHOW_RATE	広告表示率	広告表示回数 / 広告リクエスト成功数に等しい

分析ディメンション

以下は、AdMob APIのNetwork Reportデータの分析ディメンションです。調整が必要な場合は、ディメンション名をsource.group_byに追加してください：

ディメンション	意味	説明	デフォルトかどうか
DATE	日別にグループ化	YYYYMMDD形式（例："20210701"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です	はい
MONTH	月別にグループ化	YYYYMM形式（例："202107"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です
WEEK	週別にグループ化	週の初日のYYYYMMDD形式（例："20210701"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です
AD_UNIT	ad unit別にグループ化	ad unitのunique ID（例："ca-app-pub-1234/1234"）を取得します。このディメンションを使用すると、APPディメンションが自動的に追加されます	はい
APP	アプリ別にグループ化	アプリID（例："ca-app-pub-1234~1234"）を取得します	はい
AD_TYPE	広告タイプ別にグループ化	値の例："text"、"image"。指標AD_REQUESTS、MATCH_RATE、IMPRESSION_RPMとは互換性がないことに注意してください
COUNTRY	国（地域）別にグループ化	Unicode CLDR規格の国（地域）コードを取得します。例："US"、"FR"	はい
FORMAT	広告ユニットのタイプ別にグループ化	ad unitのタイプを取得します。例："banner"、"native"	はい
PLATFORM	プラットフォーム別にグループ化	値の例："Android"、"iOS"	はい
MOBILE_OS_VERSION	OSバージョン別にグループ化	値の例："iOS 13.5.1"	はい
GMA_SDK_VERSION	GoogleMobileAds SDKのバージョン別にグループ化	値の例："iOS 7.62.0"	はい
APP_VERSION_NAME	APPバージョン別にグループ化	AndroidではPackageInfoのversionName、iOSではCFBundleShortVersionStringのapp version nameを取得します	はい
SERVING_RESTRICTION	広告配信の制限モード別にグループ化	値の例："Non-personalized ads"	はい

格納ルール

テンプレートでは、データ内のDATEフィールド（日単位で集計された時間）をゼロ埋めした値を、そのデータの#event_timeとして使用します

テンプレートで使用されるイベント名は -- admob_network_report です

2.4.2 Mediation Reportテンプレート

Mediation Reportには、AdMobのマネタイズ広告とその他のサードパーティプラットフォームの広告データが含まれます。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、本節の内容を参照してください：

{
  "sink_event": {
    "event_mapping": {
      "network_report": "admob_network_report",
      "mediation_report": "admob_mediation_report"
    }
  },
  "source": {
    "report_types": [
      "mediation_report"
    ],
    "metrics": [
      "AD_REQUESTS",
      "CLICKS",
      "ESTIMATED_EARNINGS",
      "IMPRESSIONS",
      "IMPRESSION_CTR",
      "MATCHED_REQUESTS",
      "MATCH_RATE",
      "OBSERVED_ECPM"
    ],
    "group_by": [
      "DATE",
      "AD_SOURCE",
      "AD_SOURCE_INSTANCE",
      "AD_UNIT",
      "APP",
      "MEDIATION_GROUP",
      "COUNTRY",
      "FORMAT",
      "PLATFORM"
    ]
  }
}

対象指標

AdMob APIのMediation Reportデータでは、次の指標を取得できます。デフォルトではすべての指標を格納します。調整が必要な場合は、指標名をsource.metricsに追加してください：

指標	名前	説明と備考
AD_REQUESTS	広告リクエスト数
CLICKS	広告クリック数
ESTIMATED_EARNINGS	推定収入	AdMobの推定総収入。この値は1000000倍に拡大されているため（たとえば$6.50の値は6500000）、使用時には1000000で割る必要があります
IMPRESSIONS	広告表示回数	総表示回数
IMPRESSION_CTR	クリック率
MATCHED_REQUESTS	広告リクエスト成功数	広告をリクエストした後にレスポンスを得た回数
MATCH_RATE	リクエスト成功率	広告リクエスト成功数 / 広告リクエスト数に等しい
OBSERVED_ECPM	推定eCPM	サードパーティプラットフォームの推定eCPM値（サードパーティのデータ権限の問題により、現在この値は0になる場合があります）

分析ディメンション

以下は、AdMob APIのMediation Reportデータの分析ディメンションです。調整が必要な場合は、ディメンション名をsource.group_byに追加してください：

ディメンション	意味	説明	デフォルトかどうか
DATE	日別にグループ化	YYYYMMDD形式（例："20210701"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です。デフォルトではDATEを時間のグループ化に使用します	はい
MONTH	月別にグループ化	YYYYMM形式（例："202107"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です
WEEK	週別にグループ化	週の初日のYYYYMMDD形式（例："20210701"）で時間をグループ化します。時間ディメンションが少なくとも1つ必要です
AD_SOURCE	メディアチャンネル別にグループ化	メディアチャンネルIDとチャンネル名でグループ化します	はい
AD_SOURCE_INSTANCE	メディアチャンネルインスタンス別にグループ化	メディアチャンネルインスタンスIDとメディアチャンネルインスタンス名でグループ化します	はい
AD_UNIT	ad unit別にグループ化	ad unitのunique ID（例："ca-app-pub-1234/1234"）を取得します。このディメンションを使用すると、APPディメンションが自動的に追加されます	はい
APP	アプリ別にグループ化	アプリID（例："ca-app-pub-1234~1234"）を取得します	はい
MEDIATION_GROUP	メディエーショングループ別にグループ化	メディエーショングループIDとメディエーショングループ名でグループ化します	はい
COUNTRY	国（地域）別にグループ化	Unicode CLDR規格の国（地域）コードを取得します。例："US"、"FR"	はい
FORMAT	広告ユニットのタイプ別にグループ化	ad unitのタイプを取得します。例："banner"、"native"	はい
PLATFORM	プラットフォーム別にグループ化	値の例："Android"、"iOS"	はい
MOBILE_OS_VERSION	OSバージョン別にグループ化	値の例："iOS 13.5.1"。指標ESTIMATED_EARNINGS、OBSERVED_ECPMとは互換性がないことに注意してください
GMA_SDK_VERSION	GoogleMobileAds SDKのバージョン別にグループ化	値の例："iOS 7.62.0"。指標ESTIMATED_EARNINGS、OBSERVED_ECPMとは互換性がないことに注意してください
APP_VERSION_NAME	APPバージョン別にグループ化	AndroidではPackageInfoのversionName、iOSではCFBundleShortVersionStringのapp version nameを取得します。指標ESTIMATED_EARNINGS、OBSERVED_ECPMとは互換性がないことに注意してください
SERVING_RESTRICTION	広告配信の制限モード別にグループ化	値の例："Non-personalized ads"。指標ESTIMATED_EARNINGSとは互換性がないことに注意してください

格納ルール

テンプレートでは、データ内のDATEフィールド（日単位で集計された時間）をゼロ埋めした値を、そのデータの#event_timeとして使用します

テンプレートで使用されるイベント名は -- admob_mediation_report です

2.4.3 App IDによるフィルタリング

指定したアプリのデータのみを取得したい場合は、統合構成のextra_params.dimension_filtersでApp IDによるフィルタリングを行えます。この設定ではAPPディメンションを使用します。例のApp IDを実際の値に置き換えてください：

{
  "extra_params": {
    "dimension_filters": [
      {
        "dimension": "APP",
        "matches_any": {
          "values": [
            "ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX"
          ]
        }
      }
    ]
  }
}

2.4.4 収益通貨の設定

指定した通貨でAdMobの収益系指標を取得したい場合は、統合構成のextra_params.localization_settingsでcurrency_codeを設定できます。この設定はNetwork ReportとMediation Reportの両方に適用されます：

{
  "extra_params": {
    "localization_settings": {
      "currency_code": "JPY",
      "language_code": "en-US"
    }
  }
}

currency_codeにはISO 4217の3文字の通貨コード（例：JPY、USD）を使用します。未設定の場合はデフォルトでUSDが使用されます。無効なコードを使用すると、パラメータの検証に失敗します。
language_codeはレポートの言語の設定に使用します。未設定の場合はデフォルトでen-USが使用されます。日本語にする場合はja-JPに設定できます。このフィールドに通貨コードJPYを入力しないでください。
設定が有効になると、その後に取得するデータの収益通貨は標準化フィールドte_ads_object.currencyと一致します。すでに格納済みの履歴データは書き換えられません。

2.5 標準化フィールド

データに次のイベントプロパティが存在する場合は、自動的に標準化処理を行います：

元フィールド	標準化フィールド	意味
publisher_id	te_ads_object.ad_account_id	広告アカウントID
ad_unit	te_ads_object.ad_group_id	広告グループID
ad_source	te_ads_object.media_source	メディアチャンネルまたはマネタイズチャンネル
app	te_ads_object.app_id	アプリID
platform	te_ads_object.platform	プラットフォーム（Android、iOSなど）
country	te_ads_object.country	国・地域コード
localization_settings_currency_code	te_ads_object.currency	収益通貨。未設定の場合はUSD
impressions	te_ads_object.impressions	露出数
clicks	te_ads_object.clicks	クリック数
estimated_earnings（データは1000000で割られます）	te_ads_object.revenue	マネタイズ収益

2.6 認証の完了

設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：

まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします

授权信息弹窗：第 1 步复制授权回调地址，第 2 步点击前往授权，底部有完成授权按钮

次に、Google Cloud Platformに戻り、先ほど作成したcredentialsを編集します（サイドバーの「APIs & Services」-「Credentials」で、以前作成したOauth 2.0 Client IDを確認でき、その後ろにある編集ボタンをクリックすると編集ページに移動します）。Authorized redirect URIsに先ほどコピーしたコールバックURLを追加し、「Save」をクリックして変更を完了します。

Google Cloud 控制台 OAuth 客户端编辑页，框出 Authorized redirect URIs 的填写位置

最後に、AEの画面に戻って「認証設定へ」をクリックすると、Google AdMobの認証ページが開きます

AdMobで使用しているGoogleアカウントにログインし、Googleの指示に従って以降の認証操作を完了してください

認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、Google AdMobのデータ統合は完了です。

このページは役に立ちましたか？

概要​

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

統合の流れ​

1. 統合前の準備​

1.1 Publisher IDの取得​

1.2 Google Cloud Platformでのプロジェクト作成​

1.3 AdMob APIの有効化​

1.4 Oauth consent screenの設定​

1.5 Client IDとClient Secretの作成​

1.6 まとめ​

2. プランの設定​

2.1 認証情報の設定​

2.2 定期取得​

2.3 格納設定​

2.4 統合構成​

2.4.1 Network Reportテンプレート​

2.4.2 Mediation Reportテンプレート​

2.4.3 App IDによるフィルタリング​

2.4.4 収益通貨の設定​

2.5 標準化フィールド​

2.6 認証の完了​

概要