Implementacja w witrynie

Uwaga: używaj tylko jednego żądania reklamy na stronę, bez względu na to, ile blokad może znajdować się na stronie.

Ważne: zanim użyjesz tego kodu, przeczytaj Warunki korzystania z usługi

Aby użyć tego kodu, musisz mieć konto AdSense z aktywnymi uprawnieniami do korzystania z reklam AdSense w wyszukiwarce niestandardowej.

Przegląd

Implementacja reklam AdSense w wyszukiwarce niestandardowej w witrynie odbywa się w 3 etapach:

Krok 1. Utwórz w AdSense styl reklamy w wyszukiwarce niestandardowej

Po zalogowaniu się rozwiń Reklamy dla wyszukiwania i kliknij Szukaj stylów. Tutaj możesz utworzyć nowy styl lub zaktualizować istniejący.

Krok 2. Skonfiguruj kod

Kliknij Pobierz kod Umieszczona. Skonfiguruj kontenery reklam tak, aby pasowały do kontenerów reklam na stronie wyszukiwania.

Krok 3. Wdróż kod

Skopiuj kod z generatora kodu i wklej go na stronie, pamiętając o zaktualizowaniu parametru query. Aby reklamy prawidłowo się ładowały, kod wygenerowany w tagu nagłówka należy umieścić w tagu nagłówka witryny. Kod jednostki reklamowej 1 będzie zawierać ustawienia wszystkich jednostek reklamowych na stronie. Dodatkowe jednostki reklamowe będą wymagały umieszczenia odpowiedniej jednostki <div> na stronie, na której powinny pojawiać się reklamy.

Najczęściej używane funkcje znajdziesz w generatorze kodu, ale kilka dodatkowych parametrów znajdziesz w sekcji z materiałami referencyjnymi. Ta sekcja zawiera wszystkie opcje na poziomie strony, które mają zastosowanie do wszystkich jednostek reklamowych na stronie, a także wszystkie opcje na poziomie jednostki w odniesieniu do poszczególnych jednostek reklamowych.

Przykładowy kod

Asynchroniczne wczytywanie reklam

Wygenerowany kod jest asynchroniczny. Poniżej znajdziesz pełny przykład działania asynchronicznego wczytywania reklam. Możesz otworzyć ten przykład w nowej karcie. Pamiętaj, by podać własny identyfikator klienta.

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

Podobne wyszukiwanie w wyszukiwarce to bezpłatna jednostka zawierająca hasła związane z aktualnie wyszukiwanym hasłem. Linki w tej jednostce prowadzą do nowej strony wyników wyszukiwania.

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

Funkcja podobnego wyszukiwania w sieci partnerskiej udostępnia użytkownikom wyszukiwane hasła związane z treścią strony. Dzięki temu użytkownicy mogą zgłębiać interesujące ich tematy, wchodzić w interakcje z reklamami w wyszukiwarce lub korzystać z nawigacji w witrynie. Nie używaj parametru „query” w przypadku podobnego wyszukiwania na stronach z treścią, ponieważ spowoduje to nieoczekiwane wyniki.

Uwaga: zanim podobne wyszukiwania będą mogły pojawiać się w Twojej witrynie, Google musi zindeksować Twoje strony, aby upewnić się, że pasują one do kontekstu. Jeśli strona nie została jeszcze zindeksowana lub jest zablokowana (np. przez plik robots.txt) przez robota indeksującego AdSense, nie będziemy wyświetlać sugerowanych przez Ciebie zapytań powiązanych z podobnym wyszukiwaniem.

Podobne wyszukiwanie w treściach korzysta z systemu indeksowania Google, który indeksuje strony i generuje odpowiednie wyszukiwane hasła. Adresy URL stron z treścią zawierające parametry zapytań, takie jak zmienne śledzenia, identyfikatory użytkownika, identyfikatory sesji lub inne identyfikatory dynamiczne, mogą utrudniać robotowi ocenę głównej treści strony i powodować, że powiązane wyszukiwane hasła będą nieprawidłowe lub nietrafne. Aby zidentyfikować te mało istotne parametry, użyj parametru „ignoredPageParams”. Zapewni to prawidłowe indeksowanie treści i ograniczy niepotrzebne obciążenie związane z indeksowaniem. Dzięki temu Google może lepiej rozpoznać, że strona została już zindeksowana, i zacząć wyświetlać sugerowane hasła (zarówno Google, jak i partner, jeśli się kwalifikujesz).

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

Czego unikać

Zalecamy wszystkim wydawcom przestrzeganie naszych wskazówek dotyczących implementacji reklam AdSense w wyszukiwarce niestandardowej oraz unikanie niektórych metod, które mogą zakłócić renderowanie reklam i powodować nieoczekiwane rezultaty lub nieoptymalną skuteczność.

  • Nie wysyłaj wielu wywołań reklam na stronie, chyba że korzystasz z przewijania nieskończonego
  • Nie ukrywaj blokad reklam przed wyrenderowaniem reklam ani po ich wyrenderowaniu
  • Nie umieszczaj bloków reklamowych w obrębie strony.
  • Nie żądaj więcej blokad reklam, niż chcesz wyświetlić na stronie
  • Nie wolno manipulować DOM bloków reklamowych.
  • Nie wdrażaj własnego leniwego ładowania (zamiast tego polegaj na leniwym ładowaniu Google).
  • Nie zapisuj w pamięci podręcznej zasobów JavaScript Google w swojej witrynie
  • Nie używaj parametru „query” w przypadku podobnego wyszukiwania na stronach z treścią, ponieważ spowoduje to nieoczekiwane wyniki.