Implementazione web

Nota:effettua sempre una sola richiesta di annuncio per pagina, indipendentemente dal numero di blocchi presenti.

Importante: leggi i Termini e condizioni prima di utilizzare questo codice.

Per utilizzare questo codice, devi disporre di un account AdSense con autorizzazione attiva per poter usare gli annunci personalizzati AdSense associati alla ricerca.

Panoramica

L'implementazione degli annunci personalizzati AdSense associati alla ricerca sul tuo sito è una procedura in 3 passaggi:

Passaggio 1: crea il tuo stile di ricerca personalizzato in AdSense.

Una volta effettuato l'accesso, espandi Annunci per la ricerca e poi fai clic su Stili di ricerca. Qui puoi creare un nuovo stile o aggiornarne uno esistente.

Passaggio 2: configura il codice

Fai clic su Genera codice Embed. Configura i contenitori degli annunci in modo che corrispondano a quelli nella pagina di ricerca.

Passaggio 3: implementa il codice

Copia il codice dal generatore di codice e incollalo nella pagina, ricordandoti di aggiornare il parametro query. Affinché gli annunci vengano caricati correttamente, il codice generato nel tag head deve essere inserito nel tag head del tuo sito. Il codice dell'unità pubblicitaria 1 contiene le impostazioni per tutte le unità pubblicitarie della pagina. Per le unità pubblicitarie aggiuntive è necessario inserire l'unità pubblicitaria corrispondente <div> solo nella pagina in cui devono essere pubblicati gli annunci.

Le funzionalità di uso più comune sono fornite nel generatore di codice, ma alcuni parametri aggiuntivi sono disponibili nella sezione di riferimento. La sezione di riferimento contiene tutte le opzioni a livello di pagina, che si applicano a tutte le unità pubblicitarie nella pagina, nonché tutte le opzioni a livello di unità, che si applicano alle singole unità pubblicitarie.

Codice campione

Caricamento asincrono degli annunci

Il codice generato è asincrono. Di seguito è riportato un esempio funzionante del caricamento asincrono degli annunci. Puoi aprire questo esempio in una nuova scheda. Ricordati di inserire il tuo ID cliente.

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<div id="afscontainer1"></div>
<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId' : 'test client ID', // Enter your own client-ID here
  'query' : 'flowers', // User query for this page
  'styleId': '7824176615' // Enter your own style ID here
};

var adblock1 = {
  'container' : 'afscontainer1',
  'width' : 700
};

var adblock2 = {
  'container' : 'afscontainer2',
  'width' : 700
};

_googCsa('ads', pageOptions, adblock1, adblock2);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

La Ricerca correlata sulla Ricerca è un'unità organica con termini di ricerca correlati al termine di ricerca corrente. I link in questa unità rimandano a una nuova pagina dei risultati di ricerca.

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<div id="afscontainer1"></div>
<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'relatedSearchTargeting': 'query', // Must use 'query' for Related Search on Search pages
  'query': 'flowers', // User query for this page
  'styleId': '1234567890', // Enter your own style ID here
  'resultsPageBaseUrl': '//www.example.com/search', // Enter your own base URL here
  'resultsPageQueryParam': 'query' // Enter your own query parameter here
};

var adblock = {
  'container': 'afscontainer1',
  'number': 3,
  'width': 700
};

var rsblock = {
  'container': 'afscontainer2',
  'relatedSearches': 6,
  'width': 500
};

_googCsa('ads', pageOptions, adblock, rsblock);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

La ricerca correlata sui contenuti fornisce all'utente termini di ricerca correlati ai contenuti della pagina. Consente agli utenti di esplorare argomenti pertinenti, interagendo con gli annunci della rete di ricerca o con la navigazione sul sito. Non utilizzare il parametro "query" per la ricerca correlata nelle pagine di contenuti, perché produrrà risultati imprevisti.

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. Utilizza il parametro "ignoredPageParams" per identificare questi parametri non essenziali, per garantire una corretta indicizzazione dei contenuti e ridurre 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).

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<p>Page content</p>

<div id="afscontainer1"></div>

<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'relatedSearchTargeting': 'content', // Must use 'content' for Related Search on Content pages
  'hl': 'en', // The preferred language for related terms (default to 'en' if not specified)
  'styleId': '1234567890', // Enter your style ID
  'resultsPageBaseUrl': '//www.example.com/search', // Enter the base URL of your results page
  'resultsPageQueryParam': 'query', // Specify the query parameter on your results page
  'terms': 'term a,term b', // Optionally provide your own related terms in a comma-delimited list
  'referrerAdCreative': 'example ad title' // Only used when a user clicked an ad to arrive here;
                                           // required when 'terms' is present.
};

var rsblock1 = {
  'container': 'afscontainer1',
  'relatedSearches': 6
};

_googCsa('relatedsearch', pageOptions, rsblock1);
</script>

<p>More page content</p>

</body>
</html>

Errori da evitare

Consigliamo a tutti i publisher di rispettare le nostre linee guida per l'implementazione degli annunci personalizzati AdSense associati alla ricerca e di evitare determinati metodi di implementazione che potrebbero interferire con il rendering degli annunci e causare risultati imprevisti o un rendimento non ottimale.

  • Non effettuare più chiamate dell'annuncio da una pagina a meno che non venga implementata un'implementazione di scorrimento continuo
  • Non nascondere i blocchi di annunci prima o dopo il rendering degli annunci
  • Non spostare i blocchi annunci nella pagina
  • Non richiedere più blocchi di annunci di quelli che vuoi mostrare sulla pagina
  • Non manipolare il DOM dei blocchi di annunci
  • Non implementare il caricamento lento (fai affidamento sul caricamento lento di Google).
  • Non memorizzare nella cache le risorse JS di Google sul tuo sito
  • Non utilizzare il parametro "query" per la ricerca correlata nelle pagine di contenuti, perché causerebbe risultati imprevisti.