Pentru utilizatorii avansați, am pus la dispoziție această listă cu parametri acceptați pentru stilul de căutare. Codul pe care îl generați în AdSense conține toate setările folosite cel mai frecvent pentru parametri. Există doi parametri obligatorii: pubId
și query
. AdSense specifică parametrul pubId, însă dvs. trebuie să modificați codul și să atribuiți o valoare pentru parametrul query
. Restul parametrilor sunt opționali și sunt descriși mai jos.
Tipurile de parametri
Există două tipuri de parametri:
- parametri la nivel de pagină, care se aplică tuturor unităților de anunțuri din pagină;
- parametri la nivel de unitate, care se aplică unităților de anunțuri individuale.
Iată câteva exemple de rezultate din generatorul de coduri cu două blocuri de anunțuri. Pentru a configura acest cod, trebuie să setați parametrul obligatoriu query
în funcția pageOptions
(de exemplu, “query”: myQuery
). Este suficient pentru a începe să afișați anunțuri. În plus, puteți să setați parametri opționali la nivel de pagină în blocul la nivel de pagină și parametri la nivel de unitate individuală în funcțiile adblock1
și adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parametri la nivel de pagină
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parametri la nivel de unitate
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Descrierea parametrilor la nivel de pagină
Este suficient ca acești parametri să fie specificați o singură dată în fiecare pagină. Aceștia afectează toate unitățile de anunțuri din pagină.
Obligatoriu
Parametru | Descriere și exemple |
---|---|
adPage |
Obligatoriu atunci când utilizatorul navighează la următoarea pagină cu rezultate sau la pagina anterioară cu rezultate
Parametrul |
pubId |
Obligatoriu Acesta este codul dvs. de client AdSense. Parametrul pubId este partea din codul de client care urmează după „partner-”. De exemplu, în cazul în care codul dvs. de client este „partner-test-property”, parametrul pubId este „test-property”. Acesta este protocolul standard pentru anunțurile personalizate afișate în Rețeaua de căutare. Exemplu: 'pubId' : 'test-property' |
query |
Obligatoriu Acesta este termenul de căutare introdus de utilizator. Valoarea parametrului query nu trebuie să fie codificată. Exemple:
|
resultsPageBaseUrl |
Obligatoriu când există unități de căutare similară în pagină Specifică adresa URL a paginii cu rezultatele căutării în care termenul de căutare este termenul de căutare similară pe care a dat clic utilizatorul. Parametrul resultsPageBaseUr poate include proprii parametri, cu excepția termenului de căutare care va fi anexat automat.
Exemplu:
|
styleId |
Obligatoriu Este specificat codul stilului de căutare care trebuie aplicat anunțului sau unităților de căutare similară din pagină. Aflați mai multe despre folosirea stilurilor de căutare. Rețineți că, dacă styleId este setat pentru o solicitare, anunțurile sau căutările similare vor fi redate împreună cu stilul, iar parametrii de stil vechi vor fi ignorați. Dacă styleId nu este specificat în solicitare, va fi redat un stil prestabilit de sistem. Exemplu
|
Opțional
Parametru | Descriere și exemple |
---|---|
linkTarget |
Opțional Specifică dacă un clic pe un anunț se deschide în aceeași fereastră sau într-o fereastră nouă. Valoarea prestabilită este „_top”. Acest parametru poate fi folosit și la nivel de unitate.
Exemplu: 'linkTarget' : '_blank' |
maxTermLength |
Opțional Specifică numărul maxim de caractere ale unui termen de căutare similară, inclusiv spațiile. Nu există o valoare maximă dacă parametrul nu este setat. Exemplu: 'maxTermLength' : 50 |
referrerAdCreative |
Opțional Dacă un utilizator ajunge pe pagina dvs. de conținut ce include o unitate „Căutare similară pentru conținut” deoarece a dat clic pe un anunț sau pe un link de pe un alt site, iar anunțul sau linkul respectiv se află sub controlul dvs., acest parametru trebuie setat la textul exact al materialului publicitar din anunțul sau linkul respectiv. Următoarele reguli se aplică pentru folosirea acestui parametru:
Exemple: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Opțional Specifică numele parametrului URL pentru termenul de căutare din pagina cu rezultatele căutării. Dacă nu este specificată, valoarea prestabilită va fi „q”. Exemplu: 'resultsPageQueryParam' : 'query' |
terms |
Opțional Acest parametru vă permite să trimiteți o listă separată prin virgulă cu proprii termeni de căutare similară care vor fi afișați cu o solicitare de căutare similară, deși Google poate sau nu să folosească termenii respectivi. Exemplu: 'terms' : 'cars rental, flight ticket' |
Setări de configurare
Parametru | Descriere și exemple | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Opțional Specifică regulile de filtrare pe care Google trebuie să le aplice în cazul anunțurilor care corespund termenului de căutare. Mai jos sunt setările valide pentru adsafe și efectul pe care fiecare valoare îl are asupra anunțurilor afișate:
Notă: în mod prestabilit,
adsafe este setat la „high”.Exemplu: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Opțional Parametrul adtest este folosit pentru a indica faptul că o solicitare de anunțuri este un test. Când parametrul adtest are valoarea „on”, Google tratează solicitarea ca test, astfel încât nu contorizează afișările anunțurilor și nu urmărește rezultatele clicurilor.
Când parametrul Note:
Valoarea prestabilită pentru parametrul adtest este „off”. Exemplu: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Opțional Puteți să includeți un canal AdSense pentru căutare pentru a urmări performanța diferitelor pagini. Folosiți ID-ul unic al canalului pe care l-ați creat în contul dvs. AdSense. Aflați mai multe despre urmărirea performanței anunțurilor cu ajutorul canalelor personalizate. Canalele trebuie să fie separate prin simbolul „+”. Exemple: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Opțional Acest parametru identifică limba pe care ar trebui să o vizeze anunțurile solicitate. Valoarea standard este „en”. Google acceptă toate codurile de limbă pentru API-ul Google Ads. Notă: advertiserii indică limbile către care sunt direcționate anunțurile lor. Dacă includeți acest parametru în solicitarea dvs., Google afișează numai anunțurile direcționate pentru limba respectivă sau pentru toate limbile, dar nu garantează că textul publicitar va fi în limba specificată.
În mod obișnuit, trebuie să setați parametrul Exemple: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Opțional
Parametrul Valoarea prestabilită pentru parametrul
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Opțional
Parametrul Valoarea
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Opțional Specifică dacă utilizatorii i-au permis editorului să trimită informații cu caracter personal la Google în scopuri de publicitate personalizată.
Notă: în mod prestabilit, parametrul
personalizedAds este setat la „true”.Exemplu: 'personalizedAds': false |
Descrierea parametrilor la nivel de unitate
Acești parametri afectează modul în care unitățile de anunțuri individuale dintr-o pagină sunt prezentate utilizatorului. Fiecare parametru poate fi setat individual pentru fiecare unitate de anunțuri.
Obligatoriu
Parametru | Descriere și exemple |
---|---|
container |
Obligatoriu Codul containerului de anunțuri gol <div id='afscontainer1'></div> unde trebuie să se afișeze anunțul.
Exemplu:
|
Setări de configurare
Parametru | Descriere și exemple | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Opțional Specifică o funcție JavaScript care trebuie apelată când se încarcă anunțurile sau căutările similare ori când nu se difuzează anunțuri sau căutări similare. Parametrul trebuie setat la o funcție callback JavaScript pe care o implementați, care permite efectuarea unei acțiuni la finalizarea apelului pentru anunț. Funcția callback are următorii parametri:
Notă: testați funcția callback pentru a vă asigura că nu generează erori, în special erori care ar putea să afecteze încărcarea paginii.
Exemplu de callback JavaScript: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // cel mai probabil nicio acțiune } catch (e) { alert ("Error in callback function"); // efectuați o acțiune pentru a remedia eficient eroarea } } else { // cum procedați de obicei când nu există o acoperire a anunțurilor de la Google } } }; |
||||||||
maxTop |
Opțional
Folosiți acest parametru pentru a specifica numărul de anunțuri de afișat în unitatea de anunțuri superioară. Notă: acest parametru este folosit în locul parametrului
number . Unitatea de anunțuri trebuie să fie suficient de lată pentru ca primul rând de anunțuri să nu fie continuat pe următorul rând. Folosirea parametrului maxTop în orice altă poziție în pagină constituie o încălcare a politicii.Exemplu:
|
||||||||
number |
Opțional Numărul de anunțuri care ar trebui să apară în această unitate. Valoarea prestabilită este „2”. Exemplu:
|
||||||||
relatedSearches |
Opțional Numărul de căutări similare care ar trebui să apară în această unitate. Acest parametru returnează cel puțin trei căutări similare, cu excepția cazului în care este setat la zero. Dacă nu este specificat, valoarea prestabilită este 0. Exemplu: 'relatedSearches' : 4 |
||||||||
width |
Opțional Specifică lățimea unității de anunțuri sau a unității de căutare similară în pixeli. Exemple: 'width' : '700px' 'width' : 700 |