Ocena produktów

Za pomocą 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 możesz pobierać dane o skuteczności na koncie product_performance_view.

Wymagania

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

Aby przypisać rolę „Skuteczność i statystyki” istniejącemu użytkownikowi, 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 wartości impressions, clicks i click_through_rate dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż do metody accounts.reports.search to wyrażenie Merchant Center Query Language:

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 Raporty skuteczności.

Filtruj usługi

Możesz użyć interfejsu Merchant Reports APIproduct_view, aby wyświetlić przefiltrowany widok danych produktów, w tym ich stanów. Możesz na przykład wysłać zapytanie product_view, aby wyświetlić listę produktów, z którymi występują problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.

W klauzuli SELECT zapytania musisz uwzględnić pole id. Element id ma taką samą wartość jak identyfikator REST produktu.

Możesz filtrować na podstawie 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

W polu aggregated_reporting_context_status możesz sprawdzić ogólną kwalifikowalność produktu. To pole zawiera zbiorcze stany wszystkich kontekstów raportowania produktu.

Oto przykład, który zwraca produkty ze stanem zbiorczymELIGIBLE_LIMITED, co oznacza, że kwalifikują się one do wyświetlania w co najmniej 1, ale nie we wszystkich, kontekstach raportowania, na które są kierowane. Możesz poprosić o szczegółowy stan produktu w kontekście raportowania i informacje o produkcie, aby dokładniej je zbadać. Aby wysłać żądanie, przekaż to wyrażenie 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 powyższe 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"
          }
        ]
      }
    }
  ]
}

Możesz użyć filtra w klauzuli reporting_context, aby wyświetlić szczegóły produktu w określonym kontekście raportowania. Gdy filtrujesz według reporting_context, wartość 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.WHERE

Więcej informacji o polach dostępnych w zapytaniu znajdziesz w sekcji Pola w tabeli product_view.

Ulepszanie cen

W widoku statystyk dotyczących cen możesz zobaczyć sugerowane ceny promocyjne produktów i prognozy wyników, 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.

Zapytanie price_insights_product_view aby wyświetlić sugerowane ceny promocyjne produktów.

Oto przykładowe zapytanie, które możesz wykorzystać, aby wyświetlić sugerowane ceny sprzedaży produktów. Aby wysłać żądanie, przekaż do metody accounts.reports.search to wyrażenie w języku zapytań Merchant Center:

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

Oto przykładowa odpowiedź na powyższe zapytanie:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "en~US~12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "price" {
          "amountMicros": "124990000",
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "135680000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "price" {
          "amountMicros": "119990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "125440000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "price" {
          "amountMicros": "84990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "82000000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}

Więcej informacji o polach dostępnych w zapytaniu znajdziesz w sekcji Pola w tabeli priceInsightsProductView.

Wstecz
Get started
Dalej
Performance reports