Dla zaawansowanych użytkowników przygotowaliśmy tę listę obsługiwanych aktualnie parametrów stylu reklamy w wyszukiwarce. Kod wygenerowany w AdSense zawiera wszystkie najczęściej używane ustawienia parametrów. Wymagane są 2 parametry: pubId
i query
. AdSense udostępnia identyfikator „pubId”, ale musisz zmodyfikować kod strony, aby przekazywać wartość parametru query
. Wszystkie pozostałe parametry są opcjonalne i zostały opisane poniżej.
Typy parametrów
Są 2 rodzaje parametrów:
- parametry na poziomie strony, które mają zastosowanie do wszystkich jednostek reklamowych na stronie;
- parametry na poziomie jednostki, które mają zastosowanie do poszczególnych jednostek reklamowych.
Oto przykładowe dane wyjściowe z generatora kodu z 2 blokami reklam. Aby skonfigurować ten kod, musisz ustawić wymagany parametr query
w mapie pageOptions
(np. “query”: myQuery
). To wszystko, co trzeba zrobić, aby zacząć wyświetlać reklamy. Możesz też ustawić opcjonalne parametry na poziomie strony w bloku na poziomie strony oraz parametry na poziomie poszczególnych jednostek w mapach adblock1
i adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Parametry na poziomie strony
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Parametry na poziomie jednostki
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Opis parametrów na poziomie strony
Te parametry wystarczy podać tylko raz na stronę. Wpływają one na wszystkie jednostki na stronie.
Wymagane
Parametr | Opis i przykłady |
---|---|
adPage |
Wymagany, gdy użytkownik przejdzie na następną lub poprzednią stronę wyników wyszukiwania
Parametr |
pubId |
Wymagany Jest to Twój identyfikator klienta AdSense. Identyfikator „pubId” to część identyfikatora klienta, która następuje po fragmencie „partner-”. Jeśli Twój identyfikator klienta to np. „partner-test-property”, identyfikator „pubId” to „test-property”. Jest to standardowy protokół reklam w wyszukiwarce niestandardowej. Przykład: 'pubId' : 'test-property' |
query |
Wymagany Jest to wyszukiwane hasło wpisane przez użytkownika. Wartość parametru zapytania powinna być niekodowana. Przykłady:
|
resultsPageBaseUrl |
Wymagany, jeśli na stronie znajdują się jednostki podobnych wyszukiwań Określa adres URL strony wyników wyszukiwania, na której zapytanie jest podobnym wyszukiwanym hasłem klikniętym przez użytkownika. Parametr resultsPageBaseUrl może mieć własne parametry oprócz zapytania, które jest dołączane automatycznie.
Przykład:
|
styleId |
Wymagany Określa identyfikator stylu reklamy w wyszukiwarce, który ma być stosowany na stronie do jednostek reklamowych lub jednostek podobnych wyszukiwań. Dowiedz się więcej o używaniu stylów reklamy w wyszukiwarce. Pamiętaj, że gdy ustawisz w żądaniu parametr „styleId”, reklamy i podobne wyszukiwania będą renderowane za pomocą tego stylu, a starsze parametry stylu będą ignorowane. Jeśli w żądaniu brak parametru „styleId”, do renderowania zostanie użyty domyślny styl systemu. Przykład
|
Opcjonalne
Parametr | Opis i przykłady |
---|---|
linkTarget |
Opcjonalny Określa, czy kliknięcie reklamy powoduje otwarcie strony w tym samym oknie czy w nowym. Wartość domyślna to „_top”. Tego parametru możesz też używać na poziomie jednostki.
Przykład: 'linkTarget' : '_blank' |
maxTermLength |
Opcjonalny Określa maksymalną liczbę znaków (ze spacjami) podobnego wyszukiwanego hasła. Jeśli nie ustawisz tego parametru, nie ma limitu znaków. Przykład: 'maxTermLength' : 50 |
referrerAdCreative |
Opcjonalny Jeśli użytkownik dociera na Twoją stronę z treścią, która zawiera jednostkę podobnego wyszukiwania dla treści, po kliknięciu w innej witrynie reklamy lub linku będących pod Twoją kontrolą, w wartości tego parametru podaj dosłowny tekst kreacji tej reklamy lub tego linku. Stosowanie tego parametru podlega tym wytycznym:
Przykłady: 'referrerAdCreative': 'wyszukiwanie dotyczące reklam związanych z implantami zębowymi' 'referrerAdCreative': 'Wczesne objawy artropatii łuszczycowej' |
resultsPageQueryParam |
Opcjonalny Określa nazwę parametru adresu URL w przypadku wyszukiwanego hasła na stronie wyników wyszukiwania. Jeśli nie zostanie podany, wartość domyślna to „q”. Przykład: 'resultsPageQueryParam' : 'query' |
terms |
Opcjonalny Ten parametr umożliwia Ci podanie listy rozdzielanych przecinkami własnych podobnych wyszukiwanych haseł, które powinny być zwracane w przypadku żądania podobnego zapytania. Google może używać tych haseł lub też nie. Przykład: 'terms' : 'cars rental, flight ticket' |
Ustawienia konfiguracji
Parametr | Opis i przykłady | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Opcjonalny Określa reguły filtrowania, które Google ma stosować do reklam pasujących do wyszukiwanego hasła. Poniżej podano prawidłowe ustawienia parametru adsafe i wpływ każdej wartości na wyświetlane reklamy:
Uwaga: wartość domyślna parametru
adsafe to „high”.Przykład: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Opcjonalny Parametr adtest służy do sygnalizowania, że żądanie reklamy ma charakter testowy. Gdy parametr adtest ma wartość „on”, Google traktuje żądanie jako test i nie zlicza wyświetleń reklam ani liczby ich kliknięć.Gdy parametr Uwaga: z tego parametru należy korzystać podczas testowania. Nie stosuj go w systemach roboczych, bo nie otrzymasz wówczas pieniędzy za wyświetlane reklamy.
Wartość domyślna parametru adtest to „off”. Przykład: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Opcjonalny Aby śledzić skuteczność różnych stron, możesz dodać kanał AdSense dla wyszukiwania. Użyj unikalnego identyfikatora kanału utworzonego na koncie AdSense. Dowiedz się więcej o śledzeniu skuteczności reklam za pomocą kanałów niestandardowych. Do rozdzielania wielu kanałów używaj symbolu „+”. Przykłady: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Opcjonalny Ten parametr określa język, na jaki mają być kierowane żądane reklamy. Wartość domyślna tego parametru to „en”. Google obsługuje wszystkie kody języków interfejsu Google Ads 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 Przykłady: 'hl' : 'pl' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Opcjonalny
Parametr Domyślną wartością parametru
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Opcjonalny
Parametr Wartość domyślna parametru
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Opcjonalny Określa, czy użytkownicy zgodzili się na udostępnianie Google danych osobowych przez wydawcę na potrzeby wyświetlania reklam spersonalizowanych.
Uwaga: wartość domyślna parametru
personalizedAds to „true”.Przykład: 'personalizedAds': false |
Opis parametrów na poziomie jednostki
Te parametry wpływają na sposób pokazywania 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 id='afscontainer1'></div> , w którym powinna się pojawić reklama.Przykład:
|
maxTop |
Wymagany
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:
|
width |
Wymagany Określa szerokość (w pikselach) jednostki reklamowej lub jednostki podobnych wyszukiwań. Przykłady: 'width' : '700px' 'width' : 700 |
Ustawienia konfiguracji
Parametr | Opis i przykłady | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Opcjonalny Wskazuje funkcję JavaScriptu, która ma być wywoływana, gdy zostaną wczytane reklamy lub podobne wyszukiwania albo gdy nie wyświetlą się żadne reklamy ani podobne wyszukiwania. Wartość tego parametru powinna określać funkcję wywołania zwrotnego JavaScriptu, która umożliwia wykonanie wybranego działania po zakończeniu wywołania reklamy. 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 } } }; |
||||||||
number |
Opcjonalny Liczba reklam, jaka powinna się pojawić w danej jednostce. Wartość domyślna to „2”. Przykład:
|
||||||||
relatedSearches |
Opcjonalny Liczba podobnych wyszukiwań, jaka powinna się pojawić się w danej jednostce. Ten parametr zwraca co najmniej 3 podobne wyszukiwania, chyba że jego wartość jest ustawiona na „0”. Jeśli nie zostanie podana, przyjmuje domyślnie wartość „0”. Przykład: 'relatedSearches' : 4 |