Dla zaawansowanych użytkowników przygotowaliśmy tę listę obsługiwanych aktualnie parametrów stylu reklam 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. Przykład: 'pubId' : 'test-property' |
query |
Wymagany Jest to wyszukiwane hasło wpisane przez użytkownika. Wartość parametru zapytania powinna być niekodowana. Przykłady:
|
referrerAdCreative |
Wymagany (jeśli uzyskujesz ruch) Jeśli użytkownik dociera na Twoją stronę z treścią, która zawiera jednostkę podobnego wyszukiwania dla treści, ze źródła będącego pod Twoją kontrolą (w tym z dowolnej sieci, usługi lub podmiotu stowarzyszonego, z którym współpracujesz), w wartości tego parametru podaj dosłowny tekst kreacji tego źródła. Stosowanie tego parametru podlega tym wytycznym:
Uwaga: ten parametr jest wymagany, gdy używasz parametru
terms.Przykłady: 'referrerAdCreative': 'wyszukiwanie dotyczące reklam związanych z implantami zębowymi''referrerAdCreative': 'Wczesne objawy artropatii łuszczycowej' |
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 resultsPageBaseUr 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
|
Opcjonalny
| 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 |
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 Uwagi:
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 |
Wycofany
Uwaga: personalizacja reklam w AdSense dla wyszukiwania została wycofana. Więcej informacji znajdziesz w artykule AdSense dla wyszukiwania i inne usługi Search Ads będą korzystać z nowych domen docelowych, a personalizacja reklam zostanie wycofana.
|
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: |
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 } } }; |
||||||||
maxTop |
Opcjonalny
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: |
||||||||
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 podany, przyjmuje domyślnie wartość „0”. Przykład: 'relatedSearches' : 4 |
||||||||
width |
Opcjonalny Określa szerokość (w pikselach) jednostki reklamowej lub jednostki podobnych wyszukiwań. Przykłady: 'width' : '700px''width' : 700 |