Makra to specjalne ciągi znaków w kodzie kreacji. Ad Manager zastępuje je później inną wartością lub kodem na podstawie ustawień kreacji. Dzięki makrom nie musisz bezpośrednio aktualizować kodu kreacji, gdy chcesz wprowadzić zmiany. Wystarczy, że zaktualizujesz makro.
Przy każdym makrze opisujemy sugerowane sposoby jego użycia, ale możesz je dostosować do swoich potrzeb. Makra można umieszczać w dowolnym kodzie przetwarzanym przez serwer reklam podczas wyświetlania: kodzie kreacji niestandardowej lub kreacji firmy zewnętrznej, kodzie Studio, docelowych adresach URL czy tagach reklam.
Ważne uwagi na temat makr
- Uwzględnianie wielkości liter
W makrach rozróżniana jest wielkość liter. Używaj zapisu%%CACHEBUSTER%%, a nie%%Cachebuster%%. - Rozwinięcie ze zmianą znaczenia i bez niej
Wersje makr ze zmianą znaczenia i bez niej rozwijają się inaczej. Dowiedz się, jak używać makr ze zmianą znaczenia i bez niej. - Wstawianie makr
Jeśli Ad Manager rozpoznaje firmę, która przygotowała kreacje lub URL tagu VAST, wstawia makra automatycznie. W przypadku kreacji niestandardowych i szablonów kreacji makra trzeba dodać ręcznie. Jeśli nie masz pewności, gdzie należy umieścić makro, skontaktuj się z dostawcą kreacji.
Podczas trafikowania za pomocą szablonu kreacji docelowy URL pojawia się tylko wtedy, gdy w szablonie jest używane makro kliknięcia. - Zastrzeżone znaki i kodowanie adresów URL (kodowanie procentowe)
Ad Manager zastrzega niektóre małe litery poprzedzone znakiem procenta:%a
%c
%h
%i
%n
%p
%kNie należy używać tych ciągów znaków w kodowaniu adresów URL, ponieważ mogą one zakłócać rozwijanie makr.
- Makra nie są obsługiwane w przypadku automatyzacji bezpośredniej
Poznaj dostępne funkcje dotyczące automatyzacji bezpośredniej.
Przejdź do konkretnego makra na liście
Makra renderujące
Tych makr zazwyczaj używa się do renderowania kreacji, tak aby wyglądały one i działały poprawnie.
Jednostka reklamowa| Makro |
|---|
%%ADUNIT%% |
Makro jednostki reklamowej wstawia ścieżkę tej jednostki z tagu wydawcy Google do kodu kreacji w momencie jej wyświetlenia.
Sposób dodawania makra ADUNIT do kodu kreacji firmy zewnętrznej:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
Makro rozwinie się do pełnej ścieżki jednostki reklamowej zawartej w pierwotnym żądaniu reklamy, uwzględniając kod sieci. Ten przykład pokazuje, jak rozwija się ścieżka jednostki reklamowej przy wyświetlaniu reklamy:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
To makro działa dopiero po zatwierdzeniu proponowanych jednostek reklamowych. Jeśli proponowana jednostka reklamowa jest na 3 poziomie, makro użyte we fragmencie kodu kreacji rozwija się tylko do jednostki reklamowej na 2 poziomie. Po zatwierdzeniu proponowanej jednostki reklamowej makro we fragmencie kodu kreacji rozwija się do jednostki reklamowej na 3 poziomie.
| Makro | Zmiana znaczenia |
|---|---|
%%DEST_URL_ESC%% |
Ze zmianą znaczenia |
%%DEST_URL_ESC_ESC%% |
Z podwójną zmianą znaczenia |
%%DEST_URL_UNESC%% |
Bez zmiany znaczenia |
Makro docelowego adresu URL rozwija się do docelowego adresu URL kreacji, który może być taki sam jak adres docelowy elementu zamówienia lub być efektem zastąpienia ustawionego na potrzeby kreacji w elemencie zamówienia.
Makro docelowego adresu URL przydaje się w kreacjach niestandardowych i szablonach kreacji. Jeśli w kodzie kreacji trzeba umieścić jej docelowy URL, który jest zmienny, bo kreacja lub szablon są używane w różnych elementach zamówienia, to makro jest dobrym rozwiązaniem.
Są 3 makra docelowego adresu URL: ze zmianą znaczenia, z podwójną zmianą znaczenia i bez zmiany znaczenia. Zwykle liczba zmian znaczenia (wskazywana jednym lub dwoma wystąpieniami ciągu ESC bądź jego brakiem) zależy od firmy zewnętrznej, która śledzi kliknięcia. Niektóre firmy zewnętrzne śledzące kliknięcia wymagają zmiany znaczenia znaków w adresie URL, a inne nie. Poziom zmiany znaczenia wymagany przez taką firmę jest często określony ciągiem click= w tagu reklamy firmy zewnętrznej lub kodzie kreacji niestandardowej w usłudze Ad Manager:
-
click=: jedna zmiana znaczenia (%%DEST_URL_ESC%%). -
click0=: bez zmiany znaczenia (%%DEST_URL_UNESC%%). -
click1=: jedna zmiana znaczenia (%%DEST_URL_ESC%%). -
click2=: dwie zmiany znaczenia (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, które działa dokładnie tak samo jak %%DEST_URL_ESC%%. Ze względu na przejrzystość zalecamy stosowanie makra %%DEST_URL_ESC%%, jednak nie musisz poprawiać kodu starszych kreacji ani szablonów.%u lub %%DEST_URL%%, po kliknięciu kreacji otwiera się strona z adresem URL xsd:string. Jego maksymalna długość to 1024 znaki.| Makro |
|---|
%%FILE:file_display_name%% |
Makro serwera plików %%FILE:file_display_name%% rozwija się do pełnego adresu URL zasobu kreacji, który został do niej przesłany. Służy do wywoływania przesłanych zasobów, takich jak obraz, wraz z kodem kreacji niestandardowej.
Aby użyć tego makra, zastąp ciąg file_display_name wyświetlaną nazwą zasobu kreacji, którą widzisz w usłudze Ad Manager podczas przeglądania szczegółów kreacji.
| Makro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Te makra wstawiają wysokość i szerokość kreacji określone w usłudze Ad Manager do niestandardowego kodu kreacji podczas wyświetlania reklamy.
Makra wysokości i szerokości przydają się szczególnie przy tworzeniu szablonu kreacji, którego chcesz używać w kreacjach o różnych rozmiarach. Zamiast na stałe umieszczać rozmiar w kodzie każdej kreacji, możesz je wykorzystać, by dynamicznie wstawiać odpowiednie wartości.
| Makro |
|---|
%%PATTERN:klucz%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Makro dopasowania do wzorca pozwala przekazywać do kreacji co najmniej jedną zmienną niestandardową, np. wartość kierowania. Możesz korzystać z tego makra, by przekazywać pary klucz-wartość, zamieniać cały ciąg znaków kierowania lub rozwijać adres URL strony odsyłającej. To przydatne, gdy chcesz wyświetlać różne kreacje w zależności od dostępnych informacji o użytkowniku (np. jego ustawień treści).
W przypadku makra dopasowania do wzorca obowiązuje ograniczenie do 100 zamienników na kreację.
Zmiana znaczenia makra dopasowania do wzorca
Makro dopasowania do wzorca zwraca wartość w otrzymanej postaci. Jeśli używasz go w jednym z pól adresu URL (takim jak „Adres URL tagu VAST” czy „Link monitorujący firmy zewnętrznej” w kreacji wideo), być może potrzebujesz rozwiniętej wartości ze zmianą znaczenia. Aby to osiągnąć, musisz trzykrotnie zmienić znaczenie wartości w żądaniu.
%%PATTERN:klucz%%
Załóżmy, że w elemencie zamówienia masz 2 kreacje: jedną przeznaczoną dla kobiet, a drugą dla mężczyzn. „Klucz” używany w makrze może zawierać tylko znaki alfanumeryczne i podkreślenia (_).
Proces przebiega tak:
- Przekazujesz wartość niestandardową (w tym przypadku płeć użytkownika) do tagu reklamy na stronie, używając par klucz-wartość:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - W kreacji niestandardowej lub kreacji firmy zewnętrznej dynamicznie przekazujesz wartość niestandardową (płeć użytkownika), korzystając z tego makra:
<tutaj jest skrypt kreacji>...&gender=%%PATTERN:gender%% - Całe makro
%%PATTERN:gender%%zostanie zastąpione ciągiem „male” (mężczyzna). - Ad Manager wywoła i wyświetli użytkownikowi plik kreacji przeznaczonej dla mężczyzn.
%%PATTERN:TARGETINGMAP%%
Za pomocą makra %%PATTERN:TARGETINGMAP%% możesz zamieniać całą mapę kierowania i dynamicznie tworzyć tagi przebiegu zwrotnego.
Sposób dodawania makra TARGETINGMAP do tagu reklamy:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Przykład pełnego ciągu znaków pary klucz-wartość przy wyświetlaniu reklamy:
.updateTargetingFromMap({"klucz1":["wartosc1"], "klucz2": ["wartosc2","wartosc3"]}).display();
Możesz użyć tego makra do skonfigurowania tagu przebiegu zwrotnego między 2 sieciami w usłudze Ad Manager – „Network A” (Sieć A) i „Network B” (Sieć B).
Przykładowa kreacja zarezerwowana w Sieci A w usłudze Ad Manager:
<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>
Jeśli Sieć B w usłudze Ad Manager nie ma żadnej sprzedanej kampanii do zrealizowania, może przekazać wyświetlenie z powrotem do Sieci A za pomocą kreacji przebiegu zwrotnego, na przykład takiej:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // aby uniknąć zapętleń
.display();
</script>Makra TARGETINGMAP możesz również używać w tagu przebiegu zwrotnego, który jest wysyłany w żądaniu do serwera reklamowego firmy zewnętrznej, co pozwala mieć wiele wartości w kreacji dynamicznej.
Przykładowa kreacja zarezerwowana w usłudze Ad Manager:
<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>
Kreacja przy wyświetlaniu przez Ad Managera rozwija się do postaci:
<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>
Firma zewnętrzna ma teraz dostęp do dynamicznie generowanych parametrów „dfpAdUnit” i „targeting”, dzięki czemu może utworzyć taki przebieg zwrotny:
<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") // aby uniknąć zapętleń (zob. https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Aby to zrobić, firma zewnętrzna może otrzymać kod szablonu, który przypomina ten:
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%%
Możesz też użyć zarezerwowanego klucza url, aby zastosować rozwinięcie do adresu URL strony odsyłającej.
Pamiętaj, że url to zarezerwowany klucz – wszystkie pary klucz-wartość w tagach Campaign Managera 360, które jako nazwę klucza mają url, zostaną zastąpione adresem URL strony odsyłającej.
| Makro |
|---|
%%TAG_PARAM%% |
Makro parametru tagu jest używane w połączeniu z innymi parametrami tagu reklamy, a konkretnie:
Tam, gdzie jest obsługiwane, rozwija się do wartości parametru.
Na przykład makro %%TAG_PARAM:correlator%% (obsługiwane) rozwija się do wartości korelatora z tagu reklamy, ale makro %%TAG_PARAM:ppid%% (nieobsługiwane) nie rozwija się do żadnej wartości.
| Makro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Makro okna docelowego w nowym oknie wskazuje, czy ustawienie okna docelowego określone na potrzeby jednostki reklamowej, w której wyświetla się kreacja, to „_blank” (nowe okno) czy inne.
-
Jeśli okno docelowe to
_blank, makro rozwija się do wartości1. -
Jeśli okno docelowe jest inne lub nie zostało określone, makro rozwija się do wartości
0.
Makra %%TARGET_WINDOW%% należy używać, jeśli chcesz wstawić wartość ustawienia rzeczywistego okna docelowego.
| Makro |
|---|
%%TARGET_WINDOW%% |
Makro okna docelowego rozwija się do ustawienia okna docelowego określonego na potrzeby jednostki reklamowej, w której wyświetla się kreacja. Możesz używać go w kodzie kreacji, by wskazać, że kliknięcie kreacji ma powodować przekierowanie użytkownika do nowego okna lub wczytanie strony docelowej w bieżącym oknie – w zależności od ustawień witryny, w której użytkownicy zobaczą daną reklamę.
Na przykład okno docelowe jednostki reklamowej na AdManager_News.com to _top, a na AdManager_Fashion.com – _new. Jeśli w kodzie kreacji umieścisz makro %%TARGET_WINDOW%%, u użytkowników AdManager_News.com rozwinie się ono do ciągu _top, a u użytkowników AdManager_Fashion.com – do ciągu _new.
Oto przykładowy kod:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="moja reklamamad"></a>
Przy użyciu makra %%TARGET_IN_NEW_WINDOW%% możesz określić, czy ustawienie okna docelowego ma wartość „_blank” czy inną.
| Makro |
|---|
%%TFCD%% |
Tag zawartości skierowanej do dzieci (TFCD) pozwala poinformować inne firmy, że dane żądanie reklamy pochodzi ze strony z zawartością skierowaną do dzieci. Ułatwia to zachowanie zgodności z ustawą o ochronie prywatności dzieci w internecie (Children’s Online Privacy Protection Act, COPPA).
Makro możesz umieścić w przekierowaniach i żądaniach kreacji innych firm w formacie coppa=%%TFCD%% lub podobnym. Możesz też użyć go w kodzie JavaScript, by ustawić żądania tagu przebiegu zwrotnego GPT i traktować zawartość jako skierowaną do dzieci. Na podstawie informacji o charakterze strony, witryny lub aplikacji mobilnej, która wysłała żądanie do Ad Managera, makro rozwija się do wartości 1 w przypadku zawartości skierowanej do dzieci i do wartości 0 w przypadku innych treści.
Jeśli korzystasz z usług reklamowych Google i chcesz, by witryna lub aplikacja była traktowana jako skierowana do dzieci, przeczytaj artykuł Tagowanie witryny lub aplikacji pod kątem traktowania jako skierowanej do dzieci.
| Makro |
|---|
[%URI_ENCODE:variable%] |
Makro kodowania identyfikatora URI prawidłowo tłumaczy spacje i inne znaki specjalne w wartościach zmiennych szablonu kreacji do użycia w identyfikatorach URI, znanych też jako adresy URL.
Przykład
Załóżmy, że szablon kreacji zawiera zmienną listy o nazwie „Color” z 2 wartościami: „dark blue” i „light green”. Domyślnie Ad Manager dodaje fragment [%Color%] do kodu szablonu kreacji:
<a href="https://paint.com/wall.html?color=[%Color%]">Farba</a>
Podczas tworzenia kreacji Ad Manager zastępuje [%Color%] ciągiem tekstowym literału wybranego elementu listy. W tym przykładzie ciąg literału zawiera znaki spacji, co spowoduje rozdzielenie adresu URL, bo znaki spacji muszą zostać zakodowane. Aby rozwiązać ten problem, użyj makra [%URI_ENCODE:Color%].
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Farba</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
To makro jest szczególnie przydatne, gdy używasz zmiennej szablonu kreacji do określenia docelowego adresu URL lub przekierowania. Bez odpowiedniego kodowania pełny adres URL w kreacji mógłby nie zadziałać.
Przykład
Załóżmy, że szablon kreacji ma zmienną „URL” o nazwie „LandingPage”. Domyślnie Ad Manager dodaje fragment [%LandingPage%] do kodu szablonu kreacji:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Kliknij tutaj</a>
Jeśli URL [%LandingPage%] zawiera parametry zapytania, na przykład ?page=home&sport=baseball, adres URL ulega zniekształceniu i przekierowanie nie działa poprawnie. W tym przykładzie ciąg po ampersandzie (&) zostanie przypisany do pełnego adresu URL zamiast do adresu przekierowania. Aby uniknąć tego problemu, użyj makra [%URI_ENCODE:LandingPage%].
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Kliknij tutaj</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Makra śledzące
Tych makr najczęściej używa się do śledzenia i raportowania.
Cachebuster (losowa liczba)| Makro |
|---|
%%CACHEBUSTER%% |
Makro cachebuster gwarantuje, że każde wykonanie kodu powoduje wysłanie nowego wywołania do serwera reklam, co pozwala dokładnie zliczać wyświetlenia. Jeśli do kodu kreacji nie dodasz makra do pomijania pamięci podręcznej, istnieje większe prawdopodobieństwo, że wystąpią rozbieżności w liczbie wyświetleń między usługą Google Ad Manager a serwerem reklamowym firmy zewnętrznej. Nie wszystkie firmy zewnętrzne wymagają jego stosowania.
Większość dostawców kreacji umieszcza w tagu element zastępczy, zamiast którego można wstawić takie makro. Jeśli kod kreacji firmy zewnętrznej zawiera na przykład:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Możesz wybrać [RANDOM NUMBER] i kliknąć Wstaw makro cachebuster, by zastąpić nim element zastępczy:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER, aby zmniejszyć rozbieżności w przypadku korzystania z modułu Campaign Managera 360 do śledzenia wyświetleń na potrzeby Ad Managera.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Makra cachebuster w odpowiedziach VAST
Makro %%CACHEBUSTER%% rozwija się do tej samej losowej liczby przy wszystkich zdarzeniach w danej kreacji. Jest to szczególnie przydatne w reklamach wideo, ponieważ makro rozwija się do tej samej losowej liczby przy każdym zdarzeniu śledzenia wideo w odpowiedzi VAST.
| Makro | Zmiana znaczenia |
|---|---|
%%CLICK_URL_UNESC%% |
Bez zmiany znaczenia |
%%CLICK_URL_ESC%% |
Ze zmianą znaczenia |
%%CLICK_URL_ESC_ESC%% |
Z podwójną zmianą znaczenia |
Makro kliknięcia rozwija się do specjalnego adresu URL, dzięki czemu możesz śledzić kliknięcia kreacji firm zewnętrznych w usłudze Ad Manager. To makro jest zazwyczaj sparowane z docelowym adresem URL kreacji za pomocą tagu kotwicy (<a>). Nie wpisuj makra kliknięcia jako źródła obrazu ani elementu iframe. Jeśli to zrobisz, kliknięcie będzie rejestrowane przy każdym renderowaniu obrazu lub elementu iframe. To niewłaściwa metoda – kliknięcia będą odfiltrowywane jako nieprawidłowe.
Użyj wersji %%CLICK_URL_UNESC%% na początku linku. Użyj wersji %%CLICK_URL_ESC%%, gdy moduł do śledzenia kliknięć to parametr innego adresu URL.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
Dowiedz się więcej o makrach ze zmianą znaczenia i bez niej.
Weryfikowanie implementacji makra kliknięcia
Nieprawidłowo umieszczone makro kliknięcia nie będzie śledziło kliknięć. Wykonaj te czynności, by upewnić się, że Ad Manager będzie rejestrować kliknięcia zgodnie z założeniami.
- Wyświetl podgląd kreacji.
- Kliknij podgląd.
Ad Manager wyświetli potwierdzenie rejestrowania kliknięć. Jeśli go nie zobaczysz, oznacza to, że makro kliknięcia nie zostało zaimplementowane prawidłowo.
| Makro | Do czego się rozwija |
|---|---|
%eaid! |
Identyfikator elementu zamówienia |
%eadv! |
Identyfikator reklamodawcy powiązany z elementem zamówienia realizującym wyświetlenia |
%ebuy! |
Identyfikator zamówienia powiązany z elementem zamówienia realizującym wyświetlenia |
%ecid! |
Identyfikator kreacji |
%eenv! |
Wskaźnik środowiska (typu tagu): i oznacza element iframe, j – skrypt JavaScript |
%epid! |
Identyfikator jednostki reklamowej, w której jest wyświetlany element zamówienia |
%esid! |
Identyfikator jednostki reklamowej najwyższego poziomu nad jednostką, w której jest wyświetlany element zamówienia
To jest starsze makro, które może nie działać zgodnie z oczekiwaniami w Twojej sieci.
|
Makra rozwijane możesz stosować w kodzie kreacji niestandardowej lub w docelowym adresie URL do wyświetlania wartości identyfikatorów z usługi Ad Manager podczas wyświetlania kreacji na stronie. Są one często stosowane do dopasowywania identyfikatorów z Ad Managera do identyfikatorów z bazy danych wydawcy na potrzeby rozwiązywania problemów lub innych raportów.
Poszczególne takie makra w docelowym adresie URL możesz rozdzielić dowolnym znakiem, którego można bezpiecznie używać w docelowych adresach URL w usłudze Ad Manager. Na przykład makro http://www.site.com/?%eaid!;%ecid! może rozwinąć się do ciągu http://www.site.com/?1234567;4265598.
| Makro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (identyfikator urządzenia) |
%%ADVERTISING_IDENTIFIER_TYPE%% (typ urządzenia) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (ustawienie ograniczenia śledzenia reklam) |
Makro %%ADVERTISING_IDENTIFIER_PLAIN%% umożliwia wydawcom udostępniającym zasoby reklamowe w aplikacji wysyłanie do partnerów reklamowych możliwego do zresetowania identyfikatora urządzenia służącego do wyświetlania reklam opartych na zainteresowaniach. Ułatwia to przyznawanie reklamodawcom i agencjom dostępu do możliwego do zresetowania identyfikatora urządzenia.
Wydawcy udostępniający zasoby reklamowe w aplikacji mogą też używać makra %%ADVERTISING_IDENTIFIER_TYPE%% do wysyłania typu urządzenia oraz %%ADVERTISING_IDENTIFIER_IS_LAT%% do wysyłania ustawienia ograniczenia śledzenia reklam (LAT), które wskazuje sygnał LAT z urządzenia.
Dowiedz się więcej o możliwych do zresetowania identyfikatorach urządzeń na potrzeby kierowania na użytkowników, które obejmują obsługiwane typy urządzeń.
Wymagania wstępne
Musisz skonfigurować szyfrowanie HTTPS kreacji. Jest to wymagane zarówno w przypadku kreacji, jak i dostarczanych przez firmy zewnętrzne pikseli, których używasz do śledzenia konwersji. Jeśli kreacje nie są szyfrowane na potrzeby HTTPS lub jeśli zastąpisz automatyczną zgodność z protokołem SSL, makro nie rozwinie się do wartości, ale kreacje nadal będą wyświetlane.
Jak to działa
- W usłudze Ad Manager wydawca umieszcza makra w adresach URL kreacji lub w linkach monitorujących.
-
Makra rozwijają się w taki sposób, że zawierają identyfikator urządzenia użytkownika, typ urządzenia lub ustawienie LAT. Wszystkie te elementy są umieszczane w kreacji przy wykonywaniu wywołań do innej firmy.
Makro identyfikatora nie rozwinie się, jeśli żądanie reklamy pochodzi z aplikacji skierowanej do dzieci (TFCD) lub jeśli jest włączone ograniczenie śledzenia reklam (LAT). W tych przypadkach makro zwraca pusty ciąg ("").
Format
To makro wysyła 32 szesnastkowe cyfry i wielkie litery w pięciu grupach oddzielonych myślnikami w postaci 8-4-4-4-12 – łącznie 36 znaków (32 znaki alfanumeryczne i cztery myślniki).
Przykład: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Zobacz możliwe wartości obsługiwanych typów urządzeń i ustawień ograniczenia śledzenia reklam (LAT).
| Makro |
|---|
%%PREVIEW_MODE%% |
Makra trybu podglądu możesz używać w kodzie kreacji niestandardowej, by uniemożliwić systemom własnym i firm zewnętrznych liczenie wyświetleń podglądu. Makro rozwija się do wartości true, gdy kreacja pojawia się w podglądzie Ad Managera, oraz do wartości false w przypadku zwykłego wyświetlenia.
| Makro |
|---|
%%SCHEME%% |
Makro schematu rozwija się do ciągu http: lub https: w zależności od schematu zabezpieczeń strony internetowej, na której wyświetla się kreacja. Możesz umieścić je na początku adresu URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Makro |
|---|
%%SITE%% |
Rozwija się do domeny z parametru adresu URL w tagu reklamy (np. google.pl). Pozwala zmieniać kreację w zależności od tego, skąd pochodzi żądanie. Nie działa w reklamach Ad Exchange oznaczonych jako anonimowe.
| Makro | Zmiana znaczenia |
|---|---|
%%VIEW_URL_ESC%% |
Ze zmianą znaczenia |
%%VIEW_URL_UNESC%% |
Bez zmiany znaczenia |
Makro widocznego wyświetlenia pozwala Ad Managerowi zliczać wyświetlenia za każdym razem, gdy kreacja jest pobierana na urządzenie użytkownika i rozpoczęło się jej wczytywanie. Należy go używać tylko w przypadku kreacji poza stroną.
Pingi wyświetlenia można wysyłać na różne sposoby. My zalecamy skorzystanie z tagu <img>:
<!-- Ten tag img jest niewidoczny. Sprawia, że przeglądarka wysyła żądanie do adresu VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Ten tag img pokazuje rzeczywistą reklamę.-->
<img src="[%Imagefile%]" border="0">
Pierwszy tag <img> pobiera obraz o wymiarach 1 × 1 z VIEW_URL. Ustaw jego styl na "display:none", aby nie był widoczny i nie zakłócał układu strony.
Makra żądania reklamy na potrzeby RODO
Tych makr najczęściej używa się w przypadku żądań reklam objętych RODO.
RODO| Makro |
|---|
${GDPR} |
Rozwija się do wartości gdpr= powiązanej z określonym żądaniem.
| Makro |
|---|
${GDPR_CONSENT_XXXX} |
Rozwija się do ciągu tekstowego dotyczącego przejrzystości i zgody powiązanego z określonym żądaniem. Jeśli ciąg tekstowy dotyczący przejrzystości i zgody jest pusty lub nieprawidłowy, to makro się nie rozwinie. Za pomocą tego makra możesz przekazywać ciąg tekstowy dotyczący przejrzystości i zgody zewnętrznemu dostawcy kreacji w adresie URL w kreacjach niezautomatyzowanych.
Zastąp ciąg „XXXX” identyfikatorem danego dostawcy zewnętrznego z globalnej listy dostawców IAB. Jeśli tekst dotyczący przejrzystości i zgody na przetwarzanie danych jest pusty lub nieprawidłowy, to makro się nie rozwinie.
Kreacje z makrem ${GDPR_CONSENT_XXXX} mogą zostać zablokowane, jeśli dostawca zewnętrzny powiązany z wstawionym przez Ciebie identyfikatorem z globalnej listy dostawców firmy IAB nie ma zgody użytkownika.
Jeśli makro to jest użyte w tagu VAST, a dostawca zewnętrzny nie uzyskał zgody użytkownika, makro się nie rozwinie.
Makro ${GDPR_CONSENT_XXXX} powinno występować w adresie URL tylko raz. Skontaktuj się z zewnętrznym dostawcą kreacji, aby poznać jego wymagania związane z przekazywaniem ciągu tekstowego dotyczącego przejrzystości i zgody, a także ograniczenia dotyczące długości adresu URL. W odpowiednich żądaniach w ramach Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 makro to zostanie zastąpione pełnym, niezmodyfikowanym ciągiem tekstowym dotyczącym przejrzystości i zgody.
Makra Zasad dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych nie są rozwijane, gdy są zaimplementowane w kreacji HTML lub HTML5. Tylko przekierowujące i niestandardowe kreacje displayowe obsługują te rozwijane makra – odpowiednio za pomocą pól „URL firmy zewnętrznej” i „Kod HTML”.
| Makro |
|---|
${ADDTL_CONSENT} |
Rozwija się do tekstu dotyczącego udzielenia dodatkowej zgody powiązanego z określonym żądaniem.
| Makro |
|---|
%%TFUA%% |
Rozwija się do wartości 1, żeby oznaczyć żądanie jako dotyczące użytkowników z EOG i Wielkiej Brytanii, którzy nie osiągnęli wieku świadomego wyrażenia zgody.
Makra wideo
Te makra najczęściej są stosowane w kreacjach wideo do uwzględniania informacji o kontekście lub treści.
Czas trwania reklamy wideo (w milisekundach)| Makro |
|---|
%%VIDEO_AD_DURATION%% |
Rozwija się do czasu trwania reklamy wideo w milisekundach. W przypadku kodów VAST/przekierowań makro rozwija się do zadeklarowanego czasu trwania reklamy w usłudze Ad Manager.
| Makro | Zmiana znaczenia |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Bez zmiany znaczenia |
%%DESCRIPTION_URL_ESC%% |
Ze zmianą znaczenia |
%%DESCRIPTION_URL_ESC_ESC%% |
Z podwójną zmianą znaczenia |
Wersji %%DESCRIPTION_URL_ESC%% (z pojedynczą zmianą znaczenia) używa się, gdy makro jest wewnątrz adresu URL, a wersji %%DESCRIPTION_URL_UNESC%% (bez zmiany znaczenia) – w pozostałych kontekstach. Więcej informacji o makrach ze zmianą znaczenia i bez niej
W tagach reklam przekierowujących te makra rozwijają się do parametru adresu URL opisu z parametru zapytania description_url zawartego w pierwotnym tagu wydawcy Google. Adres URL opisu zazwyczaj powinien być taki sam jak URL strony odsyłającej. Parametr description_url należy podać w tagu wydawcy Google, jeśli IMA SDK może nie być w stanie dokładnie określić adresu URL strony w umieszczonym obiekcie albo używasz filmów w Ad Exchange lub AdSense dla wideo.
%%DESCRIPTION_URL%%, które działa tak samo jak %%DESCRIPTION_URL_UNESC%%, więc nie musisz poprawiać kodu starszych kreacji ani szablonów.| Makro | Zmiana znaczenia |
|---|---|
%%REFERRER_URL_UNESC%% |
Bez zmiany znaczenia |
%%REFERRER_URL_ESC%% |
Z pojedynczą zmianą znaczenia |
%%REFERRER_URL_ESC_ESC%% |
Z podwójną zmianą znaczenia |
Wersji %%REFERRER_URL_ESC%% (z pojedynczą zmianą znaczenia) używa się, gdy makro jest wewnątrz adresu URL, a wersji %%REFERRER_URL_UNESC%% (bez zmiany znaczenia) – w pozostałych kontekstach. Więcej informacji o makrach ze zmianą znaczenia i bez niej
To makro rozwija się do adresu URL strony odsyłającej (adresu strony, na której znajduje się odtwarzacz wideo) w tagach reklam przekierowujących. Odbywa się to w taki sposób: Ad Manager analizuje parametr zapytania adresu URL tagu reklamy, wydziela URL strony odsyłającej i zastępuje tekst makra tym URL-em. Działa tylko z pakietem Google IMA SDK, pod tymi warunkami:
- Skrypty na stronie muszą być dostępne.
- Makro nie może być w elemencie iframe.
%%REFERRER_URL%%, które działa tak samo jak %%REFERRER_URL_UNESC%%, więc nie musisz poprawiać kodu starszych kreacji ani szablonów.Makra treści wideo
Te makra są używane w reklamach kierowanych na źródła treści wideo.
| Makro |
|---|
%%VIDEO_DURATION%% |
Rozwija się do czasu trwania filmu w milisekundach.
| Makro |
|---|
%%VIDEO_ID%% |
Rozwija się do identyfikatora odtwarzanych w danej chwili treści wideo, który jest unikalnym identyfikatorem z systemu CMS lub wartością dfpvideo:ContentID z MRSS.
| Makro |
|---|
%%VIDEO_METADATA:klucz%% |
Rozwija się do metadanych filmu, w którym wyświetla się kreacja, według par klucz-wartość powiązanych z treściami wideo. Pary klucz-wartość można zdefiniować na karcie „Wideo” w usłudze Ad Manager.
Klucz metadanych filmu ustawiony jako docelowy można rozwinąć za pomocą makra metadanych treści wideo. „Klucz” używany w makrze może zawierać tylko znaki alfanumeryczne i podkreślenia (_).
| Makro | Zmiana znaczenia |
|---|---|
%%VIDEO_TITLE%% |
Z pojedynczą zmianą znaczenia |
Po rozwinięciu makro tytułu reklamy wideo wyświetla tytuł reklamy wideo określony w usłudze Ad Manager.
Do działania wymaga przetworzenia treści.
| Makro |
|---|
%%FW_CAID%% |
Rozwija się do identyfikatora reklamy niestandardowej FreeWheel.
To makro jest przeznaczone tylko dla wydawców, którzy do wyświetlania reklam wideo używają FreeWheel.
| Makro |
|---|
%%IAB_CATEGORIES%% |
Służy do przekazywania kategorii reklam w przypadku kreacji ręcznie sklasyfikowanych za pomocą etykiet. To makro zwraca oddzieloną przecinkami listę odpowiednich standardowych kategorii IAB (przekonwertowanych ze sklasyfikowanych kategorii Google).
Tego makra mogą używać wydawcy, którzy udostępniają zasoby reklamowe wideo usłudze FreeWheel i chcą przekazywać kategorie reklam jako parametry niestandardowe. Możesz na przykład dodać do tagu przekierowania VAST makro &iab_categories=%%IAB_CATEGORIES%%
