Riferimento

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.

Esempio:

'pubId' : 'test-property'

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

Esempio:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• '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'

Esempio:

'styleId': '1234567890'

• '_top' Si apre nella stessa finestra.
• '_blank' Si apre in una nuova finestra.

Esempio:

'linkTarget' : '_blank'

Esempio:

'maxTermLength' : 50

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'

Esempio:

'resultsPageQueryParam' : 'query'

Nota: quando utilizzi questo parametro, referrerAdCreative è anche required e relatedSearchTargeting è obbligatorio e deve essere impostato in "contenuti".

Esempi:

'terms' : 'cars rental, flight ticket'

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

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• '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'

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'

Esempi:

'channel' :  'testA'  

'channel' :  'testA+testB'  

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'

Il parametro ie imposta la codifica dei caratteri da utilizzare per interpretare la stringa di query.

Il valore predefinito di ie è utf-8.

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.

• 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

Esempio:

'container' : 'afscontainer1'

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

Esempio:

'width' : '700px'

'width' : 700

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
    }
  }
};
      

Esempio:

'number' : 4

Esempio:

'relatedSearches' : 4