廣告單元對應

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

如要開始建立第一個廣告單元對應，請按照下列步驟操作：

curl (指令列)

使用 curl 發出的要求

  1. 載入Secrets 檔案，並產生授權憑證。

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

    如要進行驗證和授權，建議使用 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",
     }
   }
}