Mempelajari Paket Pilihan

Dengan resource curators.curatedPackages, Anda dapat membuat dan mengelola paket inventaris penayang secara terprogram yang Anda seleksi atas nama perencana media.

Paket pilihan memungkinkan Anda mengelompokkan inventaris tertentu yang memenuhi kriteria penargetan tertentu, seperti jenis perangkat, geografi, dan segmen data, serta menetapkan biaya kurator yang dibebankan saat pembeli memenangkan tayangan iklan yang ditargetkan oleh paket pilihan.

Memahami konsep utama

Sebelum memulai integrasi, tinjau kolom dan setelan yang menentukan cara kerja paket pilihan:

Mengontrol siapa yang dapat mengakses paket pilihan Anda

Paket pilihan Anda hanya dapat diakses oleh perencana media yang telah Anda beri akses secara eksplisit menggunakan kolom CuratedPackage.accessSettings. Anda harus mengisi kolom accessSettings saat paket pilihan dibuat.

Anda dapat menggunakan metode mediaPlanners.list untuk melihat daftar perencana media yang memenuhi syarat untuk ditentukan di kolom CuratedPackage.accessSettings.allowlistedMediaPlanners.

Mengonfigurasi inventaris yang ditargetkan paket pilihan Anda

Anda dapat menggunakan kolom CuratedPackage.targeting untuk menentukan inventaris yang ditargetkan oleh paket pilihan Anda. Kolom targeting diisi dengan objek PackageTargeting, yang mendukung kriteria penargetan seperti jenis perangkat, format materi iklan, dan lokasi geografis.

Anda juga dapat menentukan penargetan yang disesuaikan dengan kolom CuratedPackage.targeting.includedDataSegments. Kolom includedDataSegments memungkinkan Anda menargetkan segmen data yang dikelola oleh Anda atau partner seleksi lainnya.

Memahami logika penargetan

Nilai dalam kolom berulang diproses menggunakan OR logis, yang berarti bahwa tayangan iklan yang berlaku untuk salah satu nilai yang ditentukan adalah kecocokan. Setiap kolom diproses menggunakan logika AND, yang berarti semua kolom yang ditentukan harus cocok dengan tayangan tertentu agar paket pilihan muncul dalam permintaan bid yang sesuai.

Contoh berikut membuat paket pilihan dengan kolom CuratedPackage.targeting yang diisi untuk menargetkan kombinasi jenis perangkat dan segmen data:

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

Tabel berikut menunjukkan apakah paket pilihan dari contoh menargetkan tayangan iklan, dengan setiap baris adalah tayangan iklan yang berbeda:

Jenis Perangkat ID Segmen Data Apakah paket pilihan ditargetkan?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Ya
DEVICE_TYPE_PHONE 8172, 4321 Ya
DEVICE_TYPE_PHONE 9182 Tidak
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Tidak

Menyampaikan nilai paket pilihan Anda

Anda harus menetapkan biaya kurasi menggunakan kolom gabungan CuratedPackage.fee saat membuat paket pilihan, dan hanya dapat mengisi salah satu jenis biaya yang didukung oleh objek CuratedPackage—misalnya, kolom feeCpm. Total biaya seleksi untuk tayangan iklan tertentu adalah jumlah biaya paket seleksi dan biaya segmen data yang ditargetkan yang berlaku untuk tayangan iklan tersebut.

Anda juga dapat menandakan nilai tayangan iklan yang ditargetkan oleh paket pilihan Anda dengan menetapkan kolom CuratedPackage.floorPriceCpm, yang dapat memengaruhi harga minimum yang ditentukan untuk bidder dalam Bidding Real-Time. Harga minimum yang dikirim ke bidder adalah nilai yang lebih tinggi saat membandingkan harga minimum yang Anda tentukan di kolom floorPriceCpm, dan jumlah harga minimum penayang dan total biaya seleksi.

Tabel berikut memberikan contoh cara penghitungan harga dasar efektif yang dikirim dalam permintaan bid untuk paket pilihan:

Harga minimum penayang (CPM) Total biaya seleksi (CPM) Harga minimum paket pilihan (CPM) Minimum efektif (CPM)
$7 $2 $10 $10
$4 $1 $4 $5

Mengontrol penayangan paket pilihan Anda

Paket pilihan dapat berada dalam salah satu status berikut:

  • ACTIVE: Paket pilihan aktif. Perencana media yang berlangganan dapat menerima permintaan bid Bidding Real-time yang berisi ID paket pilihan untuk inventaris yang ditargetkan.
  • INACTIVE: Paket pilihan tidak aktif. ID paket pilihan tidak muncul dalam permintaan bid bidding real-time, bahkan untuk perencana media yang berlangganan.

Langkah berikutnya

Untuk mempelajari lebih lanjut alur kerja yang dapat Anda lakukan dengan resource curatedPackages, tinjau konten berikut: