Materiały referencyjne

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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. Jeśli np. 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 lub postach na blogu).
• 'query' Używaj tej opcji wyłącznie do funkcji Podobne wyszukiwanie na stronach wyników wyszukiwania.

Uwaga: parametr strony relatedSearchTargeting jest domyślnie ustawiany na „query”. Pamiętaj jednak, że ta wartość domyślna jest przeznaczona tylko do stron wyników wyszukiwania (podobne wyszukiwanie w wyszukiwarce). Jeśli używasz podobnego wyszukiwania na dowolnej innej stronie (np. w artykule lub poście na blogu), musisz wyraźnie ustawić parametr na „content”.

Uwaga: w przypadku stosowania tego parametru obowiązują te wytyczne:

• Niektóre funkcje wyszukiwania powiązanego mogą być włączone lub wyłączone w zależności od wartości tego parametru strony.
• Nieprawidłowe przedstawienie typu strony lub korzystanie z domyślnego ustawienia „query” (zapytanie) parametru relatedSearchTargeting na stronach, które nie są stronami wyników wyszukiwania, jest uznawane za naruszenie tych instrukcji.
• Google może okresowo sprawdzać poprawność tej wartości niezależnie od tego, czy została ona ustawiona ręcznie, czy domyślnie.

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 wyrażenia występujące w reklamie bądź kreacji linku.
• Pominięcie wartości w reklamie lub kreacji linku (lub uwzględnienie 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, musisz też podać parametr referrerAdCreative, który jest wymagany, oraz parametr relatedSearchTargeting, który musi mieć wartość „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 są trafne w kontekście. Jeśli strona nie została jeszcze zindeksowana lub została zablokowana przez robota AdSense (np. przez plik robots.txt), nie będziemy wyświetlać sugerowanych powiązanych haseł, które przekazujesz Google.

Usługa Powiązane wyszukiwania w treści korzysta z systemu indeksowania treści Google do indeksowania stron i generowania odpowiednich haseł wyszukiwania. 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 mogą prowadzić do nieprecyzyjnych lub nieistotnych powiązanych haseł wyszukiwania. Ten parametr strony instruuje robota Google, aby zignorował te nieistotne parametry, co zapewni właściwe indeksowanie treści i zmniejszy niepotrzebne obciążenie robota. 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 partnerów, jeśli kwalifikują się do tego).

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ść tego parametru powinna być rozdzieloną przecinkami listą parametrów adresu URL, które mogą się pojawić, gdy użytkownik przejdzie na stronę z treściami.
• Wielkość liter ma znaczenie.
• Jeśli usuniesz z adresu URL strony z treści dowolny parametr z tej listy, nie powinno to znacząco wpłynąć na treść, wygląd ani wygodę użytkowników.
• Użycie parametru adresu URL, który znacząco wpływa na zawartość, wygląd lub wrażenia użytkowników, 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, a adres URL znajduje się:

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 nieodpowiednie 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 reklam z parametrem adtest o wartości 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 które 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ślną wartością parametru ie jest 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ślną wartością parametru oe jest utf-8.

• true Jeśli ten parametr nie jest obecny lub jeśli ustawisz go na „true”, ustawimy plik cookie służący tylko do wykrywania nieprawidłowego ruchu i użyjemy pamięci lokalnej tylko w przypadku ruchu z uzyskaną zgodą.
• false Gdy ustawisz to ustawienie na „fałsz”, ustawimy plik cookie służący tylko do wykrywania nieprawidłowego ruchu i użyjemy 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” (prawda).

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