Riferimento

Parametri

Descrizioni dei parametri a livello di pagina

Questi parametri obbligatori devono essere specificati solo una volta per pagina. Interessano tutte le unità pubblicitarie nella pagina.

Obbligatorio

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

Il parametro adPage specifica la pagina dei risultati in cui vengono visualizzati gli annunci. Questo parametro viene utilizzato quando gli utenti esplorano i risultati di ricerca successivi a quelli nella prima pagina. Ad esempio, se vengono richiesti 5 annunci e il parametro adPage è impostato su 2, gli annunci restituiti saranno quelli nella seconda pagina.

pubId Obbligatorio
Questo è il tuo ID cliente AdSense. Il tuo pubId è la parte del tuo ID cliente che si trova dopo 'partner-'. Ad esempio, se l'ID cliente è 'partner-test-property', il pubId è 'test-property'. Questo è un protocollo standard per gli Annunci associati alla ricerca personalizzati.

Esempio: 

'pubId' : 'test-property'
query Obbligatorio, tranne nella Ricerca di contenuti correlata.
Questa è la query di ricerca inserita dall'utente. Il valore del parametro query non deve essere codificato.

Nota: l'utilizzo di questo parametro nella ricerca di contenuti correlata nelle pagine di contenuti causerà risultati imprevisti.

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 correlate.
Specifica l'URL della pagina dei risultati di ricerca in cui la query di ricerca è il termine di ricerca correlato su cui l'utente ha fatto clic. resultsPageBaseUrl può includere parametri propri, ad eccezione della query di ricerca che verrà aggiunta automaticamente.

Esempio: 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting Obbligatorio quando nella pagina sono presenti unità di ricerca correlate.
Questo parametro è obbligatorio quando vengono richieste unità di ricerca correlate. Controlla il tipo di esperienza di ricerca di annunci correlata visualizzata, a seconda del contesto della pagina:
  • 'content' Utilizza questa opzione per la ricerca di contenuti correlati nelle pagine di contenuti (ad es. articoli, post del blog).
  • 'query' Utilizza questa opzione esclusivamente per la ricerca di annunci correlata nelle pagine dei risultati di ricerca.

Nota:per impostazione predefinita, il parametro della pagina relatedSearchTargeting è impostato automaticamente su "query". Tuttavia, è fondamentale notare che questo valore predefinito è progettato specificamente solo per le pagine dei risultati di ricerca (Ricerca di annunci correlata nella Ricerca). Se utilizzi la ricerca di contenuti correlata su qualsiasi altro tipo di pagina (ad es. articoli, post del blog), devi impostare esplicitamente il parametro su "content".

Nota:le seguenti linee guida si applicano all'utilizzo di questo parametro:

  • Alcune funzionalità di ricerca correlate possono essere attivate o disattivate a seconda del valore di questo parametro pagina.
  • La rappresentazione ingannevole del tipo di pagina o il ricorso all'impostazione predefinita "query" per il parametro relatedSearchTargeting nelle pagine diverse dai risultati di ricerca è considerata una violazione di queste istruzioni scritte.
  • Google potrebbe verificare periodicamente l'accuratezza di questo valore, indipendentemente dal fatto che sia impostato manualmente o utilizzando il valore predefinito.

Esempi:

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

Esempio: 

'styleId': '1234567890'

Facoltativo

Parametro Descrizione ed esempi
linkTarget Facoltativo
Specifica se facendo clic su un annuncio la destinazione viene aperta 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'
referrerAdCreative Facoltativo
Se un utente arriva alla tua pagina di contenuti dove si trova un'unità di ricerca di contenuti correlata facendo clic su un annuncio o un link su un altro sito web e quell'annuncio o link è sotto il tuo controllo, questo parametro deve essere impostato sul testo della creatività dell'annuncio o del link in questione.

