Materiały referencyjne

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

Przykład:

'pubId' : 'test-property'

Uwaga: użycie tego parametru w przypadku podobnego wyszukiwania na stronach z treścią spowoduje nieoczekiwane wyniki.

Przykłady:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

Przykład:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' Użyj tej opcji w przypadku podobnego wyszukiwania na stronach z treścią (np. artykułach, postach na blogu).
• 'query' Używaj tej opcji wyłącznie w przypadku podobnego wyszukiwania na stronach wyników wyszukiwania.

Uwaga: parametr strony relatedSearchTargeting jest domyślnie ustawiony na wartość „query”. Warto jednak pamiętać, że ta wartość domyślna jest przeznaczona tylko dla stron wyników wyszukiwania (podobne wyszukiwanie w wyszukiwarce). Jeśli korzystasz z podobnego wyszukiwania na dowolnym innym typie strony (np. artykułach, postach na blogu), musisz wyraźnie ustawić wartość parametru na „content”.

Uwaga: stosowanie tego parametru podlega tym wytycznym:

• Niektóre funkcje podobnych wyszukiwań mogą być włączone lub wyłączone w zależności od wartości tego parametru strony.
• Fałszywe przedstawianie typu strony lub korzystanie z domyślnego ustawienia „query” parametru relatedSearchTargeting na stronach innych niż strony wyników wyszukiwania jest uznawane za naruszenie tych pisemnych instrukcji.
• Google może okresowo weryfikować dokładność tej wartości, niezależnie od tego, czy została ona ustawiona ręcznie, czy przy użyciu wartości domyślnej.

Przykłady:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

Przykład:

'styleId': '1234567890'

• '_top' Otwiera się w tym samym oknie.
• '_blank' Otwiera się w nowym oknie.

Przykład:

'linkTarget' : '_blank'

Stosowanie tego parametru podlega tym wytycznym:

• Ten parametr należy podawać tylko w odpowiedzi na żądanie dotyczące podobnego wyszukiwania dla treści. W przypadku pozostałych żądań zostanie on zignorowany.
• Należy go używać tylko w przypadku ruchu celowo pozyskiwanego z innych witryn. Nie można go więc stosować do ruchu bezpłatnego.
• Powinien zawierać tytuł, opis lub inne sformułowania w reklamie lub kreacji będącej podstawą linku.
• Pomijanie wartości w kreacji reklamy lub linku (lub dodawanie dodatkowych wartości) jest uznawane za naruszenie tych pisemnych instrukcji.
• Wielkość liter nie jest rozróżniana.
• Obsługuje prawidłowe kodowanie UTF-8, znaki Unicode i znaki diakrytyczne.
• Google może użyć przesłanego przez Ciebie parametru lub go zignorować. Jeśli zostanie on użyty, może mieć wpływ na wybór i ranking 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'

Przykład:

'resultsPageQueryParam' : 'query'

Uwaga: gdy używasz tego parametru, referrerAdCreative jest również wymagany, a parametr relatedSearchTargeting musi być ustawiony na „content”.

Przykłady:

'terms' : 'cars rental, flight ticket'

Uwaga: aby podobne zapytania mogły pojawiać się w Twojej witrynie, Google musi zindeksować Twoje strony i upewnić się, że hasła pasują do kontekstu. Jeśli strona nie została jeszcze zaindeksowana lub jest zablokowana przed indeksowaniem (np. przez plik robots.txt) przez robota indeksującego AdSense, nie będziemy wyświetlać sugerowanych powiązanych wyszukiwań, które przesyłasz do Google.

Usługa podobnych wyszukiwań w treściach korzysta z systemu indeksowania treści Google, aby indeksować strony i generować odpowiednie wyszukiwane hasła. Adresy URL stron z treściami zawierające parametry zapytań, takie jak zmienne śledzenia, identyfikatory użytkowników, identyfikatory sesji lub inne identyfikatory dynamiczne, mogą utrudniać robotowi ocenianie głównych treści na stronie i prowadzić do nieprawidłowych lub nieistotnych powiązanych wyszukiwanych haseł. Ten parametr strony nakazuje robotowi Google zignorowanie tych nieistotnych parametrów, co zapewnia prawidłowe indeksowanie treści i zmniejsza niepotrzebne obciążenie związane z pobieraniem. Dzięki temu Google może lepiej rozpoznawać, że strona została już zindeksowana, i zacząć wyświetlać sugerowane terminy (zarówno Google, jak i partnera, jeśli się kwalifikuje).

