市场活动产品范围记录 - 批量

项目
11/14/2024

定义市场活动级别的产品范围，其中包含有助于确定目录中要包含哪些商品的条件列表，例如，按品牌或条件进行筛选。

可以将市场活动产品范围用于购物市场活动和基于源的受众市场活动，即利用Microsoft商家中心商店 ID 的营销活动。产品范围允许你选择目录中的哪些项要包含在市场活动中，例如，按品牌或条件进行筛选。

提示

有关Microsoft购物市场活动的概述和详细信息，请参阅产品广告技术指南。

注意

智能购物市场活动不支持市场活动级别的产品范围条件，即市场活动类型设置为“购物”和“子类型”设置为“购物”的营销活动。

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

如果提供了有效的父 ID 值，下面的批量 CSV 示例将添加新的市场活动产品范围。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

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
产品条件 1
产品条件 2
产品条件 3
产品条件 4
产品条件 5
产品条件 6
产品条件 7
产品操作员 1
产品操作员 2
产品操作员 3
产品操作员 4
产品操作员 5
产品操作员 6
产品操作员 7
产品价值 1
产品价值 2
产品价值 3
产品价值 4
产品价值 5
产品价值 6
产品价值 7
状态

Campaign

包含产品范围的市场活动的名称。

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

注意

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

客户端 ID

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

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

Id

产品范围的系统生成的标识符。

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

修改时间

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

注意

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

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

父 ID

包含产品范围的市场活动的系统生成的标识符。

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

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

注意

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

产品条件 1

条件的操作数。操作数隐式包含相等运算符。例如，可以将 Brand 读取为 Brand=。

使用每个产品条件作为相应产品值的操作数。

产品条件 (操作数)	产品值 (属性)	产品操作员 (运算符)
产品条件 1	产品价值 1	产品操作员 1
产品条件 2	产品价值 2	产品操作员 2
产品条件 3	产品价值 3	产品操作员 3
产品条件 4	产品价值 4	产品操作员 4
产品条件 5	产品价值 5	产品操作员 5
产品条件 6	产品价值 6	产品操作员 6
产品条件 7	产品价值 7	产品操作员 7

如果产品的属性值等于操作数的属性值，则满足每个条件。例如，如果操作数设置为 Brand，并将属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

注意

对于添加和更新，至少需要一个产品条件和值对，并且索引号没有相关性。例如，可以为 “产品条件 2” 和“ 产品值 2 ”指定有效值，并将剩余的条件和值字段留空。

加：自选
更新： 只读。不能更新条件或值字段。若要更新条件，必须删除产品范围并添加新范围。
删除： 只读

有关每个市场活动类型支持的产品条件 (操作数) 和产品价值 (属性) ，请参阅下表。

Feed-Based 受众市场活动的产品条件

可以为每个基于源的受众市场活动指定多个产品条件。如果产品的属性值等于操作数的属性值，则满足每个条件。例如，如果操作数设置为 Brand，并将属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

产品条件 (操作数)	产品价值 (属性) 说明	业务规则
品牌	产品的制造商、品牌或发布者。最多 1,000 个字符。	每个市场活动产品范围筛选器只能指定一次品牌操作数。
条件	产品的条件。如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。	每个市场活动产品范围筛选器只能指定一次条件操作数。
ProductType1-5 提供五个产品类型操作数值，即 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。	商家定义的产品类型或类别。 ProductType1 是最高级别的产品类型，ProductType5 是最低级别或最精细的产品类型。最多 100 个字符。	每个产品类型操作数可以按市场活动产品范围筛选器使用一次。如果将操作数设置为从 1 到 5 的产品类型，则必须按升序指定它们。例如，如果较高级别的产品分区的操作数为“ProductType1”且属性为“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。
CustomLabel0-4 提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。	由商家定义的自定义标签。自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。最多 100 个字符。	每个 CustomLabel 操作数可以为每个市场活动产品范围筛选器使用一次。

购物活动的产品条件

可以为每个Microsoft购物市场活动和广告组指定多个产品条件。如果产品的属性值等于操作数的属性值，则满足每个条件。例如，如果操作数设置为 Brand，属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

