Makrolar, reklam öğesi kodundaki özel dizelerdir. Daha sonra Ad Manager, bu dizeleri reklam öğesinin ayarlarına göre başka bir değer veya kodla değiştirir. Makrolar, değişiklik yapmanız gerektiğinde reklam öğesi kodunu doğrudan güncellemeniz gerekmediğinden kullanışlıdır. Makro referansını güncelleyebilirsiniz.
Her bir makronun nasıl kullanılabileceğiyle ilgili önerilerde bulunduk ancak siz de makroları en uygun olduğunu düşündüğünüz şekilde kullanabilirsiniz. Makrolar, yayınlanma sırasında reklam sunucusu tarafından işlenen herhangi bir koda eklenebilir. Bunlara üçüncü taraf veya özel reklam öğesi kodu, Studio kodu, tıklama URL'leri veya reklam etiketleri dahildir.
Makrolar hakkında önemli notlar
- Büyük/küçük harfe duyarlı olma
Makrolar büyük/küçük harfe duyarlıdır.%%Cachebuster%%makrosu yerine%%CACHEBUSTER%%makrosunu kullanın. - Çıkış karakterli ve çıkış karaktersiz genişletme
Çıkış karaktersiz ve çıkış karakterli makro sürümleri farklı şekilde genişler. Çıkış karakterli ve çıkış karaktersiz makroları nasıl kullanacağınızı öğrenin. - Makro ekleme
Ad Manager, üçüncü tarafı tanırsa üçüncü taraf reklam öğeleri veya VAST etiketi URL'leri için makroları otomatik yerleştirir. Özel reklam öğeleri ve reklam öğesi şablonları için makroları manuel olarak eklemeniz gerekir. Makroyu nereye yerleştireceğinizden emin değilseniz reklam öğesi tedarikçi firmasına başvurun.
Bir reklam öğesi şablonuyla trafiğe eklenirken, Tıklama URL'si girişi yalnızca şablonda bir tıklama makrosu kullanıldığında sunulur. - Ayrılmış karakterler ve URL kodlaması (yüzde kodlaması)
Ad Manager, önünde yüzde işareti olan bazı küçük harfleri ayırır:%a
%c
%h
%i
%n
%p
%kBu dizeler, makro genişlemesini engelleyebileceği için URL kodlamasında kullanılmamalıdır.
- Makrolar Programatik Doğrudan'ı desteklemez
Programatik Doğrudan ile kullanılabilen özelliklere bakın.
Listedeki belirli bir makroya gidin
Oluşturma makroları
Oluşturma makroları, reklam öğeleri oluşturmak için yaygın şekilde kullanılır ve reklam öğelerinin düzgün görünüp çalışmasını sağlar.
Reklam birimi| Makro |
|---|
%%ADUNIT%% |
Reklam birimi makrosu, yayınlandığı sırada reklam birimi yolunu Google Yayıncı Etiketi'nden reklam öğesi koduna ekler.
ADUNIT makrosunu üçüncü taraf reklam öğesi kodu snippet'ine şe şekilde ekleyebilirsiniz:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
Reklam birimi makrosu, ağ kodunu içeren orijinal reklam isteğinde yer alan tam reklam birimi yoluna genişler. Aşağıda, reklam sunulduğunda reklam birimi yolunun nasıl genişletileceğine dair bir örnek bulabilirsiniz:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Bu makro yalnızca onaylı önerilen reklam birimleriyle çalışır. Önerilen bir reklam birimi üçüncü seviyedeyse bu makro, reklam öğesi snippet'inde kullanıldığında yalnızca ikinci seviye reklam birimine genişler. Önerilen reklam birimi onaylandıktan sonra makro, reklam öğesi snippet'inde üçüncü reklam birimi seviyesine genişler
| Makro | Çıkış karakterli |
|---|---|
%%DEST_URL_ESC%% |
Çıkış karakterli |
%%DEST_URL_ESC_ESC%% |
Çift çıkış karakterli |
%%DEST_URL_UNESC%% |
Çıkış karaktersiz |
Hedef URL makrosu, reklam öğesinin tıklama URL'sine genişler. Bu URL, satır öğesinin tıklama URL'si veya satır öğesi içinde reklam öğesi için ayarlanan bir geçersiz kılmadır.
Hedef URL makrosu, özel reklam öğelerinde ve reklam öğesi şablonlarında kullanışlıdır. Reklam öğesi kodunun reklam öğesi tıklama URL'sini içermesi gerekiyor, tıklama URL'si de reklam öğesi veya şablon farklı satır öğelerinde kullanılırken değişiyorsa bu makro işe yarayabilir.
Üç tıklama URL'si makrosu mevcuttur: çıkış karakterli, çift çıkış karakterli ve çıkış karaktersiz. Çıkış miktarı (ESC kodunu bir kez eklemeniz, iki kez eklemeniz veya hiç eklememeniz), genellikle üçüncü taraf tıklama izleme şirketine bağlıdır. Bazı üçüncü taraf tıklama izleme şirketleri, URL'den çıkış yapılmasını zorunlu tutarken, bazıları bunu zorunlu tutmaz. Bir üçüncü taraf tıklama izleme şirketi tarafından gerekli görülen çıkış karakteri seviyesi, Ad Manager'da üçüncü taraf reklam etiketinde veya özel reklam öğesi kodunda, genellikle etiketteki click= dizesiyle belirtilir:
-
click=: Bir kez çıkış yap (%%DEST_URL_ESC%%). -
click0=: Çıkış yapma (%%DEST_URL_UNESC%%). -
click1=: Bir kez çıkış yap (%%DEST_URL_ESC%%). -
click2=: İki kez çıkış yap (%%DEST_URL_ESC_ESC%%).
%%DEST_URL_ESC%% ile tam olarak aynı işi yapan %%DEST_URL%%'yi destekler. Anlaşılırlık açısından %%DEST_URL_ESC%% kullanmanızı öneririz ancak eski reklam öğelerinin ve şablonların yeniden kodlanmasına gerek yoktur.%u veya %%DEST_URL%% makrosunu içeriyorsa reklam öğesini tıkladığınızda xsd:string URL'sine yönlendirilirsiniz. En fazla 1.024 karakter uzunluğundadır.| Makro |
|---|
%%FILE:file_display_name%% |
%%FILE:file_display_name%% dosya sunucusu makrosu, bir reklam öğesi için yüklenmiş reklam öğesinin tam URL'sine genişler. Yüklenen öğeleri özel reklam öğesi koduyla (ör. resim) çağırmak için bu makroyu kullanın.
Bu makroyu kullanmak için file_display_name parametresini, reklam öğesi ayrıntılarını görüntülediğiniz sırada Ad Manager'da gösterilen reklam öğesi adıyla değiştirin.
| Makro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Bu makrolar, reklam yayınlama işlemi sırasında reklam öğesinin "Hedef reklam birimi boyutu" alan değeriyle Ad Manager'da tanımlanan yükseklik ve genişliğini reklam öğesinin özel koduna ekler.
Yükseklik ve genişlik makroları, özellikle farklı boyutlardaki reklam öğeleriyle yeniden kullanmak istediğiniz bir reklam öğesi şablonu oluşturuyorsanız yararlı olabilir. Her bir reklam öğesinin boyutunu sabit şekilde kodlamak yerine, yükseklik ve genişlik makrolarının değerleri her bir reklam öğesine dinamik şekilde eklemesini sağlayabilirsiniz.
| Makro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Hedefleme değeri gibi bir veya daha fazla özelleştirilebilen değişkeni bir reklam öğesine iletmek için kalıp eşleştirme makrosunu kullanın. Anahtar/değer çiftlerini iletmek, tüm hedefleme dizesini değiştirmek veya yönlendiren URL'sini genişletmek için bu makroyu kullanabilirsiniz. Bu, kullanıcı hakkında bildiklerinize (ör. içerik tercihlerine) bağlı olarak farklı reklam öğeleri sunmak istediğinizde yararlı olabilir.
Kalıp eşleştirme makrosu, reklam öğesi başına 100 değiştirme ile sınırlıdır.
Kalıp eşleştirme makrosuna çıkış karakteri ekleme
Kalıp eşleştirme makrosu, değeri alındığı gibi döndürür. Makroyu video reklam öğesindeki "VAST etiketi URL'si" veya "Üçüncü taraf izleme URL'si" alanı gibi URL alanlarından birinde kullanıyorsanız, genişletilmiş değerin çıkış karakterli olarak döndürülmesini isteyebilirsiniz. Bunu yapmak için istekteki değere üç çıkış karakteri eklemeniz gerekir.
%%PATTERN:key%%
Örneğin, belirli bir satır öğesi için biri kadın kullanıcılara, diğeri ise erkek kullanıcılara hitap etmek üzere tasarlanmış iki reklam öğeniz olsun. Makroda kullanılan "anahtar", alfanümerik karakter veya alt çizgi (_) olmalıdır.
Süreç şöyle işler:
- Özel değeri (bu örnekte kullanıcının cinsiyeti) anahtar/değer çiftleriyle sayfanızdaki bir reklam etiketine iletirsiniz:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Özel veya üçüncü taraf reklam öğesinde, şu makroyu kullanarak özel değeri dinamik olarak iletirsiniz:
<buraya bir reklam öğesi komut dosyası gelir>...&gender=%%PATTERN:gender%% %%PATTERN:gender%%makrosunun tamamı "male" ile değiştirilecektir.- Ad Manager, "male" reklam öğesi dosyasını çağırır ve bu kullanıcıya sunar.
%%PATTERN:TARGETINGMAP%%
Tüm hedefleme haritasını değiştirmek ve dinamik olarak geri verilen gösterim etiketleri oluşturmak için %%PATTERN:TARGETINGMAP%% makrosunu kullanabilirsiniz.
TARGETINGMAP makrosunu bir reklam etiketine aşağıdaki gibi ekleyebilirsiniz:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Aşağıda, reklam sunulduğunda oluşan tam bir anahtar/değer dizesi örneği görebilirsiniz:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
İki Ad Manager ağı ("Ağ A" ve "Ağ B") arasında geri verilen gösterim etiketi ayarlamak için bu makroyu kullanabilirsiniz.
Aşağıda, Ad Manager Ağı A'da ayrılan örnek bir reklam öğesini görebilirsiniz:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Ad Manager Ağı B'de sunulacak satılmış bir kampanya yoksa bu ağ, aşağıdaki gibi bir geri verilen gösterim reklam öğesini kullanarak gösterimi Ağ A'ya geri verebilir:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // to avoid infinite loops
.display();
</script>TARGETINGMAP makrosunu, üçüncü taraf reklam sunucusuna yapılan bir istekte gönderilen geri verilen gösterim etiketinde de kullanabilirsiniz. Böylece dinamik bir reklamda birden fazla değere sahip olabilirsiniz.
Aşağıda, Ad Manager'da ayrılan örnek bir reklam öğesini görebilirsiniz:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Bu, Ad Manager tarafından sunulduğunda şu şekilde genişletilir:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Üçüncü taraf, artık dinamik olarak oluşturulan “dfpAdUnit” ve “targeting” parametrelerine erişebilir ve aşağıdaki geri verilen gösterimi oluşturabilir:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // to avoid infinite loop (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Bunu yapmak için üçüncü tarafa şunun gibi görünen bir şablon kodu verilebilir:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Yönlendiren sayfanın URL'sini genişletmek için url ayrılmış anahtarını da kullanabilirsiniz.
url'nin ayrılmış bir anahtar olduğunu ve yönlendiren URL'sinin, Campaign Manager 360 etiketlerinizde anahtar adı olarak url'yi içeren tüm anahtar/değer çiftlerinin üzerine yazılacağını unutmayın.
| Makro |
|---|
%%TAG_PARAM%% |
Etiket parametresi makrosu diğer reklam etiketi parametreleriyle birlikte kullanılır ve yalnızca aşağıdaki parametrelerle kullanılabilir:
Desteklendiğinde parametrenin değerine genişler.
Örneğin, %%TAG_PARAM:correlator%% (desteklenir) reklam etiketindeki correlator değerine genişler ancak %%TAG_PARAM:ppid%% (desteklenmez) herhangi bir değere genişlemez.
| Makro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Yeni pencere makrosundaki hedef, reklam öğesinin yayınlandığı reklam birimi için hedef pencere ayarının ne olduğunu gösterir: "_blank" (yeni pencere) veya başka bir değer.
-
Hedef pencere
_blankise makro1'e genişler. -
Hedef pencere başka herhangi bir değerdeyse veya hedef pencere belirtilmediyse makro
0'a genişler.
Gerçek hedef pencere ayarı değerini eklemek istiyorsanız %%TARGET_WINDOW%% makrosunu kullanın.
| Makro |
|---|
%%TARGET_WINDOW%% |
Hedef pencere makrosu, reklam öğesinin yayınlandığı reklam birimi için belirlenen hedef pencereye genişler. Reklam öğesinin tıklanmasının, kullanıcıların reklamı göreceği her bir sitenin ayarlarına bağlı olarak kullanıcıyı yeni bir pencereye mi yönlendireceği yoksa açılış sayfasını aynı pencerede mi yükleyeceğini belirtmek için bir reklam öğesi kodu içinde bu makroyu kullanabilirsiniz.
Örneğin, AdManager_News.com reklam biriminin hedef penceresi _top ve AdManager_Fashion.com reklam birimininki _new olarak ayarlıdır. Reklam öğesinin kodu %%TARGET_WINDOW%% makrosunu içeriyorsa AdManager_News.com kullanıcıları için _top ve AdManager_Fashion.com kullanıcıları için _new parametresini içerecek şekilde genişleyecektir.
Burada bir örnek uygulama görebilirsiniz:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Hedef pencere ayarı değerini "_blank" veya başka bir değer olarak belirlemek istiyorsanız %%TARGET_IN_NEW_WINDOW%% makrosunu kullanın.
| Makro |
|---|
%%TFCD%% |
Çocuklara yönelik içerik etiketi (TFCD), belirli bir reklam isteğinin çocuklara yönelik içeriğe sahip sayfalardan geldiğini üçüncü taraflara bildirmenizi sağlar. Makronun amacı, Çocukların Çevrimiçi Gizliliğini Koruma Yasası (COPPA) ile uygunluğun sağlanmasını desteklemektir.
Bu makroyu, tüm üçüncü taraf reklam öğesi isteklerine veya yönlendirmelerine coppa=%%TFCD%% biçiminde veya benzer şekilde ekleyebilirsiniz. Makro, JavaScript'te GPT geri verilen gösterim etiketi isteklerini çocuklara yönelik olarak değerlendirilme için ayarlama amacıyla da kullanılabilir. Makro, isteği Ad Manager'a gönderen sayfanın, sitenin veya mobil uygulamanın özellikleri hakkındaki bilgilere bağlı olarak çocuklara yönelik içerik için 1, diğer içerikler için 0'a genişler.
Google'ın reklamcılık hizmetlerini kullanıyor ve site veya uygulama düzeyinde çocuklara yönelik olarak değerlendirilmeyi uygulamak istiyorsanız lütfen Bir siteyi ya da uygulamayı çocuklara yönelik olarak değerlendirilme için etiketleme bölümüne bakın.
| Makro |
|---|
[%URI_ENCODE:degisken%] |
URI kodlama makrosu, reklam öğesi şablonu değişken değerleri içindeki boşlukları ve diğer özel karakterleri URL olarak da bilinen URI'larda kullanılmaları için doğru şekilde çevirir.
Örnek
Reklam öğesi şablonunuzda, "dark blue" ve "light green" şeklinde iki değer içeren "Color" adında bir "liste" değişkeni olduğunu varsayalım. Ad Manager, varsayılan olarak reklam öğesi şablonu snippet'inize [%Color%] değerini ekler:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
Reklam öğesi oluşturulduğunda Ad Manager [%Color%] ifadesini seçilen liste öğesinin düz metin dizesiyle değiştirir. Bu örnekte, düz metin dizesi boşluk karakterleri içerir ve boşluk karakterlerinin kodlanması gerekeceğinden URL'yi bozar: Bu sorunun önüne geçmek için [%URI_ENCODE:Color%] kullanın.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Bu makro, bir tıklama URL'sini veya yönlendirme URL'sini tanımlamak için reklam öğesi şablonu değişkeni kullanıldığında özellikle faydalıdır. Doğru kodlama olmadan, reklam öğenizdeki tam URL çalışmayabilir.
Örnek
Reklam öğesi şablonunuzda "LandingPage" adında bir "URL" değişkeni olduğunu varsayalım. Varsayılan olarak Ad Manager, reklam öğesi şablonu snippet'inize [%LandingPage%] ekler:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Burayı tıklayın!</a>
[%LandingPage%] URL'si ?page=home&sport=baseball gibi sorgu parametreleri içeriyorsa URL bozulur ve yönlendirme olması gerektiği gibi çalışmaz. Bu örnekte "ve" (&) işaretinden sonraki içerik, yönlendirme URL'si yerine tam URL ile ilişkilendirilir. Bu sorunu önlemek için [%URI_ENCODE:LandingPage%] kullanın.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Burayı tıklayın!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
İzleme makroları
Bu makrolar, en yaygın şekilde izleme ve raporlama amacıyla kullanılır.
Önbellek engelleme (rastgele bir sayı)| Makro |
|---|
%%CACHEBUSTER%% |
Önbellek engelleme makrosu, kod her yürütüldüğünde reklam sunucusuna yeni bir çağrı yapılmasını ve böylece gösterimleri doğru şekilde saymanızı sağlar. Önbelleği bozan makroyu reklam öğesi koduna eklemezseniz Google Ad Manager ile üçüncü taraf reklam sunucusunun gösterim sayımları arasında tutarsızlık olma ihtimali artar. Tüm üçüncü taraf reklam sunucuları için önbellek engelleme makrosu gerekmediğini unutmayın.
Çoğu reklam öğesi tedarikçi firması, önbellek engelleme makrolarını eklemek için etiketlerinde bir yer tutucu sunar. Örneğin, üçüncü taraf reklam öğesi kodunuzda şöyle bir şey varsa:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Yer tutucunun yerini alması için [RANDOM_NUMBER] öğesini seçmeniz ve Önbellek engelleme makrosu ekle düğmesini tıklamanız gerekir:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER makrosunu ekleyin.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
VAST yanıtlarında önbellek engelleme makroları
%%CACHEBUSTER%% makrosu, belirli bir reklam öğesi içindeki tüm etkinlikler için aynı rastgele sayıya genişletilir. Makro bir VAST yanıtındaki her video izleme etkinliği için aynı rastgele sayıya genişletileceğinden, bu özellikle video reklamlar söz konusu olduğunda yararlıdır.
| Makro | Çıkış karakterli |
|---|---|
%%CLICK_URL_UNESC%% |
Çıkış karaktersiz |
%%CLICK_URL_ESC%% |
Çıkış karakterli |
%%CLICK_URL_ESC_ESC%% |
Çift çıkış karakterli |
Tıklama makrosu, özel bir URL'ye genişleyerek Ad Manager'da üçüncü taraf reklam öğeleri için tıklamaları izlemenizi sağlar. Bu makro, genellikle bağlantı etiketindeki (<a>) bir reklam öğesinin tıklama URL'si ile eşleştirilir. Tıklama makrosunu bir resmin veya iframe'in kaynağı olarak girmeyin. Aksi takdirde, resim veya iframe her oluşturulduğunda bir tıklama kaydedilir; bu geçerli değildir ve geçersiz tıklama olarak filtrelenir.
Bağlantının başında %%CLICK_URL_UNESC%% makrosunu kullanın. Tıklama izleyici başka bir URL'nin parametresi olduğunda %%CLICK_URL_ESC%% kullanın.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">bağlantı</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">bağlantı</a>
Çıkış karakterli ve çıkış karaktersiz makrolar hakkında daha fazla bilgi
Tıklama makrosu uygulamanızı doğrulama
Yanlış yerleştirilmiş tıklama makrosu tıklamaları izlemez. Ad Manager'ın tıklamaları istediğiniz gibi kaydettiğinden emin olmak için aşağıdaki adımları uygulayın.
- Reklam öğesini önizleyin.
- Önizlemeyi tıklayın.
Ad Manager, tıklamaların kaydedileceğine dair bir onay gösterir. Bu onayı görmüyorsanız tıklama makronuz doğru şekilde uygulanmamıştır.
| Makro | Genişlediği değer |
|---|---|
%eaid! |
Satır öğesi kimliği |
%eadv! |
Sunulmakta olan satır öğesinin reklamveren kimliği |
%ebuy! |
Sunulmakta olan satır öğesinin sipariş kimliği |
%ecid! |
Reklam öğesi kimliği |
%eenv! |
Ortam (etiket türü) göstergesi: iframe için i; JavaScript için j |
%epid! |
Satır öğesinin sunulmakta olduğu reklam biriminin kimliği |
%esid! |
Satır öğesinin sunulmakta olduğu reklam biriminin üzerindeki en üst seviye reklam biriminin kimliği
Bu, eski bir makrodur ve ağınızda beklendiği gibi çalışmayabilir.
|
Bir sayfada reklam öğeleri yayınlarken Ad Manager'daki kimlik değerlerini görüntülemek için özel reklam öğesi kodunda veya tıklama URL'sinde genişletme makrolarını kullanın. Bu, çoğu zaman sorun giderme veya diğer raporlama amaçları doğrultusunda Ad Manager'daki kimlikleri yayıncının kendi veritabanındaki kimliklerle eşleştirmek için kullanılır.
Genişletme makroları, Ad Manager tıklama URL'sinde kullanılması güvenli olan herhangi bir karakter kullanılarak tıklama URL'sinde birbirinden ayrılabilir. Örneğin, http://www.site.com/?%eaid!;%ecid!, http://www.site.com/?1234567;4265598 olarak genişletilebilir.
| Makro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (cihaz kimliği) |
%%ADVERTISING_IDENTIFIER_TYPE%% (cihaz türü) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (Reklam İzlemeyi Sınırla ayarı) |
%%ADVERTISING_IDENTIFIER_PLAIN%% makrosu, uygulama içi yayıncılara ilgi alanına dayalı reklamlar sunmak için reklam iş ortaklarına sıfırlanabilir bir cihaz kimliği gönderme olanağı tanıyor. Bu, reklamverenleriniz ve ajanslarınıza sıfırlanabilir cihaz kimliği için erişim izni vermenizi kolaylaştırır.
Uygulama içi yayıncılar, cihaz türünü göndermek için %%ADVERTISING_IDENTIFIER_TYPE%% makrosunu; cihazdan gelen Reklam İzlemeyi Sınırla sinyalini gösteren Reklam İzlemeyi Sınırla (LAT) ayarını göndermek için %%ADVERTISING_IDENTIFIER_IS_LAT%% makrosunu da kullanabilir.
Desteklenen cihaz türlerini de içeren kullanıcı hedefleme için sıfırlanabilir cihaz kimlikleri hakkında daha fazla bilgi
Ön şartlar
Reklam öğeleri için HTTPS şifrelemesini ayarlayın. Bu gereksinim, reklam öğesinin yanı sıra dönüşüm izleme için kullandığınız her türlü üçüncü taraf piksel için de geçerlidir. Reklam öğeleri HTTPS için şifrelenmediği veya otomatik SSL uyumluluğu geçersiz kılındığı takdirde makro değeri genişletmez ancak reklam öğeleri yine de yayınlanır.
İşleyiş şekli
- Ad Manager'da yayıncı, makroları reklam öğesi ve/veya izleme URL'lerine ekler.
-
Makrolar kullanıcının cihaz kimliğini, cihaz türünü ve/veya LAT ayarını içerecek şekilde genişler ve ardından bunlar, üçüncü tarafa çağrı yaparken reklam öğesine dahil edilir.
Reklam isteği çocuklara yönelik uygulamadan (TFCD) geliyorsa veya Reklam İzlemeyi Sınırla (LAT) etkinleştirilirse kimlik makrosu genişlemez. Böyle durumlarda, bu makro boş bir dize ("") döndürür.
Biçim
Bu makro beş grup hâlinde görüntülenen, kısa çizgilerle ayrılmış, toplam 36 karakter için (32 alfasayısal karakter ve dört kısa çizgi) 8-4-4-4-12 biçimindeki büyük harfle yazılmış, onaltılık 32 basamak değeri gönderir.
Örnek: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Desteklenen cihaz türleri ve Reklam İzlemeyi Sınırla (LAT) için olası değerleri inceleyin.
| Makro |
|---|
%%PREVIEW_MODE%% |
Önizleme modu makrosunu, arka uç sistemlerinize veya üçüncü taraf sistemlere ait önizleme gösterimlerinin sayılmasını önlemek için özel reklam öğesi kodunda kullanın. Reklam öğesi Ad Manager önizlemesi olarak görünüyorsa doğru; sıradan bir gösterimse yanlış içerecek şekilde genişler.
| Makro |
|---|
%%SCHEME%% |
Şema makrosu, reklam öğesinin sunulduğu web sayfasının güvenlik şemasına uygun olarak http: veya https: içerecek şekilde genişler. Bunu bir URL'nin başına yerleştirebilirsiniz.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Makro |
|---|
%%SITE%% |
Bir reklam etiketindeki URL parametresinin alan adına genişler (örneğin google.com). Makro, isteğin geldiği yere dayalı olarak reklam öğenizi değiştirmek için kullanılabilir. Anonim olarak işaretlenmiş Ad Exchange reklamlarında çalışmaz.
| Makro | Çıkış karakterli |
|---|---|
%%VIEW_URL_ESC%% |
Çıkış karakterli |
%%VIEW_URL_UNESC%% |
Çıkış karaktersiz |
Bir reklam öğesi kullanıcının cihazına her indirildiğinde ve yüklenmeye başladığında, görüntülenen gösterim makrosu Ad Manager'ın bir gösterim saymasını sağlar. Bu makroyu yalnızca sayfa dışı reklam öğelerinde kullanın.
Görüntüleme pingi göndermenin birden çok yolu vardır. Bir <img> etiketi kullanmanızı öneririz:
<!-- Bu img etiketi görünmezdir. Tarayıcının VIEW_URL'ye bir istek göndermesini sağlar. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Bu img etiketi gerçek reklamı gösterir.-->
<img src="[%Imagefile%]" border="0">
İlk <img> etiketi, VIEW_URL'den 1x1 resim alır. Stili, gizli olması ve sayfanın düzenini etkilememesi için “display:none” olarak ayarlayın.
GDPR için reklam isteği makroları
Bu makrolar, en yaygın şekilde GDPR'ye tabi reklam istekleriyle kullanılır.
GDPR| Makro |
|---|
${GDPR} |
İstekle ilişkilendirilmiş gdpr= değerine genişler
| Makro |
|---|
${GDPR_CONSENT_XXXX} |
İstekle ilişkili Şeffaflık ve Kullanıcı Rızası (TC) dizesine genişler. Şeffaflık ve Kullanıcı Rızası (TC) dizesi boş veya geçersizse bu makro genişletilmez. Programatik olmayan reklam öğelerinde TC dizesini bir URL'de üçüncü taraf reklam öğesi sağlayıcıya iletmek için bu makroyu kullanın.
"XXXX" ifadesini, üçüncü taraf sağlayıcının IAB GVL kimliğiyle değiştirin. TC dizesi boş veya geçersizse bu makro genişletilmez.
${GDPR_CONSENT_XXXX} makrosunu içeren reklam öğeleri, eklediğiniz IAB GVL kimliğiyle ilişkili üçüncü taraf sağlayıcının kullanıcı rızası yoksa engellenebilir.
Bir VAST etiketinde kullanıldığında ve üçüncü taraf sağlayıcı kullanıcı iznine sahip olmadığında bu makro genişlemez.
${GDPR_CONSENT_XXXX} makrosu, URL'de yalnızca bir kez bulunmalıdır. TC dizesinin iletilmesiyle ilgili koşullarını ve URL uzunluğu kısıtlamalarını anlamak için üçüncü taraf reklam öğesi sağlayıcınızla iletişime geçin. Makro, alakalı IAB TCF sürüm 2.0 isteklerinde tam ve değiştirilmemiş TC dizesiyle değiştirilir.
Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) makroları, HTML5 reklam öğelerinin HTML'inde uygulandıklarında genişlemez. Yalnızca Görüntülü Ağ Yönlendirme ve Özel Görüntülü reklam öğeleri, TCF makrolarının sırasıyla "Üçüncü taraf URL'si" ve "HTML kodu" alanları kullanılarak genişletilmesini destekler.
| Makro |
|---|
${ADDTL_CONSENT} |
İstekle ilişkili Ek İzin (AC) dizesine genişler.
| Makro |
|---|
%%TFUA%% |
İsteği Reşit olma yaşının altındaki AEA ve Birleşik Krallık kullanıcıları olarak etiketlemek için 1 değerine genişler.
Video makroları
Bu makrolar, genel olarak video reklam öğelerinde bağlam veya içerik ile ilgili ayrıntıları dahil etmek kullanılır.
Milisaniye cinsinden video reklam süresi| Makro |
|---|
%%VIDEO_AD_DURATION%% |
Milisaniye olarak video reklamın süresine genişler. VAST paketleri/yönlendirmeleri için makro, Ad Manager'da reklamın bildirilen süresine genişler.
| Makro | Çıkış karakterli |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Çıkış karaktersiz |
%%DESCRIPTION_URL_ESC%% |
Çıkış karakterli |
%%DESCRIPTION_URL_ESC_ESC%% |
Çift çıkış karakterli |
Makro bir URL'nin içinde olduğu zaman %%DESCRIPTION_URL_ESC%% (tek çıkış karakterli) makrosunu, diğer durumlarda %%DESCRIPTION_URL_UNESC%% (çıkış karaktersiz) makrosunu kullanın. Çıkış karakterli ve çıkış karaktersiz makrolar hakkında daha fazla bilgi
Yönlendirme reklam etiketlerinde bu makrolar, orijinal Google Yayıncı Etiketi'nin description_url sorgu parametresinden açıklama URL'si parametresine genişler. Açıklama URL'si, normalde yönlendiren URL ile aynı olmalıdır. IMA SDK'nın sayfa URL'sini kesin olarak algılayamayabileceği yerleştirmeler varsa ya da Ad Exchange'de video veya Video için AdSense kullanıyorsanız Google Yayıncı Etiketi'nde description_url parametresini belirtmeniz gerekir.
%%DESCRIPTION_URL_UNESC%% ile aynı işlevi gören %%DESCRIPTION_URL%% makrosunu da destekler. Dolayısıyla, eski reklam öğelerinin ve şablonların yeniden kodlanmasına gerek yoktur.| Makro | Çıkış karakterli |
|---|---|
%%REFERRER_URL_UNESC%% |
Çıkış karaktersiz |
%%REFERRER_URL_ESC%% |
Tek çıkış karakterli |
%%REFERRER_URL_ESC_ESC%% |
Çift çıkış karakterli |
Makro bir URL'nin içinde olduğu zaman %%REFERRER_URL_ESC%% (tek çıkış karakterli) makrosunu, diğer durumlarda %%REFERRER_URL_UNESC%% (çıkış karaktersiz) makrosunu kullanın. Çıkış karakterli ve çıkış karaktersiz URL makroları hakkında daha fazla bilgi
Bu makro, yönlendirme reklam etiketlerinde yönlendiren URL'sine (video oynatıcının bulunduğu sayfanın URL'sine) genişler. Bunu şu şekilde yapar: Ad Manager, reklam etiketinin URL'sini sorgu parametresine ayrıştırır, yönlendiren URL'sini ayırır ve makro metnini bu URL'yle değiştirir. Yalnızca Google IMA SDK'sı ile ve aşağıdaki niteliklerle çalışır:
- Bu makronun çalışması için sayfada komut dosyası erişiminin etkinleştirilmesi gerekir.
- Makro, bir iframe içinde çalışmaz.
%%REFERRER_URL_UNESC%% ile aynı işlevi gören %%REFERRER_URL%% makrosunu da destekler. Dolayısıyla, eski reklam öğelerinin ve şablonların yeniden kodlanmasına gerek yoktur.Video içeriği makroları
Bu makrolar, video içerik kaynaklarını hedefleyen reklamlar için kullanılır.
| Makro |
|---|
%%VIDEO_DURATION%% |
Milisaniye olarak videonun süresine genişler.
| Makro |
|---|
%%VIDEO_ID%% |
Oynatılmakta olan video içeriğinin kimliğine genişler. Bu kimlik CMS'deki benzersiz kimlik veya MRSS'nin dfpvideo:ContentID değeridir.
| Makro |
|---|
%%VIDEO_METADATA:key%% |
Video içeriğiyle ilişkilendirilen anahtar/değer çiftlerini temel alan, reklam öğesinin sunulmakta olduğu videoyla ilgili meta verilere genişler. Ad Manager'da anahtar/değer çiftleri "Video" sekmesinden ayarlanır.
Video meta veri anahtarı hedeflendikten sonra video meta veri makrosu tarafından genişletilebilir. Makroda kullanılan "anahtar", alfanümerik karakter veya alt çizgi (_) olmalıdır.
| Makro | Çıkış karakterli |
|---|---|
%%VIDEO_TITLE%% |
Tek çıkış karakterli |
Video başlığı makrosu genişleyerek videonun başlığını Ad Manager'da tanımlandığı gibi gösterir.
Bu makronun çalışması için içerik besleme gerekir.
| Makro |
|---|
%%FW_CAID%% |
FreeWheel özel reklam kimliğine genişler.
Bu makro yalnızca video reklam yayınında FreeWheel kullanan yayıncılar için geçerlidir.
| Makro |
|---|
%%IAB_CATEGORIES%% |
Etiketlerle manuel olarak sınıflandırdığınız reklam öğeleri için reklam kategorilerini iletmek amacıyla kullanılır. Bu makro, geçerli standart IAB kategorilerinin (Google sınıflandırılmış kategorilerinden dönüştürülmüştür) virgülle ayrılmış listesini döndürür.
Bu makro, FreeWheel ile video envanteri paylaşan ve reklam kategorilerini özel parametre olarak iletmek isteyen yayıncılar tarafından kullanılabilir. Örneğin, VAST yönlendirme etiketinize &iab_categories=%%IAB_CATEGORIES%% ekleyebilirsiniz.
