Performance reports

Interfejs Merchant API udostępnia np. raporty skutecznościproduct_performance_view. Na tej stronie znajdziesz informacje o strukturze raportów skuteczności.

Dane

Możesz wysyłać zapytania dotyczące danych (np. clicks i impressions), które chcesz uzyskać. Aby wysyłać do usługi Raporty zapytania o dane o skuteczności, musisz dodać filtr zakresu dat.

Oto przykładowe zapytanie, które zwraca jeden wiersz z łączną liczbą kliknięć w określonym zakresie dat:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Musisz określić dane, które chcesz zwrócić. Symbole wieloznaczne (np. SELECT *) zwracają błąd.

Przykładowa odpowiedź poniżej pokazuje, że sprzedawca uzyskał łącznie 4440 kliknięć wszystkich produktów we wszystkich metodach marketingowych w okresie od 1 do 21 grudnia 2023 roku.

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

Segmenty

Do segmentacji w raportach skuteczności możesz używać segmentów. Na przykład zapytanie marketing_method zwraca raport z wierszem dla każdej metody marketingowej i danymi, które określisz dla tej metody marketingowej w klauzuli SELECT.

Polami segmentów mogą być atrybuty produktu (np. offer_id, brand i category) lub atrybuty zdarzenia (np. date i marketing_method).

Pola segmentów działają podobnie do funkcji GROUP BY w SQL. Pola segmentów dzielą wybrane dane, grupując je według każdego segmentu w klauzuli SELECT.

Oto przykładowe zapytanie, które zwraca kliknięcia według dnia w kolejności malejącej według clicks w ramach dodanego warunku zakresu dat. Zwracane są tylko wiersze, w których co najmniej 1 z żądanych rodzajów danych ma wartość inną niż zero.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

Przykładowa odpowiedź pokazuje, że 1 grudnia 2023 r. sprzedawca uzyskał 1546 kliknięć wszystkich produktów we wszystkich metodach marketingowych, a 2 grudnia 2023 r. – 829 kliknięć wszystkich produktów we wszystkich metodach marketingowych. 3 grudnia 2023 r. sprzedawca nie miał żadnych kliknięć, więc w przypadku tej daty nie są zwracane żadne dane.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

Podobnie jak w przypadku raportów niestandardowych w Merchant Center, w tym samym zapytaniu możesz określić wiele segmentów za pomocą interfejsu Merchant Reports API.

Oto przykładowe zapytanie, które zwraca kliknięcia wszystkich produktów na Twoim koncie w 30-dniowym okresie, podzielone na segmenty według marketing_method i offer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

Odpowiedź na to zapytanie zawiera wiersz dla każdej kombinacji offer_id i marketing_method z liczbą kliknięć dla tej kombinacji:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Kategoria i typ produktu

Język zapytań Merchant Center umożliwia segmentowanie danych według 2 grup atrybutów, które możesz zdefiniować, aby uporządkować asortyment:

Poziomy kategorii
Kategorie z mapy kategorii produktów Google. Jeśli nie podasz kategorii, Google może automatycznie przypisać ją do Twojego produktu lub doprecyzować podaną kategorię.
Poziomy typu produktu
Typy produktów, które przypisujesz na podstawie własnego podziału na kategorie. W przeciwieństwie do poziomów kategorii nie ma wstępnie zdefiniowanego zestawu obsługiwanych wartości.

Zarówno atrybut kategoria, jak i typ produktu są uporządkowane w hierarchii z wieloma poziomami. Specyfikacja produktu oddziela poszczególne poziomy znakiem >, ale w raportach możesz wybierać poszczególne poziomy hierarchii osobno.

Załóżmy, że masz produkt o tych poziomach typu produktu:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Raporty zwracają każdy poziom w osobnym polu:

Segment Wartość
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

Dane o walucie i cenie

Dane o cenach, takie jak conversion_value, są reprezentowane za pomocą typu Price. Jeśli dane są dostępne w kilku walutach, wartość dla każdej z nich jest zwracana w osobnym wierszu. Na przykład zapytanie:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

zwraca te wyniki:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Jeśli w zapytaniu poprosisz o dane dotyczące ceny i inne dane, dane dotyczące ceny będą zwracane w oddzielnych wierszach wyników niż inne dane – po jednym wierszu wyników na kod waluty. Na przykład zapytanie:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

zwraca tę odpowiedź:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

W odpowiedzi są zwracane wszystkie wybrane pola, nawet jeśli ich wartość jest nadal wartością domyślną lub zerem.

Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule Pola w tabeli productPerformanceView.