Riferimento

Parametri

Descrizioni dei parametri a livello di pagina

Questi parametri devono essere specificati solo una volta per pagina. Influiscono su tutte le unità nella pagina.

Obbligatorio

Parametro Descrizione ed esempi
adPage Obbligatorio quando l'utente passa alla pagina dei risultati successiva o alla pagina dei risultati precedente.

Il parametro adPage specifica la pagina dei risultati in cui vengono pubblicati gli annunci. Questo parametro viene utilizzato quando gli utenti superano la prima pagina dei risultati di ricerca. Ad esempio, se vengono richiesti cinque annunci e il parametro adPage è impostato su 2, gli annunci restituiti saranno la seconda pagina di cinque annunci.

pubId Obbligatorio
Questo è il tuo ID cliente AdSense. Il tuo pubId è la parte dell'ID cliente che segue "partner-". Ad esempio, se il tuo ID cliente è "partner-test-property", il tuo pubId è "test-property". Si tratta di un protocollo standard per gli annunci associati alla ricerca personalizzati.

Esempio:

'pubId' : 'test-property'

query Obbligatorio
Questa è la query di ricerca inserita dall'utente. Il valore del parametro di query non deve essere codificato.

Esempi:

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query

resultsPageBaseUrl Obbligatorio quando nella pagina sono presenti unità di ricerca correlata.
Specifica l'URL della pagina dei risultati di ricerca in cui la query di ricerca rappresenta il termine di ricerca correlato su cui l'utente ha fatto clic. I risultatiPageBaseUrl possono includere i propri parametri, ad eccezione della query di ricerca, che verrà aggiunta automaticamente.

Esempio:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

styleId Obbligatorio
Specifica l'ID dello stile personalizzato degli annunci associati ai risultati di ricerca da applicare all'annuncio o alle unità di ricerca correlata nella pagina. Scopri di più sull'utilizzo degli stili personalizzati degli annunci associati ai risultati di ricerca. Tieni presente che, con lo styleId impostato per una richiesta, gli annunci o le ricerche correlate verranno visualizzati con lo stile e i parametri di stile precedenti verranno ignorati. Se styleId non è specificato nella richiesta, verrà visualizzato uno stile predefinito di sistema.

Esempio:

'styleId': '1234567890'

Facoltativo

Parametro Descrizione ed esempi
linkTarget Facoltativo
Specifica se i clic su un annuncio vengono visualizzati nella stessa finestra o in una nuova. Il valore predefinito è "_top". Questo parametro può essere utilizzato anche a livello di unità.
  • '_top' si apre nella stessa finestra.
  • '_blank' Si apre in una nuova finestra.

Esempio:

'linkTarget' : '_blank'

maxTermLength Facoltativo
Specifica il numero massimo di caratteri di un termine di ricerca correlata, spazi inclusi. Non è prevista una soglia massima se non è impostata.

Esempio:

'maxTermLength' : 50

referrerAdCreative Facoltativo
Se un utente arriva alla tua pagina di contenuti contenente un'unità di Ricerca correlata di contenuti facendo clic su un annuncio o un link su un altro sito web e l'annuncio o il link è sotto il tuo controllo, questo parametro deve essere impostato sul testo della creatività dell'annuncio o del link.

Per l'uso di questo parametro si applicano le seguenti linee guida:

  • Il parametro deve essere fornito solo in una richiesta di Ricerca correlata di contenuti e verrà ignorato in tutte le altre richieste.
  • Deve essere utilizzato solo per il traffico proveniente intenzionalmente da altri siti web e non può mai essere utilizzato per il traffico organico.
  • Può includere la riga del titolo e/o la descrizione della creatività dell'annuncio o del link.
  • Non fa distinzione tra maiuscole e minuscole.
  • Accetta una codifica UTF-8 valida; sono supportati caratteri Unicode / segni diacritici.
  • Google potrebbe utilizzare o ignorare il parametro specificato. Quando utilizzato, potrebbe influire sulla selezione e sul ranking dei termini.

Esempi:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

resultsPageQueryParam Facoltativo
Specifica il nome del parametro URL per la query di ricerca nella pagina dei risultati di ricerca. Se non specificato, il valore predefinito è "q".

