DAI Ad Break API hakkında bilgi

Dinamik Reklam Ekleme (DAI) Reklam Arası API'si, canlı yayınlarınızdaki yaklaşan reklam aralarının zamanlamasını ve reklam hedefleme verilerini oluşturup yönetmenize olanak tanır.

DAI Reklam Arası API'si ile şunları yapabilirsiniz:

  • Yoğun trafik sırasında reklam doldurma oranını artırma: DAI hizmetlerine, canlı etkinlikleriniz için en yüksek getirili reklamları seçmesi için daha fazla süre tanıyın. Canlı yayın etkinliklerinizde yüksek eşzamanlılık, dinamik reklam etiketleri veya yüksek gecikmeli reklamlar olduğunda DAI Reklam Arası API'sini kullanmanızı öneririz.
  • Reklam aralarınız üzerinde tam kontrol sahibi olun: Reklam aralarını önceden oluşturun, güncelleyin ve silin. Bu sayede, manifest içi reklam sinyallerine kıyasla daha fazla esneklik ve yalnızca anlık karar verme yöntemine kıyasla pod yayınında daha yüksek bir doldurma oranı elde edebilirsiniz.
  • Kesintisiz bir izleyici deneyimi sunma: Tam olarak doldurulmamış veya aşırı doldurulmuş reklam kapsülleri gibi reklamlarla ilgili oynatma hatalarını en aza indirmek için kesin duraklatma bilgileri sağlayın.

Bu kılavuzda, DAI Ad Break API yöntemleri açıklanmakta ve DAI Full Service ile Pod Serving akışları için reklam arası yaşam döngüsü adım adım anlatılmaktadır.

DAI reklam arası API yöntemleri hakkında bilgi edinin

API, AdBreak kaynaklarını yönetmek için aşağıdaki standart yöntemleri kullanır:

  • Create: LiveStreamEvent öğesi için yeni bir AdBreak öğesi tanımlar. İsteğe bağlı olarak, reklam arası başlamadan 60 saniye önce bir reklam kararının başlamasını planlamak için expectedStartTime özelliğini ayarlayın.
  • Get: Reklam arası durumu ve zamanlama meta verileri dahil olmak üzere belirli bir AdBreak öğesinin ayrıntılarını alır.
  • List: Belirli bir LiveStreamEvent öğesi için API ile daha önce oluşturulmuş AdBreak öğelerinin listesini, ters kronolojik sırada döndürür. API'nin yalnızca içerik akışı manifestinde tanımlanan reklam aralarını döndürmediğini unutmayın.
  • Update: Reklam kararı başlamadan önce mevcut bir AdBreak öğesini değiştirir.
  • Delete: Daha önce oluşturulmuş bir AdBreak varlığı için reklam kararını iptal eder.

Reklam arası yaşam döngüsünü anlama

Bir AdBreak öğesi aşağıdaki durumlara sahip olabilir:

  • BREAK_STATE_UNSPECIFIED: Varsayılan durum.
  • BREAK_STATE_SCHEDULED: Reklam arası başarıyla oluşturuldu ve reklam kararı için planlandı.
  • BREAK_STATE_DECISIONED: DAI hizmetleri, reklam arası için reklam seçimi sürecini başlattı. Reklam aralarını değiştiremezsiniz ancak reklam sunucularında olumsuz etkiler yaratabilecek şekilde reklam aralarını iptal edebilirsiniz.
  • BREAK_STATE_COMPLETE: Reklam arası kullanıcılara yayınlandı.

Aşağıdaki şemada, bir AdBreak öğesinin oluşturulmasından tamamlanmasına kadar olan zaman çizelgesi gösterilmektedir.

Reklam arası öğesinin oluşturulmasından tamamlanmasına kadar olan süreç.

Reklam arası başlamadan 1 ila 300 dakika önce AdBreak öğesi oluşturabilirsiniz.

  • Google DAI'nin reklam kararları için yeterli zamanı olmayabileceğinden ve bu durum reklam doldurma oranının düşmesine neden olabileceğinden, reklam arasının beklenen başlangıç zamanından bir dakikadan kısa süre önce reklam arası oluşturmaktan kaçının.
  • Reklam sunucuları istenen reklamları geçersiz kılabilir. Bu nedenle, reklam arasının beklenen başlangıç zamanından 6 saatten daha uzun süre önce reklam arası oluşturmaktan kaçının.

Aşağıdaki bölümlerde, DAI Full Service ve kapsül yayınlama akışlarındaki reklam arası durum geçişleri ele alınmaktadır.

Tam hizmet DAI akışını anlama

Google tam hizmet DAI, hem içerik manifestini hem de reklam kapsüllerini yönetir.

Özel reklam hedefleme için, içerik canlı yayını manifestosundaki ilgili reklam işaretçisinden önce bir AdBreak öğesi oluşturmak üzere DAI reklam arası API'sini kullanın.

  • Bu süre, Google DAI hizmetlerinin reklam kararı için AdBreak verilerinizi kullanmasına olanak tanır.
  • Google DAI, manifest reklam işaretçisini algıladığında sistem, AdBreak öğe verileriyle reklam kararlarını kullanır ve öğenin durumunu BREAK_STATE_COMPLETE olarak değiştirir.

Tam hizmet DAI akışında reklam arası öğesinin oluşturulmasından tamamlanmasına kadar olan süreç.

Pod sunma akışını anlama

Bu akışta, içerik canlı yayını manifestini yönetir veya manifestteki reklam işaretlerini algılamak için üçüncü taraf bir manifest manipülasyon hizmeti kullanırsınız.

Reklam kapsülü segmentlerini veya reklam manifestini istemeniz gereken zamandan önce bir AdBreak öğesi oluşturmak için reklam arasının beklenen başlangıç zamanından önce DAI Ad Break API'yi çağırın.

Video birleştiriciniz, manifest reklam işaretçisini algılayıp reklam arası kimliğiyle reklam segmenti istekleri gönderdiğinde Google DAI, reklam kararları için aynı kimliğe sahip AdBreak verilerini kullanır.

İstemciniz reklam medyası isteğinde bulunduktan sonra, API aracılığıyla oluşturduğunuz AdBreak öğesi BREAK_STATE_COMPLETE durumuna geçer.

Reklam arası öğesinin tamamlanma durumu.

İlk isteğinizi oluşturma

API erişimini ayarlamak ve ilk isteğinizi göndermek için DAI Reklam Arası API'sini kullanma başlıklı makaleyi inceleyin.