Le seguenti linee guida si applicano all'uso di questo parametro:

  • Il parametro deve essere fornito solo in una richiesta di ricerca di contenuti correlata e verrà ignorato in tutte le altre richieste.
  • Deve essere utilizzato solo per il traffico che ricevi intenzionalmente da altri siti web e non deve essere utilizzato per il traffico organico.
  • Deve includere la riga del titolo, la descrizione e/o qualsiasi altra formulazione presente nell'annuncio o nella creatività del link.
  • L'omissione di valori dalla creatività dell'annuncio o del link (o l'inclusione di valori aggiuntivi) è considerata una violazione di queste istruzioni scritte.
  • Non fa distinzione tra maiuscole e minuscole.
  • Accetta una codifica UTF-8 valida. Sono supportati caratteri Unicode o segni diacritici.
  • Google potrebbe utilizzare o ignorare il parametro da te inviato. Se utilizzato, potrebbe influire sulla selezione e sul ranking dei termini.

Nota: questo parametro è obbligatorio quando si utilizza il parametro terms.

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 separato da virgole dei termini di ricerca correlati da restituire per una richiesta di ricerca correlata. Google potrebbe non utilizzare i termini forniti qui.

Nota:quando utilizzi questo parametro, anche referrerAdCreative è obbligatorio e relatedSearchTargeting è obbligatorio e deve essere impostato su "content".

Esempi: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams Facoltativo
Specifica l'elenco dei parametri URL per una pagina di contenuti con un'unità di ricerca di contenuti correlata che può essere ignorata in tutta sicurezza senza influire sui contenuti principali o sull'esperienza utente.

Nota: prima che i termini di ricerca correlata possano essere visualizzati sul tuo sito, Google deve eseguire la scansione delle tue pagine per verificare che i termini siano pertinenti al contesto. Quando una pagina non è stata ancora sottoposta a scansione dal crawler di AdSense o la scansione è bloccata (ad es. da un file robots.txt), non mostreremo i termini di ricerca correlata suggeriti che fornisci a Google.

Il prodotto Ricerca di contenuti correlata si basa sul sistema di scansione dei contenuti di Google per indicizzare le pagine e generare termini di ricerca pertinenti. Gli URL delle pagine di contenuti contenenti parametri di query, come variabili di monitoraggio, ID utente, ID sessione o altri identificatori dinamici, possono interferire con la capacità del crawler di valutare i contenuti principali della pagina e possono portare a termini di ricerca correlati inaccurati o irrilevanti. Questo parametro della pagina indica al crawler di Google di ignorare questi parametri non essenziali, garantendo un'indicizzazione corretta dei contenuti e riducendo il carico di scansione non necessario. In questo modo, Google può riconoscere meglio una pagina come già sottoposta a scansione e iniziare a mostrare i termini suggeriti (sia di Google sia del partner, se idoneo).

Le seguenti linee guida si applicano all'uso di questo parametro:

  • Il parametro deve essere fornito solo in una richiesta di ricerca di contenuti correlata e verrà ignorato in tutte le altre richieste.
  • Il valore di questo parametro deve essere un elenco di parametri URL separati da virgole che possono essere visualizzati quando un utente accede alla pagina dei contenuti.
  • Fa distinzione tra maiuscole e minuscole.
  • Quando un parametro URL di questo elenco viene rimosso dall'URL della pagina dei contenuti, non dovrebbe esserci un impatto significativo sui contenuti, sull'aspetto o sull'esperienza utente delle pagine.
  • L'inclusione di un parametro URL che influisce in modo significativo sui contenuti, sull'aspetto o sull'esperienza utente delle pagine è considerata una violazione di queste istruzioni scritte.
  • Google potrebbe verificare periodicamente l'effetto dell'ignorare i parametri URL forniti.

Esempi:
Un utente visita una pagina di contenuti e l'URL è: 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
 Fornire i seguenti parametri URL ignorabili: 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
 Tratterebbe l'URL della pagina dei contenuti come: 
http://example.com/content?page_id=123

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 vengono riportate le impostazioni valide per adsafe e l'effetto di ogni valore sugli annunci restituiti:
  • 'high' Restituisce annunci adatti ai minori. Non restituisce annunci con contenuti di natura sessuale per adulti o non adatti ai minori.
  • 'medium' Restituisce annunci adatti ai minori e non adatti ai minori. Non restituisce annunci con contenuti di natura sessuale per adulti.
  • 'low' Restituisce tutti i tipi di annunci.

Per impostazione predefinita, adsafe è impostato su high.

Esempio: 

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

Se il valore del parametro adtest è on, non vengono generate entrate.

Le richieste di annunci con il parametro adtest impostato su on provenienti da un dominio che non è stato approvato nella scheda Siti restituiranno annunci contenenti un overlay "annuncio di prova" e su cui non sarà possibile fare clic.

Utilizza questo parametro per eseguire test, ma non in sistemi di produzione, altrimenti non riceverai pagamenti per gli annunci pubblicati.

Il valore predefinito di adtest è off.

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.

Se vuoi specificare più canali, separali con il simbolo '+'.

Esempi: 

'channel' :  'testA'  
'channel' :  'testA+testB'
hl Facoltativo
Questo parametro identifica la lingua target degli annunci o delle ricerche correlate richiesti. Il valore predefinito è en.

Google supporta tutti i codici lingua dell'API 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 la lingua specificata o tutte le lingue, ma non garantisce che il testo degli annunci verrà visualizzato nella lingua indicata.

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 corrispondenti
latin1 con codifica ISO-8859-1 Europa occidentale (catalano, danese, finlandese, francese, indonesiano, inglese, italiano, norvegese, olandese, portoghese, spagnolo, svedese, tedesco)
latin2 ISO-8859-2 Europa orientale (ceco, croato, polacco, rumeno, serbo, slovacco, sloveno, ungherese)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Regione baltica (estone, lettone, lituano)
cirillico ISO-8859-5 Bulgaro, russo
arabic ISO-8859-6  
greco/greca ISO-8859-7 Greco
ebraico ISO-8859-8 Ebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandese
euc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sjis Shift_JIS Giapponese
big5 Big5 Cinese tradizionale
gb GB2312 Cinese semplificato
utf-8 UTF-8 Tutti
oe Facoltativo

Il parametro oe imposta la codifica dei caratteri che Google deve utilizzare per codificare il testo degli annunci. Tecnicamente è facoltativo, ma conviene specificare un valore per questo parametro.

Il valore predefinito di oe è utf-8.

Valore Nome standard Lingue supportate corrispondenti
latin1 con codifica ISO-8859-1 Europa occidentale (catalano, danese, finlandese, francese, indonesiano, inglese, italiano, norvegese, olandese, portoghese, spagnolo, svedese, tedesco)
latin2 ISO-8859-2 Europa orientale (ceco, croato, polacco, rumeno, serbo, slovacco, sloveno, ungherese)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Regione baltica (estone, lettone, lituano)
cirillico ISO-8859-5 Bulgaro, russo
arabic ISO-8859-6  
greco/greca ISO-8859-7 Greco
ebraico ISO-8859-8 Ebraico
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandese
euc-jp EUC-JP Giapponese
euc-kr EUC-KR Coreano
sjis Shift_JIS Giapponese
gb GB2312 Cinese semplificato
utf-8 UTF-8 Tutti
ivt Facoltativo
Questo parametro ti consente di fornire un valore booleano che comunica a Google che vuoi consentire gli annunci che utilizzano un cookie e uno spazio di archiviazione locale solo per il traffico non valido sia per il traffico con consenso che per quello senza consenso.
  • true Se questo parametro non è presente o lo imposti su "true", imposteremo un cookie solo per il traffico non valido e utilizzeremo lo spazio di archiviazione locale solo per il traffico con consenso.
  • false Se imposti questo parametro su "false", imposteremo un cookie solo per il traffico non valido e utilizzeremo lo spazio di archiviazione locale sia per il traffico con consenso che per quello senza consenso.

Per impostazione predefinita, il valore IVT è impostato su true.

Esempio: 

'ivt': false

Descrizioni dei parametri a livello di unità

Questi parametri influenzano il modo in cui le singole unità pubblicitarie in una pagina vengono presentate all'utente. Ciascun parametro può essere impostato specificamente per ogni 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 quanti annunci devono essere visualizzati nella parte superiore dell'unità pubblicitaria.

Nota: questo parametro viene utilizzato al posto del parametro "number". L'unità pubblicitaria deve essere abbastanza larga da contenere la prima riga dell'annuncio senza che vada a capo. L'utilizzo del parametro maxTop in qualsiasi altro posizionamento nella pagina è considerato 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 vengono caricati gli annunci o le ricerche correlate oppure quando non vengono pubblicati annunci o ricerche correlate. Il parametro deve essere impostato su una funzione di callback JavaScript implementata che consenta di eseguire un'azione al completamento 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 Impostato su 'true' se esiste almeno un annuncio o termine di ricerca correlato da visualizzare e su 'false' se non vengono restituiti annunci o ricerche correlate.
isExperimentVariant Impostato su 'true' se è in esecuzione un esperimento di stile personalizzato e viene scelta la variante dell'esperimento per visualizzare gli annunci.
callbackOptions Un oggetto JSON contenente i seguenti campi:
termPositions: per un blocco di ricerca correlato, contiene una mappa<stringa,int> dei termini forniti dal publisher alla posizione indicizzata su base zero da questi termini nella risposta. Se un termine viene fornito, ma non restituito, non verrà incluso nella mappatura.

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 che devono essere pubblicati 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