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 utilizzare gli annunci AdSense della rete di ricerca personalizzata.

Panoramica

L'implementazione degli annunci AdSense della rete di ricerca personalizzata sul tuo sito è un processo in tre fasi:

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

Dopo aver eseguito l'accesso, espandi Annunci per la rete di ricerca e poi fai clic su Stili di ricerca. Da qui puoi creare un nuovo stile o aggiornarne uno esistente.

Passaggio 2: configura il codice

Fai clic su Genera codice Incorpora. Configura i contenitori di annunci in modo che corrispondano a quelli della 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. Il codice generato nel tag head deve essere inserito nel tag head del tuo sito affinché gli annunci vengano caricati correttamente. Il codice dell'unità pubblicitaria 1 conterrà le impostazioni di tutte le unità pubblicitarie della pagina. Per le unità pubblicitarie aggiuntive sarà sufficiente posizionare l'unità pubblicitaria <div> corrispondente nella pagina in cui devono essere visualizzati gli annunci.

Le funzionalità di uso 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, valide per tutte le unità pubblicitarie nella pagina, nonché tutte le opzioni a livello di unità, valide per le singole unità pubblicitarie.

Codice di esempio

Caricamento asincrono degli annunci

Il codice generato è asincrono. Di seguito è riportato un esempio completo e funzionante di 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 nella Ricerca è un'unità organica con termini di ricerca correlati al termine di ricerca corrente. I link di 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. In questo modo, gli utenti possono esplorare argomenti pertinenti, interagendo con gli annunci della rete di ricerca o la navigazione del sito. Non utilizzare il parametro "query" per la Ricerca correlata nelle pagine di contenuti, in quanto ciò causerà 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 assicurarsi che i termini siano pertinenti al contesto. Quando una pagina non è ancora stata sottoposta a scansione o la scansione è bloccata (ad es. da un file robots.txt) dal crawler Mediapartners-Google, non mostreremo i termini di ricerca correlati suggeriti che fornisci a Google.

Il prodotto 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 di contenuti contenenti 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 possono portare a termini di ricerca correlati imprecisi o non pertinenti. Utilizza il parametro "ignoredPageParams" per identificare questi parametri non essenziali, garantendo la corretta indicizzazione dei contenuti e riducendo 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 comes from a source you control;
                                           // 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 AdSense della rete di ricerca personalizzata ed 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 di annunci da una pagina, a meno che non si tratti di un'implementazione a scorrimento continuo
  • Non nascondere i blocchi di annunci prima o dopo il rendering degli annunci
  • Non spostare i blocchi di annunci nella pagina
  • Non richiedere più blocchi di annunci di quelli che vuoi mostrare nella pagina
  • Non manipolare il DOM dei blocchi di annunci
  • Non implementare il tuo lazy loading (affidati invece a quello 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, in quanto potrebbe causare risultati imprevisti.