Seçilmiş paketler hakkında bilgi

curators.curatedPackages kaynağı, medya planlamacıları adına düzenlediğiniz yayıncı envanteri paketlerini programatik olarak oluşturup yönetmenize olanak tanır.

Seçilmiş paketler, belirli hedefleme ölçütlerini (ör. cihaz türleri, coğrafya ve veri segmentleri) karşılayan envanteri gruplandırmanıza ve alıcılar seçilmiş paket tarafından hedeflenen gösterimleri kazandığında alınan bir küratör ücreti atamanıza olanak tanır.

Temel kavramları anlama

Entegrasyonunuza başlamadan önce, seçilmiş paketlerin nasıl çalıştığını tanımlayan alanları ve ayarları inceleyin:

Seçilmiş paketlerinize kimlerin erişebileceğini kontrol etme

Seçilmiş paketlerinize yalnızca CuratedPackage.accessSettings alanını kullanarak açıkça erişim izni verdiğiniz medya planlamacıları erişebilir. Seçilmiş paket oluşturulduğunda accessSettings alanını doldurmanız gerekir.

mediaPlanners.list yöntemini kullanarak CuratedPackage.accessSettings.allowlistedMediaPlanners alanında belirtilmeye uygun medya planlamacıların listesini görüntüleyebilirsiniz.

Seçilmiş paketinizin hedeflediği envanteri yapılandırma

Seçilmiş paketinizin hedeflediği envanteri belirtmek için CuratedPackage.targeting alanını kullanabilirsiniz. targeting alanı, cihaz türü, reklam öğesi biçimi ve coğrafi konum gibi hedefleme ölçütlerini destekleyen PackageTargeting nesnesiyle doldurulur.

CuratedPackage.targeting.includedDataSegments alanıyla özelleştirilmiş hedefleme de belirtebilirsiniz. includedDataSegments alanı, sizin veya diğer seçim iş ortaklarının yönettiği veri segmentlerini hedeflemenize olanak tanır.

Hedefleme mantığını anlama

Tekrarlanan alanlardaki değerler mantıksal OR kullanılarak işlenir. Bu, belirtilen değerlerden herhangi biri için geçerli olan bir gösterimin eşleşme olduğu anlamına gelir. Her alan, mantıksal bir AND ile işlenir. Bu nedenle, seçilmiş paketin ilgili teklif isteğinde görünmesi için belirtilen tüm alanların belirli bir gösterimle eşleşmesi gerekir.

Aşağıdaki örnekte, cihaz türleri ve veri segmentlerinin bir kombinasyonunu hedeflemek için CuratedPackage.targeting alanı doldurulmuş bir seçilmiş paket oluşturulmaktadır:

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

Aşağıdaki tabloda, örnekteki seçilmiş paketin bir gösterimi hedefleyip hedeflemediği gösterilmektedir. Her satır ayrı bir gösterimi ifade eder:

Cihazın Türü Veri segmenti kimlikleri Seçili paket hedefliyor mu?
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 Evet
DEVICE_TYPE_PHONE 8172, 4321 Evet
DEVICE_TYPE_PHONE 9182 Hayır
DEVICE_TYPE_CONNECTED_TV 4321, 9182 Hayır

Seçilmiş paketinizin değerini belirtin

Seçilmiş bir paket oluştururken CuratedPackage.fee birleşim alanını kullanarak bir düzenleme ücreti belirlemeniz gerekir ve CuratedPackage nesnesi tarafından desteklenen ücret türlerinden yalnızca birini (ör. feeCpm alanı) doldurabilirsiniz. Belirli bir gösterim için toplam seçilmiş içerik ücreti, seçilmiş paket ücreti ile gösterim için geçerli olan tüm hedeflenen veri segmentlerinin ücretlerinin toplamıdır.

Ayrıca, CuratedPackage.floorPriceCpm alanını ayarlayarak seçilmiş paketinizin hedeflediği gösterimlerin değerini de belirtebilirsiniz. Bu alan, gerçek zamanlı teklif verme sırasında teklif verenlere belirtilen taban fiyatı etkileyebilir. Teklif verenlere gönderilen taban fiyat, floorPriceCpm alanında belirttiğiniz taban fiyat ile yayıncı taban fiyatı ve toplam düzenleme ücretinin toplamı karşılaştırıldığında daha yüksek olan değerdir.

Aşağıdaki tabloda, seçilmiş paket için teklif isteğinde gönderilen geçerli taban fiyatın nasıl hesaplandığına dair örnekler verilmiştir:

Yayıncı taban fiyatı (BGBM) Toplam seçim ücreti (BGBM) Seçilmiş paket tabanı (BGBM) Etkin taban (BGBM)
7 ABD doları 2 ABD doları 10 Hong Kong doları 10 Hong Kong doları
4 ABD doları 1 TL 4 ABD doları 5 Hong Kong doları

Seçilmiş paketinize ait reklam yayınını kontrol etme

Seçilmiş paketler aşağıdaki durumlardan birinde olabilir:

  • ACTIVE: Seçilmiş paket etkin olmalıdır. Abone olan medya planlayıcıları, hedeflenen envanter için seçilmiş paketin kimliğini içeren gerçek zamanlı teklif verme teklif istekleri alabilir.
  • INACTIVE: Seçilmiş paket etkin değil. Seçilmiş paketin kimliği, abonelik sahibi medya planlayıcılar için bile gerçek zamanlı teklif verme teklif isteklerinde görünmüyor.

Sonraki adımlar

curatedPackages kaynağıyla gerçekleştirebileceğiniz iş akışları hakkında daha fazla bilgi edinmek için aşağıdaki içeriği inceleyin: