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_view możesz pobierać dane o skuteczności na swoim koncie.

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. Poniższe żą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 dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż to wyrażenie 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świetlać 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. Pole id ma taką samą wartość 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 użyć pola 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. Możesz poprosić o szczegółowy stan produktu w kontekście raportowania i informacje o produkcie, aby dokładniej zbadać problemy. Aby wysłać żądanie, przekaż to wyrażenie w języku zapytań Merchant Center do accounts.reports.search metody:

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 wyrażenie 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_conversions_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 zapytaniu znajdziesz w artykule Pola w tabeli priceInsightsProductView.