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.
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é parametryParametr | 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
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 Příklad (MCM)
|
sz |
Velikost kreativy. Chcete-li zahrnout několik velikostí, je třeba je oddělit svislou čarou ( Příklad
Svislé čáry ( PříkladParametr |
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
|
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
|
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 ( Příklad
|
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 Příklad
|
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
Příklad
|
t |
Páry klíč–hodnota na úrovni bloku. Každý klíč je od hodnoty oddělen znakem rovná se ( PříkladParametr Klíč Příklad
V klíčích ani hodnotách nejsou povoleny tyto znaky: PříkladNastavení klíče „a“ na hodnotu „b+c“ pomocí řetězce |
m |
Hodnota typu MIME v záhlaví protokolu HTTP. Příklad
|
mob |
Indikátor žádosti o reklamu pro mobily. Příklad
|
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
|
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_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
|
submodel |
Údaj o hardwaru mobilního zařízení, který přepíše údaj automaticky zjištěný reklamním serverem. Příklad
Hodnoty podmodelů:
|
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.