在购物市场活动中，可以在市场活动级别和广告组级别设置产品条件。下表描述了市场活动产品范围和广告组产品分区记录) 业务规则 (操作数) 和产品价值 (属性。

产品条件 (操作数)	产品价值 (属性) 说明	市场活动产品范围规则	广告组产品分区规则
全部	必须为 null。	不适用。	对于广告组的产品分区，根节点的操作数必须设置为“All”，并将属性设置为 null 或空。
品牌	产品的制造商、品牌或发布者。最多 1,000 个字符。	每个市场活动产品范围筛选器只能指定一次品牌操作数。	Brand 操作数可以在多个分支中使用，但每个分支只能指定一次。
CategoryL1-5 有五个类别操作数值可用，即 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。	由Microsoft商家中心商店定义的产品类别。 CategoryL0 是最高级别的类别，CategoryL4 是最低级别或最精细的类别。最多 100 个字符。	每个 CategoryL 操作数可按市场活动产品范围筛选器使用一次。如果指定将操作数设置为 1 到 5 的产品类别的产品条件，它们必须按升序进行指定。例如，如果前面的产品条件的操作数为“CategoryL1”且属性为“Animals & 宠物用品”，则可以将操作数设置为“CategoryL2”。	每个 CategoryL 操作数都可以在多个分支中使用，但每个分支只能指定一次。例如，一个分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作数的另一个节点。如果将操作数设置为从 1 到 5 的产品类别，则必须按升序指定它们。例如，如果高级产品分区的操作数为“CategoryL1”且属性为“Animals & 宠物用品”，则可以将操作数设置为“CategoryL2”。无需在直接父分区中指定以前的级别产品类别操作数。例如，如果父分区的父级指定 CategoryL1 条件，则可为其分区指定 CategoryL2 条件。
频道	本地库存广告 (LIA) 频道。可能的值包括“本地存储”和“Online”。如果市场活动尚未选择加入本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。有关详细信息，请参阅本地库存广告帮助页。	每个市场活动产品范围筛选器只能指定一次通道操作数。	通道操作数可以在多个分支中使用，但每个分支只能指定一次。
ChannelExclusivity	本地库存广告 (LIA) 频道排他性。可能的值包括“单通道”和“多通道”。如果市场活动尚未选择加入本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。有关详细信息，请参阅本地库存广告帮助页。	每个市场活动产品范围筛选器只能指定一次 ChannelExclusivity 操作数。	ChannelExclusivity 操作数可以在多个分支中使用，但每个分支只能指定一次。
条件	产品的条件。如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。	每个市场活动产品范围筛选器只能指定一次条件操作数。	Condition 操作数可以在多个分支中使用，但每个分支只能指定一次。
CustomLabel0-4 提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。	由商家定义的自定义标签。自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。最多 100 个字符。此操作数不适用于赞助产品。	每个 CustomLabel 操作数可以为每个市场活动产品范围筛选器使用一次。	每个 CustomLabel 操作数都可以在多个分支中使用，但每个分支只能指定一次。例如，一个分支可能包含 CustomLabel0 和 CustomLabel1，但不能包含具有 CustomLabel1 操作数的另一个节点。
GTIN	商家定义的全球贸易项编号。 GTIN 字段限制为 50 个字符，每个 GTIN 值最多包含 14 位数字。此操作数仅适用于赞助产品。	每个市场活动产品范围筛选器只能指定一次 GTIN 操作数。	GTIN 操作数可以在多个分支中使用，但每个分支只能指定一次。
Id	商家定义的产品标识符。最多 1,000 个字符。	每个市场活动产品范围筛选器只能指定 ID 操作数一次。	ID 操作数可以在多个分支中使用，但每个分支只能指定一次。
MPN	商家定义的全球贸易项编号。最多 70 个字符。此操作数仅适用于赞助产品。	每个市场活动产品范围筛选器只能指定 MPN 操作数一次。	MPN 操作数可以在多个分支中使用，但每个分支只能指定一次。
ProductType1-5 提供五个产品类型操作数值，即 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。	商家定义的产品类型或类别。 ProductType1 是最高级别的产品类型，ProductType5 是最低级别或最精细的产品类型。最多 100 个字符。此操作数不适用于赞助产品。	每个产品类型操作数可以按市场活动产品范围筛选器使用一次。如果指定将操作数设置为 1 到 5 的产品类型的产品条件，它们必须按升序进行指定。例如，如果前面的产品条件的操作数“ProductType1”具有属性“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。	每个 ProductType 操作数都可以在多个分支中使用，但每个分支只能指定一次。例如，一个分支可能包含 ProductType1 和 ProductType2，但不能包含具有 ProductType2 操作数的另一个节点。如果将操作数设置为从 1 到 5 的产品类型，则必须按升序指定它们。例如，如果较高级别的产品分区的操作数为“ProductType1”且属性为“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。无需在直接父分区中指定以前的级别产品类型操作数。例如，如果父级的父级指定了 ProductType1 条件，则可为其分区指定 ProductType2 条件。

产品操作员 1

条件的运算符值。运算符值 等于或notequal。

产品范围的状态。

可能的值为 Active 或 Deleted。

加：自选。唯一可能的状态是 “活动”。如果将状态设置为 “已删除” ，则会忽略它，并且返回的记录的状态将设置为 “活动”。
更新： 自选
删除： 必填。 “状态”必须设置为 “已删除”。

通过

市场活动产品范围记录 - 批量

Campaign

客户端 ID

Id

修改时间

父 ID

产品条件 1

Feed-Based 受众市场活动的产品条件

购物活动的产品条件

产品条件 2

产品条件 3

产品条件 4

产品条件 5

产品条件 6

产品条件 7

产品操作员 1

产品操作员 2

产品操作员 3

产品操作员 4

产品操作员 5

产品操作员 6

产品操作员 7

产品价值 1

产品价值 2

产品价值 3

产品价值 4

产品价值 5

产品价值 6

产品价值 7

状态

反馈

其他资源