- 资源:广告客户
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- AdvertiserBillingConfig
- 方法
资源:Advertiser
Display & Video 360 (DV360) 中的单个广告客户。
JSON 表示法 |
---|
{ "name": string, "advertiserId": string, "partnerId": string, "displayName": string, "entityStatus": enum ( |
字段 | |
---|---|
name |
仅限输出。广告客户的资源名称。 |
advertiserId |
仅限输出。广告客户的唯一 ID。由系统分配。 |
partnerId |
必需。不可变。相应广告客户所属合作伙伴的唯一 ID。 |
displayName |
必需。广告客户的显示名称。 必须采用 UTF-8 编码,大小上限为 240 字节。 |
entityStatus |
必需。控制广告客户的广告订单和订单项能否支出预算并对广告资源出价。
|
updateTime |
仅限输出。上次更新广告客户时的时间戳。由系统分配。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
generalConfig |
必需。广告客户的一般设置。 |
adServerConfig |
必需。不可变。广告客户的广告服务器相关设置。 |
creativeConfig |
必需。广告客户的广告素材相关设置。 |
dataAccessConfig |
用于控制广告客户数据访问方式的设置。 |
integrationDetails |
广告客户的集成详细信息。目前,只有 |
servingConfig |
与广告客户的广告投放相关的定位设置。 |
prismaEnabled |
是否已启用与 Mediaocean (Prisma) 的集成。启用此功能即表示您同意以下条款: 我谨代表本公司授权 Mediaocean (Prisma) 将预算期方案发送给 Google,并授权 Google 将相应的 DV360 报告和账单发送给 Mediaocean,以完成与此广告客户相关的预算规划、结算和对账事宜。 |
billingConfig |
必需。广告客户的结算相关设置。 |
containsEuPoliticalAds |
可选。相应广告客户是否包含投放欧盟政治广告的订单项。 如果此字段设置为
|
AdvertiserGeneralConfig
广告客户的一般设置。
JSON 表示法 |
---|
{ "domainUrl": string, "timeZone": string, "currencyCode": string } |
字段 | |
---|---|
domainUrl |
必需。广告客户主要网站的网域网址。系统会将此信息发送给需要网站网址才能将广告系列与广告客户相关联的发布商。 请提供一个不含路径或查询字符串且以 |
timeZone |
仅限输出。广告客户时区的标准 TZ 数据库名称。例如 如需了解详情,请访问:https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 对于 CM360 混合型广告客户,时区与关联的 CM360 账号的时区相同;对于仅限第三方广告客户,时区与父级合作伙伴的时区相同。 |
currencyCode |
必需。不可变。广告客户的币种(采用 ISO 4217 格式)。 可接受的代码及其代表的币种如下: 货币代码:货币名称
|
AdvertiserAdServerConfig
广告客户的广告服务器相关设置。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 ad_server_config_scheme 。必需。ad_server_config_scheme 只能是下列其中一项: |
|
thirdPartyOnlyConfig |
仅使用第三方广告服务器的广告客户的配置。 |
cmHybridConfig |
同时使用 Campaign Manager 360 (CM360) 和第三方广告服务器的广告客户的配置。 |
ThirdPartyOnlyConfig
仅使用第三方广告服务器的广告客户的设置。
JSON 表示法 |
---|
{ "pixelOrderIdReportingEnabled": boolean } |
字段 | |
---|---|
pixelOrderIdReportingEnabled |
是否为像素启用了订单 ID 报告功能。此值一旦设置为 |
CmHybridConfig
同时使用 Campaign Manager 360 (CM360) 和第三方广告服务器的广告客户的设置。
JSON 表示法 |
---|
{ "cmAccountId": string, "cmFloodlightConfigId": string, "cmAdvertiserIds": [ string ], "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } |
字段 | |
---|---|
cmAccountId |
必需。不可变。与相应 DV360 广告客户相关联的 CM360 Floodlight 配置的账号 ID。 |
cmFloodlightConfigId |
必需。不可变。与 DV360 广告客户相关联的 CM360 Floodlight 配置的 ID。 |
cmAdvertiserIds[] |
仅限输出。共享 CM360 Floodlight 配置的一组 CM360 广告客户 ID。 |
cmSyncableSiteIds[] |
CM360 网站的列表,这些网站的展示位置将作为广告素材同步到 DV360。 如果 从该列表中移除网站可能会导致从 CM360 同步的 DV360 广告素材被删除。必须至少指定一个网站。 |
dv360ToCmDataSharingEnabled |
是否将 DV360 数据纳入 CM360 数据传输报告中。 |
dv360ToCmCostReportingEnabled |
是否向 CM360 报告 DV360 费用。 |
cmFloodlightLinkingAuthorized |
必需。不可变。通过将此字段设置为 |
AdvertiserCreativeConfig
广告客户的广告素材相关设置。
JSON 表示法 |
---|
{ "iasClientId": string, "obaComplianceDisabled": boolean, "dynamicCreativeEnabled": boolean, "videoCreativeDataSharingAuthorized": boolean } |
字段 | |
---|---|
iasClientId |
Integral Ad Service (IAS) 提供的用于配置广告系列监测的 ID。DV360 系统会将包含此 ID 的 IAS“广告系列监控”代码附加到广告素材代码。 |
obaComplianceDisabled |
是否停用 Google 的“关于此广告”功能,该功能会根据线上行为广告 (OBA) 和法规要求,在您的广告中添加标记(用于将内容标示为广告)和透明度信息(在与“关于此广告”互动时)。“关于此广告”功能可让用户更好地控制自己看到的广告,还能帮助您解释为什么他们会看到您的广告。了解详情。 如果您选择将此字段设置为
|
dynamicCreativeEnabled |
广告客户是否已启用动态广告素材。 |
videoCreativeDataSharingAuthorized |
通过将此字段设置为 仅当广告客户具有 |
AdvertiserDataAccessConfig
用于控制广告客户相关数据的访问方式的设置。
JSON 表示法 |
---|
{
"sdfConfig": {
object ( |
字段 | |
---|---|
sdfConfig |
广告客户的结构化数据文件 (SDF) 设置。 如果未指定,则使用父合作伙伴的 SDF 设置。 |
AdvertiserSdfConfig
广告客户的结构化数据文件 (SDF) 设置。
JSON 表示法 |
---|
{
"overridePartnerSdfConfig": boolean,
"sdfConfig": {
object ( |
字段 | |
---|---|
overridePartnerSdfConfig |
相应广告客户是否会替换其父级合作伙伴的 SDF 配置。 默认情况下,广告客户会沿用父级合作伙伴的 SDF 配置。如需替换合作伙伴配置,请将此字段设置为 |
sdfConfig |
相应广告客户的 SDF 配置。
|
AdvertiserTargetingConfig
与广告客户的广告投放相关的定位设置。
JSON 表示法 |
---|
{ "exemptTvFromViewabilityTargeting": boolean } |
字段 | |
---|---|
exemptTvFromViewabilityTargeting |
联网电视设备是否不受相应广告客户下所有视频订单项的可见度定位条件制约。 |
AdvertiserBillingConfig
广告客户的结算相关设置。
JSON 表示法 |
---|
{ "billingProfileId": string } |
字段 | |
---|---|
billingProfileId |
必需。分配给广告客户的结算资料的 ID。 |
方法 |
|
---|---|
|
审核广告客户。 |
|
创建新的广告客户。 |
|
删除广告客户。 |
|
修改单个广告客户下的定位选项。 |
|
获取广告客户。 |
|
列出当前用户可访问的广告客户。 |
|
列出广告客户在各种定位类型中分配的定位选项。 |
|
用于更新现有广告客户。 |