DAI Ad Break API hakkında bilgi edinme

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 doluluk oranını artırma: Dinamik Reklam Ekleme (DAI) hizmetlerine, canlı etkinlikleriniz için en yüksek getirili reklamları seçme konusunda daha fazla zaman tanıyın. Canlı yayın etkinliklerinizde eşzamanlılık yüksek olduğunda, dinamik reklam etiketleri veya yüksek gecikmeli reklamlar bulunduğ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: Reklamlarla ilgili oynatma hatalarını (ör. reklam bölmelerinin eksik veya fazla doldurulması) en aza indirmek için kesin duraklatma bilgileri sağlayın.

Bu kılavuzda, DAI Reklam Arası API yöntemleri açıklanmakta ve DAI Tam Hizmet ve Kapsül Yayınlama akışları için reklam arası yaşam döngüsü adım adım anlatılmaktadır.

DAI Ad Break API yöntemleri hakkında bilgi

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

  • Create: LiveStreamEvent öğesi için yeni bir AdBreak öğesi tanımlar. İsteğe bağlı olarak, reklam arası başlamadan 60 saniye önce 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

AdBreak öğesi aşağıdaki durumlara sahiptir:

  • 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 arasını değiştiremezsiniz ancak reklam sunucularında olumsuz etkiler yaratabilecek şekilde reklam arasını iptal edebilirsiniz.
  • BREAK_STATE_COMPLETE: Reklam arası kullanıcılara sunuldu.

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 bir 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 bir süre önce reklam arası oluşturmaktan kaçının.
  • Reklam sunucuları istenen reklamları geçersiz kılabilir. Bu nedenle, reklam arası oluştururken aranın beklenen başlangıç saatinden 6 saat öncesine kadar bekleyin.

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

Tam hizmet DAI akışını anlama

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

Özel reklam hedefleme için, içerik canlı akışı 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.

Kapsül yayınlama akışında, reklam arası öğesinin oluşturulmasından tamamlanmasına kadar olan süreç.

Pod yayınlama akışını anlama

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

Reklam kapsülü segmentlerini veya reklam manifestini istemeniz gereken zamandan önce AdBreak öğesi oluşturmak için reklam arası başlaması beklenen zamandan önce DAI reklam arası API'sini ç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.

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

Reklam arası varlığı tamamlanma durumu

İlk isteğinizi gönderme

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