Posegmentowane raporty

Nowy interfejs Search Ads 360 Reporting API jest już dostępny. Nowy interfejs API zapewnia większa elastyczność tworzenia raportów niestandardowych i integrowania danych z aplikacjami służącymi do raportowania. i procesach. Więcej informacji o przechodzeniu do nowej wersji Search Ads 360 Raportowanie i korzystaniu z niej API.

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.

keywordText keywordLandingPage kliknięcia
widżety http://www.example.com 6000

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.

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 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
}
Uwaga: zachowaj ostrożność podczas wybierania dat. Jeśli chcesz wygenerować raport kwartalny, upewnij się, że parametr timeRange raportu. obejmuje cały kwartał. W przeciwnym razie uzyskasz tylko częściowe wyniki, co może sprawić, osób uważa, że nastąpił znaczny spadek liczby kliknięć, przychodów itp.

Wysyłanie próśb o wiele segmentów

Żądanie może zawierać więcej niż jedną kolumnę segmentu. Pamiętaj:

  • Jeśli segmentujesz według tygodnia, miesiąca lub kwartału, zalecamy podanie kolumny początkowej i końcowej w żądaniu. Na przykład w raporcie kwartalnym uwzględnij zarówno kolumny quarterStart i quarterEnd. Uwzględnienie obu tych elementów podają daty rozpoczęcia i zakończenia, co ułatwi potwierdzenie uwzględniono dane dla każdego pełnego okresu.

  • W jednym żądaniu nie można uwzględnić różnych typów segmentów związanych z czasem. Nie możesz na przykład segmentować danych według kwartału i miesiąca w jednym żądaniu.

  • Liczba wierszy może wzrastać wykładniczo z każdym kolejnym segmentem.