Pro pokročilé uživatele jsme vytvořili tento seznam aktuálně podporovaných parametrů stylu vyhledávání. Kód, který vytvoříte v AdSense, obsahuje všechna nejčastěji používaná nastavení parametrů. Existují dva vyžadované parametry: pubId a query. AdSense poskytuje parametr pubId, ale kód je nutné upravit a předat hodnotu pro parametr query. Všechny ostatní parametry jsou nepovinné a jsou popsány níže.
Typy parametrů
Existují dva typy parametrů:
- parametry na úrovni stránky, které se vztahují na všechny reklamní jednotky na stránce,
- parametry na úrovni jednotky, které se vztahují na jednotlivé reklamní jednotky.
Zde je příklad výstupu z generátoru kódu se dvěma reklamními bloky. Pro konfiguraci tohoto kódu musíte nastavit požadovaný parametr query v mapě pageOptions (např. “query”: myQuery). To je vše, co je třeba k zahájení zobrazování reklam. Také můžete nastavit nepovinné parametry na úrovni stránky v bloku na úrovni stránky a parametry na úrovni jednotlivých jednotek v mapách adblock1 a adblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parametry na úrovni stránky
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parametry na úrovni jednotky
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Popisy parametrů na úrovni stránky
Tyto parametry stačí na každé stránce specifikovat jednou. Ovlivňují všechny jednotky na stránce.
Povinné
| Parametr | Popis a příklady |
|---|---|
adPage |
Vyžadováno, když uživatel přejde na další stránku s výsledky nebo na předchozí stránku s výsledky
Parametr |
pubId |
Povinný parametr Toto je Client-ID AdSense. Parametr pubId je součástí Client-ID, které následuje za řetězcem „partner-“. Pokud je vaše Client-ID například „partner-test-property“, vaše pubId je „test-property“. Toto je standardní protokol pro reklamy ve vlastním vyhledávání. Příklad: 'pubId' : 'test-property' |
query |
Povinný parametr Toto je vyhledávací dotaz zadaný uživatelem. Hodnota parametru dotazu by měla být nekódovaná. Příklady:
|
resultsPageBaseUrl |
Vyžadováno, když máte na stránce jednotky souvisejícího vyhledávání Určuje URL stránky s výsledky vyhledávání, na které daný vyhledávací dotaz je dotazem souvisejícího vyhledávání, na který uživatel kliknul. Parametr resultsPageBaseUrl může obsahovat vlastní parametry s výjimkou vyhledávacího dotazu, který bude přidán automaticky.
Příklad:
|
styleId |
Povinný parametr Určuje ID stylu vyhledávání, který se má použít na reklamu nebo jednotky souvisejícího vyhledávání na stránce. Další informace o používání stylů vyhledávání. Poznámka: pokud bude u požadavku nastaven parametr styleId, reklamy nebo související vyhledávání se vykreslí v daném stylu a starší parametry stylu budou ignorovány. Pokud u požadavku styleId nastaven není, použije se při vykreslování výchozí styl systému. Příklad
|
Nepovinné
| Parametr | Popis a příklady |
|---|---|
linkTarget |
Nepovinný parametr Určuje, zda se výsledek kliknutí na reklamu otevře ve stejném nebo novém okně. Výchozí hodnota je '_top'. Tento parametr lze použít také na úrovni jednotky.
Příklad: 'linkTarget' : '_blank' |
maxTermLength |
Nepovinný parametr Určuje maximální počet znaků dotazu souvisejícího vyhledávání, včetně mezer. Pokud parametr není nastaven, žádné maximum není. Příklad: 'maxTermLength' : 50 |
referrerAdCreative |
Nepovinný parametr Pokud se uživatel dostane na stránku s obsahem, která obsahuje související vyhledávání pro jednotku obsahu, kliknutím na reklamu nebo odkaz na jiném webu a tato reklama nebo odkaz jsou pod vaší kontrolou, tento parametr by měl být nastaven na text kreativy dané reklamy nebo na text odkazu. Na používání tohoto parametru se vztahují následující pokyny:
Příklady: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Nepovinný parametr Určuje název parametru adresy URL pro vyhledávací dotaz na stránce s výsledky vyhledávání. Pokud není uvedeno jinak, je výchozí hodnota „q“. Příklad: 'resultsPageQueryParam' : 'query' |
terms |
Nepovinný parametr Tento parametr umožňuje zadat seznam vašich vlastních souvisejících vyhledávacích dotazů oddělených čárkou. Google je může a nemusí použít. Příklad: 'terms' : 'cars rental, flight ticket' |
Nastavení konfigurace
| Parametr | Popis a příklady | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Nepovinný parametr Udává pravidla filtrování, která by Google měl použít na reklamy odpovídající vyhledávacímu dotazu. Níže jsou uvedena platná nastavení pro adsafe a účinek, který má každá hodnota na vrácené reklamy:
Poznámka: Ve výchozím nastavení je parametr
adsafe nastaven na 'high'.Příklad: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Nepovinný parametr Parametr adtest se používá k označení testovacího požadavku na reklamy. Když má parametr adtest hodnotu 'on', bere Google požadavek jako test a nepočítá zobrazení reklamy ani neměří výsledky prokliku.
Když má parametr Poznámka: Použijte tento parametr při testování, ale nepoužívejte ho v produkčních systémech, jelikož by vám zobrazené reklamy nebyly proplaceny.
Výchozí hodnota parametru adtest je 'off'. Příklad: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Nepovinný parametr Pro měření výsledků různých stránek můžete použít kanál služby AdSense pro vyhledávání. Použijte jedinečné ID kanálu, které jste vytvořili ve svém účtu AdSense. Přečtěte si další informace o měření výkonu reklam pomocí vlastních kanálů. Různé kanály by měly být odděleny symbolem „+“. Příklady: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Nepovinný parametr Tento parametr určuje jazyk, na který mají požadované reklamy cílit. Výchozí hodnota je „en“. Google podporuje všechny jazykové kódy rozhraní Google Ads API. Poznámka: Inzerenti určují jazyky, na které jejich reklamy cílí. Pokud tento parametr zahrnete ve svém požadavku, Google vrátí pouze reklamy, které cílí na daný jazyk nebo na všechny jazyky, ale nezaručí, že text reklamy bude v určeném jazyce.
Zpravidla byste měli parametr Příklady: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Nepovinné
Parametr Výchozí hodnota
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Nepovinné
Parametr Výchozí hodnota parametru
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Nepovinný parametr Určuje, zda uživatelé souhlasili s tím, že majitel obsahu bude s Googlem sdílet osobní údaje za účelem personalizace inzerce.
Poznámka: Ve výchozím nastavení je parametr
personalizedAds nastaven na „true“.Příklad: 'personalizedAds': false |
Popisy parametrů na úrovni jednotky
Tyto parametry ovlivňují způsob, kterým jsou jednotlivé reklamní jednotky na stránce prezentovány uživateli. Každý parametr lze nastavit pro každou reklamní jednotku jednotlivě.
Povinné
| Parametr | Popis a příklady |
|---|---|
container |
Povinný parametr ID prázdného kontejneru reklamy <div id='afscontainer1'></div>, kde se má reklama zobrazit.
Příklad: |
maxTop |
Povinné
Tento parametr použijte k určení počtu reklam, který se má zobrazit v horní reklamní jednotce. Poznámka: Tento parametr se používá místo parametru
number. Tato reklamní jednotka by měla být dostatečně široká, aby se první řádek reklamy nezalamoval. Použití parametru maxTop v jiném umístění na stránce je považováno za porušení zásad.Příklad: |
width |
Povinný parametr Udává šířku reklamní jednotky nebo jednotky souvisejícího vyhledávání v pixelech. Příklady: 'width' : '700px''width' : 700 |
Nastavení konfigurace
| Parametr | Popis a příklady | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Nepovinný parametr Určuje funkci JavaScriptu, která má být volána, když se načtou reklamy nebo jednotky souvisejícího vyhledávání nebo když se nezobrazí žádné reklamy nebo jednotky souvisejícího vyhledávání. Parametr by měl být nastaven na funkci zpětného volání JavaScriptu, kterou jste implementovali a která umožňuje, aby byla akce provedena, když je žádost o reklamu dokončena. Funkce zpětného volání používá následující parametry:
Poznámka: Funkci zpětného volání otestujte, aby negenerovala chyby, zejména ne chyby, které by mohly interferovat s načítáním stránky.
Příklad zpětného volání JavaScriptu: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; |
||||||||
number |
Nepovinný parametr Počet reklam, které by se měly zobrazit v této jednotce. Výchozí hodnota je 2. Příklad: |
||||||||
relatedSearches |
Nepovinný parametr Počet souvisejících vyhledávání, která by se měla zobrazit v této jednotce. Pokud tento parametr není nastaven na nulu, vrátí minimálně tři související vyhledávání. Když není zadán, je výchozí hodnota 0. Příklad: 'relatedSearches' : 4 |
