Sunucu yönlendirmeli reklam ekleme (SGAI), istemci cihazlarda birleştirilmeye hazır bir reklam kapsülü manifesti sağlar. Google Ad Manager ağınızda Pod Serving DAI'yi etkinleştirdiyseniz SGAI'yi kullanabilirsiniz. Pod Serving DAI etkin değilse hesap yöneticinizle iletişime geçin.
SGAI ile akış oluşturmak, reklam meta verilerini ve reklam kapsülü manifestlerini almak için kapsül yayınlama API uç noktalarını kullanırsınız.
Manifest manipülasyon sunucunuz varsa tercih ettiğiniz spesifikasyona göre reklam kapsülü manifest URL'leri oluşturabilir ve reklam kapsülü manifest bilgilerini taşıyan reklam işaretleyicileri içerik akışınıza ekleyebilirsiniz.
Alternatif olarak, akış manifestosundaki reklam işaretçileri dışında farklı bir mekanizma kullanarak reklam arası planlayabilirsiniz. Bu gibi durumlarda uygulamanız, diğer etkinlikleri (ör. kullanıcıların akış, uygulama veya push bildirimi ile etkileşimi) dinleyebilir. Bu etkinliklerden sonra uygulama, reklam kapsülü manifest URL'lerini oluşturabilir ve oynatıcıya reklam kapsülü manifestini yüklemeye başlamasını söyleyebilir.
Ön koşullar
Devam etmeden önce aşağıdakilere sahip olduğunuzdan emin olun:
- Google Ad Manager ağınızda DAI kapsül yayınlama etkinleştirilmiş olmalıdır.
- Kapsül yayınlama manifesti türünde bir canlı yayın etkinliği. Etkinlik oluşturmak için DAI için canlı yayın oluşturma başlıklı makaleyi inceleyin.
Önerileri takip etme
Reklam kapsülü manifest URL'sini oluşturmadan önce her reklam arasının beklenen süresini, hedefleme bilgilerini ve diğer parametrelerini belirtmek için Erken Reklam Arası Bildirimi (EABN) API'sini çağırmanız önerilir.
Üretim ve test yayınları için EABN API'yi çağırın. Özellikle reklam ağınızda programatik kampanyalar varsa bu işlemi yapmanız gerekir. Daha fazla bilgi için Programatik Doğrudan +özellikleri ve yönergeleri başlıklı makaleyi inceleyin.
Yayın kaydı isteğinde bulunma
Kullanıcı, video oynatıcı uygulamanızda bir içerik akışı başlattığında Ad Manager'da bir akış oturumu oluşturmak için hedefleme parametreleriyle bir akış kaydı isteğinde bulunursunuz. Yayın kaydı isteğinde bulunma hakkında ayrıntılı bilgi için Method:stream başlıklı makaleyi inceleyin. Ardından, istekten yanıt verileri alırsınız.
Aşağıdaki örneklerde akış kaydı isteği gönderilmektedir:
Düz metin HTTP
- İstek:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded
cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
- Yanıt:
{
"manifest_format": "hls",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"polling_frequency": 10,
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}
kabuk
- Komut satırı:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
--data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
--compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
- Çıkış:
{
"manifest_format": "hls",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
"polling_frequency": 10,
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}
JavaScript
- Fetch API'yi kullanma:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
"headers": {
"content-type": "application/x-www-form-urlencoded",
},
"body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
"method": "POST",
});
const stream = await response.json();
console.log(stream);
- Konsol günlüğü:
{
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"polling_frequency": 10,
"pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
"manifest_format": "hls"
}
Reklam arası meta verileri için anket
Akış kaydı isteğinde bulunduktan sonra reklam meta verileri için yoklama yapın. Ankete katılmak için akış yanıtındaki polling_frequence öğesini kullanarak kayıt adımında reklam meta verilerini çağırmak üzere bir zamanlayıcı ayarlarsınız.
Her anket için, meta veriler kullanılabilir hale geldikçe reklamların kısmi bir listesini alabilirsiniz.
Reklam kapsülü manifest URL'sini oluşturma
Kapsül Yayınlama API'sinin kapsül kaynağı için bir URL oluşturun. Ardından, reklam kapsülünü yüklemeye başlamak için URL'yi bir video oynatıcıya iletin.
Aşağıdaki örnekte, reklam kapsülü manifest URL'sinin yapısı gösterilmektedir:
https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000
Reklam kapsülü manifest URL'si parametrelerini, video oynatıcıdan veya bir sunucu bildiriminden alınan reklam arası bilgilerine göre hesaplayabilirsiniz. Bu parametrelerin gereksinimleri için Yöntem: pod manifesti bölümüne bakın.
Reklam kapsülü manifestini oynatma
İstemci video oynatıcı uygulamasında, birincil video oynatıcı ile içerik akışı oynatmayı başlatın ve oynatma ile reklam programını gözlemleme konusunda video oynatıcınızın belgelerini inceleyin (varsa).
Reklam kapsülü manifesti URL'lerini oluşturup bunları sunucu tarafındaki manifeste eklerseniz video oynatıcının yaklaşan reklam arası etkinliklerini gözlemleyin ve her reklam arası oynatma sırasında id3 etkinliklerine abone olduğunuzdan emin olun. Reklam arası etkinliklerini istemci tarafında planlıyorsanız oluşturma sırasında id3 etkinliklerine abone olun.
Gösterimleri ve reklam etkinliklerini raporlama
Bir video oynatıcı, reklam kapsülünü oynatıp id3 zamanlanmış meta verileriyle karşılaştığında video oynatıcının tetiklediği reklam etkinliklerini dinleyin ve bunları işleyerek medya doğrulama ping'leri gönderin.