Produkte bewerten

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

Leistungsmessung

Mit der Merchant Reports API ProductPerformanceView 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, verwenden Sie die Methode accounts.update der Content API for Shopping, um das Feld reportsManager auf true zu setzen.

accounts.update ersetzt die gesamte Ressource Account. Verwenden Sie accounts.get, um die vollständige Account-Ressource abzurufen. Geben Sie dann alle Felder in Ihrer accounts.update-Anfrage an, damit keine Informationen verloren gehen.

Beispielabfrage

Mit der folgenden Abfrage werden impressions, clicks und clickThroughRate für alle Produkte in Ihrem Konto innerhalb eines bestimmten Zeitraums von 30 Tagen abgerufen. Übergeben Sie dazu die folgende Anweisung für die Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

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

Sie können die Messwerte in der Abfrage auch segmentieren, um detailliertere Leistungsberichte zu erhalten.

Produkte filtern

Sie können die ProductView der Merchant Reports API verwenden, um eine gefilterte Ansicht Ihrer Produktdaten einschließlich Produktstatus aufzurufen. Sie können beispielsweise ProductView abfragen, um Produkte aufzulisten, bei denen Probleme auftreten, oder um eine Liste Ihrer neuen Produkte abzurufen und die Bereitstellung zu überprüfen.

Sie müssen das Feld id in die SELECT-Klausel Ihrer Abfrage aufnehmen. Die id hat denselben Wert wie die REST-ID des Produkts.

Sie können basierend auf allen verfügbaren Feldern außer itemIssues filtern. Sie können die Antwort anhand aller verfügbaren Felder mit Ausnahme des folgenden sortieren:

• gtin
• itemIssues

In diesem Beispiel werden Ihre Produkte mit dem Status NOT_ELIGIBLE_OR_DISAPPROVED zurückgegeben. Übergeben Sie dazu die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

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

Hier ist eine Beispielantwort aus der vorherigen 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 zum Verhalten finden Sie in der Referenz zu ProductView.

Preise verbessern

In der Ansicht mit Preisstatistiken finden Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen zur Leistung, 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.

Fragen Sie PriceInsightsProductView ab, um die vorgeschlagenen Sonderangebotspreise für Ihre Produkte abzurufen.

Hier ist ein Beispiel, das Sie verwenden können, um vorgeschlagene Sonderangebotspreise für Ihre Produkte abzurufen. Übergeben Sie dazu die folgende Anweisung für Merchant Center Query Language (Sprache der Merchant Center-Abfrage) an die Methode accounts.reports.search:

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

Hier ist eine Beispielantwort aus der vorherigen 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"
      }
    }
  ]
}