Materiały referencyjne

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.

Przykład:

'pubId' : 'test-property'

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

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. 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'

Przykład:

'styleId': '1234567890'

• '_top' – strona otwiera się w tym samym oknie.
• '_blank' otwiera się w nowym oknie.

Przykład:

'linkTarget' : '_blank'

Przykład:

'maxTermLength' : 50

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'

Przykład:

'resultsPageQueryParam' : 'query'

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'

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

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

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'

Przykłady:

'channel' :  'testA'  

'channel' :  'testA+testB'  

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'

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.

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.

• 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

Przykład:

'container' : 'afscontainer1'

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

Przykład:

'width' : '700px'

'width' : 700

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
    }
  }
};
      

Przykład:

'number' : 4

Przykład:

'relatedSearches' : 4