廣告單元對應

廣告單元對應是第三方設定，可對應至 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 帳戶登入。應用程式將獲得授權，代表目前登入的帳戶存取資料。

    我們建議使用 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)"

    AdMob 聯播網廣告來源的回應範例 (ID 為 5450213213286189855)：

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