Ocena produktów

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

Pomiar wyników

Za pomocą interfejsu Merchant Reports API product_performance_view możesz pobierać dane o skuteczności dotyczące swojego konta.

Wymagania

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

Aby przypisać rolę Skuteczność i statystyki istniejącym użytkownikom, utwórz prośbę o zmianę i przypisz użytkownikowi uprawnienie dostępu PERFORMANCE_REPORTING. Poniższe żądanie pokazuje, jak utworzyć prośbę o zmianę kodu źródłowego w celu przypisania prawa 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

Podane niżej zapytanie zwraca wartości impressions, clicksclick_through_rate dla wszystkich usług na Twoim koncie w okresie 30 dni. Aby wysłać żądanie, prześlij do metody accounts.reports.search to wyrażenie w języku zapytań Merchant Center:

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 API, aby wyświetlić filtrowany widok danych produktów, w tym stanów produktów.product_view Możesz na przykład wysłać zapytanie product_view, aby wyświetlić listę produktów, które mają problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.

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

Możesz filtrować według wszystkich dostępnych pól, z wyjątkiem pola item_issues. Odpowiedź możesz sortować według wszystkich dostępnych pól, z wyjątkiem tych:

  • gtin
  • item_issues

Oto przykład, który zwraca produkty o stanie NOT_ELIGIBLE_OR_DISAPPROVED. Aby wysłać żądanie, prześlij ten element języka zapytań Merchant Center do metody accounts.reports.search:

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

Oto przykładowa odpowiedź na poprzednie zapytanie:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "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"
          }
        ]
      }
    }
  ]
}

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

Ulepszanie cen

Za pomocą widoku statystyk dotyczących cen możesz sprawdzić sugerowane ceny promocyjne produktów oraz prognozy dotyczące skuteczności, której 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 Poprawianie wyceny produktów za pomocą raportu na temat statystyk dotyczących cen.

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

Oto przykład, jak wyświetlić sugerowane ceny promocyjne Twoich produktów. Aby wysłać żądanie, prześlij do metody accounts.reports.search ten element języka zapytań Merchant Center:

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

Oto przykładowa odpowiedź na poprzednie 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 zapytaniach znajdziesz w artykule Pola w tabeli priceInsightsProductView.