Stosowanie tego parametru podlega tym wytycznym:

• Ten parametr należy podawać tylko w odpowiedzi na żądanie dotyczące podobnego wyszukiwania dla treści. W przypadku pozostałych żądań zostanie on zignorowany.
• Wartością tego parametru powinna być rozdzielona przecinkami lista parametrów URL, które mogą pojawiać się, gdy użytkownik przechodzi na stronę z treścią.
• Wielkość liter jest rozróżniana.
• Gdy z adresu URL strony z treścią zostanie usunięty dowolny parametr z tej listy, nie powinno to mieć istotnego wpływu na treść, wygląd ani wygodę użytkownika.
• Umieszczenie parametru adresu URL, który ma znaczący wpływ na zawartość, wygląd lub wrażenia użytkownika, jest uznawane za naruszenie tych pisemnych instrukcji.
• Google może okresowo sprawdzać, jaki jest efekt ignorowania podanych parametrów adresu URL.

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

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

• 'high' Wyświetla reklamy dla całej rodziny. Nie wyświetla reklam nieodpowiednich dla całej rodziny lub zawierających treści o charakterze seksualnym.
• 'medium' Wyświetla reklamy dla całej rodziny i nie dla całej rodziny. Nie wyświetla reklam zawierających treści o charakterze seksualnym.
• 'low' Wyświetlanie wszystkich rodzajów reklam.

Domyślnie parametr adsafe ma wartość high.

Przykład:

'adsafe': 'medium'

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

Żądania reklamy z parametrem adtest ustawionym na on pochodzące z domeny, która nie została zatwierdzona na karcie Witryny, będą zwracać niemożliwe do kliknięcia reklamy z nakładką „reklama testowa”.

Z tego parametru należy korzystać podczas testowania. Nie stosuj go w systemach roboczych, bo nie otrzymasz wtedy pieniędzy za wyświetlane reklamy.

Wartość domyślna parametru adtest to „off”.

Przykład:

'adtest' : 'on'

Przykłady:

'channel' :  'testA'  

'channel' :  'testA+testB'  

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

Uwaga: języki, na jakie kierowane są reklamy, określają reklamodawcy. Jeśli umieścisz ten parametr w swoim żądaniu, serwer Google będzie wyświetlał 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'

Parametr ie określa schemat kodowania znaków, który powinien być użyty do interpretacji ciągu zapytania.

Domyślna wartość parametru ie to utf-8.

Parametr oe określa schemat kodowania znaków, którego Google ma użyć do kodowania tekstu reklam. Chociaż jest opcjonalny, przekazanie wartości dla tego parametru jest dobrą praktyką.

Domyślna wartość parametru oe to utf-8.

• true Gdy tego parametru nie ma lub ma on wartość „true”, ustawimy plik cookie służący tylko do wykrywania nieprawidłowego ruchu i będziemy używać pamięci lokalnej tylko w przypadku użytkowników, którzy wyrazili zgodę.
• false Gdy ustawisz ten parametr na „false”, będziemy ustawiać pliki cookie służące tylko do wykrywania nieprawidłowego ruchu i 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 IVT ma wartość „true”.

Przykład:

'ivt': false

Przykład:

'container' : 'afscontainer1'

Ten parametr służy do określania 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, aby pierwszy wiersz reklam nie został zwinięty. Używanie parametru maxTop w innym miejscu na stronie jest niedozwolone.

Przykład:

'maxTop' : 4

Przykład:

'width' : '700px'

'width' : 700

Funkcja wywołania zwrotnego przyjmuje te parametry:

Uwaga: przetestuj swoją funkcję wywołania zwrotnego, aby mieć pewność, że nie powoduje ona żadnych błędów, a 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
    }
  }
};
      

Przykład:

'number' : 4

Przykład:

'relatedSearches' : 4