产品受众记录 - 批量

项目
11/13/2024

定义可在批量文件中下载和上传的产品受众。

注意

动态再营销列表以前称为Microsoft广告中的产品受众。你将在Microsoft广告 UI 中看到“动态再营销列表”，但为了避免中断性变更，API objet 仍被命名为“产品受众”。

动态再营销列表根据客户在您的网站上查看、考虑或已购买的内容，将客户与特定产品配对。可以在搜索市场和受众市场活动中使用动态再营销列表， (并非每个人都) 受众市场活动。

动态再营销列表最适合用于购物市场活动和基于源的受众市场活动，即利用Microsoft商家中心商店 ID 的营销活动。

重要

请务必编辑与网站上的 UET 标记 ID 对应的脚本， ecomm_prodid 以包含和 ecomm_pagetype 参数。 ecomm_prodid 参数是页面上产品的产品 ID。它对于每个项目都是唯一的，并且必须与产品源中的 id 或 item_group_id 属性匹配。数字和字母数字 (仅包含) 个字符的连字符，最多包含 50 个字符。 ecomm_pagetype 参数标识用户访问的页面类型。有效选项：主页、搜索、类别、产品、购物车、购买等。

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

提示

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

可以通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 ProductAudiences 的 DownloadEntity 值来下载帐户中的所有产品受众记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

以下批量 CSV 示例将添加新的产品受众。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,Search;DynamicSearchAds;Shopping;Audience

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkProductAudience);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

对于 产品受众 记录，批量文件架构中提供了以下属性字段。

受众
受众网络大小
访问群体搜索大小
客户端 ID
说明
Id
成员资格持续时间
修改时间
父 ID
产品受众类型
Scope
状态
支持的市场活动类型
UET 标记 ID

受众

产品受众的名称。

该名称最多可包含 128 个字符。

加：必填
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

受众网络大小

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

受众至少需要有 300 人，Microsoft广告将使用它进行优化。

加：只读
更新： 只读
删除： 只读

访问群体搜索大小

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

受众至少需要有 300 人，Microsoft广告将使用它进行优化。

在生成访问群体时，此属性最多为空 24 小时，例如，如果添加或更新产品访问群体成员资格持续时间、规则或标记标识符。

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

加：只读
更新： 只读
删除： 只读

客户端 ID

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

加：自选
更新： 自选
删除： 只读

说明

产品受众的说明。使用说明可帮助你记住此产品受众的目标受众。

说明最多可以包含 1,024 个字符。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读

Id

产品受众的系统生成的标识符。

加：只读
更新： 只读和必需
删除： 只读和必需

成员资格持续时间

创建产品受众时，可以指定Microsoft广告应查找与产品受众定义匹配的操作，以便将人员添加到列表中。

最短持续时间为 1 天，允许的最大持续时间为 180 天。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

修改时间

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

注意

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

加：只读
更新： 只读
删除： 只读

父 ID

帐户或客户的系统生成的标识符。如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。

加：自选
更新： 只读。不能更改父 ID。
删除： 只读

产品受众类型

确定要添加到产品受众的人员。

可能的值为 GeneralVisitors、ProductSearchers、ProductViewers、ShoppingCartAbandoners 和 PastBuyers。

加：必填
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

范围

范围定义哪些帐户可以使用此产品受众。如果范围设置为 “帐户”，则产品受众只能与一个指定帐户中的市场活动和广告组相关联， (父 ID) 。如果范围设置为 “客户”，则产品受众可以与所有客户帐户中的任何市场活动和广告组相关联。

加：必填
更新： 只读。不能更改范围。
删除： 只读

状态

产品受众状态。

可能的值为 Active 或 Deleted。

加：自选。默认值为 Active。
更新： 只读
删除： 必填。 “状态”必须设置为 “已删除”。

支持的市场活动类型

支持此产品受众的市场活动类型的分号分隔列表。

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

加：只读
更新： 只读
删除： 只读

UET 标记 ID

与产品受众一起使用的通用事件跟踪 (UET) 标记的Microsoft广告标识符。

重要

请务必编辑网站上的 UET 脚本，以包含 prodid 和 pagetype 参数。

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

加：必填
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

CustomEvents 规则模板

对于 CustomEvents 规则，必须包含以下一个或多个条件事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。如果指定了多个条件，则使用逻辑 AND 运算符联接这些条件。换句话说，仅当满足所有指定的规则条件时，才会将访问者添加到产品受众。

例如，假设以下自定义事件在大容量文件中设置为逻辑表达式：

CustomEvents (Category Equals video) and (Action Equals play) 和 (Label Equals 预告片) 和 (Value 等于 5)

计算逻辑表达式确定将添加到产品受众的人员。

PageVisitors 规则模板

对于 PageVisitors 规则，必须包含一个或多个规则项组。对于每个规则项组，将使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。换句话说，如果满足任何一个规则项组中的所有指定规则项条件，则将用户添加到产品受众。

例如，假设以下规则项组在大容量文件中设置为逻辑表达式：

PageVisitors ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) )

