キュレートされたパッケージの詳細

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 共用体フィールドを使用してキュレーション手数料を設定する必要があります。また、 手数料タイプ（feeCpm フィールドなど）のいずれか 1 つのみを入力できます。CuratedPackage特定のインプレッションのキュレーション手数料の合計は、キュレートされたパッケージの手数料と、そのインプレッションに適用されるターゲット データ セグメントの手数料の合計です。

キュレートされたパッケージのターゲットとするインプレッションの価値を通知するには、 CuratedPackage.floorPriceCpm フィールドを設定することもできます。このフィールドは、リアルタイム ビッダーに入札者に指定される最小価格に影響する可能性があります。 入札者に送信される最小価格は、floorPriceCpm フィールドで指定した最小価格と、パブリッシャーの最小価格とキュレーション手数料の合計を比較して、高い方の値になります。

次の表に、キュレートされたパッケージの入札リクエストで送信される有効な最小価格の計算方法の例を示します。

パブリッシャーの最小価格（CPM） キュレーション手数料の合計（CPM） キュレートされたパッケージの最小価格（CPM） 有効な最小価格（CPM）
$7 $2 $10 $10
$4 $1 $4 $5

キュレートされたパッケージの配信を管理する

キュレートされたパッケージは、次のいずれかの状態になります。

  • ACTIVE: キュレートされたパッケージは有効です。サブスクライブしているメディア プランナーは、ターゲットとする広告枠のキュレートされたパッケージの ID を含むリアルタイム ビッダーの入札リクエストを受け取ることができます。
  • INACTIVE: キュレートされたパッケージは無効です。サブスクライブしているメディア プランナーの場合でも、キュレートされたパッケージの ID はリアルタイム ビッダーの入札リクエストに表示されません。

次のステップ

curatedPackages リソースで実行できるワークフローについて詳しくは、次のコンテンツをご覧ください。