Parametri
Descrizioni dei parametri a livello di pagina
Questi parametri devono essere specificati solo una volta per pagina. Influiscono su tutte le unità pubblicitarie della pagina.
Obbligatorie
| Parametro | Descrizione ed esempi |
|---|---|
adPage
|
Obbligatorio quando l'utente passa alla pagina dei risultati successiva o precedente. Il parametro |
pubId
|
Obbligatorio Questo è il tuo ID cliente AdSense. Il tuo pubId è la parte del tuo ID cliente che segue "partner-". Ad esempio, se il tuo ID cliente è "partner-test-property", il tuo pubId è "test-property". Questo è un protocollo standard per gli annunci associati alla ricerca personalizzata. Esempio: 'pubId' : 'test-property' |
query
|
Obbligatorio, ad eccezione delle ricerche correlate nelle pagine Contenuti. Questa è la query di ricerca inserita dall'utente. Il valore del parametro di query non deve essere codificato. Nota: l'utilizzo di questo parametro nella Ricerca correlata nelle pagine dei contenuti produrrà 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 correlata. Specifica l'URL della pagina dei risultati di ricerca in cui la query di ricerca è il termine di ricerca correlata 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' |
relatedSearchTargeting
|
Obbligatorio quando nella pagina sono presenti unità di ricerca correlata. Questo parametro è obbligatorio quando vengono richieste unità di ricerca correlata. Controlla il tipo di esperienza di Ricerca correlata che viene visualizzata, a seconda del contesto della pagina:
Nota: il parametro della pagina relatedSearchTargeting è impostato automaticamente su "query" per impostazione predefinita. Tuttavia, è importante notare che questo valore predefinito è progettato specificamente per le pagine dei risultati di ricerca solo (Ricerca correlata nella Ricerca). Se utilizzi la ricerca correlata su qualsiasi altro tipo di pagina (ad es. articoli, post di blog), devi impostare esplicitamente il parametro su "content". Nota:per l'uso di questo parametro si applicano le seguenti linee guida:
Esempi: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
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 sulla 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à eseguito il rendering di uno stile predefinito di sistema. Esempio: 'styleId': '1234567890' |
Facoltativo
| Parametro | Descrizione ed esempi |
|---|---|
linkTarget
|
Facoltativo Specifica se i clic su un annuncio si aprono nella stessa finestra o in una nuova finestra. Il valore predefinito è "_top". Questo parametro può essere utilizzato anche a livello di unità.
Esempio: 'linkTarget' : '_blank' |
maxTermLength
|
Facoltativo Specifica il numero massimo di caratteri di un termine di ricerca correlata, spazi inclusi. Nessun limite massimo se non impostato. Esempio: 'maxTermLength' : 50 |
referrerAdCreative
|
Facoltativo Se un utente arriva alla tua pagina di contenuti che contiene un'unità della ricerca correlata di contenuti facendo clic su un annuncio o su 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 in questione. Le seguenti linee guida si applicano all'uso di questo parametro:
Nota: questo parametro è obbligatorio quando si utilizza il
parametro 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 correlata da restituire con una richiesta di ricerca correlata, anche se Google può utilizzare o meno i termini forniti qui.
Nota: quando utilizzi questo parametro, anche Esempi: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Facoltativo Specifica l'elenco di parametri URL per una pagina di contenuti con un'unità della Ricerca correlata per i contenuti che può essere ignorata 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 garantire che i termini siano contestualmente pertinenti. Se una pagina non è ancora stata sottoposta a scansione o non è bloccata (ad es. da un file robots.txt) dal crawler di AdSense, non mostreremo a Google i termini di Ricerca correlata suggeriti. La Ricerca correlata sui contenuti si basa sul sistema di scansione dei contenuti di Google per indicizzare le pagine e generare termini di ricerca pertinenti. Gli URL delle pagine dei contenuti che contengono 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 potrebbero generare termini di ricerca correlati imprecisi o irrilevanti. Questo parametro di pagina indica al crawler di Google di ignorare questi parametri non essenziali, garantendo una corretta indicizzazione 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 che del partner, se idonei). Le seguenti linee guida si applicano all'uso di questo parametro:
Esempi:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Specificare i seguenti parametri URL ignorabili: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'L'URL della pagina di contenuti viene trattato 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 sono riportate le impostazioni valide per adsafe e l'effetto di ogni valore sugli annunci restituiti:
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 parametro adtest ha il valore on, Google tratta la richiesta come un test e non conteggia le impressioni dell'annuncio né monitora i risultati di clickthrough. Se il parametro adtest ha il valore on, non vengono generate entrate. Le richieste di annunci con il parametro adtest impostato su on provenienti da un dominio non approvato nella scheda Siti restituiranno gli annunci che hanno un overlay "annuncio di prova" e non possono essere selezionati. Utilizza questo parametro per eseguire i test, ma non nei 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 inserire più canali, separali con il 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 delle API di AdWords. Nota: gli inserzionisti specificano le lingue scelte come target per i propri annunci. Se includi questo parametro nella tua richiesta, Google restituirà solo annunci che hanno come target tale 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. Esempi: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
Facoltativo Il parametro Il valore predefinito di
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Facoltativo Il parametro Il valore predefinito di
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
Facoltativo Questo parametro consente di fornire un valore booleano che informa Google che vuoi consentire gli annunci che utilizzano un cookie di solo rilevamento del traffico non valido e uno spazio di archiviazione locale sia per il traffico con consenso sia per quello per cui non è stato fornito il consenso.
Per impostazione predefinita, l'IVT è impostato su true. Esempio: 'ivt': false |
Descrizione 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 individualmente per ciascuna unità pubblicitaria.
Obbligatorie
| 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 mostrare nell'unità pubblicitaria superiore. Nota: questo parametro è utilizzato al posto del parametro "number". Questa unità pubblicitaria deve essere sufficientemente larga in modo che la prima riga dell'annuncio non vada a capo. L'utilizzo del parametro maxTop in qualsiasi altro posizionamento nella pagina rappresenta una violazione delle norme. Esempio: 'maxTop' : 4 |
width
|
Obbligatorio Specifica la larghezza dell'annuncio o dell'unità di ricerca correlata in pixel. 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 vengono caricati o quando non vengono pubblicati annunci o ricerche correlate. Il parametro deve essere impostato su una funzione di callback JavaScript implementata da te, che consente di eseguire un'azione al termine della chiamata dell'annuncio. La funzione di callback accetta i seguenti parametri:
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 visualizzati 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 |