廣告單元對應

廣告單元對應是第三方設定，可將廣告單元對應至 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 資料。這些 AdMob 資料可能包含帳戶資訊、廣告空間和中介服務設定、報表以及其他資料。但不含付款或廣告活動詳細資料等機密資料。

開始建立第一個廣告單元對應：

curl (指令列)

使用 curl 提出要求

  1. 載入用戶端密鑰檔案並產生授權憑證。

    首次執行這個步驟時，系統會要求您在瀏覽器中接受授權提示。接受前，請確認您已登入可存取 AdMob API 的 Google 帳戶。您的應用程式將有權代表目前登入的帳戶存取資料。

    如要進行驗證和授權，建議您使用 oauth2l，這是一款簡單的指令列工具，可用於 Google OAuth 2.0。安裝 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 片段是廣告單元 ID 的最後 10 位數字，格式為「ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY」。請參閱找出廣告單元 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",
     }
   }
}