Načtení kódu kreativy pomocí požadavku bez kódu

K odeslání žádosti o nezpracovaný kód kreativy nakonfigurovaný ve službě Ad Manager lze namísto značky reklamy použít požadavek bez kódu. Požadavky bez kódu 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 požadavek bez kódu služba Ad Manager odešle jen nezpracovaný kód kreativy přesně tak, jak je nakonfigurován, aniž by jej 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.

Požadavky bez kódu by se neměly používat k zobrazování reklam v e‑mailech. Podívejte se na všechny nepodporované funkce.

Ruční vytvoření požadavku bez kódu

Pokud chcete vytvořit požadavek bez kódu, vyjděte ze základní adresy 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.

Požadavky bez kódu je potřeba odesílat zabezpečeně pomocí protokolu SSL (https://)

Vyjděte ze základní adresy URL

Použijte tuto základní adresu 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í požadavků bez kódu 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 požadavcích bez kódu 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 pouze 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

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 požadavcích bez kódu 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 požadavky bez kódu

Aktivace měření zobrazení

U požadavků bez kódu 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 požadavku bez kódu 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 jej ručně spustíte odesláním pingu zobrazení na adresu URL uvedenou v záhlaví Google-Delayed-Impression protokolu HTTP. 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 požadavků 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 pomocí požadavku bez kódu makro zhlédnutého zobrazení. Toto makro se nahradí adresou URL, na kterou má kreativa při vykreslování odeslat požadavek.

Odeslání požadavku bez kódu za účelem načtení kódu kreativy

Webový obsah

Požadavky bez kódu se obecně používají v prostředích bez podpory značek či sad SDK Google. Pokud požadavek bez kódu načítáte na webu, je ho 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 požadavků bez kódu 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

Požadavky bez kódu, 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í.

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