Performance reports

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

Dane

Możesz wysłać zapytanie o dane (np. clicks i impressions), które chcesz uzyskać. Aby zapytać usługę Raporty o dane o skuteczności, musisz dodać filtr zakresu dat.

Oto przykładowe zapytanie zwracające 1 wiersz z łączną liczbą kliknięć w wybranym zakresie dat:

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

Musisz określić dane, które mają zostać zwrócone. Symbole wieloznaczne (np. SELECT *) powodują błąd.

Z poniższej przykładowej odpowiedzi wynika, że w okresie od 1 do 21 grudnia 2023 r. sprzedawca uzyskał łącznie 4440 kliknięć wszystkich swoich produktów we wszystkich metodach marketingowych.

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

Segmenty

Do podziału na segmenty w raportach skuteczności możesz używać polów segmentów. Na przykład zapytanie marketing_method zwraca raport z wierszami dla każdej metody marketingowej oraz danymi, które określasz dla tej metody w klauzuli SELECT.

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

Pola segmentów działają podobnie do zapytania GROUP BY w SQL. Pola segmentów dzielą wybrane dane, tworząc grupy według każdego segmentu w nawiasach klamrowych SELECT.

Oto przykładowe zapytanie, które zwraca kliknięcia na dzień w kolejności malejącej według kolumny clicks w ramach dodanego zakresu dat. Zwracane są tylko wiersze, w których co najmniej 1 z wymaganych danych nie ma wartości 0.

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

Z tego przykładowego komunikatu odpowiedzi wynika, że 1 grudnia 2023 r. sprzedawca miał 1546 kliknięć we wszystkich swoich produktach we wszystkich metodach marketingowych, a 2 grudnia 2023 r. – 829 kliknięć we wszystkich swoich produktach we wszystkich metodach marketingowych. 3 grudnia 2023 r. sprzedawca nie miał żadnych kliknięć, więc na ten dzień nie ma żadnych danych do zwrócenia.

{
  "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 interfejsie Merchant Reports API możesz określić wiele segmentów w tym samym zapytaniu.

Oto przykładowe zapytanie, które zwraca kliknięcia wszystkich produktów na Twoim koncie w okresie 30 dni, 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 po jednym wierszu dla każdej kombinacji wartości offer_id i marketing_method z liczbą kliknięć dla danej 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 o wynikach sprzedaży według 2 grup atrybutów, które możesz zdefiniować, aby uporządkować swój asortyment:

Poziomy kategorii

Kategorie z mapy kategorii produktów Google. Jeśli nie podasz kategorii produktu, Google może automatycznie przypisać kategorię do produktu lub doprecyzować podawaną 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 atrybuty kategorii, jak i atrybuty typu produktu są uporządkowane w hierarchii o wielu poziomach. Specyfikacja produktu oddziela każdy poziom znakiem >, ale w raportach możesz osobno wybierać poszczególne poziomy hierarchii.

Weźmy na przykład produkt z tymi poziomami typu produktu:

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

Raporty zwracają każdy poziom w odpowiednim polu:

Dane o walucie i cenie

Dane o cenie, takie jak conversion_value, są reprezentowane za pomocą typu Price. Jeśli dane są dostępne w różnych walutach, wartość dla każdej waluty jest zwracana w osobnym wierszu. Na przykład takie 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 występują zarówno dane o cenie, jak i nieoparte na cenie, dane o cenie są zwracane w oddzielnych wierszach wyników od danych nieopartych na cenie, po jednym wierszu na każdy kod waluty. Na przykład takie 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 zwracane są wszystkie wybrane pola, nawet jeśli ich wartość jest nadal wartością domyślną lub 0.

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