Dokumentacja

Parametry

Opis parametrów na poziomie strony

Parametry te wystarczy określić na stronie tylko raz. Wpływają one na wszystkie jednostki na stronie.

Wymagane

Parametr Opis i przykłady
adPage Wymagany, gdy użytkownik przechodzi na następną lub poprzednią stronę wyników.

Parametr adPage określa, na której stronie wyników wyświetlają się reklamy. Ten parametr jest używany, gdy użytkownik przechodzi poza pierwszą stronę wyników wyszukiwania. Przykład: jeśli zostanie zażądanych 5 reklam, a parametr adPage ma wartość 2, reklamy będą wyświetlone na drugiej stronie wyników wyszukiwania.

pubId Wymagany
To jest Twój identyfikator klienta AdSense. Twój identyfikator pubId to część identyfikatora klienta, która następuje po „partner-”. Jeśli na przykład identyfikator klienta to „partner-test-property”, pubId to „test-property”. Jest to standardowy protokół reklam w wyszukiwarce niestandardowej.

Przykład:

'pubId' : 'test-property'
query Wymagane, z wyjątkiem podobnego wyszukiwania na stronach z treścią.
Jest to wyszukiwane hasło wpisane przez użytkownika. Wartość parametru zapytania powinna być niezakodowane.

Uwaga: użycie tego parametru na stronach z podobnym wyszukiwaniem na stronach z treścią spowoduje, nieoczekiwane rezultaty.

Przykłady:

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl Wymagany, jeśli na stronie znajdują się jednostki podobnego wyszukiwania.
Określa adres URL strony wyników wyszukiwania, na której jest określone zapytanie podobne wyszukiwane hasło, które kliknął użytkownik. Parametr resultsPageBaseUrl może zawierać własny z wyjątkiem zapytania, które zostanie dołączone automatycznie.

Przykład:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting Wymagany, jeśli na stronie znajdują się jednostki podobnego wyszukiwania.
Ten parametr jest wymagany w przypadku żądań jednostek podobnego wyszukiwania. Decyduje on o typie Wyświetla się podobne wyszukiwanie w zależności od kontekstu strony:
  • 'content' Użyj tej opcji w przypadku podobnego wyszukiwania na stronach z treścią (np. w artykułach, posty na blogu).
  • 'query' Używaj tej opcji wyłącznie w przypadku podobnego wyszukiwania na Strony wyników wyszukiwania.

Uwaga: parametr strony relatedSearchKierowanie ma automatycznie wartość „query” domyślnie. Warto jednak zauważyć, że jest to wartość domyślna przeznaczone tylko na strony wyników wyszukiwania (podobne wyszukiwanie w wyszukiwarce). Jeśli jesteś używając podobnego wyszukiwania na stronach innego typu (np. w artykułach lub postach na blogu), musisz jako wartość parametru „content”.

Uwaga: stosowanie tego parametru podlega tym wytycznymi:

  • W zależności od wartości tego parametru niektóre funkcje podobnego wyszukiwania mogą być włączone lub wyłączone strony.
  • Fałszywe przedstawianie typu strony lub poleganie na domyślnym „zapytaniu” dla parametru Parametr relatedSearchKierowanie na stronach innych niż wyniki wyszukiwania jest uważany za naruszenie tych pisemnych instrukcji.
  • Google może okresowo sprawdzać poprawność tej wartości, niezależnie od tego, czy jest ustawiona ręcznie lub przy użyciu domyślnej.

Przykłady:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId Wymagany
Określa identyfikator stylu reklamy w wyszukiwarce niestandardowej, który ma być stosowany do reklam lub jednostek podobnego wyszukiwania w stronę. Dowiedz się więcej o korzystaniu z niestandardowych stylów reklamy w wyszukiwarce. Zwróć uwagę, że po ustawieniu atrybutu styleId dla żądania reklamy i podobne wyszukiwania będą renderowane ze stylem, a starsze parametry stylu – zignorowano. Jeśli w żądaniu nie określisz atrybutu styleId, zostanie wyświetlony domyślny styl systemu.

Przykład:

'styleId': '1234567890'

Opcjonalnie

Parametr Opis i przykłady
linkTarget Opcjonalny
Określa, czy kliknięcie reklamy otwiera się w tym samym, czy w nowym oknie. okno. Wartość domyślna to „_top”. Tego parametru można też używać na poziomie jednostki.
  • '_top' – strona otwiera się w tym samym oknie.
  • '_blank' otwiera się w nowym oknie.

Przykład:

'linkTarget' : '_blank'
maxTermLength Opcjonalny
Określa maksymalną liczbę znaków (ze spacjami) podobnego wyszukiwanego hasła. Brak wartości maksymalnej, jeśli nie jest ustawiona.

Przykład:

