Vzorové značky Google Publisher Tag

V tomto článku naleznete ukázky značek Google Publisher Tag pro implementaci v mobilech a počítačích. Přečtěte si, jak pomocí Generátoru značek Google vygenerovat značky GPT automaticky.

Obsah tohoto článku:

Příklad asynchronní značky Google Publisher Tag

Níže je ukázka celého kódu, který byste použili k vytvoření asynchronní značky Google Publisher Tag. Tato značka ilustruje množství běžných funkcí a syntaxí používaných v žádostech o reklamy s asynchronní značkou GPT.

1 <html>
  • Řádky 3 až 15 představují standardizovaný kód, který asynchronně načítá javascriptovou knihovnu GPT používanou ve službě DFP. (V případě potřeby se použije protokol SSL/HTTPS.) Na tomto místě se sestaví fronta příkazů na zpracování seznamu funkcí (volání reklam), které se mají zpracovat asynchronně. V této části kódu majitelé stránek nemusejí provádět žádné změny.

  • (Volitelné) Řádky 16 až 20 nastavují atributy na úrovni stránky pro reklamní bloky zobrazující reklamy AdSense. Pokud jsou zde nastaveny, přepíšou všechny styly nastavené ve službě DFP nebo AdSense. Tento přístup se obvykle nepoužívá, protože tyto atributy můžete nastavit ve službě DFP. Další informace o nastavení parametrů AdSense ve značce GPT naleznete v dokumentaci funkce .set() v centru nápovědy.

  • Řádky 17, 22, 39, 46: Pokud používáte asynchronní vykreslování, vložte veškerý JavaScript (po úvodním univerzálním skriptu) do funkce googletag.cmd.push na řádku 17. Funkci tím přidáte do fronty příkazů, které se budou asynchronně zpracovávat při načtení stránky. Přečtěte si další informace o rozdílech mezi synchronním a asynchronním zobrazováním.

  • Řádek 23: "/1234/travel/asia/food" určuje kód sítě (1234) a cílenou reklamní jednotku (travel/asia/food). Kód své sítě naleznete ve službě DFP na kartě Správce.

    [728, 90] nastavuje velikost kreativy v reklamním bloku. Zde uveďte, jaké velikosti kreativ se v tomto reklamním bloku mohou zobrazovat. Několik velikostí uveďte následovně: [[width1, height1], [width2, height2], [width3, height3]]. Všechny zde uvedené velikosti by měly být přiřazeny také k cílené reklamní jednotce – toto vám jen umožní zúžit seznam podle konkrétního bloku. Při použití reklamních bloků několika velikostí by reklamní bloky měly být deklarovány ve stejném pořadí, v jakém jsou uvedeny ve službě DFP. Přečtěte si další informace o definování bloků a sekvenčnosti.

  • Řádky 23, 26, 37, 40, 44 a 47: "div-gpt-ad-123456789-0" určuje způsob, jakým se reklamní bloky definované v hlavičce přiřazují k reklamním blokům na stránce (značky div v těle stránky, ve kterých se reklamy zobrazují). Mohou být pojmenovány libovolně, musí se však shodovat. Náš generátor značek používá názvy "div-gpt-ad-[náhodné číslo]-0", "div-gpt-ad-[náhodné číslo]-1" a tak dále. Jde o přehledný způsob vytvoření podobných, avšak různých značek.

    Přestože se zde používají náhodná čísla, nejde o způsob jednoznačné identifikace žádosti o reklamu v GPT. Identifikace se provádí na pozadí pomocí knihovny GPT. Tyto názvy mohou být na různých stránkách stejné. Nikdy se však nesmí nacházet několik značek div se stejným názvem na jedné stránce.

  • Řádky 25, 28, 29 a 30: nastavují cílení typu klíč–hodnota na úrovni reklamního bloku pomocí funkce .setTargeting(). K jednomu klíči můžete přiřadit více hodnot, jak je uvedeno v prvním příkladu: ("key". ["value1", "value2", "value3"]). Pokud chcete cílit na několik klíčů, zavolejte tuto funkci několikrát, jak je ukázáno v druhém případě (gender=male a age=20-30). Další informace o způsobu nastavení parametrů klíč–hodnota ve značkách GPT naleznete v dokumentaci funkce .setTargeting() a v článku Nastavení cílení a velikostí pomocí značky GPT.

  • Řádek 30: googletag.pubads().setTargeting("topic","basketball"); nastavuje cílení na páry klíč–hodnota na úrovni stránky. Upozorňujeme, že pokud vlastní cílení nastavíte pomocí vlastního cílení na úrovni stránky, všechny reklamní bloky jej zdědí. Stejně jako u cílení na úrovni bloku můžete k jednomu klíči přiřadit několik hodnot: ("key". ["value1", "value2", "value3"]). Další informace o nastavení párů klíč–hodnota ve značkách GPT naleznete v dokumentaci funkce .setTargeting() a v článku Nastavení cílení a velikostí pomocí značky GPT.

  • Řádek 31: googletag.pubads().enableSingleRequest(); umožňuje architekturu jediného požadavku (SRA). Tento řádek uveďte v případě, že chcete volat všechny reklamní bloky na stránce pomocí jednoho volání (umožňuje zaručené blokování ostatních reklam a díky sloučení reklam do jediného volání může pozitivně ovlivnit výkonnost stránky). Existují nějaké případy, kdy použití architektury SRA není vhodné? Architektura SRA v současné době nepodporuje přetáčení značky DoubleClick (značky InRed) ani programovatelné reklamy Google (GPA).

  • Řádek 37: (Volitelné) style="width: 728px; height: 90px" představuje velikost, která se pro prvek nastaví před vykreslením kreativy. Používáte-li značky s více velikostmi, doporučujeme tento atribut vynechat (v takovém případě prvek po vykreslení dané kreativy převezme její velikost). Pokud se rozhodnete tento atribut použít, zvolte oba rozměry tak, aby byly dostatečné pro největší možnou kreativu. V případě značek reklamy jedné velikosti můžete tento příkaz použít k rozbalení prvku kontejneru v době načítání kreativy, aby se ostatní prvky stránky po vykreslení kreativ neposouvaly.

