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'
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.