瞭解精選套裝組合

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 欄位中指定的底價，以及發布商底價和總策展費的總和，並將較高的值傳送給競價者。

注意： 精選套裝組合的底價包含收錄費用總額。

下表提供範例，說明如何計算精選套件出價要求中傳送的有效底價：

發布商底價 (千次曝光出價)	收錄費用總額 (千次曝光出價)	精選套裝組合底價 (千次曝光出價)	有效底價 (千次曝光出價)
$7 美元	$2 美元	$10 美元	$10 美元
$4 美元	$1 美元	$4 美元	$5

控管精選套件的放送

精選套裝組合可能處於下列其中一種狀態：

• ACTIVE：精選套裝方案已啟用。訂閱的媒體企劃人員可以收到即時出價出價要求，其中包含目標廣告空間的精選套裝組合 ID。
• INACTIVE：精選套裝組合已停用。即使是已訂閱的媒體企劃人員，即時出價出價要求中也不會顯示精選套裝組合的 ID。

後續步驟

如要進一步瞭解可透過 curatedPackages 資源執行的工作流程，請參閱下列內容：

• 瞭解如何查看資料區隔
• 瞭解如何建立及管理精選套裝方案。
• 瞭解如何啟用及停用精選套裝組合。
• 瞭解如何查看精選套裝組合。