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 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. Poniższe żądanie pokazuje, jak utworzyć żądanie poprawki, aby przypisać PERFORMANCE_REPORTING prawo dostępu:

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ż ten komunikat Merchant Center Query Language do metody accounts.reports.search:

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, które mają problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.

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

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

• gtin
• item_issues

Oto przykład, który zwraca Twoje produkty ze stanem NOT_ELIGIBLE_OR_DISAPPROVED. Aby wysłać żądanie, przekaż to wyrażenie 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 powyższe 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 zapytaniu znajdziesz w artykule Pola w tabeli productView.

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ład, który możesz wykorzystać, aby wyświetlić sugerowane ceny promocyjne Twoich produktów. Aby wysłać żądanie, przekaż ten komunikat Merchant Center Query Language do metody accounts.reports.search:

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 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 artykule Pola w tabeli priceInsightsProductView.