市场活动客户列表关联记录 - 批量

定义可在批量文件中上传和下载的“市场活动客户列表”关联。

受众目标不能同时设置市场活动级别和广告组级别。 如果设置了任何可出价市场活动级别受众标准,则不能设置任何可出价广告组受众级别访问群体条件。 受众排除可以在市场活动级别和广告组级别设置。 Microsoft Advertising 应用市场活动与广告组级别排除项的联合。

提示

有关访问群体的概述和详细信息,请参阅 受众 API 技术指南。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CampaignCustomerListAssociationsDownloadEntity 值,可以下载帐户中的所有市场活动客户列表关联记录。 此外,下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息(包括最佳做法),请参阅 批量下载和上传

如果提供了有效的 父 ID 值,下面的批量 CSV 示例将添加新的“市场活动客户列表关联”。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Customer List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,CustomerListIdHere,My Customer List

对于 市场活动客户列表关联 记录, 批量文件架构中提供了以下属性字段。

受众

客户列表的名称。

此批量字段映射到“客户列表”记录的“受众”字段。

添加: 对于某些用例,只读和必需。 必须指定 “受众” 或“ 访问群体 ID” 字段。 如果要在同一批量文件中添加新的“市场活动客户列表关联”,并且未设置“访问群体 ID”字段,则必须将此“访问群体”字段设置为与“客户列表”记录的“受众”字段相同的值的逻辑键。 有关详细信息,请参阅 批量文件架构引用密钥
更新: 只读
删除: 只读

访问群体 ID

与市场活动关联的客户列表的 Microsoft Advertising 标识符。

此批量字段映射到“客户列表”记录的“ID”字段。

添加: 对于某些用例,只读和必需。 必须指定 “受众” 或“ 访问群体 ID” 字段。 如果设置“访问群体 ID”字段,则必须指定现有客户列表标识符,或指定等于父客户列表记录的 ID 字段的负标识符。 如果未设置“访问群体 ID”字段,则必须将“访问群体”字段设置为与“客户列表”记录的“受众”字段相同的逻辑键。 如果要在同一批量文件中添加具有新客户列表的新市场活动客户列表关联,则建议使用上述任何选项。 有关详细信息,请参阅 批量文件架构引用密钥
更新: 只读
删除: 只读

出价调整

要增加/减少客户列表的出价金额的百分比。

支持的值为负 90 (-90.00) 到正 900 (900.00) 。

重要

如果未指定,则默认出价调整值为 0。 默认值可能会更改。

添加:
更新: 选。 如果未为更新设置任何值,则不会更改此设置。
删除: 只读

Campaign

与客户列表关联的市场活动的名称。

添加: 只读和必需
更新: 只读和必需
删除: 只读和必需

注意

若要添加、更新和删除,必须指定 “父 ID ”或 “市场活动” 字段。

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。

添加:
更新:
删除: 只读

Id

市场活动与客户列表之间关联的系统生成的标识符。

添加: 只读
更新: 只读和必需
删除: 只读和必需

修改时间

上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间,而不是客户端。 有关日期和时间格式的信息,请参阅 基元 XML 数据类型中的 dateTime 条目。

添加: 只读
更新: 只读
删除: 只读

父 ID

与客户列表关联的市场活动的系统生成的标识符。

此批量字段映射到市场活动记录的 ID 字段。

添加: 只读和必需。 必须指定现有的市场活动标识符,或指定等于父市场活动记录的 ID 字段的负标识符。 如果将客户列表关联到同一批量文件中的新市场活动,则建议这样做。 有关详细信息,请参阅 批量文件架构引用密钥
更新: 只读和必需
删除: 只读和必需

注意

若要添加、更新和删除,必须指定 “父 ID ”或 “市场活动” 字段。

状态

关联状态。

可能的值为 ActivePausedDeleted

添加: 选。 默认状态值为 “活动”。
更新:
删除: 必填。 “状态”必须设置为 “已删除”。