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