类似的再营销列表记录 - 批量

定义与再营销列表之一类似的受众。

Microsoft Advertising 将为再营销列表自动生成类似的受众。

注意

必须至少有一个与至少 1,000 名用户有活动关联的再营销列表,Microsoft Advertising 才能生成类似的受众。

类似的受众需要在搜索网络或 Microsoft 受众网络上至少有 300 个用户,然后才能将其与活动市场活动或广告组相关联。

类似的受众最多需要 24 小时才能生成,目标受众在该时间点之前不会生效。

不能为再营销列表创建或编辑类似的受众。 话虽如此,可以添加和删除类似的再营销列表关联和排除项。 如果删除源再营销列表,也会删除类似的受众。 如果类似的受众与市场活动或广告组相关联,则无法删除源再营销列表。

提示

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

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

下面是针对类似再营销列表的批量 CSV 示例下载。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Scope,Audience,Supported Campaign Types,Source Id
Format Version,,,,,,6.0,,,,
Similar Remarketing List,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Account,Similar Remarketing List,Search;DynamicSearchAds;Shopping;Audience,SourceRemarketingListIdHere

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ,则可以使用 BulkServiceManager 来节省时间来下载 BulkSimilarRemarketingList 对象,而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

// Map properties in the Bulk file to the BulkSimilarRemarketingList
var bulkSimilarRemarketingList = new BulkSimilarRemarketingList
{
    // Map properties in the Bulk file to the 
    // SimilarRemarketingList object of the Campaign Management service.
    SimilarRemarketingList = new SimilarRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Id' column header in the Bulk file
        Id = similarRemarketingListIdKey,
        // 'Audience' column header in the Bulk file
        Name = "Similar Remarketing List",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Source Id' column header in the Bulk file
        SourceId = sourceRemarketingListId,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

对于 类似再营销列表 记录, 批量文件架构中提供了以下属性字段。

受众

类似的再营销列表的名称由 Microsoft Advertising 设置。 该名称最多可包含 128 个字符。

名称最多可以包含 128 个字符

添加: 不支持
更新: 不支持
删除: 不支持

受众网络大小

在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。

在 Microsoft Advertising 使用它进行优化之前,受众至少需要有 300 人。

类似受众的受众网络大小可能与 再营销列表的受众网络大小不同。

添加: 不支持
更新: 不支持
删除: 不支持

访问群体搜索大小

搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。

在 Microsoft Advertising 使用它进行优化之前,受众至少需要有 300 人。

类似受众的受众搜索大小可能与 再营销列表的受众搜索大小不同。

在生成源再营销列表(例如,添加或更新再营销列表的再营销列表成员身份持续时间、规则或标记标识符)时,此属性将最多为零或空 24 小时。

如果与 再营销列表关联的 UET 标记的状态为“未验证”或“非活动”,则此属性将为零或空,因为再营销列表无法从您的网站接收生成列表所需的客户信息。

添加: 不支持
更新: 不支持
删除: 不支持

Id

类似受众的 Microsoft Advertising 标识符。

添加: 不支持
更新: 不支持
删除: 不支持

修改时间

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

注意

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

添加: 不支持
更新: 不支持
删除: 不支持

父 ID

帐户或客户的 Microsoft Advertising 标识符。

如果 “作用域 ”设置为 “帐户”,则这是帐户 ID,否则为客户 ID。

添加: 不支持
更新: 不支持
删除: 不支持

范围

作用域定义哪些帐户可以使用此受众。

类似受众的范围会自动设置为 再营销列表的范围。

如果将范围设置为 “帐户”,则受众只能与一个指定帐户中的市场活动和广告组相关联, (ParentId) 。 如果将范围设置为 “客户”,则受众可以与所有客户帐户中的任何市场活动和广告组相关联。

添加: 不支持
更新: 不支持
删除: 不支持

源 ID

Microsoft Advertising 用于生成此类似再营销列表的再营销列表的 Microsoft Advertising 标识符。

添加: 不支持
更新: 不支持
删除: 不支持

状态

类似的再营销列表状态。

可能的值为 ActiveDeleted

添加: 不支持
更新: 不支持
删除: 不支持

支持的市场活动类型

支持此类似再营销列表的市场活动类型的分号分隔列表。

支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型,因此不应依赖于一组固定值。

添加: 不支持
更新: 不支持
删除: 不支持