Sie können Segmentfelder zur Segmentierung in Leistungsberichten verwenden.
Die Abfrage von marketingMethod
gibt beispielsweise einen Bericht mit einer Zeile für jede Marketingmethode und die metrics zurück, die Sie für diese Marketingmethode in der SELECT
-Klausel angeben.
Wie bei benutzerdefinierten Berichten im Merchant Center können Sie mit der Merchant Reports API mehrere Segmente in derselben Abfrage angeben.
Mit dieser Beispielabfrage werden die Klicks für alle Produkte in Ihrem Konto innerhalb eines 30-Tage-Zeitraums zurückgegeben, segmentiert nach marketingMethod
und offerId
:
SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'
Die Antwort auf diese Abfrage enthält eine Zeile für jede Kombination aus offerId
und marketingMethod
mit der Anzahl der Klicks für diese Kombination:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
Kategorie und Produkttyp
Die Merchant Center-Abfragesprache unterstützt die Segmentierung von Messwerten nach zwei Attributgruppen, die Sie definieren können, um Ihr Inventar zu organisieren:
- Kategorieebenen
- Kategorien aus der Produkt-Taxonomie von Google. Google kann Ihrem Produkt die Kategorie automatisch zuweisen, wenn keine angegeben wurde, oder die angegebene Kategorie weiter optimieren.
- Produkttypebenen
- 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 wählen Sie jedoch jede Hierarchieebene 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 |
---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Währungs- und Preismesswerte
Preismesswerte wie conversionValue
werden durch den Typ Price
dargestellt. Wenn der Messwert in mehreren Währungen verfügbar ist, wird der Wert für jede Währung in einer separaten Zeile zurückgegeben. Zum Beispiel die folgende Abfrage:
SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'
gibt folgende Ergebnisse zurück:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Wenn Sie in einer Abfrage sowohl Preis- als auch andere Messwerte anfordern, werden Preismesswerte in separaten Ergebniszeilen von anderen Messwerten zurückgegeben (eine Ergebniszeile pro Währungscode). Zum Beispiel die folgende Abfrage:
SELECT conversions, conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'
gibt folgende Antwort zurück:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Alle ausgewählten Felder werden in der Antwort zurückgegeben, auch wenn ihr Wert immer noch der Standardwert oder null ist.