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

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 フィールドなど）のいずれか 1 つのみを入力できます。特定のインプレッションのキュレーション料金の合計は、キュレーション パッケージの料金と、そのインプレッションに適用されるターゲット データ セグメントの料金の合計です。

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

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

パブリッシャーの最小価格（CPM） 合計キュレーション料金（CPM） キュレーション パッケージの最小価格（CPM） 有効な下限額（CPM）
$7 $2 $10 $10
$4 $1 $4 $5

キュレーションされたパッケージの配信を制御する

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

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

次のステップ

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