Akışınıza hedefleme parametreleri sağlama

Aşağıdaki hedefleme parametrelerinden herhangi birinin sağlanması isteğe bağlıdır.

Talebe bağlı (VOD) için içerik kaynağı oluşturduğunuzda veya yapılandırdığınızda ya da DAI için canlı yayın ayarladığınızda varsayılan bir video reklam etiketi belirtmeniz gerekir. Tüm DAI akışları varsayılan olarak bu reklam etiketini ve parametrelerini kullanır. Reklam etiketi parametreleri hem videonun ortasında gösterilen reklamlar hem de videodan önce gösterilen reklamlar için geçerlidir. Oynatıcınızın belirli bir akış için benzersiz öğe isteğinde bulunmasını istiyorsanız bu seçeneklerden yararlanabilirsiniz.

Geçersiz kılınabilen Ad Manager reklam etiketi parametreleri

Belirli bir parametreye gitme:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid rdid

rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta

 

Varsayılan reklam etiketini geçersiz kılma

Video oynatıcınız bir akış isteğinde bulunduğunda, varsayılan reklam etiketi tam olarak arayüzde belirttiğiniz şekilde kullanılır. Ancak isterseniz akış isteğinizde bu etiketin belirli parametrelerini geçersiz kılabilirsiniz. Bu parametrelerin dışındaki parametreler geçersiz kılınamaz.

IMA SDK veya SSB kullanarak varsayılan reklam etiketini nasıl geçersiz kılacağınızı öğrenin.