2 <head>
3 <script type="text/javascript">
4   var googletag = googletag || {};
5   googletag.cmd = googletag.cmd || [];
6   (function() {
7     var gads = document.createElement("script");
8     gads.async = true;
9     gads.type = "text/javascript";
10     var useSSL = "https:" == document.location.protocol;
11     gads.src = (useSSL ? "https:" : "http:") + "//www.googletagservices.com/tag/js/gpt.js";
12     var node =document.getElementsByTagName("script")[0];
13     node.parentNode.insertBefore(gads, node);
14    })();
15 </script>
16 <script type="text/javascript">
17   googletag.cmd.push(function() {
18     googletag.pubads().set("adsense_background_color", "FFFFFF");
19   });
20 </script>
21 <script>
22   googletag.cmd.push(function() {
23     googletag.defineSlot("/1234/travel/asia/food", [728, 90], "div-gpt-ad-123456789-0")
24       .addService(googletag.pubads())
25       .setTargeting("interests", ["sports", "music", "movies"]);
26     googletag.defineSlot("/1234/travel/asia/food", [[468, 60], [728, 90], [300, 250]], "div-gpt-ad-123456789-1")
27       .addService(googletag.pubads())
28       .setTargeting("gender", "male")
29       .setTargeting("age", "20-30");
30     googletag.pubads().setTargeting("topic","basketball");
31     googletag.pubads().enableSingleRequest();
32     googletag.enableServices();
33   });
34 </script>
35 </head>
36 <body>
37   <div id="div-gpt-ad-123456789-0" style="width: 728px; height: 90px">
38     <script type="text/javascript">
39       googletag.cmd.push(function() {
40       googletag.display("div-gpt-ad-123456789-0");
41       });
42     </script>
43   </div>
44     <div id="div-gpt-ad-123456789-1">
45     <script type="text/javascript">
46       googletag.cmd.push(function() {
47          googletag.display("div-gpt-ad-123456789-1");
48       });
49     </script>
50   </div>
51 </body>
52 </html>
 

Příklad synchronní značky Google Publisher Tag

Níže je ukázka celého kódu, který byste použili k vytvoření synchronní značky Google Publisher Tag. Tato značka ilustruje množství běžných funkcí a příkladů syntaxe používaných v žádostech o reklamy se synchronní značkou GPT.

