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: BirLiveStreamEventöğesi için yeni birAdBreaköğesi tanımlar. İsteğe bağlı olarak, reklam kararının reklam arasından 60 saniye önce başlayacak şekilde planlanması içinexpectedStartTimeözelliğini ayarlayın.Get: Reklam arası durumu ve zamanlama meta verileri dahil olmak üzere belirli birAdBreakvarlığının ayrıntılarını alır.List: Belirli birLiveStreamEventvarlığı için daha önce API ile oluşturulmuşAdBreakvarlı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 birAdBreaköğesini değiştirir.Delete: Daha önce oluşturulmuş birAdBreaköğ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üresiexpectedStartTimealan değerinden 30 dakika sonra veyaexpectedStartTimealanını ayarlamazsanız karar verme işlemi başladıktan 30 dakika sonra dolar. Bu süreyiexpireDurationalanı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.

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
AdBreakverilerinizi kullanmasına olanak tanır. - Google DAI, manifest reklam işaretçisini algıladığında sistem,
AdBreakvarlık verileriyle reklam kararlarını kullanır ve varlığın durumunuBREAK_STATE_COMPLETEolarak 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.

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.

İ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.