Segmentierung

Die Segmentierung, die in benutzerdefinierten Berichten im Merchant Center verfügbar ist, kann in der Reporting API implementiert werden, indem das entsprechende Feld in eine Abfrage eingefü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 in deine eigene Händler-ID. Sie können die Abfrage ändern. Die vollständige Abfrage muss in einer Zeile verbleiben, um mit dem API Explorer zu arbeiten.

Das Ergebnis des Sendens dieser Abfrage an reports.search ist eine Zeile, in der die Klicks für jede Kombination aus offer_id und program angegeben sind, 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 Kategorie angegeben wurde, oder die angegebene Kategorie weiter verfeinern.
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. In der Produktspezifikation wird jede Ebene durch das Zeichen > getrennt. In Berichten wird jedoch jede Hierarchieebene separat ausgewählt.

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 einer ReportRow gibt die Währung an, in der Preismesswerte wie metrics.order_item_sales_micros zurückgegeben werden. Da dies wichtig ist, um diese Messwerte richtig zu interpretieren, enthält der zurückgegebene ReportRow automatisch segments.currency_code, wenn Sie einen der unten aufgeführten Preismesswerte auswählen.

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

Buy on Google-Messwerte

Die 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 Produktdimensionen 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. Das Auswählen von Messwerten auf Bestellebene 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.