広告ユニットのマッピング

広告ユニットのマッピングは、AdMob 広告ユニットにマッピングされ、第三者広告ネットワークに広告リクエストを送信できるようにする、第三者の設定です。

メディエーション グループを作成するときに、広告ユニットのマッピングは、各メディエーション グループ行のパラメータとして、指定された広告ユニットがサードパーティ広告ネットワーク リクエストを行うための設定として使用されます。AdMob の管理画面とは異なり、広告ユニットのマッピングはメディエーション グループとメディエーション グループ行の外部で個別に作成する必要があります。作成後、すべての広告ユニットのマッピングを一覧表示し、新しい広告ユニットのマッピングを使用してメディエーション グループ行を作成または更新する際にパラメータとして使用できます。

例

OAuth 2.0 認証情報を作成したら、AdMob API の使用を開始できます。OAuth 2.0 を使用してアクセスをリクエストするには、アプリケーションにスコープ情報も必要になります。

OAuth 2.0 のスコープ情報は次のとおりです。

範囲 意味
https://www.googleapis.com/auth/admob.monetization AdMob の収益化設定の参照、作成、編集を行います。
https://www.googleapis.com/auth/admob.readonly AdMob のすべてのデータを表示します。これには、アカウント情報、広告枠とメディエーションの設定、レポートなどのデータが含まれます。 また、支払いやキャンペーンの詳細などの機密データは含まれません。

最初の広告ユニット マッピングを作成しましょう。

curl（コマンドライン）

curl を使用したリクエスト

  1. クライアント シークレット ファイルを読み込み、認証情報を生成します。

    この手順を初めて行う際には、認証を求めるメッセージがブラウザに表示されます。承認する前に、AdMob API へのアクセス権を持つ Google アカウントでログインしていることをご確認ください。現在ログインしているアカウントに代わって、アプリケーションがデータにアクセスすることが認証されます。

    認証と承認には、Google OAuth 2.0 を操作するためのシンプルなコマンドライン ツールである oauth2l を使用することをおすすめします。oauth2l をインストールして、次のコマンドを実行します。path_to_credentials_json は、クラウド アプリケーションの登録時にダウンロードした credentials.json ファイルのパスに置き換えます。初回実行時に、コマンドにより OAuth 2.0 承認フローを順を追って実行します。後続の実行では、トークンが自動的に更新されます。

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. 広告ソースを一覧表示します。

    pub-XXXXXXXXXXXXXXXX をパブリッシャー ID に置き換えて、AdMob の広告ソース情報を取得します。パブリッシャー ID を確認する方法については、こちらの手順をご覧ください。

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    レスポンスの例:

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. アダプターを一覧表示します。

    SSSSSSSSSSSSSSSSSSSS は、対象のアダプタの広告ソース ID に置き換えます。

    アダプタのリストを取得するには、次のコマンドを使用します。

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    ID 5450213213286189855 の AdMob ネットワーク広告ソースのレスポンスの例:

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. 広告ユニットのマッピングを作成します。

    YYYYYYYYYY を、実際の広告ユニット ID フラグメントに置き換えます。広告ユニット ID のフラグメントは、広告ユニット ID の末尾の 10 桁で、「ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY」の形式になります。広告ユニット ID を確認する手順をご覧ください。

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. すべての広告ユニットのマッピングを一覧表示します。

    YYYYYYYYYY は、実際の広告ユニット ID フラグメントに置き換えます。広告ユニット ID のフラグメントは、「ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY」という形式の広告ユニット ID の末尾 10 桁です。手順については、広告ユニット ID を確認するをご覧ください。

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}