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

広告ユニットのマッピングは、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",
     }
   }
}