Posegmentowane raporty

Interfejs Search Ads 360 API zwraca tylko dane zbiorcze, chyba że poprosisz o bardziej szczegółowe, posegmentowane dane i skalowalnych danych. Na przykład kolumna kliknięć w słowie kluczowym zawiera łączną liczbę kliknięć słowa kluczowego w wybranym okresie.

Jeśli jednak wyświetlisz raport dotyczący słów kluczowych podzielony na segmenty według kwartału, dla każdego słowa kluczowego każdy kwartał będzie wyświetlany po jednym wierszu, a w kolumnie kliknięć będą podane sumy kwartalne.

Pamiętaj, że raport podzielony na segmenty zwraca wiersz tylko wtedy, gdy dla segmentu są dostępne dane. Na przykład w raporcie słów kluczowych z kolumną floodlightActivity słowa kluczowe i Para aktywności Floodlight nie pojawi się w raporcie, jeśli nie zostaną przypisane żadne dane dla zakresu dat raportu.

Niektóre segmenty są niezgodne z określonymi kolumnami

Niektóre segmenty mogą powodować, że wybrane kolumny będą zwracać nieprawidłowe dane. Na przykład segmentowanie według Kolumna floodlightActivity ma znaczenie tylko wtedy, gdy uwzględnisz kolumny z danymi Floodlight takie jak dfaActions, dfaRevenue, dfaTransactions, i dfaWeightedActions. Inne typy kolumn konwersji (np. adWordsConversions) lub kolumn z danymi wyszukiwarki (takimi jak kliknięcia i wyświetlenia), nie zawierają danych raportowanych przez Floodlight, więc jeśli podasz nieprawidłowe wartości, posegmentować raport według parametru floodlightActivity.

Jak zażądać raportu podzielonego na segmenty

Aby poprosić o segmentację raportu, uwzględnij kolumnę zawierającą segment jako jego działanie w dokumencie Typy raportów.

To żądanie asynchroniczne dotyczy raportu słów kluczowych posegmentowanego według kwartału. 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
}