Další informace o generování značek Google Publisher Tag naleznete v článku generování značek ve službě DFP.

1 <html>
  • Řádky 3 až 10 představují standardizovaný kód, který asynchronně načítá knihovnu jazyka JavaScript pro značky GPT, používanou ve službě DFP a v případě potřeby použije protokol SSL/HTTPS. Na tomto místě se sestaví fronta příkazů na zpracování seznamu funkcí (volání reklam), které se mají zpracovat asynchronně. V této části kódu majitelé stránek nemusejí provádět žádné změny.

  • (Volitelné) Řádky 11 až 13 nastavují atributy na úrovni stránky pro reklamní bloky zobrazující reklamy AdSense. Pokud jsou zde nastaveny, přepíšou všechny styly nastavené ve službě DFP nebo AdSense. Tento přístup se obvykle nepoužívá, protože tyto atributy můžete nastavit ve službě DFP. Další informace o nastavení parametrů AdSense ve značce GPT naleznete v dokumentaci funkce .set() v centru nápovědy.

  • Řádky 15 a 18: "/1234/travel/asia/food" určuje kód sítě (1234) a cílenou reklamní jednotku (travel/asia/food). Kód své sítě naleznete ve službě DFP na kartě Správce.

    [728, 90] nastavuje velikost kreativy v reklamním bloku. Zde uveďte, jaké velikosti kreativ se v tomto reklamním bloku mohou zobrazovat. Několik velikostí uveďte následovně: [[width1, height1], [width2, height2], [width3, height3]]. Všechny zde uvedené velikosti by měly být přiřazeny také k cílené reklamní jednotce – toto vám jen umožní zúžit seznam podle konkrétního bloku. Při použití reklamních bloků několika velikostí by reklamní bloky měly být deklarovány ve stejném pořadí, v jakém jsou uvedeny ve službě DFP. Přečtěte si další informace o definování bloků a sekvenčnosti.

    Řádky 15, 18, 29, 31, 34 a 36: "div-gpt-ad-123456789-0" určuje způsob, jakým se reklamní bloky definované v hlavičce přiřazují k reklamním blokům na stránce (značky div v těle stránky, ve kterých se reklamy zobrazují). Mohou být pojmenovány libovolně, musí se však shodovat. Náš generátor značek používá názvy "div-gpt-ad-[náhodné číslo]-0", "div-gpt-ad-[náhodné číslo]-1" a tak dále. Jde o přehledný způsob vytvoření podobných, avšak různých značek.

    Přestože se zde používají náhodná čísla, nejde o způsob jednoznačné identifikace žádosti o reklamu v GPT. Identifikace se provádí na pozadí pomocí knihovny GPT. Tyto názvy mohou být na různých stránkách stejné. Nikdy se však nesmí nacházet několik značek div se stejným názvem na jedné stránce.

  • Řádky 17, 20, 21 a 22 (Volitelné): nastavují cílení typu klíč–hodnota na úrovni reklamního bloku pomocí funkce .setTargeting(). K jednomu klíči můžete přiřadit více hodnot, jak je uvedeno v prvním příkladu: ("key". ["value1", "value2", "value3"]). Pokud chcete cílit na několik klíčů, zavolejte tuto funkci několikrát, jak je ukázáno v druhém případě (gender=male a age=20-30). Další informace o způsobu nastavení parametrů klíč–hodnota ve značkách GPT naleznete v dokumentaci funkce .setTargeting() a v článku Nastavení cílení a velikostí pomocí značky GPT.

  • Řádek 22: googletag.pubads().setTargeting("topic","basketball"); nastavuje cílení na páry klíč–hodnota na úrovni stránky. Upozorňujeme, že pokud vlastní cílení nastavíte pomocí vlastního cílení na úrovni stránky, všechny reklamní bloky jej zdědí. Stejně jako u cílení na úrovni bloku můžete k jednomu klíči přiřadit několik hodnot: ("key". ["value1", "value2", "value3"]). Další informace o nastavení párů klíč–hodnota ve značkách GPT naleznete v dokumentaci funkce .setTargeting() a v článku Nastavení cílení a velikostí pomocí značky GPT.

  • Řádek 23: googletag.pubads().enableSingleRequest(); umožňuje architekturu jediného požadavku (SRA). Tento řádek uveďte v případě, že chcete volat všechny reklamní bloky na stránce pomocí jednoho volání (umožňuje zaručené blokování ostatních reklam a díky sloučení reklam do jediného volání může pozitivně ovlivnit výkonnost stránky). Existují nějaké případy, kdy použití architektury SRA není vhodné? Architektura SRA v současné době nepodporuje přetáčení značky DoubleClick (značky InRed) ani programovatelné reklamy Google (GPA).

  • Řádek 24: Chcete-li kreativy vykreslit synchronně, přidejte řádek googletag.pubads().enableSyncRendering();. Dává službě pokyn, aby počkala na dokončení každé žádosti o reklamy a teprve poté pokračovala ve vykreslování stránky.

  • Řádek 29: (Volitelné) style="width: 728px; height: 90px" představuje velikost, která se pro prvek nastaví před vykreslením kreativy. Používáte-li značky s více velikostmi, doporučujeme tento atribut vynechat (v takovém případě prvek po vykreslení dané kreativy převezme její velikost). Pokud se rozhodnete tento atribut použít, zvolte oba rozměry tak, aby byly dostatečné pro největší možnou kreativu. V případě značek reklamy jedné velikosti můžete tento příkaz použít k rozbalení prvku kontejneru v době načítání kreativy, aby se ostatní prvky stránky po vykreslení kreativ neposouvaly.

