Ocena produktów

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

Mierz wyniki

Możesz użyć interfejsu Merchant Reports API ProductPerformanceView, aby pobierać dane o skuteczności dla konta.

Wymagania

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

Aby przypisać do konta rolę Skuteczność i statystyki, użyj metody accounts.update interfejsu Content API for Shopping i ustaw w polu reportsManager wartość true.

accounts.update zastępuje cały zasób Account. Użyj accounts.get, aby uzyskać pełny zasób Account, a następnie wypełnij wszystkie pola w żądaniu accounts.update, aby nie utracić informacji.

Przykładowe zapytanie

To zapytanie pobiera wartości impressions, clicks i clickThroughRate dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż do metody accounts.reports.search tę instrukcję Język zapytania w Merchant Center:

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Możesz też podzielić na segmenty dane w zapytaniu, aby uzyskać bardziej szczegółowe raporty skuteczności.

Filtruj usługi

Za pomocą interfejsu ProductView interfejsu Merchant Reports API możesz wyświetlać filtrowany widok danych produktów, w tym ich stanów. Możesz np. wysłać zapytanie ProductView, aby wyświetlić listę produktów, których dotyczą problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.

W klauzuli SELECT zapytania musisz umieścić pole id. id ma tę samą wartość co identyfikator REST produktu.

Możesz filtrować na podstawie wszystkich dostępnych pól oprócz itemIssues. Możesz posortować odpowiedź na podstawie wszystkich dostępnych pól oprócz tych:

• gtin
• itemIssues

Oto przykład, który zwraca produkty ze stanem NOT_ELIGIBLE_OR_DISAPPROVED. Aby wysłać żądanie, przekaż do metody accounts.reports.search tę instrukcję języka zapytań Merchant Center:

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Oto przykładowa odpowiedź z poprzedniego zapytania:

{
  "results": [
    {
      "productView": {
        "id": "online~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 konkretnych polach i zachowaniu znajdziesz w dokumentacji ProductView.

Popraw ceny

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

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

Wyślij zapytanie PriceInsightsProductView, aby wyświetlić sugerowane ceny promocyjne produktów.

Oto przykład, którego możesz użyć, aby wyświetlić sugerowane ceny promocyjne dla swoich produktów. Aby wysłać żądanie, przekaż do metody accounts.reports.search tę instrukcję Język zapytania w Merchant Center:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

Oto przykładowa odpowiedź z poprzedniego zapytania:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "online~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": "online~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": "online~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"
      }
    }
  ]
}