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.
Obbligatorio
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 pubId è la parte dell'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 deve essere non codificati. Nota: l'utilizzo di questo parametro nella Ricerca correlata nelle pagine dei contenuti comporterà 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 rappresenta termine di ricerca correlata su cui l'utente ha fatto clic. I risultatiPageBaseUrl possono includere il proprio , tranne la 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 quale tipo di L'esperienza di Ricerca correlata viene visualizzata, a seconda del contesto della pagina:
Nota: il parametro della pagina relatedSearchTargeting viene impostato automaticamente su "query" per impostazione predefinita. Tuttavia, tieni presente che questo valore predefinito è specifico Pensate solo per le pagine dei risultati di ricerca (Ricerca correlata nella Ricerca). Se utilizzando 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 a unità di ricerca correlata in della pagina. Scopri di più sull'utilizzo degli stili personalizzati degli annunci associati ai risultati di ricerca. Tieni presente che, avendo lo styleId impostato per una richiesta, gli annunci o le ricerche correlate verranno visualizzati con lo stile, mentre i parametri di stile precedenti verranno ignorato. 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à Ricerca correlata per i contenuti facendo clic su un annuncio o un link in un altro sito web e l'annuncio o link è sotto il tuo controllo, questo parametro deve essere impostato esattamente sul testo della creatività dell'annuncio o del link. Le seguenti linee guida si applicano all'uso di questo parametro:
Nota: questo parametro è obbligatorio quando si utilizza la proprietà
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 ti consente di fornire un elenco delimitato da virgole dei tuoi termini di ricerca correlata. da restituire con una richiesta di ricerca correlata, anche se Google può utilizzare termini qui forniti.
Nota: quando utilizzi questo parametro, Esempi: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Facoltativo Specifica l'elenco di parametri URL per una pagina di contenuti con una ricerca di contenuti correlata che può essere tranquillamente 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 pagine per assicurarsi che i termini siano contestualmente pertinenti. Quando una pagina non è stata ancora sottoposti a scansione o a cui è bloccata (ad esempio da un file robots.txt) dal crawler di AdSense, non mostreremo termini di Ricerca correlata suggeriti che fornisci a Google. La Ricerca correlata nei contenuti si basa sul sistema di scansione dei contenuti di Google per indicizzare pagine e generare termini di ricerca pertinenti. URL delle pagine dei contenuti contenenti parametri di query quali poiché variabili di monitoraggio, ID utente, ID di sessione o altri identificatori dinamici possono interferire la capacità del crawler di valutare i contenuti principali della pagina e ciò potrebbe generare contenuti imprecisi o termini di ricerca correlata non pertinenti. Questo parametro della pagina indica al crawler di Google di ignorare questi parametri non essenziali, garantendo una corretta indicizzazione dei contenuti e riducendo la scansione non necessaria caricamento. In questo modo Google può riconoscere meglio una pagina come già sottoposta a scansione e avviare che mostrano i termini suggeriti (sia di Google sia di quelli 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=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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 includono un "annuncio di prova" si sovrappongono e non è possibile fare clic. 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 nell'account AdSense o dal Technical Account Manager. Scopri di più sui canali qui. Se ci sono più canali devono essere separati dal segno "+" . 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 ti consente di fornire un valore booleano per comunicare a Google che vuoi consentire gli annunci che utilizzano un cookie e un cookie per il solo rilevamento del traffico non valido spazio di archiviazione locale per il traffico con e senza 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.
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 mostrare nell'unità pubblicitaria superiore. Nota: questo parametro è utilizzato al posto di "number" . Questa unità pubblicitaria deve essere abbastanza larga da impedire che la prima riga dell'annuncio vada a capo. Utilizzo di 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 hanno o quando non vengono pubblicati annunci o ricerche correlate. Il parametro deve essere impostato su un la funzione di callback JavaScript implementata per consentire l'esecuzione di un'azione quando la chiamata dell'annuncio è stata completata. 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 dovrebbero essere visualizzate in questa unità. Se non specificato, il valore predefinito è 0. Esempio: 'relatedSearches' : 4 |