Parametre	Açıklama	Örnek değer
iu	Mevcut reklam birimi. Bu, şu biçimde olmalıdır: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Ad Manager kampanya hedeflemesi için kullanılması gereken anahtar/değer çiftleri. Bazı platformlar için URL kodlaması gerekir. Değer otomatik olarak kodlandığından, URL kodlama koşulu HTML5 için IMA DAI SDK'sı kullanılırken geçerli değildir. Bu parametre HTML5'te zaten kodlanmışsa çalışmaz.	Şunlar gibi birden fazla anahtar/değer çiftleri içeren örnekler: section=sports  page=golf,tennis   SSB akışları: cust_params değerinin tamamını kodlayıp birleştirin ancak çift kodlama yapmayın. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Yalnızca değerleri kodlayın. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: cust_params değerinin tamamını kodlayıp birleştirin ancak çift kodlama yapmayın. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS ve tvOS: Hiçbir şeyi kodlamayın. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: Hiçbir şeyi kodlamayın. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Farklı cihazlar için dinamik olarak değişiklik yapmanıza olanak tanıyacak şekilde, varsayılan reklam etiketinizdeki sz parametresini geçersiz kılar. Boyuttan sonra "v" eklemeyin.	sz=400x300
tfcd	Bir isteği çocuklara yönelik olarak değerlendirilmesi için etiketleyin. Bir DAI isteği tfcd=1 içerdiğinde, rdid, idtype veya is_lat parametrelerine atanan değerler, COPPA'ya uyum sağlamak için kaldırılır.	tfcd=1
description_url	Değer, sayfada oynatılan videoyu açıklamalıdır. Genellikle video oynatıcıyı barındıran sayfadır ancak videoyu açıklayan metne sahip bir sayfa da olabilir. SSB akışlarında ve Roku için IMA DAI SDK'sını kullanırken description_url değerini her zaman URL olarak kodlamanız gerekir. Değer otomatik olarak kodlandığından, bu koşul HTML5 için IMA DAI SDK'sı kullanılırken geçerli değildir. Bu parametre HTML5'te zaten kodlanmışsa çalışmaz. Bu parametre, IMA SDK tarafından otomatik olarak ayarlanmaz. Bunun manuel olarak ayarlanması gerekir. Ad Exchange kullanıyorsanız bu alan gereklidir. Daha fazla bilgi	URL olarak kodlanmış örnek: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Kodlanmamış örnek: description_url= http://www.sample.com/ golf.html
ppid	Yayıncı Tarafından Sağlanan Tanımlayıcı (PPID), yayıncıların sıklık sınırı, kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu ve diğer kitleye dayalı reklam yayını kontrolleri için cihazlarda kullanılacak bir tanımlayıcı göndermesini sağlar. Daha fazla bilgi	ppid= 12JD92J...
ciu_szs	Tamamlayıcı boyutlarının virgülle ayrılmış listesi. Tamamlayıcı reklamlar yalnızca HTML5 SDK'sını kullandığınızda DAI için desteklenir.	ciu_szs=728x90,300x250
mpt	İş ortağına ait oynatıcının adını belirtir. Bu, SDK ile entegre olan genellikle JWPlayer, Brightcove, Ooyala gibi iş ortakları tarafından kullanılır.	mpt=JWPlayer
mpv	İş ortağına ait oynatıcının sürümünü belirtir. Bu, yalnızca mpt de ayarlanmışsa ayarlanmalıdır ve SDK ile entegre olan iş ortaklarına ait oynatıcının sürümünü gösterir.	mpv=2.1
ptpl	Reklam arası şablon kimliği. Bu kimliği, Ad Manager arayüzünde ara şablonunun ayarlarını görüntülerken Ad Manager URL'sinde bulabilirsiniz. break_template_id parametresinin değeri olarak görünür.	ptpl=1234
ptpln	Reklam arası şablon adı. Bu, görünen ada değil, Ad Manager'daki "Ad" alanına karşılık gelir.	ptpln=my_break_template
an	an parametresi uygulama adıdır. Bu parametre çoğu programatik video reklam için gerekli olduğundan, mobil uygulamadan ve bağlı TV cihazlarından gönderilen isteklere uygulanmalıdır.* IMA SDK bu parametreyi de otomatik olarak dolduracaktır ancak parametrenin DAI API ve SSB (SDK dışı ortamlar) ile manuel olarak belirtilmesi gerekir. * Uygulama adı iOS ve tvOS üzerinde kullanıcıların okuyabileceği bir ad olmalıdır ancak SDK, 9 haneli App Store Kimliğine erişemez. Böyle durumlarda SDK, uygulama paketini an parametresi üzerinden (com.package.publisher biçiminde) gönderir.	an=sample%20app
ltd	Çerez veya diğer yerel tanımlayıcıların kullanımına izin verilmediğinde reklamların sınırlı şekilde yayınlanıp yayınlanmayacağını belirtir. Daha fazla bilgi	ltd=1
rdid idtype is_lat	Yerel uygulamalarda (web veya mobil web'de değil) SDK; rdid, idtype ve is_lat parametreleri ile akış isteklerinize kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcılarını iletir. SSB akışlarında, istemci tarafı Video Çözümleri reklam isteğinde olduğu gibi bu açık parametreleri iletmeniz gerekir. Apple, iOS 14.5 sürümünden itibaren LAT sinyali için desteğini sonlandırmıştır. Google, kullanıcının App Tracking Transparency'yi destekleyen iOS sürümlerinde izlemeye izin verdiğini belirtmek için sıfır olmayan bir IDFA'dan yararlanır. Bu nedenle, doğru işletim sistemi sürümünü belirten geçerli bir UserAgent gereklidir.	Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin.
trt	Trafiği satın alınmış olarak veya başka bir şekilde belirtir.	Tanımlanmamış trafik türü: trt=0 Satın alınan trafik: trt=1 Organik trafik: trt=2
vconp	Şuna istinaden önerilir: MRC Video Ölçüm Kuralları Oynatıcının, TV yayınına benzer şekilde içerik videolarını sürekli olarak arka arkaya oynatmayı amaçlayıp amaçlamadığını belirtir. Olası değerler, sürekli oynatma AÇIK ise 2, KAPALI ise 1'dir. Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.	Sürekli oynatma AÇIK: vconp=2   Sürekli oynatma KAPALI: vconp=1
vpa	Şuna istinaden önerilir: MRC Video Ölçüm Kuralları Reklamın otomatik oynatma veya tıklama ile başlatılıp başlatılmayacağını belirtir. Olası değerler, sayfada kullanıcının işlem yapması bekleniyorsa click, video otomatik olarak oynatılıyorsa auto'dur. Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.	Otomatik oynatma: vpa=auto   Tıklama: vpa=click
vpmute	Şuna istinaden önerilir: MRC Video Ölçüm Kuralları Video oynatıcının sesi kapatıldığında reklam oynatmanın başlatılıp başlatılmayacağını belirtir. Olası değerler, sesi kapatılmış için 1, sesi açılmış için 0'dır. Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.	Sesi kapatılmış: vpmute=1   Sesi açılmış: vpmute=0
npa	Reklam istekleri için kişiselleştirme ayarı. Olası kesilmeleri önlemek için parametreyi etiketin başlarında belirtmeniz gerekir. Reklam isteğini kişiselleştirilmemiş olarak işaretlemek için npa=1 değerini belirtin. Parametrenin atlanması, kişiselleştirilmiş reklamları varsayılan yapar.	npa=1
omid_p	OMID iş ortağı adı parametresi, OMID ölçümünü entegre eden iş ortağının adını ve iş ortağı sürümünü belirten bir değişken değeri kabul eder. Bu parametre yalnızca Open Measurement SDK'sını (OM SDK) kullanırken Aktif Görüntüleme ölçümü isteyen yayıncılar için geçerlidir. Bu parametre, otomatik olarak ayarlandığından IMA SDK kullanılırken kullanılmamalıdır. Programatik Erişim Kitaplığı'nı (PAL) kullanırken OMID desteğini belirtmek için iş ortağı adını ve sürümünü ayarlamak üzere omidPartnerName ve omidPartnerVersion API'lerini kullanmanız gerekir. PAL veya IMA kullanmadığınızda omid_p ve sdk_apis parametrelerini (virgülle ayrılmış diğer API'leri de içerebilecek desteklenen API'ler) ayarlamanız gerekir.	PAL kullanılırken: request.omidPartnerName = 'examplepartnername' request.omidPartnerVersion = '1.0.0.0' PAL kullanılmadığında: omid_p=examplepartnername/1.0.0.0&sdk_apis=7
gdpr gdpr_consent	Bu alanlar, hem sınır içindeki hem de sınır dışındaki çerez senkronizasyon isteklerinde TCF 2.0 sürümü izin bilgilerinin aktarılması için kullanılır.	GDPR spesifikasyonlarını inceleyin.
givn|paln	Programatik Erişim Kitaplığı (PAL) kullanan entegrasyonlarda video nonce parametresi değişken bir dize değerini kabul eder. Tek seferlik rastgele sayı URL için güvenlidir. URL olarak kodlamanız gerekmez. Not: Daha önce eski paln parametresini kullanarak tek seferlik bir sayı sağladıysanız givn parametresine geçmeniz ve paln göndermeyi bırakmanız önemle tavsiye edilir. Her iki parametreyi de eklemeyin.	Bu parametreye aktarılan değer hakkında daha fazla bilgiyi PAL ile ilgili başlangıç kılavuzlarında bulabilirsiniz.
addtl_consent	IAB'ye kaydolmamış izin verilen Google Reklam Teknolojisi Sağlayıcıların listesi.	Ek İzin spesifikasyonlarını inceleyin
rdp	Veri işlemeyi kısıtlamak için özel olarak rdp=1 değerini ayarlamanız veya rdp'yi (ayarlı değer olmadan) eklemeniz gerekir. Veri İşlemeyi Kısıtla ağ ayarı etkinleştirilmediği takdirde, bu parametrenin olmadığı veya rdp=0 olarak ayarlanmış reklam istekleri kısıtlanmaz.	rdp=1
sdk_apis	SDK API çerçevesi parametresi, oynatıcının desteklediği tüm API çerçevelerini belirten, sabit tam sayı değerlerinin virgülle ayrılmış listesini kabul eder. Olası API Çerçevesi değerlerinin listesine bakın. Bu parametre, Programatik Erişim Kitaplığı'nı (PAL) kullanan yayıncılar tarafından kullanılır. IMA SDK'yı kullanırken bu parametreye değer ayarlamaya çalışırsanız değerler, IMA SDK tarafından desteklenen değerlerle geçersiz kılınır.	sdk_apis=2,7,9
sid	Yalnızca sıklık sınırı amacıyla kullanılabilecek, gizliliği koruyan güvenli bir reklam tanımlayıcısı türü. IAB'nin IFA yönergeleri uyarınca bu parametre UUID biçiminde doldurulmalıdır. Daha fazla bilgi sid=0 parametresini ayarlayarak oturum kimliğinin iletilmesini devre dışı bırakabilirsiniz.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Video oynatıcının "Neden bu reklamı görüyorum?" ifadesini oluşturma desteğini gösterir. Bu, IMA SDK kullanılırken otomatik olarak desteklenir. IMA SDK kullanılmadığında, video oynatıcılar bu DAI API kılavuzunda belirtildiği gibi VAST Icon ve IconClickFallbackImage desteğini uygulamalıdır.*  SSB için WTA desteklenmez. Ad Exchange kullanıyorsanız bu alan gereklidir. Daha fazla bilgi * CTV cihazları dışında IconClickFallbackImage için destek gerekli değildir.	Destekleniyor: wta=1 Desteklenmiyor: wta=0

IMA SDK'yı kullanarak varsayılan reklam etiketini geçersiz kılma

Bir video oynatıcı, IMA SDK'yı kullanarak bir DAI akışı isteğinde bulunduğunda "adTagParameters" adlı bir alanı aktarabilir. Bu sözlük benzeri yapı, anahtarların yukarıdaki tabloda listelenen Ad Manager reklam etiketi parametreleri olabileceği anahtar/değer çiftleri ile ayarlanabilir.

Aynı yapıyı kullanarak akışınızı özelleştirebilir ve Ad Manager reklam isteği ile ilgili olmayan parametreleri aktarabilirsiniz. Belirli akış varyantları için istekte bulunmayı ve reklam arası oluşturmayı öğrenin.

adTagParameters alanının uygulanması, ilgili programlama diline veya platforma bağlı olarak biraz farklı olabilir. iOS, Android, tvOS, Chromecast, HTML5 geliştirme belgelerine veya DAI oynatıcı ve uygulama geliştirme kılavuzu içindeki ek belgelere bakın.

 

adTagParameters alanını SDK üzerinden ayarlama

cust_params veya description_url parametresini iOS, tvOS ve Android uygulamalarında SDK aracılığıyla ayarlarken dizeleri URL olarak kodlamamanız gerekir. cust_params parametresini, anahtar/değer çiftlerini bir "&" işaretiyle birleştiren tek bir dize olarak aktarabilirsiniz.

Örneğin, cust_params parametresini sport=football&city=newyork değerine ayarlamak istediğinizi varsayalım:

Kodlanmamış değerleri kullanan adTagParams yapısı şu şekilde olurdu:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

HTML5 akış istekleri için kodlanmış değerleri kullanan adTagParameters yapısı şu şekilde olurdu:

{
  "tfcd": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Roku akış istekleri için kodlanmış değerleri kullanan adTagParams yapısı şu şekilde olurdu:

request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

DAI API'sini kullanarak varsayılan reklam etiketini geçersiz kılma ^(Beta) 

Video oynatıcılar DAI API'sini kullanarak bir DAI akışı isteğinde bulunduğunda isteğe bağlı olarak, anahtarların yukarıdaki tabloda listelenen Ad Manager reklam etiketi parametreleri olabileceği anahtar-değer çiftleri aktarabilir.

Bu parametreler hem doğrusal/canlı hem de VOD için application/x‑www‑form‑urlencoded form türünün HTTP POST isteği gövdesinin bir parçası olarak gönderilmelidir.

Aynı yapıyı kullanarak akışınızı özelleştirebilir ve Ad Manager reklam isteği ile ilgili olmayan parametreleri aktarabilirsiniz. Belirli akış varyantı parametrelerini ve HMAC kimlik doğrulamasını nasıl isteyeceğinizi öğrenin.

DAI API'si örnek uygulamasına göz atın.

SSB'yi kullanarak varsayılan reklam etiketini geçersiz kılma

Aşağıda, SSB varsayılan VOD reklam etiketini değiştirme örnekleri verilmiştir. Oynatıcı veya uygulama tarafından aktarılıp üzerine başka değer yazılmış parametreler vurgulanır.

Talebe bağlı video örnekleri

	Örnek
Temel VOD akışı URL'si	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(belirtilen reklam birimini içerir)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(geçersiz kılınan anahtar/değer çiftlerini içerir)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(çocuklara yönelik içerik bildirimi içerir)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfcd=1
(geçersiz kılınan reklam birimini VE anahtar/değer çiftlerini VE özel description_url kodunu VE çocuklara yönelik içerik bildirimini içerir)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

 

Canlı doğrusal akış örnekleri

	Örnek
Temel canlı doğrusal akış URL'si	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(belirtilen reklam birimini içerir)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(geçersiz kılınan anahtar/değer çiftlerini içerir)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(çocuklara yönelik içerik bildirimi içerir)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1
(geçersiz kılınan reklam birimini VE anahtar/değer çiftlerini VE özel description_url kodunu VE çocuklara yönelik içerik bildirimini içerir)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8& iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfcd=1

Belirli bir canlı yayın sırasında hedefleme parametrelerini dinamik olarak güncelleme

Akışı izlemekte olan belirli bir kullanıcının hedefleme verilerini, IMA DAI SDK'sındaki replaceAdTagParameters yöntemiyle dinamik şekilde güncelleyebilirsiniz.

DAI sorunlarını giderme veya kesintilerle ilgili konular için yayıncı destek ekibiyle iletişime geçin.