30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

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:

Może zwracać tylko raporty o reklamodawcy i koncie wyszukiwarki.
Blokowanie klienta do czasu wygenerowania raportu przez Search Ads 360

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.