Načtení kódu kreativy pomocí žádosti bez značky

K odeslání žádosti o nezpracovaný kód kreativy nakonfigurovaný ve službě Ad Manager lze namísto značky reklamy použít žádost bez značky. Žádosti bez značek se obvykle používají, když je potřeba vlastní analýza a zobrazení, jako například v set-top boxech nebo jiných prostředích bez podpory značek či sad SDK Google.

V odpovědi na žádost bez značky služba Ad Manager odešle jen nezpracovaný kód kreativy přesně tak, jak je nakonfigurován, aniž by ho spustila a zobrazila reklamu. Pokud není nalezena žádná reklama, odešle se prázdná odpověď se stavovým kódem 200/OK.

K zobrazení reklamy a aktivaci měření zobrazení musí vaše aplikace, přehrávač nebo web kód spustit.

Ruční vytvoření žádosti bez značky

Pokud chcete vytvořit žádost bez značky, vyjděte ze základní URL a zahrňte všechny povinné parametry a případné další volitelné parametry. Tyto parametry určují věci, jako je reklamní jednotka, velikost kreativy, páry klíč–hodnota a další informace o žádosti.

Žádosti bez značek je potřeba odesílat zabezpečeně pomocí protokolu SSL (https://)

Vyjděte ze základní URL

Použijte tuto základní URL:  https://securepubads.g.doubleclick.net/gampad/adx?

Zadání parametrů žádosti o reklamu

Povinné parametry

Parametr	Popis
iu	Kód reklamní jednotky Google Ad Manager včetně kódu sítě Google Ad Manager. Chcete-li zahrnout několik úrovní, je třeba je oddělit lomítkem(/). Příklad iu=/123/homepage iu=/456/sports/baseball V případě použití žádostí bez značek v rámci Správy více zákazníků (MCM) uveďte kód sítě ve tvaru parent,child. Příklad (MCM) iu=/123,456/homepage
sz	Velikost kreativy. Chcete-li zahrnout několik velikostí, je třeba je oddělit svislou čarou (|). Příklad sz=320x50 pro jednu velikost sz=320x50|300x50 pro více velikostí Svislé čáry (|) v žádostech bez značek doporučujeme zakódovat jako %7c. Příklad Parametr &sz=216x36|300x50|320x50 zakódujte jako &sz=216x36%7c300x50%7c320x50.
url	Adresa URL domény, na které je hostována původní žádost o reklamu. Vyžadováno jen u žádostí v rámci MCM. Příklad url=www.example.com
c	Hodnota korelátoru (nebo parametru pro vynechání mezipaměti). Musí se jednat o náhodné číslo (písmena jsou zakázána) vygenerované majitelem stránek, které zajistí, aby při každém načtení stránky došlo k novému volání reklamního serveru a předešlo se tak nesrovnalostem při počítání zobrazení. Příklad c=8362527364
tile	Pozice značky na webové stránce. Hodnota musí být jedinečné celé číslo. Pro snazší implementaci doporučujeme použít postupně se zvyšující hodnotu. Tento parametr je potřeba pouze v případě, že několik značek reklam na jedné stránce používá stejný kód reklamní jednotky (iu=) a korelátor (c=). Příklad 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 Aby se předešlo opětovnému výběru stejné kreativy pro stejný korelátor (c=), je všechny žádosti s inkrementálními hodnotami parametru tile (tile=) nutné odeslat do 30 sekund.

Nepovinné parametry

Parametr	Popis
d_imp	Přepínač zpožděného zobrazení. Pokud je zahrnut, deaktivuje se počítání zobrazení při přijetí žádosti a k zaznamenání zobrazení se použije buď makro zhlédnutého zobrazení ve zpět zaslané kreativě, nebo informace z parametru d_imp_hdr. Příklad d_imp=1 d_imp=0 (Toto je výchozí hodnota pro počítání zobrazení službou Google Ad Manager.)
d_imp_hdr	Přepínač informací o zpožděném zobrazení v záhlaví. Pokud je zahrnut, je v záhlaví protokolu HTTP uvedena adresa URL k nahlášení zobrazení. Ve výchozím nastavení tyto informace v záhlaví nejsou definovány. Za účelem započítání zobrazení musí majitel stránek na tuto adresu URL ručně pingnout. Další informace o počítání zobrazení a žádostech bez značek Záhlaví Google-Delayed-Impression obsahuje adresu URL s informacemi o zobrazení pro službu Google Ad Manager. Záhlaví Google-3rdParty-Delayed-Impression obsahuje adresu URL pro počítání zobrazení pomocí třetí strany (pokud je v kreativě přítomna). Příklad d_imp_hdr=1 d_imp_hdr=0 (Explicitně zakáže informace o zpožděném zobrazení v záhlaví.)
t	Páry klíč–hodnota na úrovni bloku. Každý klíč je od hodnoty oddělen znakem rovná se (=) a jednotlivé páry klíč–hodnota jsou odděleny znakem ampersand (&). Každý klíč a hodnotu je potřeba samostatně zakódovat pro adresu URL a poté je třeba stejným způsobem zakódovat celý řetězec. Každý klíč v sadě párů klíč–hodnota musí být jedinečný. Pokud stejný klíč zadáte několikrát, bude uvažována pouze jedna z přidružených hodnot. Příklad Parametr t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith přiřazuje klíči „genre“ hodnotu „action“ a klíči „movie“ hodnotu „Mr & Mrs Smith“. Všimněte si, že znak & je mezi páry klíč–hodnota zakódován jednou %26 a uvnitř hodnoty je zakódován dvakrát na %2526. Klíč excl_cat lze použít jako speciální klíč pro vyloučení konkurenčních reklam. Příklad t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines V klíčích ani hodnotách nejsou povoleny tyto znaky: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Mezery jsou v hodnotách povoleny (je třeba je zakódovat jako %20 nebo +), ale v klíčích nikoliv. Příklad Nastavení klíče „a“ na hodnotu „b+c“ pomocí řetězce t=a%3Db%252Bc nefunguje.
m	Hodnota typu MIME v záhlaví protokolu HTTP. Příklad m=text/wml
mob	Indikátor žádosti o reklamu pro mobily. Příklad mob=js (Toto je jediná přípustná hodnota.)
ppid	Pomocí identifikátoru poskytnutého majitelem stránek (PPID) můžete do služby Google Ad Manager odeslat identifikátor, který se bude používat k omezení frekvence, segmentaci publika, cílení na publikum, sekvenčnímu střídání reklam a dalšímu řízení zobrazování reklam napříč zařízeními. Příklad ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Údaj o šířce obrazovky mobilního zařízení, kterým se přepíše údaj automaticky zjištěný reklamním serverem. Příklad u_w=1024
u_h	Údaj o výšce obrazovky mobilního zařízení, kterým se přepíše údaj automaticky zjištěný reklamním serverem. Příklad u_h=768
submodel	Údaj o hardwaru mobilního zařízení, který přepíše údaj automaticky zjištěný reklamním serverem. Příklad submodel=iPhone4%2C1 (Čárka, která odděluje hodnotu podmodelu, je zakódována.) Hodnoty podmodelů: iPhone (první generace): 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 a LTE): iPhone5,1 iPhone 5 (CDMA a LTE): iPhone5,2 iPhone 5c (GSM a CDMA): iPhone5,3 iPhone 5c (GSM a CDMA): iPhone5,4 iPhone 5s (GSM a CDMA): iPhone6,1 iPhone 5s (GSM a 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  iPod první generace: iPod1,1 iPod druhé generace: iPod2,1 iPod třetí generace: iPod3,1 iPod čtvrté generace: iPod4,1 iPod páté generace: iPod5,1 iPad první generace (Wi-Fi): iPad1,1 iPad první generace (AT&T): iPad1,2 iPad druhé generace (Wi-Fi): iPad2,1 iPad druhé generace (AT&T): iPad2,2 iPad druhé generace (Verizon): iPad2,3 iPad druhé generace (Wi-Fi): iPad2,4 iPad třetí generace (Wi-Fi): iPad3,1 iPad třetí generace (Verizon): iPad3,2 iPad třetí generace (AT&T): iPad3,3 iPad čtvrté generace (Wi-Fi): iPad3,4 iPad čtvrté generace (AT&T): iPad3,5 iPad čtvrté generace (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM a LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA a 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

 

K omezení frekvence a cílení na publikum můžete používat resetovatelné identifikátory zařízení (RDID). Další informace o konfiguraci RDID pro žádosti bez kódu

Aktivace měření zobrazení

U žádostí bez značek může Ad Manager měřit stažená zobrazení (nazývají se také „zpožděná“). Použijte některou z níže uvedených možností, ale ne všechny najednou. Použití všech možností společně by mohlo vést k tomu, že by se zobrazení započítávala dvakrát nebo třikrát.

Doporučujeme možnost 1. Abyste ji však mohli použít, musíte mít přístup k záhlavím odpovědí HTTP a musíte být schopni implementovat protokol založený na záhlavích.

Možnost 1: Čtení záhlaví HTTP odpovědí kvůli počítání zobrazení

Přidejte k žádosti bez značky parametry d_imp=1 a d_imp_hdr=1, aby služba Google Ad Manager zobrazení nebo stažené zobrazení zaznamenala až ve chvíli, kdy ho ručně spustíte odesláním pingu zobrazení na adresu URL uvedenou v záhlaví protokolu HTTP Google-Delayed-Impression. Při aktivaci pingu zobrazení zaznamená služba Google Ad Manager zobrazení reklamního serveru a stažené zobrazení reklamního serveru.

Aby se zobrazení nezapočítalo dvakrát, do kreativ poskytovaných prostřednictvím žádostí bez značek nezahrnujte makro zhlédnutého zobrazení.

Možnost 2: Použití makra zhlédnutého zobrazení

Pokud k záhlavím odpovědí HTTP nemáte přístup, přidejte do fragmentu kódu jednotlivých kreativ vracených na žádost bez značky makro zhlédnutého zobrazení. Toto makro se nahradí adresou URL, na kterou má kreativa při vykreslování odeslat požadavek.

Odeslání žádosti bez značky za účelem načtení kódu kreativy

Webový obsah

Žádosti bez značek se obecně používají v prostředích bez podpory značek či sad SDK Google. Pokud žádost bez značky načítáte na webu, je ji potřeba načíst v prvku <iframe>, aby se poskytnutý nezpracovaný kód mohl spustit.

Vlastní prostředí bez sady SDK Google

Při načítání nezpracovaného kódu kreativ v prostředích bez podpory značek Google či sad SDK (jako jsou například set-top-boxy jiných výrobců než Google) postupujte podle následujících pokynů:

• Abyste zajistili správné fungování cílení, nastavte platné záhlaví požadavku User-Agent.
• Zajistěte, aby vaše prostředí dokázalo zpracovat chování reklam rich media, včetně JavaScriptu a rozbalení kreativ.
• Odešlete do služby Google Ad Manager požadavek HTTPS.
• Zkontrolujte, zda je stav odpovědi HTTP 200/OK (což znamená, že byl požadavek platný).

Funkce, které u žádostí bez značek nejsou podporovány

• Active View
• Ad Exchange
• Soubory cookie a identifikátory mobilních aplikací používané k měření
• obálky kreativ,
• Dynamická alokace pomocí služeb AdSense, Ad Exchange nebo AdMob
• Nativní inventář
• Preferované dohody
• Náhledy kreativ
• AdChoices

Žádosti bez značek, které používají adresy gampad/ad ve značkách HTML pro obrázky (<img>), nepodporují měřicí kód JavaScript a měření stažených zobrazení.

U kreativ zobrazených na žádosti bez značek není podporováno označování reklam odznakem reklamy. Reklama musí splňovat příslušné regulační požadavky na reklamy zobrazované v Evropském hospodářském prostoru (EHP). To zahrnuje mechanismus, pomocí něhož mohou uživatelé nahlásit nezákonný obsah. O případných nahlášeních nezákonného obsahu musí majitelé obsahu společnost Google informovat pomocí příslušného formuláře.

Při vytváření přehledů pro tyto reklamy ve službě Ad Manager vyberte metriku Celkový počet zobrazení kódu.