了解精选资源包

借助 curators.curatedPackages 资源，您可以以编程方式创建和管理您代表媒体策划人员精心挑选的发布商广告资源包。

通过甄选包，您可以将符合特定定位条件（例如设备类型、地理位置和细分受众群）的精选广告资源分组，并指定甄选费用。当买方赢得甄选包定位到的展示机会时，系统会收取该费用。

了解主要概念

在开始集成之前，请先查看用于定义精选软件包运作方式的字段和设置：

控制哪些人可以访问您的精选套餐

只有您使用 CuratedPackage.accessSettings 字段明确授予访问权限的媒体策划人员才能访问您精选的资源包。创建精选软件包时，您必须填充 accessSettings 字段。

您可以使用 mediaPlanners.list 方法查看符合条件可指定在 CuratedPackage.accessSettings.allowlistedMediaPlanners 字段中的媒体策划人员列表。

注意： 您无法创建向多个媒体策划人员授予访问权限的精选软件包。

配置甄选包定位到的广告资源

您可以使用 CuratedPackage.targeting 字段指定精选套装所定位的商品目录。targeting 字段填充了 PackageTargeting 对象，该对象支持定位条件，例如设备类型、广告格式和地理位置。

您还可以使用 CuratedPackage.targeting.includedDataSegments 字段指定自定义定位条件。通过 includedDataSegments 字段，您可以定位到您或其他甄选合作伙伴管理的基于数据的细分受众群。

了解定位逻辑

重复字段中的值会使用逻辑 OR 进行处理，这意味着适用于任何指定值的展示都属于匹配的展示。 系统会使用逻辑 AND 处理每个字段，这意味着所有指定字段都必须与给定的展示匹配，精选包才能显示在相应的出价请求中。

以下示例创建了一个精选软件包，其中填充了 CuratedPackage.targeting 字段，以定位到设备类型和数据段的组合：

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

下表显示了示例中的精选包是否定位到展示，其中每行代表一次不同的展示：

设备类型	基于数据的细分受众群 ID	是否定位到甄选广告资源包？
DEVICE_TYPE_PERSONAL_COMPUTER	8765、8172	是
DEVICE_TYPE_PHONE	8172、4321	是
DEVICE_TYPE_PHONE	9182	否
DEVICE_TYPE_CONNECTED_TV	4321、9182	否

表明精选套餐的价值

创建精选内容包时，您必须使用 CuratedPackage.fee 联合字段设置精选费用，并且只能填充 CuratedPackage 对象支持的一种费用类型，例如 feeCpm 字段。给定展示的策展总费用是策展套餐费用以及适用于该展示的所有定位数据段的费用之和。

您还可以通过设置 CuratedPackage.floorPriceCpm 字段来指明精选广告包所定位的展示的价值，这可能会影响实时出价中向出价方指定的底价。发送给出价方的底价是您在 floorPriceCpm 字段中指定的底价与发布商底价和总精选费用的总和这两者中的较高值。

注意： 甄选资源包的最低价格包含甄选费总额。

下表提供了示例，展示了如何计算精选广告资源包的出价请求中发送的有效底价：

发布商底价（每千次展示费用）	甄选费总额（每千次展示费用）	精选资源包底价 (CPM)	有效底价（每千次展示费用）
$7	$2	$10	$10
$4	$1	$4	$5

控制精选内容包的投放

精选内容包可能处于以下任一状态：

• ACTIVE：精选套餐处于有效状态。订阅的媒体策划人员可以接收实时出价出价请求，其中包含目标广告资源的精选广告资源包 ID。
• INACTIVE：精选包处于非有效状态。即使是订阅的媒体策划人员，精选包的 ID 也不会显示在实时出价出价请求中。

后续步骤

如需详细了解如何使用 curatedPackages 资源执行工作流，请查看以下内容：

• 了解如何查看数据细分受众群
• 了解如何创建和管理精选软件包。
• 了解如何启用和停用精选套餐。
• 了解如何查看精选套餐。