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.

Omówienie

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. Umieść 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>

Podobne wyszukiwanie na stronach z treścią

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 zapytania dla podobnego wyszukiwania na stronach z treścią, ponieważ spowoduje on nieoczekiwany wyników.

Uwaga: aby podobne wyszukiwania mogły pojawiać się w Twojej witrynie, Google musi zindeksować Twoje strony, tak by hasła pasowały do kontekstu. Jeśli strona nie została jeszcze zindeksowana lub przed indeksowaniem (np. przez plik robots.txt) przez tag robot indeksujący AdSense, nie wyświetlamy sugerowanych podobnych zapytań, które podajesz Google.

Podobne wyszukiwanie w treści stron korzysta z systemu indeksowania Google i generować trafne wyszukiwane hasła. Adresy URL stron z treścią zawierające parametry zapytań, takie jak śledzenie zmiennych, identyfikatorów użytkowników, sesji i innych identyfikatorów dynamicznych, mogą zakłócać działanie robota możliwość oceny głównej treści strony i może prowadzić do niedokładnych lub nietrafnych podobnych wyszukiwań Google Cloud. Użyj parametru „ignoredPageParams” do identyfikacji tych nieistotnych parametrów, zapewnienie prawidłowego indeksowania treści i ograniczenie niepotrzebnego obciążenia. Dzięki temu możemy lepiej rozpoznają stronę jako już zindeksowane i zaczną wyświetlać sugerowane hasła (zarówno Google, partnera). 

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

Wszystkim wydawcom zalecamy stosowanie się do wskazówek dotyczących implementacji reklam AdSense w wyszukiwarce niestandardowej, oraz unikanie metod implementacji, które mogą zakłócać renderowanie reklam i powodować, nieoczekiwane rezultaty lub nieoptymalna 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 zapytania dla podobnego wyszukiwania na stronach z treścią, ponieważ spowoduje on nieoczekiwane wyniki.