Produkte bewerten

Mit der Merchant Reports API können Sie Leistungsdaten aufrufen , Ihre Produkte nachbestimmten Attributenfiltern und Ihre Preise verbessern.

Leistung messen

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

Voraussetzungen

Zum Abrufen dieses Berichts benötigen Sie die Rolle „Leistung und Statistiken“.

Wenn Sie einem vorhandenen Nutzer die Rolle „Leistung und Statistiken“ zuweisen möchten, erstellen Sie eine Patch-Anfrage und weisen Sie dem Nutzer das Zugriffsrecht PERFORMANCE_REPORTING zu. Die folgende Anfrage zeigt, wie Sie eine Patch-Anfrage zum Zuweisen des Zugriffsrechts PERFORMANCE_REPORTING erstellen:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Ersetzen Sie Folgendes:

  • {ACCOUNT_ID}: Die eindeutige Kennung des Merchant Center-Kontos.
  • {EMAIL_ID}: Die E-Mail-Adresse des Nutzers, dem Sie die Rolle zuweisen möchten.

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 Zeitraum von 30 Tagen abgerufen. Um die Anfrage zu stellen, übergeben Sie die folgende Merchant Center Query Language-Anweisung an die accounts.reports.search Methode:

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 Leistungsberichte Leitfaden.

Produkte filtern

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

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

Sie können nach allen verfügbaren Feldern filtern, mit Ausnahme der folgenden:

  • status_per_reporting_context
  • item_issues.

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

  • gtin
  • status_per_reporting_context
  • item_issues

Im Feld aggregated_reporting_context_status können Sie die allgemeine Berechtigung eines Produkts sehen. In diesem Feld werden die Status aller Berichtskontexte eines Produkts zusammengefasst.

Hier ein Beispiel, das Ihre Produkte mit dem zusammengefassten Status ELIGIBLE_LIMITED zurückgibt. Das bedeutet, dass sie in mindestens einem, aber nicht allen Berichtskontexten ausgeliefert werden können. Sie können den detaillierten Produktstatus pro Berichtskontext und Produktprobleme anfordern, um weitere Informationen zu erhalten. Um die Anfrage zu stellen, übergeben Sie die folgende Merchant Center Query Language-Anweisung an die accounts.reports.search Methode:

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'

Hier ist eine Beispielantwort auf die vorherige Abfrage:

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

Sie können in der WHERE-Klausel einen Filter für reporting_context verwenden, um Produktdetails für einen bestimmten Berichtskontext aufzurufen. Wenn Sie nach reporting_context filtern, wird aggregated_reporting_context_status nur auf Grundlage des ausgewählten Berichtskontexts berechnet. status_per_reporting_context und item_issues geben nur Details für diesen Kontext zurück.

Weitere Informationen zu den Feldern, die für die Abfrage verfügbar sind, finden Sie unter Felder in der Tabelle.product_view

Preise verbessern

In der Ansicht „Preisinformationen“ können Sie vorgeschlagene Angebotspreise für Ihre Produkte sowie Vorhersagen für die Leistung sehen, 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.

Fragen Sie price_insights_product_view ab, um vorgeschlagene Sonderangebotspreise für Ihre Produkte aufzurufen.

Hier ist ein Beispiel, mit dem Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte aufrufen können. Um die Anfrage zu stellen, übergeben Sie die folgende Merchant Center Query Language-Anweisung an die accounts.reports.search Methode:

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

Weitere Informationen zu den Feldern, die für die Abfrage verfügbar sind, finden Sie unter Felder in der Tabelle priceInsightsProductView.

Zurück
Get started
Weiter
Performance reports