Raporty żądań

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.

Po skonfigurowaniu aplikacji klienckiej zgodnie z opisem w sekcji Moja pierwsza aplikacja możesz używać interfejsu Search Ads 360 API do wysyłania żądań i pobierania raportów. Możesz zgłaszać jeden z tych typów żądań:

Synchroniczny

Wymaga tylko jednego żądania i zwraca raport w odpowiedzi w formacie JSON. Żądania synchroniczne:

Jeśli chcesz korzystać z dużych raportów o reklamodawcy lub koncie wyszukiwarki, zalecamy metodę asynchroniczne.

Asynchroniczny

Wymaga wysłania wstępnego żądania określającego dane, które chcesz umieścić w raporcie. Następnie wysyłasz kolejne żądania do ankiet Search Ads 360. Gdy Search Ads 360 zakończy generowanie raportu, wysyłasz do niego prośbę o pobranie go w postaci co najmniej 1 pliku. Żądania asynchroniczne:

  • Może zwracać dowolny typ raportu.
  • Dzielenie bardzo dużych raportów na kilka plików
  • Formatuje raporty jako CSV lub TSV

Model danych: wiersze i kolumny

Search Ads 360 porządkuje dane w raporcie w wierszach i kolumnach. Typ żądanego raportu określa, jakie wiersze będą zwracane. Jeśli np. poprosisz o raport słów kluczowych, każdy wiersz będzie zawierał dane o jednym słowie kluczowym. Listę wszystkich typów raportów znajdziesz w sekcji dotyczącej typów raportów. Aby określić, które kolumny mają się znaleźć w raporcie, nadaj im nazwy w prośbie o raport. Listę kolumn, które można zwrócić w przypadku każdego typu raportu, znajdziesz w dokumentacji typów raportów.

Zachowania kolumn

Sposób działania kolumny zależy od typu zawartych w niej danych (opis działania poszczególnych kolumn znajdziesz w sekcji Typy raportów):

  • Kolumny atrybutów. Kolumna atrybutu zawiera dane, które służą do konfigurowania lub identyfikowania elementu w kampanii, np. nazwa kampanii czy stawka za słowo kluczowe. Interfejs Search Ads 360 API zawsze zwraca bieżącą wartość w kolumnie atrybutu, niezależnie od daty lub zakresu dat określonych w żądaniu. Jeśli np. wczoraj zmienisz stawkę za słowo kluczowe z 2,00 na 1,50, a potem poprosisz o wygenerowanie raportu z danymi z poprzedniego miesiąca, raport zwróci wartość stawki za słowo kluczowe 1,50.

  • Kolumny danych. Kolumna danych zawiera dane o skuteczności kampanii, takie jak przychody, liczba kliknięć reklamy i liczba wizyt zarejestrowanych przez tag Floodlight. Jeśli nie określisz zakresu czasu obejmującego jeden dzień, API zwraca wartość zbiorczą dla kolumn danych. Jeśli np. poprosisz o raport z danymi z poprzedniego miesiąca, interfejs API zwróci łączną liczbę kliknięć z ostatniego miesiąca.

  • Kolumny segmentów. Kolumna segmentu dzieli dane na osobne wiersze. Na przykład date to kolumna segmentu, którą możesz określić na potrzeby wielu typów raportów. Jeśli w raporcie słów kluczowych określisz kolumnę date z zakresem dat od 1.01.2013 do 7.01.2013 r., interfejs API zwróci 7 wierszy dla każdego słowa kluczowego, z których każdy odpowiada jednemu dzieńowi i wyświetli dane z tego dnia. Zobacz raporty podzielone na segmenty.

Waluty

W żądaniu raportu musisz określić walutę danych pieniężnych (atrybuty takie jak dailyBudget i dane, np. cost). Możesz określić jedną z tych opcji:

  • Waluta agencji, jeśli raport jest ograniczony do agencji, reklamodawcy lub konta wyszukiwarki.
  • Waluta reklamodawcy, jeśli raport obejmuje reklamodawcę lub konto wyszukiwarki.
  • Waluta konta wyszukiwarki, jeśli zakres raportu obejmuje to konto wyszukiwarki.
  • USD

Aby określić walutę, użyj właściwości żądania Reports.request.statisticsCurrency.

Sam raport będzie wskazywać walutę we właściwości Reports.statisticsCurrencyCode.

Strefa czasowa

Dane Search Ads 360 są przechowywane w datach bez stref czasowych. Odpowiadają one strefie czasowej konta wyszukiwarki używanej z danymi o wyszukiwarce (kliknięcia, wyświetlenia i wizyty) oraz strefie czasowej sieci Campaign Manager na potrzeby danych o konwersjach (dotyczących np. działań, transakcji i przychodów). Gdy wszystkie dane w raporcie pochodzą z tej samej strefy czasowej, ta strefa czasowa jest zwracana w żądaniu. W przeciwnym razie strefa czasowa nie zostanie zwrócona. Żądania mogą sprawić, że raporty Reports.request.verifySingleTimeZone: true będą zawierały dane z więcej niż 1 strefy czasowej.

Jeśli wszystkie dane w raporcie pochodzą z jednej strefy czasowej, jest ona zwracana w polu Reports.statisticsTimeZoneReports.