Produkte bewerten

Mit der Merchant Reports API können Sie Leistungsdaten ansehen, 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

Um diesen Bericht abzurufen, 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 können:

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 Spalten impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto in einem bestimmten Zeitraum von 30 Tagen abgerufen. Übergeben Sie die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search, um die Anfrage zu stellen:

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 product_view der Merchant Reports API können Sie eine gefilterte Ansicht Ihrer Produktdaten, einschließlich Produktstatus, anzeigen lassen. 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. Der Wert id entspricht der REST-ID des Produkts.

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

gtin
item_issues

Hier ein Beispiel, das Ihre Produkte mit dem Status NOT_ELIGIBLE_OR_DISAPPROVED zurückgibt. Übergeben Sie dazu die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

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

Hier ist eine Beispielantwort auf die vorherige Anfrage:

{
  "results": [
    {
      "productView": {
        "id": "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 den für Abfragen verfügbaren Feldern finden Sie unter Felder in der productView-Tabelle.

Preise optimieren

In der Ansicht „Preisstatistiken“ können Sie vorgeschlagene Sonderangebotspreise 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

Fragen Sie price_insights_product_view, um Vorschläge für Sonderangebotspreise für Ihre Produkte zu erhalten.

Hier sehen Sie ein Beispiel, mit dem Sie vorgeschlagene Verkaufspreise für Ihre Produkte abrufen können. Übergeben Sie für die Anfrage die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

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