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 Twój identyfikator klienta AdSense. Identyfikator pubId to część identyfikatora klienta po ciągu „partner-”. Jeśli na przykład identyfikator klienta to „partner-test-property”, identyfikator 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ć niezakodowana. Uwaga: stosowanie tego parametru na stronach z podobnym wyszukiwaniem na stronach z treścią może spowodować nieoczekiwane wyniki. 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 zapytanie jest podobnym wyszukiwanym hasłem, które kliknął użytkownik. Parametr resultsPageBaseUrl może zawierać własne parametry z wyjątkiem zapytania, które będzie dołączane 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. Określa ona typ wyświetlania podobnych wyszukiwań w zależności od kontekstu strony:
Uwaga: parametr strony relatedSearchKierowanie ma domyślnie wartość „query”. Pamiętaj jednak, że ta wartość domyślna jest przeznaczona tylko dla stron wyników wyszukiwania (podobne wyszukiwanie w wyszukiwarce). Jeśli używasz podobnego wyszukiwania na stronach innego typu (np. w artykułach lub postach na blogu), musisz wyraźnie ustawić parametr „content” jako „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 na stronie. Dowiedz się więcej o korzystaniu z niestandardowych stylów reklamy w wyszukiwarce. Pamiętaj, że gdy ustawisz w żądaniu parametr styleId, reklamy i podobne wyszukiwania będą renderowane z użyciem tego stylu, a starsze parametry stylu będą ignorowane. Jeśli w żądaniu nie określisz atrybutu styleId, zostanie wyświetlony domyślny styl systemu. Przykład: 'styleId': '1234567890' |
Opcjonalny
Parametr | Opis i przykłady |
---|---|
linkTarget
|
Opcjonalny Określa, czy kliknięcie reklamy ma otworzyć się w tym samym czy nowym oknie. 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
|
Opcjonalnie Jeśli użytkownik trafia na Twoją 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ę, jako dosłowny tekst kreacji tej reklamy lub linku należy ustawić ten parametr. 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 wyszukiwanego hasła 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 rozdzielanej przecinkami Twoich podobnych wyszukiwanych haseł, które będą zwracane w odpowiedzi na żądanie podobnego wyszukiwania. Google może używać podanych tutaj haseł, ale nie musi.
Uwaga: gdy używasz tego parametru, właściwość Przykłady: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
Opcjonalny Określa listę parametrów adresu URL strony z treścią z jednostką podobnego wyszukiwania dla treści, którą można bezpiecznie zignorować bez wpływu na główne treści czy wygodę użytkowników. Uwaga: zanim podobne wyszukiwania będą mogły pojawiać się w Twojej witrynie, Google musi zindeksować Twoje strony, aby upewnić się, że pasują kontekstowo. 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. Ten parametr strony informuje robota Google, że ma ignorować te zbędne parametry, co zapewni poprawne 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 partnerskie, jeśli się kwalifikujesz). Stosowanie tego parametru podlega tym wytycznym:
Przykłady:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Podanie tych niemożliwych do pominięcia parametrów adresu URL: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Adres URL strony z treścią będzie traktowany w taki sposób: 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. Oto prawidłowe ustawienia 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 z nakładką „reklama testowa” i nieklikalne. 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
|
Opcjonalnie Aby śledzić skuteczność różnych stron, możesz dodać kanał AdSense dla wyszukiwania. Użyj unikalnego identyfikatora kanału utworzonego na Twoim koncie AdSense lub technicznego menedżera konta. Więcej informacji o kanałach znajdziesz tutaj. Kilka kanałów należy rozdzielić symbolem „+”. 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 zezwolić na wyświetlanie reklam używających pamięci lokalnej oraz plików cookie służących tylko do wykrywania nieprawidłowego ruchu w przypadku ruchu użytkowników, którzy wyrazili zgodę, i użytkowników, 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 się pojawić 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 powinna być na tyle szeroka, by pierwszy wiersz reklam się nie zawinął. Używanie parametru maxTop w innym miejscu na stronie jest naruszeniem zasad. Przykład: 'maxTop' : 4 |
width
|
Wymagany Określa szerokość w pikselach reklamy lub jednostki podobnego wyszukiwania. Przykład: 'width' : '700px' 'width' : 700 |
Ustawienia konfiguracji
Parametr | Opis i przykłady | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
Opcjonalne Określa funkcję JavaScriptu, która ma być wywoływana, gdy wczytają się reklamy lub podobne wyszukiwania albo gdy nie wyświetlą się żadne reklamy ani podobne wyszukiwania. Powinien on być ustawiony na funkcję wywołania zwrotnego JavaScriptu, która umożliwia wykonanie działania po zakończeniu wywołania reklamy. Funkcja wywołania zwrotnego przyjmuje te parametry:
Uwaga: przetestuj funkcję wywołania zwrotnego, aby mieć pewność, że nie generuje żadnych błędów, zwłaszcza takich, które mogą zakłócać 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
|
Opcjonalne Liczba reklam, które powinny pojawić się w tej jednostce. Wartością domyślną jest 2. Przykład: 'number' : 4 |
||||||||
relatedSearches
|
Opcjonalne Liczba podobnych wyszukiwań, które powinny pojawić się w tej jednostce. Jeśli nie zostanie podana, domyślna wartość to 0. Przykład: 'relatedSearches' : 4 |