Riferimento

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 adPage specifica la pagina dei risultati in cui vengono visualizzati gli annunci. Questo parametro viene utilizzato quando gli utenti navigano oltre 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 quelli nella seconda pagina di cinque annunci.

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:
  • 'content' Utilizza questa opzione per la ricerca correlata nelle pagine Contenuti (ad es. articoli, post di blog).
  • 'query' Utilizza questa opzione esclusivamente per la ricerca correlata su Pagine dei risultati di ricerca.

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:

  • Alcune funzionalità di ricerca correlata possono essere attivate o disattivate a seconda del valore di questo parametro della pagina.
  • Rappresentazione ingannevole del tipo di pagina o fare affidamento sulla "query" predefinita per il parametro Il parametro relatedSearchTargeting nelle pagine non dei risultati di ricerca è considerato una violazione delle queste istruzioni scritte.
  • Google potrebbe verificare periodicamente l'accuratezza di questo valore, indipendentemente dal fatto che sia impostato o meno manualmente o utilizzando l'impostazione predefinita.

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à.
  • '_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. 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:

  • Il parametro deve essere fornito solo in una richiesta di Ricerca correlata di contenuti e verrà può essere ignorata in tutte le altre richieste.
  • Deve essere utilizzata solo per il traffico che ricevi intenzionalmente da altri siti web e non devono essere utilizzati per il traffico organico.
  • Deve includere la riga del titolo, la descrizione e/o qualsiasi altra formulazione dell'annuncio oppure creatività con link.
  • L'omissione di valori dalla creatività dell'annuncio o del link (o l'inclusione di valori aggiuntivi) è considerata una violazione delle presenti istruzioni scritte.
  • 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. Se utilizzato, potrebbe influire sulla selezione e il ranking dei termini.

Nota: questo parametro è obbligatorio quando si utilizza la proprietà 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 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, referrerAdCreative è anche required e relatedSearchTargeting è obbligatorio e deve essere impostato in "contenuti".

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:

  • Il parametro deve essere fornito solo in una richiesta di Ricerca correlata di contenuti e verrà può essere ignorata in tutte le altre richieste.
  • Il valore di questo parametro deve essere un elenco delimitato da virgole di parametri URL che possono vengono visualizzate quando un utente visita la pagina dei contenuti.
  • Fa distinzione tra maiuscole e minuscole.
  • Quando un parametro URL di questo elenco viene rimosso dall'URL della pagina di contenuti, deve: non influiranno in modo significativo sui contenuti, sull'aspetto o sull'esperienza utente delle pagine.
  • L'inclusione di un parametro URL che abbia un impatto significativo sui contenuti, sull'aspetto o esperienza utente è considerata una violazione di queste istruzioni scritte.
  • Google potrebbe verificare periodicamente l'effetto della ignorazione dei parametri URL forniti.

Esempi:
Un utente visita una pagina di contenuti e il cui 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'
L'URL della pagina di contenuti viene considerato come segue:
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:
  • 'high' restituisce annunci adatti ai minori. Non restituisce annunci non adatti ai minori o con contenuti di natura sessuale.
  • 'medium' restituisce sia annunci adatti ai minori sia annunci 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 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 ie imposta la 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 con codifica ISO-8859-1 Europa occidentale (catalano, danese, olandese, inglese, finlandese, francese, tedesco, indonesiano, italiano, norvegese, portoghese, spagnolo, svedese)
latin2 ISO-8859-2 Europa orientale (ceco, croato, 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
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 Tutte
oe Facoltativo

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

Il valore predefinito di oe è utf-8.

Valore Nome standard Lingue supportate associate
latin1 con codifica ISO-8859-1 Europa occidentale (catalano, danese, olandese, inglese, finlandese, francese, tedesco, indonesiano, italiano, norvegese, portoghese, spagnolo, svedese)
latin2 ISO-8859-2 Europa orientale (ceco, croato, 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
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 Tutte
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.
  • true Se questo parametro non è presente o lo imposti su "true", imposteremo un cookie per il solo rilevamento del traffico non valido e utilizzeremo lo spazio di archiviazione locale solo per il traffico per i quali è stato fornito il consenso.
  • false Se imposti questo parametro su "false" imposteremo un cookie per il solo rilevamento del 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

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:

containerName Nome del contenitore dell'annuncio o dell'unità di ricerca correlata.
adsLoaded Impostato su true quando esiste almeno un annuncio o un termine di ricerca correlato da visualizzare e false quando non vengono restituiti annunci o ricerche correlate.
isExperimentVariant Impostato su true se è in corso un esperimento sugli stili personalizzati e la variante del viene scelto per eseguire il rendering degli annunci.
callbackOptions Un oggetto JSON contenente i seguenti campi:
termPositions: Per un blocco di ricerca correlata, contiene una mappa<string,int> del publisher fornito termini alla posizione zero-indicizzata di questi termini nella risposta. Se viene fornito un termine ma non viene restituito, non apparirà 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 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