Vi har forberedt denne liste til avancerede brugere over de søgeparametre, vi understøtter i øjeblikket. Den kode, du genererer i AdSense, indeholder alle de oftest benyttede parameterindstillinger. Der er to obligatoriske parametre: pubId og query. AdSense leverer pubID, men du skal redigere koden og angive en værdi for query-parameteren. Alle de andre parametre er valgfri og er beskrevet nedenfor.
Parameter-typer
Der er to typer parametre:
- Sideniveau-parametre, der gælder for alle annonceenhederne på siden
- Enhedsniveau-parametre, der gælder for individuelle annonceenheder.
Her er nogle output-eksempler fra kodegeneratoren med to annonceblokke. Du konfigurerer koden ved at angive den nødvendige query-parameter i pageOptions-oversigten (f.eks. “query”: myQuery). Det er det eneste, der kræves, for at annoncer kan vises. Du kan også angive valgfri sideniveau-parametre i sideniveau-blokken og individuelle enhedsniveau-parametre i adblock1- og adblock2-oversigterne.
<div id="afscontainer2"></div>
<script type=" text/javascript" charset="utf-8">
// Parametre på sideniveau
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parametre på enhedsniveau
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Beskrivelser af sideniveau-parametre
Disse parametre skal kun angives en gang pr. side. De påvirker alle annonceenheder på siden.
Påkrævet
| Parameter | Beskrivelse og eksempler |
|---|---|
adPage |
Påkrævet, når brugeren går til næste resultatside eller forrige resultatside
|
pubId |
Påkrævet Dette er dit kunde-id til AdSense. Dit pubId er den del af dit kunde-id, der kommer efter "partner-". Hvis dit kunde-id for eksempel er "partner-test-property", er dit pubId "test-property". Dette er standardprotokol for tilpasset søgeannonce. Eksempel: 'pubId' : 'test-property' |
query |
Påkrævet Det er den søgeforespørgsel, brugeren har indtastet. Værdien af query-parameteren bør ikke være kodet. Eksempler:
|
referrerAdCreative |
Påkrævet (hvis der anskaffes trafik) Hvis en bruger kommer til din indholdsside, som indeholder en relateret søgning til indholdsenhed, fra en kilde, der er under din kontrol (herunder ethvert tredjepartsnetværk, enhver tredjepartstjeneste eller ethvert affiliateprogram, du samarbejder med), skal denne parameter angives for annonceteksten for den pågældende kilde ordret. Nedenstående retningslinjer gælder for brugen af denne parameter:
Bemærk! Denne parameter er påkrævet, når du bruger parameteren
terms.Eksempler: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageBaseUrl |
Påkrævet, når der er relaterede søgemaskiner på siden Angiver webadressen for den søgeresultatside, hvor søgeforespørgslen er den relaterede søgeterm, som brugeren har klikket på. resultsPageBaseUr kan indeholde sine egne parametre, undtagen den søgeforespørgsel, der tilføjes automatisk.
Eksempel:
|
styleId |
Påkrævet Angiver id'et for den søgestil, der skal anvendes på annoncen eller relaterede søgeenheder på siden. Få flere oplysninger om brug af søgestile. Bemærk! Når styleId er angivet for en anmodning, gengives annoncer eller relaterede søgninger med stilen, og ældre stilparametre ignoreres. Hvis styleId ikke er angivet i anmodningen, gengives et systemstandard-layout. Eksempel
|
Valgfri
| Parameter | Beskrivelse og eksempler |
|---|---|
linkTarget |
Valgfrit Angiver, om klik på en annonce åbnes i samme vindue eller et nyt vindue. Standarden er "_top". Denne parameter kan også bruges på enhedsniveau.
Eksempel: 'linkTarget' : '_blank' |
maxTermLength |
Valgfrit Angiver det maksimale antal tegn i en relateret søgeterm, herunder mellemrum. Intet maksimum, hvis der ikke er angivet noget. Eksempel: 'maxTermLength' : 50 |
resultsPageQueryParam |
Valgfrit Angiver navnet på webadresseparameteren for søgeforespørgslen på søgeresultatsiden. Angives som standard til "q", hvis der ikke er angivet nogen. Eksempel: 'resultsPageQueryParam' : 'query' |
termer |
Valgfrit Denne parameter giver dig mulighed for at angive en kommasepareret liste over dine egne relaterede søgetermer, der skal returneres med en relateret søgeforespørgsel, selvom Google muligvis bruger termerne angivet her. Eksempel: 'terms' : 'cars rental, flight ticket' |
Konfigurationsindstillinger
| Parameter | Beskrivelse og eksempler | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Valgfrit Angiver de filtreringsregler for annoncer, som Google skal bruge på søgeforespørgslen. Følgende er de gyldige indstillinger for adsafe og hver værdis effekt på de hentede annoncer:
Bemærk!:
adsafe er som standard sat til 'high'.Eksempel: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Valgfritadtest-parameteren bruges til at angive, at en anmodning om annoncer er en test. Når parameteren adtest har værdien 'on', behandler Google anmodningen som en test, så annoncevisninger bliver ikke talt og klikfrekvensen bliver ikke sporet.
Når Bemærkninger:
Standardværdien for adtest er 'off'. Eksempel: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Valgfrit Du kan inkludere en AdSense til søgning-kanal, hvis du vil spore præstationer for forskellige sider. Brug det unikke kanal-id, du oprettede på din AdSense-konto. Få mere at vide om Sporing af annonceeffektivitet med tilpassede kanaler. Flere kanaler skal adskilles med tegnet "+". Eksempler: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Valgfrit Denne parameter identificerer det sprog, som de anmodede annoncer skal målrettes mod. Standardværdien er 'en'. Google understøtter alle Google Ads API-sprogkoder. Bemærk!: Annoncører angiver de sprog, som de målretter deres annoncer mod. Hvis du indsætter denne parameter i din forespørgsel, vil Google kun returnere annoncer, der er målrettet mod det pågældende sprog eller målrettet mod alle sprog, men det er ikke nogen garanti for, at annonceteksten bliver i det pågældende sprog.
Som regel skal du sætte Eksempler: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Valgfri
Standardværdien for
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Valgfri
Standardværdien for
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Udfaset
Bemærk! Personlig tilpasning af annoncer er nu udfaset for AdSense til søgning. Du kan få flere oplysninger i AdSense til søgning og andre Search Ads-produkter for at bruge nye visningsdomæner og udfase personlig tilpasning af annoncer.
|
Beskrivelser af enhedsniveau-parametre
Disse parametre påvirker den måde, som de enkelte annonceenheder på en side vises på for brugeren. Hver enkelt parameter kan indstilles individuelt for den enkelte annonceenhed.
Påkrævet
| Parameter | Beskrivelse og eksempler |
|---|---|
container |
Påkrævet Id'et for den tomme annoncecontainer <div id='afscontainer1'></div>, hvor annoncen skal vises.
Eksempel: |
Konfigurationsindstillinger
| Parameter | Beskrivelse og eksempler | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Valgfrit Angiver en JavaScript-funktion, der skal kaldes, når annoncerne eller relaterede søgninger er indlæst, eller når der ikke vises nogen annoncer eller relaterede søgninger. Parameteren skal indstilles til en JavaScript-tilbagekaldsfunktion, som du implementerer, hvilket gør det muligt at udføre en handling, når annoncekaldet gennemføres. Tilbagekaldsfunktionen tager følgende parametre:
Bemærk! Test din tilbagekaldsfunktion for at sikre, at den ikke genererer fejl, især fejl, der kan forstyrre indlæsningen af din side.
Eksempel på et JavaScript-tilbagekald: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, adsloaded isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // gør sandsynligvis ingenting } catch (e) { alert ("Fejl i tilbagekaldsfunktion"); // Gør noget for at håndtere fejl på en smart måde } } else { // som du altid gør, når der ikke er nogen annoncedækning fra Google } } }; |
||||||||
maxTop |
Valgfri
Brug denne parameter til at angive antallet af annoncer, der skal vises på den øverste annonceenhed. Bemærk! Denne parameter bruges i stedet for parameteren
number. Denne annonceenhed skal være bred nok til, at den første linje af annoncerne ikke ombrydes. Det er en overtrædelse af politikken at bruge maxTop-parameteren på nogen anden placering på siden.Eksempel: |
||||||||
number |
Valgfrit Antallet af annoncer, der skal vises i denne enhed. Standardværdien er '2'. Eksempel: |
||||||||
relatedSearches |
Valgfrit Antallet af relaterede søgninger, der skal vises i denne enhed. Denne parameter returnerer mindst tre relaterede søgninger, medmindre den er indstillet til nul. Angives som standard til 0, hvis der ikke er angivet noget. Eksempel: 'relatedSearches' : 4 |
||||||||
width |
Valgfrit Angiver bredden på annonceenheden eller en enhed til relateret søgning i pixels. Eksempler: 'width' : '700px''width' : 700 |