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/{mediationGroupId} 示例: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

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

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

中介组可用的状态类型。

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

ExperimentState

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

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

方法

create

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

list

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

patch

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