Przegląd

Interfejs API do raportowania

Interfejs API do raportowania pozwala sprzedawcy korzystać z danych o skuteczności w sposób zautomatyzowany za pomocą języka zapytań w Merchant Center. Jest to podobne do możliwość tworzyć raporty niestandardowe, bezpośrednio w Merchant Center. Interfejs Reporting API ma takie zalety:

  • Pozwala dużym sprzedawcom importować dane o skuteczności informacji o produktach do do ich wewnętrznych lub zewnętrznych systemów raportowania.
  • Pozwala użytkownikom, partnerom zewnętrznym i agregatorom zarządzać kontem Merchant Center Konta Centrum mają dostęp do raportów.

Użytkownicy interfejsu API mogą określać, które dane dotyczące wydajności chcą pobierać na stronie Odpowiedź na połączenie w wyszukiwarce, na przykład:

  • Dane, które mają zostać zwrócone (np. kliknięcia, wyświetlenia)
  • Wymiary, według których należy dzielić dane na segmenty (np. OfferId, Date)
  • Warunki, które muszą zostać spełnione (np. Kliknięcia > 100)

Język zapytań interfejsu API do raportowania może wysyłać zapytania do interfejsu Content API for Shopping, danych o skuteczności (kliknięcia, wyświetlenia) i segmentację wymiarów (raportowane atrybuty zdarzeń, takie jak program i data oraz produkt, takich jak marka, kategoria itp.) za pomocą metody Search w Reports.

Wynikiem zapytania do usługi Reports jest lista elementów typu ReportRow instancji, przy czym każdy element ReportRow reprezentuje wartości żądanych wskaźników dla segmentów wskazanych w zapytaniu. Jeśli nie podasz żadnych segmentów, pojedynczy zwrócony wiersz zawiera dane zbiorcze ze wszystkich segmentów. W przeciwnym razie, jeśli dotyczy segmentów odbiorców wraz z danymi, odpowiedź będzie zawierać jeden wiersz dla: każdej unikalnej krotki segmentu. Można wybrać wiele segmentów wiele danych w jednym zapytaniu.

Zapytanie o dane

Możesz wysyłać zapytania o dane (kliknięcia, wyświetlenia, CTR itp.), które Cię interesują . Aby wysłać zapytanie dotyczące raportów, musisz dodać filtr według zakresu dat. posprzedażna. Przykładowe zapytanie poniżej zwraca jeden wiersz: kwotę łączną kliknięć w dodanym warunku zakresu dat.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

Przykładowa odpowiedź

Przykładowa odpowiedź z kodem JSON poniżej pokazuje,jak ten sprzedawca uzyskał 4440 kliknięć łącznie we wszystkich produktach we wszystkich miejscach docelowych 1 grudnia 2020 r. i 21 grudnia 2020 r.

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

Zapytanie dotyczące segmentów

Oprócz danych można też wysyłać zapytania o segmenty, które mogą być atrybutem produkt (offer_id, brand, category itp.) lub atrybut zgłoszonego produktu wydarzenie (date, program). Raportowane zdarzenie to wyświetlenie lub kliknięcie w przypadku usługi.

Segmenty działają podobnie do GROUP BY w SQL. Segmenty dzielą wybrane grupowania danych według każdego segmentu w klauzuli SELECT. Przykładowe zapytanie poniżej zwraca liczbę kliknięć dziennie w kolejności malejącej według dodanego warunku zakresu dat. Tylko wiersze, w których co najmniej jeden żądany rodzaj danych ma wartość inną niż zero, .

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

Przykładowa odpowiedź

Przykładowa odpowiedź z kodem JSON poniżej pokazuje,jak ten sprzedawca uzyskał 1546 kliknięć we wszystkich miejscach docelowych 1 grudnia 2020 r. i 829 kliknięć we wszystkich miejscach docelowych w 2 grudnia 2020 r. Od 3 grudnia 2020 r. nie zostaną zwrócone żadne obiekty sprzedawca nie uzyskał w tym dniu żadnych kliknięć.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}
Dalej
Gramatyka zapytania