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 |
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:
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:
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.
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:
Uwaga: ten parametr jest wymagany, gdy używasz parametru
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, 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:
Przykłady:
http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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:
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 Domyślną wartością parametru
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
Opcjonalny Parametr Domyślną wartością parametru
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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.
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:
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 |