2 <head>
3 <script type="text/javascript">
4   (function() {
5   var useSSL = 'https:' == document.location.protocol;
6 var src = (useSSL ? 'https:' : 'http:') +
7 '//www.googletagservices.com/tag/js/gpt.js';
8   document.write('<scr' + 'ipt src="' + src + '"></scr' + 'ipt>');
9   })();
10 </script>
11 <script type="text/javascript">
12     googletag.pubads().set("adsense_background_color", "FFFFFF");
13 </script>
14 <script>
15     googletag.defineSlot("/1234/travel/asia/food", [728, 90], "div-gpt-ad-123456789-0")
16       .addService(googletag.pubads())
17       .setTargeting("interests", ["sports", "music", "movies"]);
18     googletag.defineSlot("/1234/travel/asia/food", [[468, 60], [728, 90], [300, 250]], "div-gpt-ad-123456789-1")
19       .addService(googletag.pubads())
20       .setTargeting("gender", "male")
21       .setTargeting("age", "20-30");
22     googletag.pubads().setTargeting("topic","basketball");
23     googletag.pubads().enableSingleRequest();
24     googletag.pubads().enableSyncRendering();
25     googletag.enableServices();
26 </script>
27 </head>
28 <body>
29   <div id="div-gpt-ad-123456789-0" style="width: 728px; height: 90px">
30     <script type="text/javascript">
31       googletag.display("div-gpt-ad-123456789-0");
32     </script>
33   </div>
34   <div id="div-gpt-ad-123456789-1">
35     <script type="text/javascript">
36       googletag.display("div-gpt-ad-123456789-1");
37     </script>
38   </div>
39 </body>
40 </html>
 

Pokud nemůžete měnit záhlaví svých webových stránek

Reklamní jednotky můžete definovat přímo v jednotlivých značkách reklamy při načítaní stránky. Nejedná se o doporučený způsob značkování, je ale nezbytný v případě, že nemáte možnost měnit záhlaví.

Protože značka reklamy používá knihovnu jazyka JavaScript pro značky GPT, je nutné před kódem značky uvést kód, který tuto knihovnu načítá. Kód načítající knihovnu je uveden v příkladu níže. Kód načítající knihovnu je uveden v příkladu níže.

Reklamní blok můžete určit při načítání stránky podle následujících příkladů:

Příklad asynchronní značky GPT

Volání javascriptové knihovny GPT

<script type="text/javascript">
 var googletag = googletag || {};
 googletag.cmd = googletag.cmd || [];
 (function() {
   var gads = document.createElement("script");
   gads.async = true;
   gads.type = "text/javascript";
   var useSSL = "https:" == document.location.protocol;
   gads.src = (useSSL ? "https:" : "http:") + "//www.googletagservices.com/tag/js/gpt.js";
   var node =document.getElementsByTagName("script")[0];
   node.parentNode.insertBefore(gads, node);
  })();
</script>