'maxTermLength' : 50
referrerAdCreative Opcjonalny
Jeśli użytkownik trafi na stronę z treścią, która zawiera jednostkę podobnego wyszukiwania dla treści klikając reklamę lub link w innej witrynie, nad którą masz kontrolę, należy ustawić dosłowny tekst reklamy lub linku.

Stosowanie tego parametru podlega tym wytycznym:

  • Ten parametr należy podawać tylko w żądaniu podobnego wyszukiwania dla treści, a wtedy będzie on będą ignorowane w przypadku wszystkich innych żądań.
  • Należy go używać tylko w przypadku ruchu celowo pozyskiwanego z innych witryn i nie należy ich używać w przypadku ruchu bezpłatnego.
  • Powinien zawierać tytuł, opis lub inne sformułowania użyte w reklamie, kreacji linku.
  • Pominięcie wartości w kreacji z reklamą lub linkiem (albo uwzględnienie dodatkowych wartości) jest niedozwolone uznano za naruszenie tych pisemnych instrukcji.
  • Wielkość liter nie jest rozróżniana.
  • Akceptuje prawidłowe kodowanie UTF-8. obsługiwane są znaki Unicode / znaki diakrytyczne.
  • Google może użyć przesłanego przez Ciebie parametru lub go zignorować. Używanie może mieć wpływ na wybór oraz ranking tych haseł.

Uwaga: ten parametr jest wymagany, gdy używasz parametru terms.

Przykłady:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam Opcjonalny
Określa nazwę parametru adresu URL w przypadku zapytania na stronie wyników wyszukiwania. Jeśli nie zostanie podany, domyślna wartość to „q”.

Przykład:

'resultsPageQueryParam' : 'query'
terms Opcjonalny
Ten parametr umożliwia podanie listy rozdzielonych przecinkami własnych podobnych wyszukiwanych haseł w odpowiedzi na podobne wyszukiwanie, chociaż Google może, ale nie musi, podane tutaj warunki.

Uwaga: jeśli używasz tego parametru, referrerAdCreative ma także wartość required i relatedSearchTargeting jest wymagany i musi być ustawiony do opcji „content”.

Przykłady:

'terms' : 'cars rental, flight ticket'
ignoredPageParams Opcjonalny
Określa listę parametrów adresu URL w przypadku strony z treścią za pomocą podobnego wyszukiwania dla treści które można bezpiecznie zignorować bez wpływu na główną treść czy wygodę użytkownika.

