Etiketsiz istek ile reklam öğesi kodunu yükleme

Ad Manager'da trafiğe eklenen ham reklam öğesi kodunu istemek için reklam etiketi yerine etiketsiz istek kullanılabilir. Etiketsiz istekler, genellikle Google etiketleme veya SDK desteği olmayan set üstü kutularda ya da diğer ortamlarda özel ayrıştırma ve görüntülü reklam gerektiğinde kullanılır.

Etiketsiz istek yaptığınızda Ad Manager, reklamı başlatıp yayınlamadan yalnızca trafiğe eklendiği şekliyle ham reklam öğesi kodunu döndürür. Reklam bulunamazsa boş bir yanıtla 200/OK durumu döndürülür.

Uygulamanız, oynatıcınız veya siteniz reklamı gösterme kodunu yürütmeli ve gösterim izlemeyi etkinleştirmelidir.

Reklamları e-postada yayınlamak için etiketsiz istek kullanılmamalıdır. Tüm desteklenmeyen özellikleri inceleyin.

Manuel olarak etiketsiz istek oluşturma

Etiketsiz istek oluşturmak için işe ana URL ile başlayın, gerekli tüm parametreleri ve isteğe bağlı ek parametreleri dahil edin. Bu parametreler; reklam birimi, reklam boyutu, anahtar/değer çiftleri ve istekle ilgili diğer bilgileri belirtir.

