Auf dieser Seite wird beschrieben, wie Sie mit gtag.js Daten für erweiterte E-Commerce-Berichte erheben. Wenn Sie Google Analytics in gtag.js konfiguriert und in Google Analytics erweiterte E-Commerce-Berichte aktiviert haben, können Sie mit gtag.js Impressions-, Produktdaten, Angebotsdaten und Aktionsdaten an Google Analytics senden.
Datentypen und Aktionen für erweiterte E-Commerce-Berichte
Es gibt mehrere Arten von E-Commerce-Daten, die Sie senden können:
Impressionsdaten
Informationen zu einem angesehenen Produkt Sie wird als impressionFieldObject
bezeichnet und enthält die folgenden Werte:
Schlüssel | Werttyp | Erforderlich | Beschreibung |
---|---|---|---|
id |
Text | *Ja |
Die Produkt-ID oder SKU (z.B. P67890).
* Es muss entweder |
name |
Text | *Ja |
Der Name des Produkts (z.B. Android-T-Shirt).
* Es muss entweder |
list |
Text | Nein | Die Liste oder Sammlung, zu der das Produkt gehört (z.B. Suchergebnisse) |
list_name |
Text | Nein | Die Liste oder Sammlung, zu der das Produkt gehört (z.B. Suchergebnisse) |
brand |
Text | Nein | Die dem Produkt zugeordnete Marke (z. B. Google) |
category |
Text | Nein |
Die Kategorie, zu der das Produkt gehört (z.B. Bekleidung). Verwenden Sie / als Trennzeichen, um bis zu fünf Hierarchieebenen anzugeben (z.B. Bekleidung/Herren/T-Shirts).
|
variant |
Text | Nein | Die Variante des Produkts (z.B. Schwarz). |
position |
Ganzzahl | Nein | Die Position des Produkts in einer Liste oder Sammlung (z.B. 2). |
list_position |
Ganzzahl | Nein | Die Position des Produkts in einer Liste oder Sammlung (z.B. 2). |
price |
Zahl | Nein | Der Preis eines Produkts (z. B. 29,20). |
Produktdaten
Produktdaten stellen einzelne Produkte dar, die angesehen oder in den Einkaufswagen gelegt wurden. Sie werden als productFieldObject
bezeichnet und enthalten die folgenden Werte:
Schlüssel | Werttyp | Erforderlich | Beschreibung |
---|---|---|---|
id |
Text | *Ja |
Die Produkt-ID oder SKU (z.B. P67890).
* Es muss entweder „id“ oder „ |
name |
Text | *Ja |
Der Name des Produkts (z.B. Android-T-Shirt).
* Es muss entweder „id“ oder „ |
brand |
Text | Nein | Die dem Produkt zugeordnete Marke (z. B. Google) |
category |
Text | Nein | Die Kategorie, zu der das Produkt gehört (z.B. Bekleidung). Verwenden Sie / als Trennzeichen, um bis zu fünf Hierarchieebenen anzugeben (z.B. Bekleidung/Herren/T-Shirts). |
variant |
Text | Nein | Die Variante des Produkts (z.B. Schwarz). |
price |
Zahl | Nein | Der Preis eines Produkts (z. B. 29,20). |
quantity |
Ganzzahl | Nein | Die Menge eines Produkts (z.B. 2). |
coupon |
Text | Nein | Der Gutscheincode, der einem Produkt zugewiesen ist (z.B. SUMMER_SALE13). |
position |
Ganzzahl | Nein | Die Position des Produkts in einer Liste oder Sammlung (z.B. 2). |
list_position |
Ganzzahl | Nein | Die Position des Produkts in einer Liste oder Sammlung (z.B. 2). |
Angebotsdaten
Informationen zu einem aufgerufenen Angebot Sie wird als promoFieldObject
bezeichnet und enthält die folgenden Werte:
Schlüssel | Werttyp | Erforderlich | Beschreibung |
---|---|---|---|
id |
Text | *Ja |
Die Angebots-ID (z.B. PROMO_1234).
* Es muss entweder |
name |
Text | *Ja |
Der Name der Werbeaktion (z.B. Sommerschlussverkauf).
* Es muss entweder |
creative |
Text | Nein | Das mit der Werbeaktion verknüpfte Creative (z.B. sommer_banner2). |
creative_name |
Text | Nein | Der Name des Creatives (z.B. sommer_banner2). |
position |
Text | Nein | Die Position des Creatives (z. B.banner_slot_1) |
creative_slot |
Text | Nein | Der Name der Creative-Fläche (z. B.banner_slot_1) |
Aktionsdaten
Informationen zu einer durchgeführten E-Commerce-Aktion
Sie wird als actionFieldObject
bezeichnet und enthält die folgenden Werte:
Schlüssel | Werttyp | Erforderlich | Beschreibung |
---|---|---|---|
id |
Text | *Ja |
Die Transaktions-ID (z.B. T1234).
* Erforderlich, wenn der Aktionstyp |
affiliation |
Text | Nein | Das Geschäft oder die Zugehörigkeit, über das bzw. die diese Transaktion erfolgt ist (z. B. Google Store). |
revenue |
Zahl | Nein |
Gibt den Gesamtumsatz oder die Gesamtsumme der Transaktion an (z. B. 11,99). Dieser Wert kann Versandkosten, Steuerkosten oder andere Anpassungen des Gesamtumsatzes enthalten, die in Ihre Umsatzberechnungen einbezogen werden sollen. |
value | Zahl | Nein | Wert (d. h. Umsatz), der dem Ereignis zugeordnet ist |
tax |
Zahl | Nein | Der gesamte Steuern, der der Transaktion zugewiesen ist. |
shipping |
Zahl | Nein | Die Versandkosten der Transaktion. |
coupon |
Text | Nein | Der Transaktionsgutschein, der mit der Transaktion eingelöst wurde. |
list |
Text | Nein | Die Liste, zu der die verknüpften Produkte gehören. Optional. |
items |
array | Nein | Das Array, das die zugehörigen Produkte enthält. |
step |
Ganzzahl | Nein | Eine Zahl, die einen Schritt im Bezahlvorgang darstellt. Optional bei „Checkout“-Aktionen. |
checkout_step |
Ganzzahl | Nein | Eine Zahl, die einen Schritt im Bezahlvorgang darstellt. |
option |
Text | Nein |
Zusätzliches Feld für checkout - und checkout_option -Aktionen, das Optionsinformationen auf der Zahlungsseite beschreiben kann, z. B. die ausgewählte Zahlungsmethode.
|
checkout_option |
Text | Nein | Bezahlvorgang-Option (d.h. ausgewählte Zahlungsmethode). |
Schlüssel | Werttyp | Erforderlich | Beschreibung |
---|---|---|---|
coupon |
String | Nein | Gutscheincode für einen käuflichen Artikel. |
Aktionen für Produkte und Angebote
Aktionen geben an, wie Produkt- und Angebotsdaten interpretiert werden, die Sie an Google Analytics senden.
Aktion | Veranstaltung | Beschreibung |
---|---|---|
click |
Ein Klick auf ein Produkt oder einen Produktlink für ein oder mehrere Produkte. | |
detail |
Eine Ansicht der Produktdetails. | |
add |
Hinzufügen eines oder mehrerer Produkte in den Einkaufswagen | |
remove |
Entfernen Sie ein oder mehrere Produkte aus einem Einkaufswagen. | |
checkout |
Der Bezahlvorgang für ein oder mehrere Produkte wird gestartet. | |
checkout_option |
Senden des Optionswerts für einen bestimmten Bezahlschritt. | |
purchase |
Der Verkauf von einem oder mehreren Produkten. | |
refund |
Die Erstattung für ein oder mehrere Produkte. | |
promo_click |
Ein Klick auf eine interne Werbung. | |
add_to_cart |
Ein Nutzer legt ein oder mehrere Produkte in den Einkaufswagen. | |
begin_checkout |
Ein Nutzer startet den Bezahlvorgang für ein oder mehrere Produkte. | |
checkout_progress |
Ein Nutzer schließt den Bezahlvorgang nach dem ersten Schritt ab. | |
purchase |
Ein Nutzer schließt einen Kauf ab. | |
refund |
Ein Nutzer erhält eine Erstattung für ein oder mehrere Produkte. | |
remove_from_cart |
Ein Nutzer entfernt ein oder mehrere Produkte aus dem Einkaufswagen. | |
select_content |
Ein Nutzer klickt auf ein Produkt oder einen Produktlink. | |
set_checkout_option |
Der Schritt des Bezahlvorgangs, den ein Nutzer abschließt. | |
view_item |
Ein Nutzer sieht sich Details zu einem Produkt an. | |
view_item_list |
Ein Nutzer ruft eine Liste mit einem oder mehreren Produkten auf. | |
view_promotion |
Ein Nutzer klickt auf eine interne Werbung. | |
view_refund |
Ein Nutzer sieht eine Erstattung für ein oder mehrere Produkte. |
Beispiele
Produktimpressionen messen
Senden Sie zum Messen von Produktimpressionen eine view_item_list
mit den Produktinformationen:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
Produktklicks messen
Wenn Sie einen Produktklick erfassen möchten, senden Sie ein select_content
-Ereignis, geben Sie product
als content_type
an und geben Sie die Produktinformationen an:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
Produktdetailansichten messen
Nach dem Klicken auf einen Produkteintrag sehen Nutzer möglicherweise die Seite mit den Produktdetails. Wenn Sie Aufrufe von Produktdetails messen möchten, senden Sie ein view_item
-Ereignis mit den Produktdetails:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Hinzufügen und Entfernen von Artikeln in Einkaufswagen messen
Senden Sie ein add_to_cart
-Ereignis mit den Produktinformationen, um zu messen, wie ein Produkt in den Einkaufswagen gelegt wurde:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Wenn Sie messen möchten, wie ein Produkt aus dem Einkaufswagen entfernt wird, senden Sie ein remove_from_cart
-Ereignis mit den Produktinformationen:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Bezahlvorgänge analysieren
So messen Sie die einzelnen Schritte im Bezahlvorgang:
- Messcode hinzufügen, um jeden Schritt des Bezahlvorgangs zu erfassen.
- Fügen Sie gegebenenfalls Messcode hinzu, um Zahlungsoptionen zu erfassen.
1. Schritte für den Bezahlvorgang messen
Senden Sie ein begin_checkout
-Ereignis mit den entsprechenden Artikeln, um den ersten Schritt des Bezahlvorgangs zu erfassen:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
Senden Sie ein checkout_progress
-Ereignis mit den Artikeln an der Kasse, um jeden nachfolgenden Schritt an der Kasse zu erfassen:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. Zahlungsoptionen analysieren
Senden Sie ein set_checkout_option
-Ereignis mit der Zahlungsoption, um eine Bezahloption zu erfassen:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Impressionen von Angeboten messen
Damit Impressionen über Angebote erfasst werden, müssen Sie ein view_promotion
-Ereignis mit Angebotsinformationen senden:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Klicks auf Werbung messen
Wenn Sie einen Klick auf eine Werbeaktion erfassen möchten, senden Sie ein select_content
-Ereignis und stellen Sie das Angebot bereit:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Käufe analysieren
Senden Sie ein purchase
-Ereignis mit den Artikeln in der Transaktion, um eine Transaktion zu messen:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
Erstattungen erfassen
Wenn Sie eine vollständige Erstattung einer Transaktion erfassen möchten, senden Sie ein refund
-Ereignis mit der Transaktions-ID:
gtag('event', 'refund', { "transaction_id": "T12345" })
Wenn du eine teilweise Erstattung erfassen möchtest, sende ein refund
-Ereignis mit der Transaktions-ID und den zu erstattenden Artikeln:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});