REST Resource: accounts.mediationGroups

资源:MediationGroup

描述 AdMob 中介组。

JSON 表示法
{
  "name": string,
  "mediationGroupId": string,
  "displayName": string,
  "targeting": {
    object (MediationGroupTargeting)
  },
  "state": enum (State),
  "mediationGroupLines": {
    string: {
      object (MediationGroupLine)
    },
    ...
  },
  "mediationAbExperimentState": enum (ExperimentState)
}
字段
name

string

此中介组的资源名称。格式为:accounts/{publisherId}/MediationGroups/{大小中介组 Id} 示例:accounts/pub-9876543210987654/MediationGroups/0123456789

mediationGroupId

string

中介组的 ID。例如:“0123456789”。这是一个只读属性。

displayName

string

用户为中介组提供的名称。允许的长度上限为 120 个字符。

targeting

object (MediationGroupTargeting)

此中介组定位的一组条件,例如广告单元和地理位置。

state

enum (State)

中介组的状态。系统只会投放已启用的中介组。

mediationGroupLines

map (key: string, value: object (MediationGroupLine))

用于此中介组投放的中介行。

键是指中介组行的 ID。在创建时,请使用不同的负值作为占位符。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

mediationAbExperimentState

enum (ExperimentState)

仅供输出。属于此中介组的中介 A/B 实验的状态。

MediationGroupTargeting

此中介组定位的一组条件。例如,中介组可以定位特定的广告单元 ID、平台、格式和地理位置。

JSON 表示法
{
  "platform": string,
  "format": string,
  "adUnitIds": [
    string
  ],
  "targetedRegionCodes": [
    string
  ],
  "excludedRegionCodes": [
    string
  ],
  "idfaTargeting": enum (IdfaTargeting)
}
字段
platform

string

描述应用的平台。例如:“IOS”“Android”。

format

string

此中介组定位的广告格式。示例:“banner”“native”。

adUnitIds[]

string

此中介组定位的广告单元。示例:“ca-app-pub-1234/8790”。

targetedRegionCodes[]

string

位置的 Unicode 国家/地区代码 (CLDR),例如“US”。如果此中介组定位到所有可用区域,则未设置。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#unicode_region_subtag

excludedRegionCodes[]

string

位置的 Unicode 国家/地区代码 (CLDR),例如“US”。如果此中介组未排除任何区域,则取消设置。

idfaTargeting

enum (IdfaTargeting)

该参数可用于根据是否带有 IDFA 来定位广告请求。如果设置为“ALL”,则中介组适用于所有广告请求(无论是否带有 IDFA)。如果设为 AVAILABLE,中介组会应用于带有 IDFA 的广告请求。如果设置为 NOT_AVAILABLE,中介组会应用于没有 IDFA 的广告请求。不需要为 ANDROID 设备指定此值。

IdfaTargeting

广告标识符是否适用于 iOS 设备。

枚举
IDFA_TARGETING_UNSPECIFIED 默认值。此值未使用。
ALL 定位到所有设备,无论有没有广告标识符 (IDFA)。
AVAILABLE 仅定位到适用 IDFA 的设备。
NOT_AVAILABLE 仅定位到没有广告标识符 (IDFA) 可用的设备。

状态

中介组的可用状态类型。

枚举
STATE_UNSPECIFIED 未设置的字段的默认值。请勿使用。
ENABLED 中介组有效,用于投放广告或收集统计信息。
DISABLED 该中介组已被停用,不再投放广告或收集统计信息。已停用的中介组可以重新启用。

ExperimentState

中介组的中介 A/B 实验状态。

枚举
EXPERIMENT_STATE_UNSPECIFIED 未设置的字段的默认值。请勿使用。
RUNNING 中介组有一项实验处于“正在运行”状态。
NOT_RUNNING 中介组中没有任何处于“RUNNING”状态的实验。

方法

create

在特定 AdMob 帐号下创建一个中介组。

list

列出指定 AdMob 帐号下的中介组。

patch

更新指定 AdMob 帐号下的指定中介组。