Etiketsiz istekler, SSL kullanılarak güvenli bir şekilde oluşturulmalıdır (https://).

Temel URL ile başlama

Şu temel URL'yi kullanın:  https://securepubads.g.doubleclick.net/gampad/adx?

Reklam isteğinizin parametrelerini belirtme

Gerekli parametreler

Parametre	Açıklama
iu	Google Ad Manager ağ kodunuz da dahil olmak üzere, Google Ad Manager reklam birimi kodu. Birden çok seviye eklemek için ayırıcı olarak (/) karakterini kullanın. Örnek iu=/123/homepage iu=/456/sports/baseball Etiketsiz isteklerle Çoklu Müşteri Yönetimi (ÇMY) kullanırken ağ kodu için üst,alt yapısını kullanın. Örnek (ÇMY) iu=/123,456/homepage
sz	Reklam öğesi boyutu. Birden fazla boyut eklemek için boyutlar arasında ayırıcı olarak (|) karakterini kullanın. Örnek Tek bir boyut için sz=320x50 Birden fazla boyut için sz=320x50|300x50 Etiketsiz isteklerdeki dik çizgi (|) karakterlerini %7c ile kodlamanız önerilir. Örnek &sz=216x36|300x50|320x50 parametresi &sz=216x36%7c300x50%7c320x50 hâlini alır.
url	İlk reklam isteğini barındıran alanın URL'si. Yalnızca ÇMY istekleri için gereklidir. Örnek url=www.example.com
c	İlişkilendirici değeri (veya önbellek bozma değeri). Bu, gösterim sayımındaki tutarsızlıkları önlemek amacıyla sayfa her yüklendiğinde reklam sunucusuna yeni bir çağrıda bulunulmasını sağlamak için yayıncı tarafından oluşturulan rastgele bir sayı (harflere izin verilmez) olmalıdır. Örnek c=8362527364
tile	Etiketin bir web sayfasındaki konumu. Değer benzersiz bir tam sayı olmalıdır. Daha kolay uygulama için giderek artan bir değer kullanılması önerilir. Bu yalnızca birden çok reklam etiketinin aynı sayfa üzerinde aynı reklam birimi kodu (iu=) ve ilişkilendirici (c=) değerlerini kullanması durumunda gereklidir. Örnek https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

İsteğe bağlı parametreler

Parametre	Açıklama
d_imp	Gecikmeli gösterimi açma/kapatma. Dahil edilmesi hâlinde, istek üzerine gösterim sayımı devre dışı bırakılır ve döndürülen reklam öğesindeki görüntülenen gösterim makrosu veya d_imp_hdr parametresine ait bilgiler bir gösterimin kaydedilmesinde kullanılır. Örnek d_imp=1 d_imp=0 (Bu, Google Ad Manager gösterim sayımı için varsayılan değerdir.)
d_imp_hdr	Gecikmeli gösterim başlık bilgilerini açma/kapatma. Dahil edilmesi hâlinde, gösterim sayımı için kullanılacak görüntüleme URL'si HTTP başlığında döndürülür. Varsayılan olarak, bu başlık bilgileri tanımlanmamıştır. Gösterim sayılması için yayıncının bu görüntüleme URL'sini manuel olarak pinglemesi gerekir. Gösterim sayımı ve etiketsiz istekler hakkında daha fazla bilgi Google-Delayed-Impression başlığı, Google Ad Manager gösterim URL'sini içerir. Google-3rdParty-Delayed-Impression başlığı, reklam öğesinde mevcutsa üçüncü taraf gösterim URL'sini içerir. Örnek d_imp_hdr=1 d_imp_hdr=0 (Gecikmeli gösterim başlığı bilgilerini açıkça devre dışı bırakır.)
t	Alan düzeyinde anahtar/değer çiftleri. Her anahtar ve değer "eşittir" işareti olan = karakteri ile ayrılır. Anahtar/değer çiftleri ise "ve" işareti olan & karakteri ile ayrılır. Önce her bir anahtar ve değer için ayrı ayrı, daha sonra tüm dize için URL kodlaması yapılmalıdır. Bir anahtar/değer grubundaki her anahtar benzersiz olmalıdır. Aynı anahtarı bir kereden fazla girerseniz ilişkili değerlerden yalnızca biri hesaba katılır. Örnek t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith parametresi, "genre" anahtarını "action" değerine, "movie" anahtarını "Mr & Mrs Smith" değerine atar. Anahtar/değer atamaları arasındaki "&" karakterinin tek başına (%26) kodlandığına ancak bir değer içinde geçtiğinde ikili (%2526) kodlandığına dikkat edin. Rakip hariç tutma durumlarında özel anahtar olarak excl_cat kullanın. Örnek t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines Anahtarlarda veya değerlerde şu karakterlere izin verilmez: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Boşluk karakteri değerlerin içinde kullanılabilir (%20 veya + ile çıkış yapılarak) ancak anahtarlarda kullanılamaz. Örnek "a" anahtarının t=a%3Db%252Bc ile "b+c" değerine ayarlanması işe yaramaz.
dk	HTTP başlığında yer alan mime türündeki değer. Örnek m=text/wml
mob	Mobil reklam isteği göstergesi. Örnek mob=js (Kabul edilen tek değer budur.)
ppid	Yayıncı tarafından sağlanan tanımlayıcı (PPID) parametresi, Google Ad Manager'a sıklık sınırı, kitle segmentasyonu, kitle hedefleme, sıralı reklam rotasyonu ve kitleye dayalı diğer reklam yayını kontrolleri için cihazlar genelinde kullanılacak bir tanımlayıcı göndermenizi sağlar. Örnek ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Reklam sunucusu tarafından yapılan otomatik algılamayı geçersiz kılan mobil cihaz ekran genişliği. Örnek u_w=1024
u_h	Reklam sunucusu tarafından yapılan otomatik algılamayı geçersiz kılan mobil cihaz ekran yüksekliği. Örnek u_h=768
submodel	Reklam sunucusu tarafından yapılan otomatik algılamayı geçersiz kılan mobil cihaz donanım bilgileri. Örnek submodel=iPhone4%2C1 (Alt model değerini sınırlamak için kullanılan virgül kodlanmıştır.) Alt model değerleri: iPhone (birinci nesil): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM ve LTE): iPhone5,1 iPhone 5 (CDMA ve LTE): iPhone5,2 iPhone 5c: (GSM ve CDMA): iPhone5,3 iPhone 5c (GSM ve CDMA): iPhone5,4 iPhone 5s (GSM ve CDMA): iPhone6,1 iPhone 5s (GSM ve CDMA): iPhone6,2 iPhone 6 : iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2  1. Nesil iPod: iPod1,1 2. Nesil iPod: iPod2,1 3. Nesil iPod: iPod3,1 4. Nesil iPod: iPod4,1 5. Nesil iPod: iPod5,1 1. Nesil iPad (Wi-Fi): iPad1,1 1. Nesil iPad (AT&T): iPad1,2 2. Nesil iPad (Wi-Fi): iPad2,1 2. Nesil iPad (AT&T): iPad2,2 2. Nesil iPad (Verizon): iPad2,3 2. Nesil iPad (Wi-Fi): iPad2,4 3. Nesil iPad (Wi-Fi): iPad3,1 3. Nesil iPad (Verizon): iPad3,2 3. Nesil iPad (AT&T): iPad3,3 4. Nesil iPad (Wi-Fi): iPad3,4 4. Nesil iPad (AT&T): iPad3,5 4. Nesil iPad (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM ve LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA ve LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Sıklık sınırı ve kitle hedefleme için sıfırlanabilir cihaz kimliğini (RDID) kullanabilirsiniz. Etiketsiz istekler için RDID'yi yapılandırma hakkında daha fazla bilgi

Gösterim izlemeyi etkinleştirme

Ad Manager, etiketsiz istekler için "gecikmeli" gösterim olarak da bilinen indirilen gösterim sayısını izleyebilir. Aşağıdaki seçeneklerden herhangi birini kullanabilirsiniz ancak bu seçeneklerin ikisini birlikte kullanmayın. Tüm seçeneklerin birlikte kullanılması, gösterimlerin iki (veya üç) kez sayılmasına neden olabilir.

1. seçeneği kullanmanız önerilir ancak HTTP yanıt başlıklarına erişebilmeniz ve başlık tabanlı bir protokol uygulayabilmeniz gerekir.

1. seçenek: Gösterim sayımını kontrol etmek için HTTP yanıt başlığını okuyun

d_imp=1 ve d_imp_hdr=1 parametrelerini etiketsiz isteğinize ekleyin. Böylece, siz Google-Delayed-Impression HTTP başlık URL'si ile manuel olarak gösterim ping'i tetikleyene kadar Google Ad Manager bir gösterim veya indirilen gösterim kaydetmez. Gösterim ping'i tetiklendiğinde Google Ad Manager tarafından bir "Reklam sunucusu gösterimi" ve "Reklam sunucusundan indirilen gösterim" kaydedilir.

Bir gösterimin iki kez sayılmasını önlemek istiyorsanız etiketsiz istekler tarafından döndürülen reklam öğelerine görüntülenen gösterim makrosunu dahil etmeyin.

2. Seçenek: Görüntülenen gösterim makrosunu kullanın

HTTP yanıt başlıklarına erişemiyorsanız envanterinizi segmentlere ayırmanız ve görüntülenen gösterim makrosunu etiketsiz istek tarafından döndürülen her reklam öğesinin kod snippet'ine eklemeniz gerekir. Bu makro, oluşturulurken reklam öğesi tarafından gönderilecek bir URL'ye genişler.

Reklam öğesi kodunu almak için etiketsiz istek yapma

Web içeriği

Etiketsiz istekler, genellikle Google etiketleme veya SDK desteği olmayan ortamlarda kullanılır. Etiketsiz isteği web'e yüklerseniz döndürülen ham kodu yürütebilmek için bunu bir <iframe> içinde yüklemeniz gerekir.

Google SDK'sı olmayan özel ortamlar

Google etiketleme veya SDK desteği olmayan ortamlarda (ör. Google harici set üstü kutu) ham reklam öğesi kodunu almak için aşağıdaki kurallara başvurun:

• Hedeflemenin doğru şekilde çalışmasını sağlamak için User-Agent istek başlığında geçerli bir kullanıcı aracısı ayarlayın.
• JavaScript ve reklam öğesi genişletme dahil olmak üzere ortamınızın rich media davranışlarını işleyebildiğinden emin olun.
• Google Ad Manager'a bir HTTPS isteği gönderin.
• İstek biçiminin doğru olduğunu gösteren "HTTP 200/OK" ifadesini bulmak için yanıt durumunu inceleyin.

Etiketsiz istekleri desteklemeyen özellikler

• Aktif Görüntüleme
• Ad Exchange
• İzleme amacıyla kullanılan çerezler veya mobil uygulama tanımlayıcıları
• Reklam sarmalayıcılar
• AdSense, Ad Exchange veya AdMob ile Dinamik ayırma
• Yerel envanter
• Tercih Edilen Anlaşmalar
• Reklam öğesi önizlemeleri

HTML resim etiketlerinde (<img>) gampad/ad kullanan etiketsiz istekler, JavaScript izleme kodunu desteklemez ve indirilen gösterimlerin sayımında desteklenmez.

Bu reklamlarla ilgili rapor oluşturmak için Ad Manager raporlarındaki "Toplam kod sunma sayısı" metriğini kullanın.