Produkte bewerten

Mit der Merchant Reports API können Sie Leistungsdaten abrufen, Ihre Produkte nach bestimmten Attributen filtern und Ihre Preise optimieren.

Leistung messen

Mit der Merchant Reports API product_performance_view können Sie Leistungsmesswerte für Ihr Konto abrufen.

Voraussetzungen

Sie benötigen die Rolle Leistung und Statistiken, um diesen Bericht abzurufen.

Wenn Sie einem Konto die Rolle „Leistung und Statistiken“ zuweisen möchten, patchen Sie die User-Ressource für das Konto mit dem Zugriffsrecht PERFORMANCE_REPORTING.

accounts.v1beta.accounts.users.patch ersetzt die gesamte User-Ressource. Rufen Sie accounts.v1beta.accounts.users.get auf, um die vollständige User-Ressource abzurufen, und geben Sie dann alle Felder in Ihrer accounts.v1beta.accounts.users.patch-Anfrage an, um Datenverluste zu vermeiden.

Beispielabfrage

Mit der folgenden Abfrage werden die Werte für impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto in einem bestimmten 30-tägigen Zeitraum abgerufen. Geben Sie dazu die folgende Merchant Center-Abfragesprache-Anweisung an die Methode accounts.reports.search weiter:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Weitere Informationen zu Leistungsberichten finden Sie im Leitfaden Leistungsberichte.

Produkte filtern

Mit der Merchant Reports API können Sie mithilfe des Parameters product_view eine gefilterte Ansicht Ihrer Produktdaten einschließlich Produktstatus aufrufen. Sie können product_view beispielsweise abfragen, um Produkte mit Problemen aufzulisten oder eine Liste Ihrer neuen Produkte abzurufen und die Auslieferung zu überprüfen.

Das Feld id muss in der SELECT-Klausel Ihrer Abfrage enthalten sein. Der Wert von id muss mit der REST-ID des Produkts übereinstimmen.

Sie können nach allen verfügbaren Feldern filtern, mit Ausnahme von item_issues. Sie können die Antwort nach allen verfügbaren Feldern sortieren, mit Ausnahme der folgenden:

• gtin
• item_issues

Hier ein Beispiel, in dem Ihre Produkte mit dem Status NOT_ELIGIBLE_OR_DISAPPROVED zurückgegeben werden. Geben Sie dazu die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search weiter:

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

Hier ist eine Beispielantwort auf die vorherige Abfrage:

{
  "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"
          }
        ]
      }
    }
  ]
}

Weitere Informationen zu bestimmten Feldern und deren Verhalten finden Sie in der Referenz product_view.

Preise optimieren

In der Ansicht „Preisstatistiken“ sehen Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen für die Leistung, die Sie erwarten können, wenn Sie die Preise Ihrer Produkte aktualisieren. Mit dem Bericht „Preisstatistiken“ können Sie Preise Ihrer Produkte effektiver gestalten.

Weitere Informationen finden Sie unter Produktpreise mit dem Bericht zu Preisstatistiken verbessern.

Führen Sie die Abfrage price_insights_product_view durch, um Vorschläge für Sonderangebotspreise für Ihre Produkte zu erhalten.

Hier finden Sie ein Beispiel für vorgeschlagene Sonderangebotspreise für Ihre Produkte. Übergeben Sie dazu der Methode accounts.reports.search die folgende Merchant Center-Abfragesprache-Anweisung:

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

Hier ist eine Beispielantwort auf die vorherige Abfrage:

{
   "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"
      }
    }
  ]
}