Voor gevorderde gebruikers hebben we deze lijst opgesteld van de momenteel ondersteunde parameters voor zoekstijlen. De code die u in AdSense maakt, bevat alle meest gebruikte parameterinstellingen. Er zijn 2 vereiste parameters: pubId en query. AdSense geeft de pubId op, maar u moet de code bewerken en een waarde doorgeven voor de parameter query. Alle andere parameters zijn optioneel en worden hieronder beschreven.
Parametertypen
Er zijn 2 typen parameters:
- Parameters op paginaniveau, die van toepassing zijn op alle advertentieblokken op de pagina.
- Parameters op advertentieblokniveau, die van toepassing zijn op afzonderlijke advertentieblokken.
Hier is een voorbeeld van de uitvoer van de codegenerator met 2 advertentieblokken. Als u deze code wilt instellen, moet u de vereiste parameter query instellen op de kaart pageOptions (bijv. “query”: myQuery). Meer hoeft u niet te doen om advertenties weer te geven. U kunt ook optionele parameters op paginaniveau instellen in het paginaniveaublok en afzonderlijke parameters op advertentieblokniveau instellen op de kaarten adblock1 en adblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parameters op paginaniveau
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parameters op advertentieblokniveau
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Beschrijvingen van parameters op paginaniveau
Deze parameters hoeven slechts eenmaal per pagina te worden opgegeven. Ze zijn van invloed op alle advertentieblokken op de pagina.
Vereist
| Parameter | Beschrijving en voorbeelden |
|---|---|
adPage |
Vereist als de gebruiker naar de volgende of de vorige pagina met resultaten navigeert
De parameter |
pubId |
Vereist Dit is uw client-ID van AdSense. De pubId is het deel van uw client-ID dat na 'partner-' komt. Als uw client-ID bijvoorbeeld 'partner-test-property' is, is de pubId 'test-property'. Dit is een standaardprotocol voor aangepaste zoekadvertenties (CSA). Voorbeeld: 'pubId' : 'test-property' |
query |
Vereist Dit is de zoekopdracht die de gebruiker heeft opgegeven. De waarde van de queryparameter mag geen codes bevatten. Voorbeelden:
|
resultsPageBaseUrl |
Vereist als er gerelateerde zoekblokken op de pagina staan Specificeert de URL van de pagina met zoekresultaten waarop de zoekopdracht de gerelateerde zoekterm is waarop de gebruiker heeft geklikt. De resultsPageBaseUrl kan eigen parameters bevatten, behalve de zoekopdracht. Die wordt automatisch toegevoegd.
Voorbeeld:
|
styleId |
Vereist Geeft de ID aan van de zoekstijl die moet worden toegepast op de advertentie of gerelateerde zoekblokken op de pagina. Lees meer informatie over het gebruik van zoekstijlen. Als u de styleId instelt in een verzoek, worden advertenties of gerelateerde zoekopdrachten getoond met de stijl. Verouderde stijlparameters worden genegeerd. Als de styleId niet is opgegeven in het verzoek, wordt een standaardstijl van het systeem weergegeven. Voorbeeld
|
Optioneel
| Parameter | Beschrijving en voorbeelden |
|---|---|
linkTarget |
Optioneel Geeft aan of een klik op een advertentie wordt geopend in hetzelfde venster of in een nieuw venster. De standaardwaarde is '_top'. Deze parameter kan ook op advertentieblokniveau worden gebruikt.
Voorbeeld: 'linkTarget' : '_blank' |
maxTermLength |
Optioneel Specificeert het maximumaantal tekens van een gerelateerde zoekterm, inclusief spaties. Er geldt geen maximum als dit niet is ingesteld. Voorbeeld: 'maxTermLength' : 50 |
referrerAdCreative |
Optioneel Als een gebruiker op uw contentpagina met een blok met Gerelateerde zoekopdracht voor content terechtkomt na een klik op een advertentie of link op een andere website en u beheert die advertentie of link, moet deze parameter worden ingesteld op de letterlijke tekst in het advertentiemateriaal van die advertentie of link. De volgende richtlijnen zijn van toepassing op het gebruik van deze parameter:
Voorbeelden: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Optioneel Geeft de naam aan van de URL-parameter voor de zoekopdracht op de pagina met zoekresultaten. De standaardwaarde is q als deze niet is opgegeven. Voorbeeld: 'resultsPageQueryParam' : 'query' |
terms |
Optioneel Met deze parameter kunt u een door komma's gescheiden lijst van uw eigen gerelateerde zoektermen opgeven die moeten worden geretourneerd voor een gerelateerde zoekopdracht. Google kan deze zoektermen wel of niet gebruiken. Voorbeeld: 'terms' : 'cars rental, flight ticket' |
Configuratie-instellingen
| Parameter | Beschrijving en voorbeelden | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Optioneel Specificeert de filterregels die Google moet toepassen op advertenties die overeenkomen met de zoekopdracht. De volgende instellingen zijn de geldige instellingen voor adsafe en het gevolg dat elke waarde heeft voor geretourneerde advertenties:
Opmerking: Standaard is
adsafe ingesteld op 'high'.Voorbeeld: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Optioneel De parameter adtest wordt gebruikt om aan te geven dat een verzoek voor advertenties een test is. Als de parameter adtest de waarde on heeft, behandelt Google het verzoek als een test en wordt het aantal advertentievertoningen niet meegeteld en worden de klikfrequenties niet bijgehouden.
Als de parameter Opmerking: Gebruik deze parameter voor tests, maar niet in productiesystemen, anders wordt u niet betaald voor advertenties die u weergeeft.
De standaardwaarde voor adtest is 'off'. Voorbeeld: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Optioneel U kunt een kanaal opnemen voor AdSense voor zoeken als u de prestaties van verschillende pagina's wilt bijhouden. Gebruik de unieke kanaal-ID die u in uw AdSense-account heeft gemaakt. Lees meer informatie over hoe u advertentieprestaties kunt bijhouden met aangepaste kanalen. Meerdere kanalen moeten van elkaar zijn gescheiden door een +. Voorbeelden: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Optioneel Deze parameter geeft aan welke taal de aangevraagde advertenties moeten targeten. De standaardwaarde is 'en'. Google ondersteunt alle taalcodes van de Google Ads API. Opmerking: Adverteerders geven de talen op die hun advertenties targeten. Als u deze parameter opneemt in uw verzoek, geeft Google alleen advertenties weer die zijn getarget op die taal of op alle talen. Er is geen garantie dat de advertentietekst in de opgegeven taal wordt getoond.
Gewoonlijk moet u de parameter Voorbeelden: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Optioneel
De parameter De standaardwaarde voor
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Optioneel
De parameter De standaardwaarde voor
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Optioneel Geeft aan of gebruikers de uitgever toestemming hebben gegeven om persoonlijke informatie met Google te delen voor gepersonaliseerd adverteren.
Opmerking: Standaard is
personalizedAds ingesteld op true.Voorbeeld: 'personalizedAds': false |
Beschrijvingen van parameters op advertentieblokniveau
Deze parameters beïnvloeden de manier waarop afzonderlijke advertentieblokken op een pagina aan de gebruiker worden weergegeven. U kunt elke parameter afzonderlijk instellen voor elk advertentieblok.
Vereist
| Parameter | Beschrijving en voorbeelden |
|---|---|
container |
Vereist De ID van de lege advertentiecontainer <div id='afscontainer1'></div> waar de advertentie moet worden weergegeven.
Voorbeeld: |
maxTop |
Vereist
Geef met deze parameter aan hoeveel advertenties moeten worden weergegeven in het bovenste advertentieblok. Opmerking: Deze parameter wordt gebruikt in plaats van de parameter
number. Dit advertentieblok moet breed genoeg zijn, zodat de eerste regel van de advertenties niet overloopt naar de volgende regel. Als de parameter maxTop op een andere plaatsing op de pagina staat, is dat een beleidsschending.Voorbeeld: |
width |
Vereist Specificeert de breedte van het advertentieblok of het gerelateerde zoekblok in pixels. Voorbeelden: 'width' : '700px''width' : 700 |
Configuratie-instellingen
| Parameter | Beschrijving en voorbeelden | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Optioneel Specificeert welke JavaScript-functie moet worden aangeroepen als de advertenties of gerelateerde zoekopdrachten zijn geladen of als er geen advertenties of gerelateerde zoekopdrachten worden weergegeven. De parameter moet worden ingesteld op een JavaScript-callbackfunctie die u implementeert. Hierdoor kan een actie worden uitgevoerd als de advertentieaanroep is afgerond. De callbackfunctie heeft de volgende parameters:
Opmerking: Test uw callbackfunctie om te voorkomen dat deze fouten veroorzaakt, met name fouten waardoor de pagina niet goed wordt geladen.
Voorbeeld van een JavaScript-callback: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // doet hoogstwaarschijnlijk niks } catch (e) { alert ("Fout in callbackfunctie"); // doe iets om de fout elegant af te handelen } } else { // zoals u altijd doet wanneer er geen advertentiedekking van Google is } } }; |
||||||||
number |
Optioneel Het aantal advertenties dat in dit blok moet worden weergegeven. De standaardwaarde is 2. Voorbeeld: |
||||||||
relatedSearches |
Optioneel Het aantal gerelateerde zoekopdrachten dat in dit advertentieblok moet worden weergegeven. Deze parameter retourneert minstens 3 gerelateerde zoekopdrachten, tenzij deze is ingesteld op nul. De standaardwaarde is 0 als deze niet wordt opgegeven. Voorbeeld: 'relatedSearches' : 4 |
