Segmentation

Mithilfe von Segmenten Felder für Segmentierung bei der Leistung berichten. Beispielsweise wird bei der Abfrage von marketingMethod ein Bericht mit einer Zeile für die einzelnen Marketingmethoden Messwerte, die Sie für diese Marketingmethode in der SELECT-Klausel angeben.

Wie bei benutzerdefinierten Berichten im Merchant Center können Sie mehrere Segmente in derselben Abfrage mit der Merchant Reports API.

Mit dieser Beispielabfrage werden die Klicks für alle Produkte in Ihrem Konto zurückgegeben. innerhalb eines 30-tägigen Zeitraums, 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 von 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"
      }
    }
  ]
}

Achtung :Da für jede Kombination von Segmentfeldern eine neue Zeile zurückgegeben wird in der SELECT-Klausel erhöht sich die Gesamtzahl der Zeilen in Ihrer Antwort. exponentiell mit jedem zusätzlichen Segmentfeld.

Kategorie und Produkttyp

Merchant Center-Abfrage Sprache unterstützt die Segmentierung anhand von zwei Attributgruppen, die Sie definieren können, Inventar:

Kategorieebenen

Kategorien aus Google-Produkten Taxonomie. Google kann Ihrem Produkt die Kategorie automatisch zuweisen, wenn keine angegeben wurde, oder die angegebene Kategorie zu verfeinern.

Produkttypebenen

Produkttypen, die Sie basierend auf Ihren Kategorisierung. Im Gegensatz zur Kategorieebenen gibt es keine vordefinierten unterstützten Werte.

Sowohl die Kategorie- als auch die Produkttypattribute sind in einer Hierarchie organisiert, auf mehreren Ebenen. Das Produkt Spezifikation zwischen durch das Zeichen >. Sie wählen jedoch alle Hierarchieebenen aus. separat in Berichten.

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
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 mithilfe des Price Typ. Ist der Messwert in mehreren Währungen verfügbar, wird der Wert für jeden Währung wird 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 Preismesswerte als auch andere Messwerte anfordern, werden Preismesswerte werden in separaten Ergebniszeilen von Nicht-Preismesswerten 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 noch immer Standardwert oder Null.