广告单元映射

广告单元映射是指映射到 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)"
    

    以下是 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",
         }
       }
    }