Posegmentowane raporty

Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na nowy interfejs Search Ads 360 Reporting API i jego używaniu.

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
}
  

Uwaga: uważaj na daty. Jeśli prosisz o raport kwartalny, sprawdź, czy pole timeRange dla raportu obejmuje cały kwartał. W przeciwnym razie zobaczysz tylko częściowe wyniki, co może sprawić, że użytkownicy myślą, że znacznie zmniejszyła się liczba kliknięć, przychody itd.

Żą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 i quarterEnd. 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.