Esempio:

'resultsPageQueryParam' : 'query'

terms Facoltativo
Questo parametro consente di fornire un elenco delimitato da virgole dei termini di ricerca correlati da restituire con una richiesta di ricerca correlata, anche se Google potrebbe utilizzare o meno i termini qui forniti.

Esempi:

'terms' : 'cars rental, flight ticket'

Impostazioni configurazione

Parametro Descrizione ed esempi
adsafe Facoltativo
Specifica le regole di filtro che Google deve applicare agli annunci corrispondenti alla query di ricerca. Di seguito sono riportate le impostazioni valide per adsafe e l'effetto di ciascun valore sugli annunci restituiti:
  • 'high' restituisce annunci adatti ai minori. Non restituisce annunci non adatti ai minori o con contenuti di natura sessuale per adulti.
  • 'medium' restituisce annunci adatti ai minori e non. Non restituisce annunci con contenuti di natura sessuale per adulti.
  • 'low' restituisce tutti i tipi di annunci.

Il valore predefinito di adsafe è alto.

Esempio:

'adsafe': 'medium'

adtest Facoltativo
Il parametro adtest viene utilizzato per indicare che una richiesta di annunci è un test. Quando il parametro adtest ha il valore on, Google tratta la richiesta come un test e non conteggia le impressioni dell'annuncio né monitora i risultati dei clickthrough.

Quando il parametro adtest ha il valore on, non vengono generate entrate.

Utilizza questo parametro durante i test, ma non nei sistemi di produzione, altrimenti non riceverai pagamenti per gli annunci che pubblichi.

Il valore predefinito di adtest è disattivato.

Esempio:

'adtest' : 'on'

channel Facoltativo
Puoi includere un canale AdSense per la ricerca per monitorare il rendimento di pagine diverse. Utilizza l'ID canale univoco creato nel tuo account AdSense o dal tuo Technical Account Manager. Scopri di più sui canali qui.

Più canali devono essere separati dal simbolo "+".

Esempi:

'channel' :  'testA'  
'channel' :  'testA+testB'  

hl Facoltativo
Questo parametro identifica la lingua target degli annunci richiesti o delle ricerche correlate. Il valore predefinito è en.

Google supporta tutti i codici lingua dell'API di AdWords.

Nota: gli inserzionisti specificano le lingue target dei loro annunci. Se includi questo parametro nella tua richiesta, Google restituirà solo annunci che hanno come target quella lingua o che hanno come target tutte le lingue, ma non garantisce che il testo dell'annuncio sarà nella lingua specificata.

In genere, devi impostare il parametro hl sulla lingua principale della pagina da cui viene inviato questo parametro.

Esempi:

'hl' : 'es'

ie Facoltativo

Il parametro ie imposta lo schema di codifica dei caratteri da utilizzare per interpretare la stringa di query.

Il valore predefinito di ie è utf-8.

Valore Nome standard Lingue supportate associate
latin1 ISO-8859-1 Europa occidentale (catalano, danese, olandese, inglese, finlandese, francese, tedesco, indonesiano, italiano, norvegese, portoghese, spagnolo, svedese)
latin2 ISO-8859-2 Europa orientale (Croato, Ceco, Polacco, Rumeno, Serbo, Slovacco, Sloveno, Ungherese)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltico (estone, lettone, lituano)
cirillico ISO-8859-5 Bulgaro, russo
arabic ISO-8859-6  
greco/greca ISO-8859-7 Greco
hebrew ISO-8859-8 Ebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandese
euc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sji Shift_JIS Giapponese
big5 Big5 Cinese tradizionale
gb GB2312 Cinese semplificato
utf-8 UTF-8 Tutte
oe Facoltativo

Il parametro oe imposta la codifica dei caratteri che Google deve utilizzare per codificare il testo degli annunci. Anche se tecnicamente è facoltativo, è buona norma passare un valore per questo parametro.

Il valore predefinito di oe è utf-8.

