このページは Cloud Translation API によって翻訳されました。

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

広告ユニットのマッピングは、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 を使用したリクエスト

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

この手順を初めて行う際には、認証を求めるメッセージがブラウザに表示されます。承認する前に、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
```

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

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",
   }
 ]
}

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

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"
     }]
  }]
}

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

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

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

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",
     }
   }
}

広告ユニットのマッピング コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

例

curl（コマンドライン）

curl を使用したリクエスト

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