Segmentation

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.