Segmentierung

Die Segmentierung, die in benutzerdefinierten Berichten im Merchant Center verfügbar ist, kann in der Reporting API implementiert werden. Dazu wird einer Abfrage das entsprechende Feld hinzugefügt. Wenn Sie beispielsweise segments.program abfragen, wird ein Bericht mit einer Zeile für jedes Programm (Shopping-Anzeigen, Produkteinträge usw.) erstellt, der die Messwerte (Impressionen, Klicks usw.) für dieses Programm enthält, 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 Zeitraums von 30 Tagen 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 Platzhalter für die Händler-ID in der Anfrage-URL durch deine eigene Händler-ID. Sie können die Abfrage ändern. Die vollständige Abfrage muss in einer Zeile bleiben, damit der API Explorer verwendet werden kann.

Das Ergebnis beim Senden 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 zur Organisation Ihres Inventars definieren können:

Kategorieebenen (segments.category_l1, segments.category_l2 usw.)

Kategorien aus der Produkt-Taxonomie von Google. Google kann die Kategorie Ihrem Produkt automatisch zuweisen, wenn keine 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 keine vordefinierten unterstützten 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. Sie wählen jedoch jede Ebene der Hierarchie in Berichten separat aus.

Betrachten Sie zum Beispiel ein Produkt mit den folgenden Produkttypebenen:

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

Bei 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.conversion_value_micros zurückgegeben werden. Da dies für die korrekte Interpretation dieser Messwerte wichtig ist, enthält der zurückgegebene ReportRow automatisch segments.currency_code, wenn Sie einen der unten aufgeführten 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

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

Messwerte auf Artikelebene

Messwerte, die auf der Grundlage der Artikel in Bestellungen berechnet und mit den Produktdimensionen der Artikel in den einzelnen Bestellungen 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 werden pro Bestellung berechnet.

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

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

Sie können Messwerte auf Artikelebene in Kombination mit beliebigen 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.