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 |
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à.
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:
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:
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 Il valore predefinito di
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Facoltativo Il parametro Il valore predefinito di
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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.
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:
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 |