基于印象的再营销列表记录 - 批量

项目
11/13/2024

定义可在批量文件中下载和上传的基于展示的再营销列表。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 ImpressionBasedRemarketingLists 的 DownloadEntity 值，可以下载帐户中的所有基于印象的再营销列表记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

以下批量 CSV 示例将添加新的基于展示的再营销列表。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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
印象市场活动 ID
成员资格持续时间
修改时间
父 ID
Scope
状态
支持的市场活动类型

受众

基于展示的再营销列表的名称。

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

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

受众网络大小

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

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

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

访问群体搜索大小

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

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

在构建受众时，此属性最多为空 24 小时，例如，如果添加或更新基于展示的再营销列表成员资格持续时间、规则或标记标识符。

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

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

客户端 ID

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

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

说明

基于展示的再营销列表的说明。使用说明来帮助你记住此基于展示的再营销列表的目标受众。

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

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

实体类型

此实体类型基于用户查看广告的方式。创建基于展示的再营销列表时，必须指定实体类型。可能的值为 AdGroup 或 Campaign。

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

Id

基于展示的再营销列表的系统生成的标识符。

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

印象广告组 ID

用于创建基于展示的再营销列表的 AdGroupId。

加：如果实体类型为 AdGroup，则为必需。如果“实体类型”为 “市场活动”，则为空。
更新： 自选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

印象市场活动 ID

用于创建基于展示的再营销列表的 CampaignId。

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

成员资格持续时间

创建基于展示的再营销列表时，可以指定Microsoft广告应查找与基于印象的再营销列表定义相匹配的操作，以便将用户添加到列表中。

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

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

修改时间

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

注意

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

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

父 ID

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

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

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 规则，必须包含一个或多个规则项组。

重要

在 2021 日历年，我们添加了对 CNF) (连接正常形式的支持。以前Microsoft广告仅支持 (DNF) 的消除正常形式。新页面访问者规则的默认普通形式仍为 DNF。但是，必须确保应用程序可以适当地读取和区分 CNF 和 DNF。应用程序不应再假定该规则具有分离性。

如果普通窗体是 conjunctive (CNF) ，则首先使用逻辑 OR 运算符联接同一页的规则项条件。然后，使用逻辑 AND 运算符联接规则项组列表中的每个结果。换句话说，如果满足所有规则项组中的任何指定规则项条件，则将用户添加到基于展示的再营销列表中。

规则 1 和规则 2
(规则 1 或规则 2) 和规则 3
(规则 1 或规则 2) and (规则 3 或规则 4)

如果普通窗体 (DNF) 分离，则首先使用逻辑 AND 运算符联接同一页的规则项条件。然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。换句话说，如果满足任何一个规则项组中的所有指定规则项条件，则将用户添加到基于展示的再营销列表。

规则 1 或规则 2
(规则 1 和规则 2) 或规则 3
(规则 1 和规则 2) 或 (规则 3 和规则 4)

对于 DNF 计算的示例，假设以下规则项组在批量文件中设置为逻辑表达式：

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) 。如果范围设置为 “客户”，则基于展示的再营销列表可以与所有客户帐户中的任何市场活动和广告组相关联。

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

状态

基于展示的再营销列表状态。

可能的值为 Active 或 Deleted。

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

支持的市场活动类型

支持此基于展示的再营销列表的市场活动类型的分号分隔列表。

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

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

通过

基于印象的再营销列表记录 - 批量

受众

受众网络大小

访问群体搜索大小

客户端 ID

说明

实体类型

Id

印象广告组 ID

印象市场活动 ID

成员资格持续时间

修改时间

父 ID

CustomEvents 规则模板

PageVisitors 规则模板

PageVisitorsWhoDidNotVisitAnotherPage 规则模板

PageVisitorsWhoVisitedAnotherPage 规则模板

范围

状态

支持的市场活动类型

反馈

其他资源