Uwaga: aby podobne wyszukiwania mogły pojawiać się w Twojej witrynie, Google musi: zaindeksuj strony w celu sprawdzenia, czy hasła pasują kontekstowo. Jeśli strona nie została jeszcze zostało pobrane lub zablokowane (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 korzysta z systemu indeksowania Google i generować odpowiednie wyszukiwane hasła. Adresy URL stron z treścią zawierające parametry zapytania takie jak , bo zmienne śledzenia, identyfikatory użytkownika, identyfikatory sesji lub inne identyfikatory dynamiczne mogą zakłócać działanie oceny głównej treści strony przez robota indeksującego i może to prowadzić do nieprawidłowych lub nietrafnych podobnych zapytań. Ten parametr strony informuje robota Google, że ma zignorować tych nieistotnych parametrów, co zapewnia prawidłowe indeksowanie treści i ogranicza niepotrzebne strony. Dzięki temu Google może lepiej rozpoznać, że strona została już zindeksowana, i uruchomić zawierające sugerowane hasła (zarówno Google, jak i partnera, jeśli spełnia wymagania).

Stosowanie tego parametru podlega tym wytycznym:

  • Ten parametr należy podawać tylko w żądaniu podobnego wyszukiwania dla treści, a wtedy będzie on będą ignorowane w przypadku wszystkich innych żądań.
  • Wartość tego parametru powinna być rozdzielaną przecinkami listą parametrów adresu URL, które mogą są wyświetlane, gdy dowolny użytkownik przejdzie na stronę z treścią.
  • Wielkość liter ma znaczenie.
  • Usunięcie dowolnego z parametrów adresu URL z tej listy z adresu URL strony z treścią spowoduje, nie mają znaczącego wpływu na treść, wygląd ani wrażenia użytkowników stron.
  • stosowanie parametru adresu URL, który ma istotny wpływ na zawartość, wygląd lub zawartość stron; użytkownika jest uznawane za naruszenie tych pisemnych instrukcji.
  • Google może okresowo sprawdzać skutki ignorowania podanych parametrów adresu URL.

Przykłady:
Użytkownik odwiedza stronę z treścią, której adres URL to:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Podawanie tych nieistotnych parametrów adresów URL:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
Adres URL strony z treścią będzie traktowany jako:
http://example.com/content?page_id=123

Ustawienia konfiguracji

Parametr Opis i przykłady
adsafe Opcjonalny
Określa reguły filtrowania, które Google ma zastosować do reklam pasujących do wyszukiwanego hasła. Poniżej podano prawidłowe ustawienia dla parametru adsafe i wpływ każdej wartości na wyświetlane reklamy:
  • 'high' Wyświetla reklamy dla całej rodziny. Nie wyświetla reklam nie dla całej rodziny lub zawierających treści erotyczne.
  • 'medium' Wyświetla reklamy dla całej rodziny i nie dla całej rodziny. Nie zwraca reklam zawierających treści pornograficzne.
  • 'low' Wyświetla wszystkie typy reklam.

Domyślnie parametr adsafe jest ustawiony na wysoki.

Przykład:

'adsafe': 'medium'
adtest Opcjonalny
Parametr adtest służy do wskazywania, że żądanie reklam ma charakter testowy. Gdy parametr adtest ma wartość on, Google traktuje żądanie jako test i nie zlicza wyświetleń reklam ani nie śledzi wyników klikalności.

Gdy parametr adtest ma wartość on, wydawca nie uzyskuje żadnych przychodów.

Żądania reklamy z parametrem adtest ustawionym na on, które pochodzą z domeny, która nie została zatwierdzona na karcie Witryny, będą zwracać reklamy zawierające „reklamę testową”. nakładają się na siebie i nie można ich kliknąć.

Używaj tego parametru podczas testowania, ale nie używaj go w systemach produkcyjnych. W przeciwnym razie nie otrzymasz płatności za wyświetlane reklamy.

Domyślna wartość parametru adtest jest wyłączona.

Przykład:

'adtest' : 'on'
channel Opcjonalny
Możesz dodać kanał AdSense dla wyszukiwania, aby śledzić skuteczność różnych stron. Użyj unikalnego identyfikatora kanału utworzonych na koncie AdSense lub przez technicznego menedżera konta. Więcej informacji o kanałach znajdziesz tutaj.

Kilka kanałów należy rozdzielić znakiem „+” .

Przykłady:

'channel' :  'testA'  
'channel' :  'testA+testB'  
hl Opcjonalny
Ten parametr określa język, na który mają być kierowane żądane reklamy lub podobne wyszukiwania. Wartością domyślną jest en.

Google obsługuje wszystkie kody języków interfejsu API AdWords.

Uwaga: języki, na które są kierowane reklamy, określają reklamodawcy. Jeśli umieścisz ten parametr w swoim żądaniu, Google będzie zwracać tylko reklamy kierowane na ten język lub na wszystkie języki, ale nie ma gwarancji, że tekst reklamy będzie zapisany w wybranym języku.

Zazwyczaj należy ustawić parametr hl na główny język strony, z której wysyłany jest ten parametr.

Przykłady:

'hl' : 'es'
ie Opcjonalny

Parametr ie określa schemat kodowania znaków, którego należy użyć do interpretacji ciągu zapytania.

Domyślną wartością parametru ie jest utf-8.

Wartość Nazwa standardowa Powiązane obsługiwane języki
latin1 ISO-8859-1 zachodnioeuropejskie (angielski, duński, fiński, francuski, hiszpański, indonezyjski, kataloński, niderlandzki, niemiecki, norweski, portugalski, szwedzki, włoski)
latin2 ISO-8859-2 wschodnioeuropejskie (chorwacki, czeski, polski, rumuński, serbski, słowacki, słoweński, węgierski)
latin3 ISO-8859-3  
latin4 ISO-8859-4 bałtycki (estoński, litewski, łotewski)
cyrylica ISO-8859-5 bułgarski, rosyjski
arabski ISO-8859-6  
grecki ISO-8859-7 grecki
hebrajski ISO-8859-8 hebrajski
latin5 ISO-8859-9  
latin6 ISO-8859-10 islandzki
euc-jp EUC-JP japoński
euc-kr EUC-KR koreański
Sjis Shift_JIS japoński
big5 Big5 chiński tradycyjny
gb GB2312 chiński uproszczony
utf-8 UTF-8 Wszystko
oe Opcjonalny

Parametr oe określa schemat kodowania znaków, którego Google ma użyć do kodowania tekstu reklam. Jest to opcjonalne technicznie, ale warto przekazać wartość tego parametru.

Domyślną wartością parametru oe jest utf-8.

Wartość Nazwa standardowa Powiązane obsługiwane języki
latin1 ISO-8859-1 zachodnioeuropejskie (angielski, duński, fiński, francuski, hiszpański, indonezyjski, kataloński, niderlandzki, niemiecki, norweski, portugalski, szwedzki, włoski)
latin2 ISO-8859-2 wschodnioeuropejskie (chorwacki, czeski, polski, rumuński, serbski, słowacki, słoweński, węgierski)
latin3 ISO-8859-3  
latin4 ISO-8859-4 bałtycki (estoński, litewski, łotewski)
cyrylica ISO-8859-5 bułgarski, rosyjski
arabski ISO-8859-6  
grecki ISO-8859-7 grecki
hebrajski ISO-8859-8 hebrajski
latin5 ISO-8859-9  
latin6 ISO-8859-10 islandzki
euc-jp EUC-JP japoński
euc-kr EUC-KR koreański
Sjis Shift_JIS japoński
gb GB2312 chiński uproszczony
utf-8 UTF-8 Wszystko
ivt Opcjonalny
Ten parametr umożliwia podanie wartości logicznej, która informuje Google, że chcesz zezwalać na reklamy wykorzystujące pliki cookie służące tylko do wykrywania nieprawidłowego ruchu oraz pamięci lokalnej w przypadku użytkowników, którzy wyrazili zgodę lub jej nie wyrazili.
  • true Jeśli ten parametr nie istnieje lub ma wartość „true” (prawda), ustawimy plik cookie służący tylko do wykrywania nieprawidłowego ruchu i będziemy używać pamięci lokalnej tylko w przypadku ruchu, który wyraził zgodę na przetwarzanie danych.
  • false Gdy ustawisz ten parametr na „false” ustawimy plik cookie służący tylko do wykrywania nieprawidłowego ruchu i będziemy używać pamięci lokalnej zarówno w przypadku użytkowników, którzy wyrazili zgodę, jak i tych, którzy jej nie wyrazili.

Domyślnie ustawiona wartość nieprawidłowego ruchu ma wartość Prawda.

Przykład:

'ivt': false

Opis parametrów na poziomie jednostki

Parametry te wpływają na sposób wyświetlania użytkownikowi poszczególnych jednostek reklamowych na stronie. Każdy parametr możesz ustawiać osobno dla każdej jednostki reklamowej.

Wymagane

Parametr Opis i przykłady
container Wymagany
Identyfikator pustego kontenera <div>, w którym powinna pojawić się reklama.

Przykład:

'container' : 'afscontainer1'
maxTop Wymagany, gdy jednostka reklamowa znajduje się nad wynikami wyszukiwania.

Ten parametr umożliwia określenie liczby reklam wyświetlanych w górnej jednostce reklamowej.

Uwaga: ten parametr jest używany zamiast parametru „number” . Ta jednostka reklamowa powinien być na tyle szeroki, by pierwszy wiersz reklam nie zawijał się. Korzystanie z parametru maxTop w innym miejscu docelowym na stronie narusza zasady.

Przykład:

'maxTop' : 4
width Wymagany
Określa szerokość reklamy lub jednostki podobnego wyszukiwania w pikselach.

Przykład:

'width' : '700px'
'width' : 700

Ustawienia konfiguracji

Parametr Opis i przykłady
adLoadedCallback Opcjonalny
Określa funkcję JavaScriptu, która ma być wywoływana, gdy reklamy lub podobne wyszukiwania lub gdy nie wyświetlają się żadne reklamy ani podobne wyszukiwania. Ten parametr powinien być ustawiony na implementowana przez Ciebie funkcja wywołania zwrotnego JavaScriptu, która umożliwia wykonanie działania, gdy .

Funkcja wywołania zwrotnego przyjmuje te parametry:

containerName Nazwa kontenera jednostki reklamowej lub jednostki podobnego wyszukiwania.
adsLoaded Ustaw wartość „true”, jeśli występuje co najmniej jedna reklama lub podobne wyszukiwane hasło do wyświetlenia, a wartość „false” (fałsz) , gdy nie pojawiły się żadne reklamy ani podobne wyszukiwania.
isExperimentVariant Ustaw wartość „true”, jeśli trwa eksperyment dotyczący stylu niestandardowego, a wariant eksperyment jest wybierany do renderowania reklam.
callbackOptions Obiekt JSON zawierający te pola:
termPositions: W przypadku bloku podobnego wyszukiwania zawiera element map<string,int> podane przez wydawcę do zerowej pozycji tych haseł w odpowiedzi. Jeśli podano hasło ale nie zostanie zwrócony, nie pojawi się na mapie.

Uwaga: przetestuj funkcję wywołania zwrotnego, aby upewnić się, że nie generuje żadnych błędów. zwłaszcza takie, które mogą utrudniać wczytywanie strony.

Przykład wywołania zwrotnego JavaScriptu:

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
    }
  }
};
      
number Opcjonalny
Liczba reklam, jaka powinna pojawić się w tej jednostce. Wartością domyślną jest 2.

Przykład:

'number' : 4
relatedSearches Opcjonalny
Liczba podobnych wyszukiwań, która powinna pojawić się w tej jednostce. Jeśli nie zostanie podana, domyślna wartość to 0.

Przykład:

'relatedSearches' : 4