对逻辑表达式的求值确定将向产品受众添加以下示例中的哪一个用户。

用户	已访问的 URL	引用网站 URL	已添加到列表
用户 1	A	X	是。逻辑表达式的计算结果为 True。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) (False 和 True) 或 (True) 或 (False) False 或 True 或 False True
用户 2	B	Y	不正确。逻辑表达式的计算结果为 False。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) (False 和 True) 或 (False) 或 (False) False 或 False 或 False False
用户 3	C	Z	是。逻辑表达式的计算结果为 True。 ( (Url 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) (False 和 False) 或 (True) 或 (True) False 或 True 或 True True

PageVisitorsWhoDidNotVisitAnotherPage 规则模板

再营销规则是用于确定要添加到产品受众的条件。对于 PageVisitorsWhoDidNotVisitAnotherPage 规则，必须包含一个或多个已访问页面的规则项组 (IncludeRuleItemGroups) ，并且还必须包括一个或多个未访问的页面的规则项组 (ExcludeRuleItemGroups) 。

对于 IncludeRuleItemGroups 中的每个规则项组，将使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。

同样，对于 ExcludeRuleItemGroups 中的每个规则项组，将使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。最后，逻辑 NOT 运算符将应用于排除规则项组的聚合结果。

换句话说，如果满足任何包含规则项组条件，并且不满足排除规则项组条件，则将访问者添加到产品受众。

例如，假设以下规则项组在大容量文件中设置为逻辑表达式：

( ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (引用erUrl 等于 Z) ) ) ，而不是 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) )

对逻辑表达式的求值确定将向产品受众添加以下示例中的哪一个用户。

用户	已访问的 URL	引用网站 URL	已添加到列表
用户 1	A	X	是。逻辑表达式的计算结果为 True。 ( ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (引用erUrl 等于 Z) ) ) ，而不是 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 True) 或 (True) 或 (False) ) ，而不是 ( (True 和 False) 或 (False) ) (False 或 True 或 False) ，而不是 (False 或 False) True 和 not False True
用户 2	B	Y	是。逻辑表达式的计算结果为 True。 ( ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (引用erUrl 等于 Z) ) ) ，而不是 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 True) 或 (True) 或 (False) ) ，而不是 ( (False 和 False) 或 (False) ) (False 或 True 或 False) ，而不是 (False 或 False) True 和 not False True
用户 3	C	Z	不正确。逻辑表达式的计算结果为 False。 ( ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (引用erUrl 等于 Z) ) ) ，而不是 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 False) 或 (True) 或 (True) ) ，而不是 ( (False) 或 (True) ) (False 或 True 或 True) ，而不 (False 或 True) True 和 not True False

PageVisitorsWhoVisitedAnotherPage 规则模板

再营销规则是用于确定要添加到产品受众的条件。对于 PageVisitorsWhoVisitedAnotherPage 规则，必须包含一个或多个规则项组，用于访问的页 (RuleItemGroups) ，并且还必须包含一个或多个规则项组，用于必须已访问的另一个页面 (AnotherRuleItemGroups) 。

对于 RuleItemGroups 中的每个规则项组，将使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。

同样，对于 AnotherRuleItemGroups 中的每个规则项组，将使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。

换句话说，如果满足任何规则项组条件，并且满足其他任何规则项组条件，则将访问者添加到产品受众。

例如，假设以下规则项组在大容量文件中设置为逻辑表达式：

( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) ) 和 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) )

对逻辑表达式的求值确定将向产品受众添加以下示例中的哪一个用户。

用户	已访问的 URL	引用网站 URL	已添加到列表
用户 1	A	X	不正确。逻辑表达式的计算结果为 False。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) ) 和 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 True) 或 (True) 或 (False) ) 和 ( (true 和 False) 或 (False) ) ) (False 或 True 或 False， (False 或 False) True 和 False False
用户 2	B	Y	不正确。逻辑表达式的计算结果为 False。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) ) 和 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 True) 或 (True) 或 (False) ) 和 ( (False) 或 (False) ) ) (False 或 True 或 False， (False 或 False) True 和 False False
用户 3	C	Z	是。逻辑表达式的计算结果为 True。 ( ( (Url 包含 X) 和 (ReferrerUrl NotEquals Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等于 Z) ) ) 和 ( ( (Url BeginsWith A) 和 (ReferrerUrl BeginsWith B) ) 或 ( (Url 包含 C) ) ) ( (False 和 True) 或 (True) 或 (True) ) ， ( (False 和 False) 或 (True) ) (False 或 True 或 True) ， (False 或 True) True 和 True True

通过

产品受众记录 - 批量

受众

受众网络大小

访问群体搜索大小

客户端 ID

说明

Id

成员资格持续时间

修改时间

父 ID

产品受众类型

范围

状态

支持的市场活动类型

UET 标记 ID

CustomEvents 规则模板

PageVisitors 规则模板

PageVisitorsWhoDidNotVisitAnotherPage 规则模板

PageVisitorsWhoVisitedAnotherPage 规则模板

反馈

其他资源