Raport płatnych wyników wyszukiwania zawiera wyszukiwane hasła, które spowodowały wyświetlenie Twoich reklam w Google lub spowodowały, że w Google pojawiły się bezpłatne wyniki wyszukiwania. Raport płatnych i bezpłatnych wyników wyszukiwania zawiera dane tylko wtedy, gdy wcześniej skonfigurujesz go na koncie wyszukiwarki objętym raportowaniem.
Ten raport może zostać zwrócony tylko przez żądanie asynchroniczne (czyli metodą Reports.request()).
Poproś o fragment
Wyślij standardową treść żądania Reports.request(), ale określ "reportType": "paidAndOrganic".
{
...
"reportType": "paidAndOrganic",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
W każdej kolumnie, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName w tabeli poniżej.
Możesz też określić właściwości headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Więcej informacji znajdziesz w tabeli „Filtrowalne”.
columnName | opis, | Sposób działania | Typ | Możliwe do filtrowania |
|---|---|---|---|---|
agency |
Nazwa agencji. | atrybut | String |
Tak |
agencyId |
Identyfikator agencji w DS. | atrybut | ID |
Tak |
advertiser |
Nazwa reklamodawcy. | atrybut | String |
Tak |
advertiserId |
Identyfikator reklamodawcy DS. | atrybut | ID |
Tak |
account |
Nazwa konta wyszukiwarki. | atrybut | String |
Tak |
accountId |
Identyfikator konta wyszukiwarki DS. | atrybut | ID |
Tak |
accountEngineId |
Identyfikator konta na zewnętrznym koncie wyszukiwarki. | atrybut | String |
Tak |
accountType |
Typ konta wyszukiwarki: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu lub Comparison Shopping. |
atrybut | Engine type |
Tak |
searchQuery |
Wyszukiwane hasła wpisane przez użytkowników Google. | atrybut | String |
Tak |
serpType |
Typ wyniku wyszukiwania, który kliknęli użytkownicy Google. Możliwe wartości to:
|
atrybut | SERP type |
Tak |
paidClicks |
Liczba kliknięć reklamy po wpisaniu zapytania. | wskaźnik | Integer |
Tak |
organicClicks |
Liczba kliknięć bezpłatnych wyników wyszukiwania dotyczących Twojej witryny po wpisaniu zapytania. | wskaźnik | Integer |
Tak |
paidAndOrganicClicks |
Liczba kliknięć jednej z Twoich reklam lub bezpłatnego wyniku wyszukiwania dotyczącego Twojej witryny, gdy użytkownik wpisał zapytanie. | wskaźnik | Integer |
Tak |
paidImpressions |
Liczba wyświetleń reklamy na stronie wyników wyszukiwania lub w witrynie w sieci Google po wpisaniu przez użytkownika wyszukiwanego hasła. | wskaźnik | Integer |
Tak |
organicQueries |
Łączna liczba użytkowników, którzy wpisali zapytanie, i zobaczyli co najmniej jeden bezpłatny wynik wyszukiwania z Twojej witryny. | wskaźnik | Integer |
Tak |
paidAndOrganicQueries |
Łączna liczba użytkowników, którzy wpisali wyszukiwane hasło i zobaczyli co najmniej jedną z Twoich reklam lub co najmniej jeden bezpłatny wynik wyszukiwania z Twojej witryny. | wskaźnik | Integer |
Tak |
paidCtr |
Współczynnik klikalności reklamy, który określa, jak często użytkownicy, którzy widzą Twoją reklamę, klikają ją po wpisaniu zapytania. | wskaźnik | Number |
Tak |
organicCtr |
Współczynnik pokazujący, jak często osoby, które widzą bezpłatne wyniki wyszukiwania Twojej witryny, klikają je i trafiają na Twoją stronę. | wskaźnik | Number |
Tak |
paidAndOrganicCtr |
Współczynnik kliknięć Twojej witryny przez użytkowników, którzy widzieli którąś z Twoich reklam lub bezpłatny wynik wyszukiwania i dotarli do Twojej witryny. | wskaźnik | Number |
Tak |
paidAvgPos |
Średnia pozycja, na której pojawia się reklama po wpisaniu zapytania. | wskaźnik | Number |
Tak |
organicAvgPos |
Średnia najwyższa pozycja witryny w bezpłatnych wynikach wyszukiwania. | wskaźnik | Number |
Tak |
paidCostPerClick |
Średni koszt kliknięcia reklamy. Jest to średnia kwota, jaką płacisz za każde kliknięcie Twojej reklamy. | wskaźnik | Money |
Tak |
date |
Podziel raport na segmenty według dni. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego dnia. Ta kolumna zawiera datę każdego wiersza. | podziel na segmenty | Date |
Tak |
monthStart |
Podziel raport na segmenty według miesięcy. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca pierwszy dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
monthEnd |
Podziel raport na segmenty według miesięcy. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca ostatni dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
quarterStart |
Podział raportu na segmenty według kwartałów. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień kwartału każdego wiersza. | podziel na segmenty | Date |
Tak |
quarterEnd |
Podział raportu na segmenty według kwartałów. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału każdego wiersza. | podziel na segmenty | Date |
Tak |
weekStart |
Segmentuje raport według tygodni (od niedzieli do soboty). Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszego dnia (niedzielę) każdego wiersza. | podziel na segmenty | Date |
Tak |
weekEnd |
Segmentuje raport według tygodni (od niedzieli do soboty). Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca ostatni dzień (sobota) każdego wiersza. | podziel na segmenty | Date |
Tak |
yearStart |
Segmentuje raport według lat. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy rok. Ta kolumna zwraca pierwszy dzień roku każdego wiersza. | podziel na segmenty | Date |
Tak |
yearEnd |
Segmentuje raport według lat. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy rok. Ta kolumna zwraca ostatni dzień roku w każdym wierszu. | podziel na segmenty | Date |
Tak |
campaign |
Segmentuje raport według kampanii. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdą kampanię w zakresie raportu. Ta kolumna zwraca nazwę kampanii. | podziel na segmenty | String |
Tak |
campaignId |
Segmentuje raport według kampanii. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdą kampanię w zakresie raportu. Ta kolumna zwraca identyfikator kampanii DS. | podziel na segmenty | ID |
Tak |
adGroup |
Podział raportu na segmenty według grupy reklam. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej grupy reklam w zakresie raportu. Ta kolumna zwraca nazwę grupy reklam. | podziel na segmenty | String |
Tak |
adGroupId |
Podział raportu na segmenty według grupy reklam. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej grupy reklam w zakresie raportu. Ta kolumna zwraca identyfikator grupy reklam DS. | podziel na segmenty | ID |
Tak |
keywordId |
Podział raportu na segmenty według słowa kluczowego. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każde słowo kluczowe w zakresie raportu. Ta kolumna zwraca identyfikator słowa kluczowego DS. | podziel na segmenty | ID |
Tak |
keywordMatchType |
Podział raportu na segmenty według słowa kluczowego. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każde słowo kluczowe w zakresie raportu. Ta kolumna zwraca typ dopasowania słowa kluczowego. | podziel na segmenty | Match type |
Tak |
keywordText |
Podział raportu na segmenty według słowa kluczowego. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każde słowo kluczowe w zakresie raportu. Ta kolumna zwraca tekst słowa kluczowego. | podziel na segmenty | String |
Tak |