Stream Activity Monitor API hakkında bilgi

Dinamik Reklam Ekleme (DAI) Akış Etkinliği İzleyicisi (SAM) API'si, canlı yayın ve seç-izle video (VOD) izleme oturumlarını ayrı ayrı incelemenize ve bunlarla ilgili sorunları gidermenize olanak tanır.

Bağımsız bir canlı yayın veya VOD izleme oturumunu görsel olarak incelemek ve sorunlarını gidermek için Google Ad Manager kullanıcı arayüzündeki Akış Etkinliği İzleyicisi'ni kullanın. Bir oturumun teşhis verilerini programatik olarak almak için Ad Manager API networks.daiSessions kaynağını kullanın.

Kullanım alanlarını anlama

SAM API ile akış teşhislerini otomatik hale getirebilir ve DAI entegrasyonlarınızda reklam yayını sorunlarını çözebilirsiniz. Örneğin:

  • Yayın oturumu oluşturmayı doğrulama: Google DAI'nin canlı yayın veya VOD oturumu oluştururken aldığı parametreleri, STITCHED ya da POD_SERVING birleştirme modunu, raporlama modunu ve içerik meta verilerini onaylayın.
  • Reklam isteklerini ve yanıtlarını denetleme: Giden Video Reklam Sunma Şablonu (VAST) ve Video Çok Reklamlı Oynatma Listesi (VMAP) reklam etiketlerini, HTTP durum kodlarını, yanıt gecikmelerini, ham XML yanıt gövdelerini ve sarmalayıcı yönlendirme zincirlerini inceleyin.
  • Reklam kapsülü karar verme ve reklam öğeleriyle ilgili sorunları giderme: Google DAI'nin her kapsül için hangi reklamları seçtiğini veya bıraktığını, kapsüldeki her reklamın süresini ve reklam öğesinin kaynak reklam sistemini doğrulayın.
  • Reklam önceden getirme yürütmesini izleme: Google DAI'nin bir reklam kapsülünü önceden getirip getirmediğini belirleyin ve her reklam kapsülünün önceden getirme aşamasını kontrol edin.
  • DAI Reklam Arası API'si ve kapsül yayınlama DAI API çağrılarını doğrulama: Gerçek ara yürütme, yayınlanan reklam süreleri ve eklenen ara reklam sürelerini DAI Reklam Arası API'si ve kapsül yayınlama DAI API'si gibi API çağrılarıyla karşılaştırın.
  • Reklam etkinliği izlemeyi doğrulama: İstemci tarafı veya sunucu tarafı izleme ping'lerinin başarılı olup olmadığını doğrulayın ve reklam sunucularından gelen HTTP yanıtlarını inceleyin.
  • Oturum izleme ve uyarıları otomatikleştirme: Otomatik entegrasyon testlerinde ve üretim izleme ardışık düzenlerinde oynatma veya para kazanma sorunlarını tespit etmek için INFO, WARNING veya ERROR önem derecesine sahip yapılandırılmış bulgu girişlerini ayrıştırın.

Üst düzey kaynağı öğrenme

SAM API, admanager.googleapis.com uç noktasındaki Google Ad Manager REST API'nin (Beta) bir parçasıdır ve salt okunur networks.daiSessions.get yöntemini kullanıma sunar. DAI oturum kimliği veya özel hata ayıklama anahtarı ile DaiSession kaynağını sorgulayabilirsiniz. DAI, oturum kayıtlarını oynatmadan sonraki üç güne kadar saklar.

SAM API, bir Google Ad Manager ağındaki tüm DaiSession kaynaklarının listelenmesini desteklemez.

SAM ile DAI akış yanıtlarını inceleme

Google DAI'nin akış isteklerinizi nasıl işlediğini doğrulamak için DaiSession yanıtını inceleyin:

  • Tam hizmet DAI API: Akış kaydı çağrısını doğrulamak için creationContext.streamCreateRequest alanını inceleyin, reklam kararını incelemek için adSelections ve adPods haritalarını kontrol edin ve birleştirilmiş reklam, seçenek listesi reklam öğesi ve temel içerik sürelerini onaylamak için adBreaks haritasını inceleyin.
  • Kapsül yayınlama DAI API'si: creationContext.stitchingType alanının POD_SERVING değerine ayarlandığını onaylayın, adPods ve adBreaks haritalarındaki adBreakId alanını kapsül manifestiniz veya kapsül segmenti istek çağrılarınızla karşılaştırın ve trackingPings haritasındaki sunucu tarafı veya medya doğrulama işaretlerini inceleyin.
  • DAI Reklam Arası API: Bir AdBreak nesnesinin breakSequence değerini AdBreak.breakSequence özelliğiyle eşleştirin.

İlk isteğinizi gönderme

Kimlik doğrulamayı ayarlamak ve DAI oturum kaynaklarını almak için Yayın Etkinliği İzleyicisi API'sini kullanma başlıklı makaleyi inceleyin.