28 lutego 2026 r. wycofaliśmy i wyłączyliśmy wersję 1 beta interfejsu Merchant API. Instrukcje przejścia na najnowszą stabilną wersję znajdziesz w artykule Migracja z wersji 1 beta do wersji 1.

Ocena produktów

Za pomocą interfejsu Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według określonych atrybutów i ulepszać ceny.

Pomiar wyników

Za pomocą interfejsu Merchant Reports API product_performance_viewmożesz pobierać dane o skuteczności swojego konta .

Wymagania

Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.

Aby przypisać rolę Skuteczność i statystyki do istniejącego użytkownika, utwórz żądanie PATCH i przypisz użytkownikowi prawo dostępu PERFORMANCE_REPORTING. To żądanie pokazuje, jak utworzyć żądanie PATCH, aby przypisać prawo dostępu PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Zastąp następujące elementy:

{ACCOUNT_ID}: unikalny identyfikator konta Merchant Center.
{EMAIL_ID}: adres e-mail użytkownika, któremu chcesz przypisać rolę.

Przykładowe zapytanie

To zapytanie pobiera dane impressions, clicks i click_through_rate wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż to stwierdzenie w języku zapytań Merchant Center do accounts.reports.search metody:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Więcej informacji o raportach skuteczności znajdziesz w przewodniku po raportach skuteczności.

Filtruj usługi

Za pomocą interfejsu Merchant Reports API's product_view możesz wyświetlić przefiltrowany widok danych produktów, w tym ich stany. Możesz na przykład wysłać zapytanie do product_view, aby wyświetlić listę produktów, które mają problemy, lub uzyskać listę nowych produktów i sprawdzić, czy są one wyświetlane.

W klauzuli SELECT zapytania musisz uwzględnić pole id. Wartość id jest taka sama jak identyfikator REST produktu.

Możesz filtrować według wszystkich dostępnych pól, z wyjątkiem tych:

status_per_reporting_context
item_issues.

Odpowiedź możesz posortować według wszystkich dostępnych pól z wyjątkiem tych:

gtin
status_per_reporting_context
item_issues

Aby sprawdzić ogólną kwalifikowalność produktu, możesz sprawdzić pole aggregated_reporting_context_status. To pole agreguje stany we wszystkich kontekstach raportowania produktu.

Oto przykład, który zwraca Twoje produkty ze zagregowanym stanem ELIGIBLE_LIMITED, co oznacza, że kwalifikują się one do wyświetlania w co najmniej 1, ale nie we wszystkich docelowych kontekstach raportowania. Aby dokładniej zbadać problem, możesz poprosić o szczegółowy stan produktu w kontekście raportowania i problemy z produktem. Aby wysłać żądanie, przekaż to następujące stwierdzenie w języku zapytań Merchant Center do metody accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

Oto przykładowa odpowiedź na poprzednie zapytanie:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Aby wyświetlić szczegóły produktu w określonym kontekście raportowania, możesz użyć filtra reporting_context w klauzuli WHERE. Gdy filtrujesz według reporting_context, aggregated_reporting_context_status jest obliczana tylko na podstawie wybranego kontekstu raportowania, a status_per_reporting_context i item_issues zwracają tylko szczegóły dotyczące tego kontekstu.

Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule Pola w tabeliproduct_view table.

Ulepszanie cen

W widoku statystyk dotyczących cen możesz zobaczyć sugerowane ceny promocyjne produktów oraz prognozy skuteczności, których możesz się spodziewać, jeśli zaktualizujesz ceny produktów. Raport ze statystykami dotyczącymi cen umożliwia skuteczniejsze wycenianie produktów.

Więcej informacji znajdziesz w artykule Ulepszanie wyceniania produktów za pomocą raportu na temat statystyk dotyczących cen.

Aby wyświetlić sugerowane ceny promocyjne produktów, wyślij zapytanie do price_insights_product_view.

Oto przykład, którego możesz użyć, aby wyświetlić sugerowane ceny promocyjne produktów. Aby wysłać żądanie, przekaż to stwierdzenie w języku zapytań Merchant Center do accounts.reports.search metody:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view