Den här listan över sökformatparametrar som stöds är avsedd för avancerade användare. Koden du genererar i AdSense innehåller alla de vanligaste parameterinställningarna. Det finns två obligatoriska parametrar: pubId
och query
. AdSense tillhandahåller pubId, men du måste redigera koden och skicka med ett värde på query
-parametern. Alla övriga parametrar är valfria och beskrivs nedan.
Typer av parametrar
Det finns två typer av parametrar:
- parametrar på sidnivå som tillämpas på alla annonsenheter på sidan
- parametrar på enhetsnivå som tillämpas på enskilda annonsenheter
Här är några exempel på utdata från kodgeneratorn med två annonsblock. För att konfigurera denna kod måste du ställa in den obligatoriska query
-parametern i pageOptions
-kartan (t.ex. “query”: myQuery
). Det är allt som krävs för att börja visa annonser. Du kan även ställa in valfria parametrar på sidnivå i sidnivåblocket och parametrar för enskilda enheter i mappningarna adblock1
och adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Beskrivning av parametrar på sidnivå
Du behöver bara ange dessa parametrar en gång per sida. De påverkar alla annonsenheter på sidan.
Krävs
Parameter | Beskrivning och exempel |
---|---|
adPage |
Krävs när användaren navigerar till nästa eller föregående resultatsida
Parametern |
pubId |
Obligatorisk Detta är ditt Client-ID för AdSense. Ditt pubId är den del av ditt Client-ID som kommer efter ”partner-”. Om Client-id till exempel är ”partner-test-property” är pubId ”test-property”. Detta är standardprotokollet för CSA. Exempel: 'pubId' : 'test-property' |
query |
Obligatorisk Detta är användarens sökfråga. Värdet på frågeparametern ska vara okodad. Exempel:
|
resultsPageBaseUrl |
Obligatorisk när det finns enheter för relaterad sökning på sidan Anger webbadressen till sökresultatsidan där sökfrågan är den relaterade sökterm som användaren har klickat på. resultsPageBaseUrl kan ha egna parametrar, med undantag för sökfrågan som läggs till automatiskt.
Exempel:
|
styleId |
Obligatorisk Anger id:t för det sökformat som ska användas på annonsen eller relaterade sökenheter på sidan. Läs mer om hur du använder sökformat. Observera att med styleId angivet för en begäran renderas annonser eller relaterade sökningar med det formatet och äldre formatparametrar ignoreras. Om styleId inte har angetts i begäran återges ett format som är standard för systemet. Exempel
|
Valfri
Parameter | Beskrivning och exempel |
---|---|
linkTarget |
Valfri Anger om målsidan öppnas i samma eller ett nytt fönster när användaren klickar på annonsen. Standard är '_top'. Denna parameter kan även användas på enhetsnivå.
Exempel: 'linkTarget' : '_blank' |
maxTermLength |
Valfri Anger det högsta antalet tecken i en relaterad sökterm, inklusive blanksteg. Om inget värde anges finns ingen maxgräns. Exempel: 'maxTermLength' : 50 |
referrerAdCreative |
Valfri Om en användare kommer till din innehållssida som innehåller en enhet för relaterad sökning genom att klicka på en annons eller länk på en annan webbplats och du har kontroll över annonsen eller länken, ska denna parameter vara den ordagranna texten i annonsen eller länken. Följande riktlinjer gäller för användning av denna parameter:
Exempel: 'referrerAdCreative': 'sökning efter annonser relaterade till tandimplantat' 'referrerAdCreative': 'Tidiga tecken på psoriasisartrit' |
resultsPageQueryParam |
Valfri Anger namnet på webbadressparametern för sökfrågan på sökresultatsidan. Standardvärdet är 'q' om inget annat anges. Exempel: 'resultsPageQueryParam' : 'query' |
terms |
Valfri Med den här parametern kan du ange en kommaavgränsad lista över dina egna relaterade söktermer som ska returneras med en relaterad sökbegäran. Det kan dock hända att Google inte använder de termer som anges här. Exempel: 'terms' : 'hyrbil, flygbiljett' |
Konfigurationsinställningar
Parameter | Beskrivning och exempel | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Valfri Anger vilka filtreringsregler Google ska använda för annonser som matchar sökfrågan. Följande är de giltiga inställningarna för adsafe och den effekt varje värde har på returnerade annonser:
Obs! Som standard är
adsafe inställt på 'high'.Exempel: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Valfri Parametern adtest används för att indikera att en annonsbegäran är ett test. När parametern adtest har värdet 'on' behandlar Google begäran som ett test och räknar inte annonsexponeringarna och spårar inte heller den resulterande klickfrekvensen.
När parametern Obs! Använd den här parametern vid testning. Använd den inte på den faktiska webbsidan eftersom du då inte får betalt för annonser som du visar.
Standardvärdet för adtest är 'off'. Exempel: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Valfri Du kan använda en AdSense for Search-kanal för att spåra resultatet av olika sidor. Använd det unika kanal-id som du skapade i ditt AdSense-konto. Läs mer om hur du spårar annonsresultat med anpassade kanaler. Flera kanaler ska avgränsas med plustecken (+). Exempel: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Valfri Den här parametern anger det språk som de begärda annonserna ska inriktas på. Standardvärdet är 'en'. Google har stöd för alla Google Ads API-språkkoder. Obs! Annonsörer anger språken som deras annonser inriktas på. Om du tar med denna parameter i begäran returnerar Google bara annonser som är inriktade på det språket eller på alla språk. Det finns dock ingen garanti för att annonstexten visas på det angivna språket.
Vanligen bör du ställa in parametern Exempel: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Valfri
Parametern Standardvärdet för
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Valfri
Parametern Standardvärdet för
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Valfri Anger om användarna har samtyckt till att låta utgivaren dela personliga uppgifter med Google specifikt för anpassade annonser.
Obs! Standardinställningen för
personalizedAds är 'true'.Exempel: 'personalizedAds': false |
Beskrivning av parametrar på enhetsnivå
Dessa parametrar påverkar hur de enskilda annonsenheterna på en sida visas för användaren. Varje parameter kan anges separat för varje annonsenhet.
Krävs
Parameter | Beskrivning och exempel |
---|---|
container |
Krävs Id för den tomma annonsbehållaren <div id='afscontainer1'></div> där annonsen ska visas.
Exempel:
|
maxTop |
Krävs
Använd den här parametern för att ange det antal annonser som ska visas i den översta annonsenheten. Obs!Denna parameter används i stället för parametern
number . Annonsenheten måste vara bred nog för att annonsernas första rad inte ska radbrytas. Att använda parametern maxTop för någon annan placering på sidan utgör en policyöverträdelse.Exempel:
|
width |
Obligatorisk Anger annonsenhetens eller den relaterade sökenhetens bredd i pixlar. Exempel: 'width' : '700px' 'width' : 700 |
Konfigurationsinställningar
Parameter | Beskrivning och exempel | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Valfri Anger en JavaScript-funktion som ska anropas när annonserna eller relaterade sökningar har lästs in eller när inga annonser eller relaterade sökningar visas. Parametern ska ställas in på en JavaScript-återanropsfunktion som du implementerar och som gör att en åtgärd kan utföras när annonsanropet är klart. Återanropsfunktionen tar följande parametrar:
Obs! Testa återanropsfunktionen och kontrollera att den inte genererar några fel, i synnerhet fel som kan störa inläsningen av sidan.
Exempel på ett JavaScript-återanrop: 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 |
Valfri Anger det antal annonser som ska visas i enheten. Standardvärdet är '2'. Exempel:
|
||||||||
relatedSearches |
Valfri Antalet relaterade sökningar som ska visas i enheten. Denna parameter returnerar minst tre relaterade sökningar om den inte är inställd på noll. Anges som 0 som standard om inget annat anges. Exempel: 'relatedSearches' : 4 |