Valore Nome standard Lingue supportate associate
latin1 ISO-8859-1 Europa occidentale (catalano, danese, olandese, inglese, finlandese, francese, tedesco, indonesiano, italiano, norvegese, portoghese, spagnolo, svedese)
latin2 ISO-8859-2 Europa orientale (Croato, Ceco, Polacco, Rumeno, Serbo, Slovacco, Sloveno, Ungherese)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltico (estone, lettone, lituano)
cirillico ISO-8859-5 Bulgaro, russo
arabic ISO-8859-6  
greco/greca ISO-8859-7 Greco
hebrew ISO-8859-8 Ebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandese
euc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sji Shift_JIS Giapponese
gb GB2312 Cinese semplificato
utf-8 UTF-8 Tutte
ivt Facoltativo
Questo parametro ti consente di fornire un valore booleano che indichi a Google che vuoi consentire gli annunci che utilizzano un cookie di solo rilevamento del traffico non valido e uno spazio di archiviazione locale per il traffico con e senza consenso.
  • true Se questo parametro non è presente o lo imposti su "true", imposteremo un cookie di solo traffico non valido e utilizzeremo lo spazio di archiviazione locale solo per il traffico per cui è stato dato il consenso.
  • false Se imposti questo parametro su "false", imposteremo un cookie di solo traffico non valido e utilizzeremo lo spazio di archiviazione locale per il traffico con e senza consenso.

Per impostazione predefinita, l'IVT è impostato su true.

Esempio:

'ivt': false

Descrizioni dei parametri a livello di unità

Questi parametri influiscono sul modo in cui le singole unità pubblicitarie in una pagina vengono presentate all'utente. Ogni parametro può essere impostato singolarmente per ciascuna unità pubblicitaria.

Obbligatorio

Parametro Descrizione ed esempi
container Obbligatorio
L'ID del contenitore di annunci vuoto <div> in cui deve essere pubblicato l'annuncio.

Esempio:

'container' : 'afscontainer1'

maxTop Obbligatorio quando l'unità pubblicitaria si trova sopra i risultati di ricerca.

Utilizza questo parametro per specificare il numero di annunci da pubblicare nell'unità pubblicitaria superiore.

Nota: questo parametro viene utilizzato al posto di "number". L'unità pubblicitaria deve essere sufficientemente larga da evitare che la prima riga degli annunci vada a capo. L'utilizzo del parametro maxTop in qualsiasi altro posizionamento nella pagina costituisce una violazione delle norme.

Esempio:

'maxTop' : 4
width Obbligatorio
Specifica la larghezza in pixel dell'annuncio o dell'unità di ricerca correlata.

Esempio:

'width' : '700px'
'width' : 700

Impostazioni configurazione

Parametro Descrizione ed esempi
adLoadedCallback Facoltativo
Specifica una funzione JavaScript da chiamare quando gli annunci o le ricerche correlate sono stati caricati o quando non vengono pubblicati annunci o ricerche correlate. Il parametro deve essere impostato su una funzione di callback JavaScript da te implementata, che consente di eseguire un'azione al termine della chiamata dell'annuncio.

La funzione di callback accetta i seguenti parametri:

containerName Nome del contenitore dell'annuncio o dell'unità di ricerca correlata.
adsLoaded Imposta il valore su true quando c'è almeno un annuncio o un termine di ricerca correlato da visualizzare e su false quando non vengono restituiti annunci o ricerche correlate.
isExperimentVariant Imposta il valore su true se è in corso un esperimento sugli stili personalizzati e viene scelta la variante dell'esperimento per visualizzare gli annunci.
callbackOptions Un oggetto JSON che contiene i seguenti campi:
termPositions: per un blocco di ricerca correlata, contiene una map<string,int> dei termini forniti dal publisher alla posizione indicizzata zero di questi termini nella risposta. Se un termine viene fornito ma non restituito, non verrà visualizzato nella mappa.

Nota: verifica la funzione di callback per assicurarti che non generi errori, in particolare quelli che potrebbero interferire con il caricamento della pagina.

Esempio di callback JavaScript:

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 Facoltativo
Il numero di annunci da pubblicare in questa unità. Il valore predefinito è 2.

Esempio:

'number' : 4

relatedSearches Facoltativo
Il numero di ricerche correlate che devono essere visualizzate in questa unità. Se non specificato, il valore predefinito è 0.

Esempio:

'relatedSearches' : 4