Raport płatny i bezpłatne wyniki wyszukiwania pokazuje wyszukiwane hasła, które spowodowały wyświetlenie Twoich reklam w Google, spowodowały, że w Google pojawiły się bezpłatne wyniki wyszukiwania dotyczące Twojej witryny albo jedno i drugie. 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 (tzn. za pomocą funkcji Reports.request()).
Poproś o fragment
Wysyłaj regularnie
Reports.request()
treści żądania, ale określ "reportType": "paidAndOrganic"
.
{ ... "reportType": "paidAndOrganic", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Dla każdej kolumny, którą chcesz zwracać lub odfiltrować w raporcie,
określ columnName
wymienione w tabeli poniżej.
Możesz też opcjonalnie określić
headerText
startDate,
i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. odnosi się do kategorii „Można filtrować”. w tabeli poniżej.
columnName | Opis | Zachowanie | Typ | Można filtrować |
---|---|---|---|---|
agency |
Nazwa agencji. | atrybut | String |
Tak |
agencyId |
Identyfikator agencji 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 |
Rodzaj 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 słowa wpisane przez użytkowników Google. | atrybut | String |
Tak |
serpType |
Typ wyniku wyszukiwania, który klikali użytkownicy Google. Możliwe wartości to:
|
atrybut | SERP type |
Tak |
paidClicks |
Liczba kliknięć reklamy po wpisaniu wyszukiwanego hasła. | wskaźnik | Integer |
Tak |
organicClicks |
Liczba kliknięć bezpłatnych wyników wyszukiwania dotyczących Twojej witryny po wpisaniu przez użytkownika zapytania. | wskaźnik | Integer |
Tak |
paidAndOrganicClicks |
Liczba kliknięć jednej z Twoich reklam lub bezpłatnego wyniku wyszukiwania dotyczącego Twojej witryny po wpisaniu przez użytkownika zapytania. | 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 razy, gdy użytkownicy wprowadzili zapytanie i zobaczyli co najmniej jeden bezpłatny wynik wyszukiwania z Twojej witryny. | wskaźnik | Integer |
Tak |
paidAndOrganicQueries |
Łączna liczba razy, gdy użytkownicy wprowadzili zapytanie 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 osoby, które zobaczą Twoją reklamę, klikają ją po wpisaniu wyszukiwanego hasła. | 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ą do Twojej witryny. | wskaźnik | Number |
Tak |
paidAndOrganicCtr |
Współczynnik pokazujący, jak często osoby, które widzą jedną z Twoich reklam lub bezpłatny wynik wyszukiwania Twojej witryny, klikają je i trafiają do Twojej witryny. | wskaźnik | Number |
Tak |
paidAvgPos |
Średnia pozycja, na której wyświetla się reklama po wpisaniu zapytania. | wskaźnik | Number |
Tak |
organicAvgPos |
Średnia najwyższa pozycja Twojej 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 swojej reklamy. | wskaźnik | Money |
Tak |
date |
segmentuje raport według dni; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego dnia. Ta kolumna zawiera datę każdego wiersza. | podziel na segmenty | Date |
Tak |
monthStart |
segmentuje raport według miesięcy; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca pierwszy dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
monthEnd |
segmentuje raport według miesięcy; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca ostatni dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
quarterStart |
segmentowanie raportu według kwartałów; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień każdego kwartału. | podziel na segmenty | Date |
Tak |
quarterEnd |
segmentowanie raportu według kwartałów; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału każdego wiersza. | podziel na segmenty | Date |
Tak |
weekStart |
Segmentacja raportu według tygodni (od niedzieli do soboty); każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszy dzień (niedzielę) każdego wiersza. | podziel na segmenty | Date |
Tak |
weekEnd |
Segmentacja raportu według tygodni (od niedzieli do soboty); każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy tydzień. Ta kolumna zawiera ostatni dzień (sobota) każdego wiersza. | podziel na segmenty | Date |
Tak |
yearStart |
segmentuje raport według lat; każdy wiersz i jego dane zbiorcze są dzielone na wiele 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 jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy rok. Ta kolumna zawiera ostatni dzień roku każdego wiersza. | podziel na segmenty | Date |
Tak |
campaign |
segmentuje raport według kampanii; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdą kampanię w zakresie raportu. Ta kolumna zawiera nazwę kampanii. | podziel na segmenty | String |
Tak |
campaignId |
segmentuje raport według kampanii; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdą kampanię w zakresie raportu. Ta kolumna zwraca identyfikator kampanii DS. | podziel na segmenty | ID |
Tak |
adGroup |
segmentuje raport według grupy reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdej grupy reklam w zakresie raportu. Ta kolumna zawiera nazwę grupy reklam. | podziel na segmenty | String |
Tak |
adGroupId |
segmentuje raport według grupy reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdej grupy reklam w zakresie raportu. Ta kolumna zwraca identyfikator grupy reklam DS. | podziel na segmenty | ID |
Tak |
keywordId |
segmentuje raport według słowa kluczowego; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego słowa kluczowego w zakresie raportu. Ta kolumna zwraca identyfikator słowa kluczowego z DS. | podziel na segmenty | ID |
Tak |
keywordMatchType |
segmentuje raport według słowa kluczowego; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego słowa kluczowego w zakresie raportu. Ta kolumna zwraca typ dopasowania słowa kluczowego. | podziel na segmenty | Match type |
Tak |
keywordText |
segmentuje raport według słowa kluczowego; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego słowa kluczowego w zakresie raportu. Ta kolumna zwraca tekst słowa kluczowego. | podziel na segmenty | String |
Tak |