Interfejs Search Ads 360 API zwraca tylko dane zbiorcze, chyba że poprosisz o bardziej szczegółowe, posegmentowane dane. Na przykład kolumna kliknięć w raporcie słów kluczowych zawiera łączną liczbę kliknięć słowa kluczowego w określonym przez Ciebie przedziale czasu.
keywordText | keywordLandingPage | kliknięcia |
---|---|---|
widżety | http://www.example.com | 6000 |
Jeśli jednak poprosisz o raport o słowach kluczowych z podziałem na kwartał, dla każdego słowa kluczowego zobaczysz po jednym wierszu na każdy kwartał, a w kolumnie kliknięć znajdziesz sumy kwartalne.
keywordText | keywordLandingPage | quarterStart | quarterEnd | kliknięcia |
---|---|---|---|---|
widżety | http://www.example.com | 2012-01-01 | 2012-03-31 | 1000 |
widżety | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
widżety | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
widżety | http://www.example.com | 2012-10-01 | 2012-12-31 | 3000 |
Pamiętaj, że raport podzielony na segmenty zwraca wiersz tylko wtedy, gdy dla segmentu dostępne są dane.
Na przykład w raporcie słów kluczowych z kolumną floodlightActivity
para słowa kluczowego i aktywności Floodlight nie pojawi się w raporcie, jeśli w zakresie dat raportu nie zostaną do niej przypisane żadne dane.
Niektóre segmenty są niezgodne z określonymi kolumnami
Niektóre segmenty mogą powodować, że określone kolumny będą zwracać nieprawidłowe dane. Na przykład segmentowanie według właściwości floodlightActivity
jest istotne tylko wtedy, gdy uwzględnisz kolumny zawierające dane Floodlight, takie jak dfaActions
, dfaRevenue
, dfaTransactions
i dfaWeightedActions
. Inne typy kolumn konwersji (np. adWordsConversions
) lub kolumny zawierające dane z wyszukiwarki (np. kliknięcia i wyświetlenia) nie zawierają danych raportowanych przez Floodlight, więc jeśli posegmentujesz raport według wartości floodlightActivity
, zwracają nieprawidłowe wartości.
Jak pobrać raport podzielony na segmenty
Aby poprosić o podzielenie raportu na segmenty, dodaj kolumnę z listą segment
jako sposób działania w dokumentacji referencyjnej Typy raportów.
Podane niżej żądanie asynchroniczne dotyczy raportu słów kluczowych podzielonego na segmenty według kwartału. Kolumna kliknięć w każdym wierszu będzie zawierać łączną liczbę kliknięć w danym kwartale:
{ "reportScope": { "agencyId": "20700000000000123", // Replace with your IDs "advertiserId": "2170000012345" // Replace with your IDs }, "reportType": "keyword", "columns": [ { "columnName": "campaignId" }, { "columnName": "keywordText" }, { "columnName": "keywordLandingPage" }, { "columnName": "quarterStart" }, { "columnName": "quarterEnd" }, { "columnName": "clicks" }, ] "timeRange" : { "startDate" : "2012-01-01", "endDate" : "2012-12-31" }, "downloadFormat": "csv", "maxRowsPerFile": 5000000, "statisticsCurrency": "agency", "verifySingleTimeZone": false, "includeRemovedEntities": false }
Żądanie wielu segmentów
W żądaniu możesz umieścić więcej niż jedną kolumnę segmentu. Pamiętaj:
-
Jeśli segmentujesz dane według tygodnia, miesiąca lub kwartału, zalecamy uwzględnienie w żądaniu zarówno kolumny początkowej, jak i końcowej. Na przykład w raporcie kwartalnym uwzględnij zarówno kolumny
quarterStart
, jak iquarterEnd
. Jeśli uwzględnisz obie te kolumny, zobaczysz daty rozpoczęcia i zakończenia okresu, co pozwoli Ci sprawdzić, czy zostały uwzględnione dane dla każdego pełnego okresu. -
W jednym żądaniu nie możesz uwzględnić różnych typów segmentów związanych z czasem. W tym samym żądaniu nie można na przykład segmentować według kwartału i miesiąca.
-
Liczba wierszy może rosnąć wykładniczo z każdym dodatkowym segmentem.