Segmentierung

Die Segmentierung, die in den benutzerdefinierten Berichten im Merchant Center verfügbar ist, kann in der Reporting API implementiert werden, indem einer Abfrage das entsprechende Feld hinzugefügt wird. Die Abfrage von segments.program führt beispielsweise zu einem Bericht mit einer Zeile für jedes Programm (Shopping-Anzeigen, Produkteinträge usw.), die die Messwerte (Impressionen, Klicks usw.) für dieses Programm enthalten, wie in der SELECT-Klausel angegeben.

Wie bei benutzerdefinierten Berichten im Merchant Center können Sie mit der Reporting API mehrere Segmente in derselben Abfrage angeben.

Mit der folgenden Beispielabfrage werden die Klicks für alle Produkte in Ihrem Konto innerhalb eines 30-Tage-Zeitraums abgerufen, segmentiert nach program und offer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Laufen

Klicken Sie auf Ausführen, um das Beispiel im API Explorer auszuprobieren. Nachdem du auf Ausführen geklickt hast, aktualisiere den Händler-ID-Platzhalter in der Anfrage-URL auf deine eigene Händler-ID. Sie können die Abfrage ändern. Damit Sie mit dem API Explorer arbeiten können, muss die vollständige Abfrage in einer Zeile verbleiben.

Das Senden dieser Abfrage an reports.search ergibt eine Zeile, in der die Klicks für jede Kombination aus offer_id und program angegeben werden, wie in diesem JSON-Beispielstring:

{
  "results": [
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "38"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "125"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "23"
      }
    },
    {
      "segments": {
        "program": "SHOPPING_ADS",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "8"
      }
    },
    {
      "segments": {
        "program": "FREE_PRODUCT_LISTING",
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "3"
      }
    }
  ]
}

Kategorie und Produkttyp

Die Merchant Center Query Language unterstützt die Segmentierung von Messwerten nach zwei Attributgruppen, die Sie definieren können, um Ihr Inventar zu organisieren:

Kategorieebenen (segments.category_l1, segments.category_l2 usw.)
Kategorien aus der Produkt-Taxonomie von Google. Google kann Ihrem Produkt die Kategorie automatisch zuweisen, wenn keine angegeben ist, oder die angegebene Kategorie weiter optimieren.
Produkttypebenen (segments.product_type_l1, segments.product_type_l2 usw.)
Produkttypen, die Sie basierend auf Ihrer Kategorisierung zuweisen. Im Gegensatz zu den Kategorieebenen gibt es keinen vordefinierten Satz unterstützter Werte.

Sowohl die Kategorie- als auch die Produkttypattribute sind in einer Hierarchie mit mehreren Ebenen organisiert. Die Produktspezifikation trennt die einzelnen Ebenen durch das Zeichen >, aber Sie wählen jede Hierarchieebene in Berichten separat aus.

Betrachten Sie beispielsweise ein Produkt mit den folgenden Produkttypebenen:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

In Berichten wird jede Ebene in einem eigenen Feld zurückgegeben:

Segment Wert
segments.product_type_l1 Home & Garden
segments.product_type_l2 Kitchen & Dining
segments.product_type_l3 Kitchen Appliances
segments.product_type_l4 Refrigerators

Währungs- und Preismesswerte

Das Feld segments.currency_code eines ReportRow gibt die Währung an, in der Preismesswerte wie metrics.conversion_value_micros zurückgegeben werden. Da dies für die korrekte Interpretation dieser Messwerte wichtig ist, enthält die zurückgegebene ReportRow automatisch segments.currency_code, wenn Sie einen der unten stehenden Preismesswerte auswählen.

  • metrics.conversion_value_micros
  • metrics.aov_micros
  • metrics.ordered_item_sales_micros
  • metrics.returns_micros
  • metrics.shipped_item_sales_micros

Buy on Google-Messwerte

Merchant Center Query Language unterstützt zwei Messwertkategorien für Buy on Google-Bestellungen: Messwerte auf Artikelebene und Messwerte auf Bestellebene.

Messwerte auf Artikelebene

Messwerte, die auf der Grundlage der Artikel in den Bestellungen berechnet und mit den Produktabmessungen der Artikel in jeder Bestellung verknüpft sind.

  • metrics.item_days_to_ship
  • metrics.item_fill_rate
  • metrics.ordered_items
  • metrics.ordered_item_sales_micros
  • metrics.rejected_items
  • metrics.returned_items
  • metrics.return_rate
  • metrics.returns_micros
  • metrics.shipped_items
  • metrics.shipped_item_sales_micros
  • metrics.unshipped_items
Messwerte auf Auftragsebene

Messwerte, die auf Auftragsbasis berechnet werden.

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

Messwerte auf Bestellebene sind nicht mit den Produktdimensionen der Artikel in den einzelnen Bestellungen verknüpft.

Sie können Messwerte auf Artikelebene in Kombination mit allen verfügbaren Segmenten auswählen. Die Auswahl von Messwerten auf Auftragsebene in Kombination mit einem der folgenden Produktdimensionssegmente schlägt jedoch fehl:

  • segments.brand
  • segments.category_l1, segments.category_l2, segments.category_l3, segments.category_l4, segments.category_l5
  • segments.custom_label1, segments.custom_label2, segments.custom_label3, segments.custom_label4, segments.custom_label5
  • segments.offer_id
  • segments.product_type_l1, segments.product_type_l2, segments.product_type_l3, segments.product_type_l4, segments.product_type_l5
  • segments.title

Weitere Informationen

Eine vollständige Liste der Segmente finden Sie in der Dokumentation.