DAI Ad Break API hakkında bilgi

Dinamik Reklam Ekleme (DAI) Reklam Arası API'si, canlı yayınlarınızda 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:

  • Trafiğin yoğun olduğu zamanlarda reklam doluluk oranını artırın: DAI hizmetlerine, canlı etkinlikleriniz için en yüksek getiriyi sağlayan reklamları seçmeleri için daha fazla zaman tanıyın. Canlı yayın etkinliklerinizde yüksek eşzamanlılık, dinamik reklam etiketleri veya yüksek gecikmeli reklamlar varsa DAI Reklam Arası API'sini kullanmanızı öneririz.
  • Reklam aralarınızın kontrolünü tamamen elinize alın: Reklam aralarını önceden oluşturun, güncelleyin ve silin. Bu sayede, manifest içi reklam sinyallerine kıyasla daha fazla esneklik elde edebilir ve tam zamanında karar vermeye kıyasla kapsül yayınlama için daha yüksek doluluk oranı sağlayabilirsiniz.
  • Kesintisiz bir izleyici deneyimi sunun: Tam olarak doldurulmamış veya aşırı doldurulmuş reklam kapsülleri gibi reklamla ilgili oynatma hatalarını en aza indirmek için kesin ara 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 Reklam Arası API yöntemlerini öğrenme

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

  • Create: Bir LiveStreamEvent öğesi için yeni bir AdBreak öğesi tanımlar. İsteğe bağlı olarak, reklam kararının reklam arasından 60 saniye önce başlayacak şekilde planlanması için expectedStartTime özelliğini ayarlayın.
  • Get: Reklam arası durumu ve zamanlama meta verileri dahil olmak üzere belirli bir AdBreak varlığının ayrıntılarını alır.
  • List: Belirli bir LiveStreamEvent varlığı için daha önce API ile oluşturulmuş AdBreak varlıklarının listesini ters kronolojik sırayla 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 öğesi için reklam kararını iptal eder.

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

Bir AdBreak varlığının aşağıdaki durumları vardır:

  • 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ı üzerinde olumsuz etkileri olabilecek reklam arasını iptal edebilirsiniz.
  • BREAK_STATE_COMPLETE: Reklam arası kullanıcılara sunuldu.
  • BREAK_STATE_EXPIRED: Reklam arasının süresi yayınlanmadan önce doldu. Yalnızca canlı yayın etkinliğinde çoklu ara planlamasını etkinleştirdiğinizde geçerlidir. Ayrıntılar için Videonun ortasında gösterilen reklam arası ayarları başlıklı makaleyi inceleyin. Varsayılan olarak, reklam aralarının süresi expectedStartTime alan değerinden 30 dakika sonra veya expectedStartTime alanını ayarlamazsanız karar verme işlemi başladıktan 30 dakika sonra dolar. Bu süreyi expireDuration alanını kullanarak özelleştirebilirsiniz.

Aşağıdaki şemada, bir AdBreak varlığının oluşturulmasından tamamlanmasına kadar geçen zaman çizelgesi gösterilmektedir.

Oluşturulmasından tamamlanmasına kadar reklam arası öğesi.

Reklam arasının başlaması beklenen zamandan 1 ila 300 dakika önce bir AdBreak öğesi oluşturabilirsiniz.

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

Aşağıdaki bölümlerde, DAI Tam Hizmet 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 DAI Ad Break API'yi kullanarak içerik canlı yayın manifestindeki ilgili reklam işaretçisinden önce bir AdBreak öğesi oluşturun.

  • Bu teslimat süresi, 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 varlık verileriyle reklam kararlarını kullanır ve varlığın durumunu BREAK_STATE_COMPLETE olarak değiştirir.

Canlı yayın etkinliğinde çoklu ara planlamayı etkinleştirdiğinizde AdBreak varlığında matchParams alanını ayarlayabilirsiniz. Bu işlem, Google DAI'nin algılanan manifest reklam işaretçilerini BREAK_STATE_SCHEDULED veya BREAK_STATE_DECISIONED durumundaki reklam aralarıyla eşleştirmesine olanak tanır.

Tam hizmet DAI akışında oluşturmadan tamamlamaya kadar reklam arası öğesi.

Kapsül yayınlama 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 manifest değiştirme aracı kullanırsınız.

Reklam kapsülü segmentlerini veya reklam manifestini istemeniz gereken zamandan önce bir AdBreak varlık oluşturmak için reklam arasının beklenen başlangıç zamanından ö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 yaptığında 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ı öğesi tamamlanma durumu.

İlk isteğinizi gönderme

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