För avancerade användare har vi sammanställt denna lista över de sökformatparametrar som stöds för närvarande. Den kod 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 överföra ett värde för query-parametern. Alla övriga parametrar är valfria och beskrivs nedan.
Parametertyper
Det finns två typer av parametrar:
- Parametrar på sidnivå som gäller för alla annonsenheter på sidan
- Parametrar på enhetsnivå som gäller för 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.
Obligatoriskt
| 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 ditt Client-id till exempel är ”partner-test-property” är ditt pubId ”test-property”. Detta är standardprotokollet för CSA. Exempel: 'pubId' : 'test-property' |
query |
Obligatorisk Detta är den sökfråga som användaren anger. Värdet för frågeparametern ska vara okodad. Exempel:
|
resultsPageBaseUrl |
Obligatorisk när det finns relaterade sökenheter på sidan Anger webbadressen till sökresultatsidan där sökfrågan är den relaterade sökterm som användaren har klickat på. resultsPageBaseUr kan ha egna parametrar, med undantag för sökfrågan som läggs till automatiskt.
Exempel:
|
styleId |
Obligatorisk Anger id:t för sökformatet som ska tillämpas 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
|
Valfritt
| Parameter | Beskrivning och exempel |
|---|---|
linkTarget |
Valfri Anger om målsidan öppnas i samma eller ett nytt fönster då man 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 för en relaterad sökterm, inklusive blanksteg. Om inget värde anges finns inget maximalt antal. Exempel: 'maxTermLength' : 50 |
referrerAdCreative |
Valfri Om en användare kommer till din innehållssida som innehåller en relaterad sökning för innehållsenheten 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': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
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 kommaseparerad 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' : 'cars rental, flight ticket' |
Konfigurationsinställningar
| Parameter | Beskrivning och exempel | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Valfri Anger vilka filtreringsregler som 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 Anmärkningar:
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 avgränsas med symbolen +. 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 din 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 |
Valfritt
Parametern Standardvärdet för
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Valfritt
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å
De här parametrarna påverkar hur de enskilda annonsenheterna på en sida visas för användaren. Varje parameter kan anges separat för varje annonsenhet.
Obligatoriskt
| Parameter | Beskrivning och exempel |
|---|---|
container |
Krävs Id för den tomma annonsbehållaren <div id='afscontainer1'></div> där annonsen ska visas.
Exempel: |
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 } } }; |
||||||||
maxTop |
Valfritt
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 istället för parametern
number. Denna annonsenhet måste vara bred nog att annonsernas första rad inte radbryts. Att använda parametern maxTop för någon annan placering på sidan är en överträdelse av policy.Exempel: |
||||||||
number |
Valfri Anger det antal annonser som ska visas i enheten. Standardvärdet är '2'. Exempel: |
||||||||
relatedSearches |
Valfritt Antalet relaterade sökningar som ska visas i denna enhet. 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 |
||||||||
width |
Valfritt Anger annonsenhetens eller den relaterade sökenhetens bredd i pixlar. Exempel: 'width' : '700px''width' : 700 |