Ukázková značka reklamy 1: asynchronní vložená značka (tato metoda nepodporuje značky SRA)

<div id="div-gpt-ad-1234567891234-0">
  <script type='text/javascript'>
    googletag.cmd.push(function() {
      googletag.defineSlot('/1234/sports/football', [728, 90],'div-gpt-ad-1234567891234-0')
        .addService(googletag.pubads())
        .setTargeting("Gender", "Male");
      googletag.enableServices();
      googletag.display('div-gpt-ad-1234567891234-0');
  });
  </script>
</div>

Ukázková značka reklamy 2: asynchronní kondenzovaná vložená značka (tato metoda nepodporuje značky SRA ani cílení na úrovní reklamního bloku)

<div id='div-gpt-ad-1234567891234-0'>
  <script type='text/javascript'>
    googletag.cmd.push(function() {
      googletag.pubads().display('/1234/sports/football', [728, 90], 'div-gpt-ad-1234567891234-0');
    });
  </script>
</div>
Příklad synchronní značky GPT

Volání javascriptové knihovny GPT

<script type="text/javascript">
 (function() {
   var useSSL = 'https:' == document.location.protocol;
   var src = (useSSL ? 'https:' : 'http:') + '//www.googletagservices.com/tag/js/gpt.js';
   document.write('<scr' + 'ipt src="' + src + '"></scr' + 'ipt>');
 })();
</script>

Ukázková značka reklamy 1: synchronní vložená značka (tato metoda nepodporuje značky SRA)

<div id='div-gpt-ad-1234567891234-0'>
  <script type='text/javascript'>
    googletag.defineSlot('/1234/sports', [728, 90],'div-gpt-ad-1234567891234-0')
      .addService(googletag.pubads())
      .setTargeting("Gender", "Male");
    googletag.pubads().enableSyncRendering();
    googletag.enableServices();googletag.display('div-gpt-ad-1234567891234-0');
  </script>
</div>

Ukázková značka reklamy 2: vložené značky, kondenzovaná forma (tato metoda nepodporuje značky SRA ani cílení na úrovní reklamního bloku)

<div id='div-gpt-ad-1234567891234-0'>
  <script type='text/javascript'>
    googletag.pubads().display('/1234/sports', [728, 90], 'div-gpt-ad-1234567891234-0');
  </script>
</div>

Přepsání formátování reklam AdSense na úrovni stránky (volitelné)

Ve většině případů jste již formátování reklam AdSense nastavili ve službě DFP nebo AdSense. Pokud však toto formátování chcete na úrovni jednotlivých stránek přepsat, můžete do značek vložit následující kód.

Pro asynchronní značky:

<script>
  googletag.cmd.push(function() {
    googletag.pubads().set("adsense_background_color", "FFFFFF");
  });
</script>

Pro synchronní značky:

<script>
  googletag.pubads().set("adsense_background_color", "FFFFFF");
</script>

Použití nejavascriptové značky GPT k vytvoření měřicího pixelu 1x1

Postup vytvoření měřicího kódu pomocí značky GPT:

  1. Vytvořte novou reklamní jednotku nebo vyberte nějakou existující, pomocí které chcete sledovat počet zobrazení.

  2. Vytvořte řádkovou položku 1x1 a přidejte do ní kreativu (vlastní nebo třetí strany) v podobě průhledného pixelu.

  3. Nastavte pro řádkovou položku 1x1 cílení na měřicí reklamní jednotku.

  4. Vytvořte nejavascriptovou značku GPT, která volá pixel pro měření zobrazení.

    Níže naleznete ukázku kódu kreativy, který byste mohli přidat za účelem vytvoření nástroje na měření zobrazení 1x1 ve formátu značky bez JavaScriptu:

    <img src='http://pubads.g.doubleclick.net/gampad/ad?iu=/1234/ad_unit&sz=1x1&t=&c=12345678'/>
  5. Značku pixelu pro měření zobrazení můžete použít dvěma způsoby:

    • přidat značku do vlastní kreativy nebo do kreativy třetí strany, která se zobrazí na stránce: na kartě Nastavení kreativy přidejte značku do horní části pole Fragment kódu,

    • přidat značku přímo na webovou stránku.

Další informace o generování nejavascriptových adres URL naleznete v našem článku o zobrazování reklam v prostředí bez JavaScriptu.