広告ユニットのマッピングは、AdMob 広告ユニットにマッピングされ、第三者広告ネットワークに広告リクエストを送信できるようにする第三者の設定です。
メディエーション グループを作成する際、広告ユニットのマッピングは、指定された広告ユニットのサードパーティ広告ネットワーク リクエストを行うための設定として、各メディエーション グループの行のパラメータとして使用されます。AdMob の UI とは異なり、広告ユニットのマッピングはメディエーション グループとメディエーション グループの広告申込情報とは別に作成する必要があります。作成後は、すべての広告ユニット マッピングを一覧表示し、新しい広告ユニット マッピングを使用してメディエーション グループの行を作成または更新する際にパラメータとして使用できます。
例
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 桁です。広告ユニット ID は「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", } } }