Verfügbare Events

Geändert am Mo, 15 Jun um 3:10 NACHMITTAGS

Unser Plugin feuert eine Reihe von Events, auf die sie im GTM Setup hören können und entsprechend verarbeiten. Dies sind:

view_item_list

Beispiel:

{
   "event":"view_item_list",
   "ecommerce":{
      "currency":"EUR",
      "item_list_name":"Category: Clothing",
      "item_list_id":"a515ae260223466f8e37471d279e6406",
      "items":[
         {
            "item_name":"Ganz neues Produkt",
            "item_id":"SW10099",
            "price":899,
            "item_brand":"Shopware Fashion",
            "index":0,
            "quantity":1,
            "item_list_name":"Category: Clothing",
            "item_list_id":"a515ae260223466f8e37471d279e6406",
            "item_category":"Clothing"
         }
      ]
   }
}

view_item

Beispiel:

{
   "event":"view_item",
   "ecommerce":{
      "currency":"EUR",
      "value":19.99,
      "items":[
         {
            "item_name":"Main product with properties",
            "item_id":"SWDEMO10007.1",
            "price":19.99,
            "index":0,
            "item_list_name":"Category",
            "quantity":1,
            "item_variant":"S",
            "item_category":"Clothing",
            "item_category2":"Men",
            "item_list_id":"2185182cbbd4462ea844abeb2a438b33",
            "item_brand":"Shopware Fashion"
         }
      ]
   }
}

view_cart

Beispiel:

{
   "event":"view_cart",
   "ecommerce":{
      "currency":"EUR",
      "value":19.99,
      "items":[
         {
            "item_name":"Main product with properties",
            "item_id":"SWDEMO10007.1",
            "index":0,
            "price":19.99,
            "quantity":1,
            "item_variant":"S",
            "item_brand":"Shopware Fashion",
            "item_category":"Clothing",
            "item_category2":"Men",
            "item_list_id":"2185182cbbd4462ea844abeb2a438b33"
         }
      ]
   }
}

(Um die item_category Werte auch im Checkout auszugeben, aktivieren Sie bitte die jeweilige Plugin-Option)

add_to_cart

Beispiel:

{
   "event":"add_to_cart",
   "ecommerce":{
      "currency":"EUR",
      "value":19.99,
      "items":[
         {
            "item_name":"Main product with properties",
            "item_id":"SWDEMO10007.1",
            "quantity":1,
            "item_variant":"S",
            "item_category":"Clothing",
            "price":19.99,
            "item_brand":"Shopware Fashion"
         }
      ]
   }
}

purchase

Beispiel:

{
   "event":"purchase",
   "ecommerce":{
      "currency":"EUR",
      "transaction_id":"10042",
      "value":19.99,
      "tax":"3.19",
      "shipping":0,
      "items":[
         {
            "item_name":"Main product with properties",
            "item_id":"SWDEMO10007.1",
            "index":0,
            "price":19.99,
            "quantity":1,
            "item_variant":"S",
            "item_brand":"Shopware Fashion",
            "item_category":"Clothing",
            "item_category2":"Men",
            "item_list_id":"2185182cbbd4462ea844abeb2a438b33"
         }
      ],
      "new_customer":false,
      "customer_lifetime_value":4686.86
   }
}

Weitere Events

begin_checkout
select_item
add_to_cart_list (Custom Event für das Hinzufügen von Produkten von der Listenseite aus)
remove_from_cart
purchase
confirm_order (Custom Event für die checkout/confirm Seite)
add_payment_info
add_shipping_info

Maßgeblich ist bei den Produkt-bezogenen Events das items-Array.

Wenn Sie sich Events live ansehen wollen, werfen Sie bitte einen Blick in unseren Demoshop: Link zum Demoshop

Wir orientieren uns so gut es geht an der GA4 Entwickler*innen-Doku von Google. Diese finden Sie hier.

Als Identifier dienen immer die Keys item_name (Produktname) und item_id (Artikelnummer bzw. SKU, nicht die Datenbank-ID des Produkts!) Je nach Event kann es sein, dass weniger Keys befüllt sind als oben im Beispiel zu sehen.

Zusätzliche Events:

bei Kund*innen-Neuregistrierung: shopwareGTM.customerRegistered [aktuell nur im SW5 Plugin verfügbar]
bei Aktivierung der Remarketing-Parameter: remarketingTriggered
bei Klick auf den „Zur Kasse“ Button: initiateCheckout [aktuell nur im SW5 Plugin verfügbar]
wenn die Kund*innen der Verwendung von Cookies zugestimmt haben: cookieConsentGiven (siehe auch: https://www.codiverse.de/shopware-codiverse-gtm-eugh-urteil-zu-cookies-2019/)

die folgenden Events wurden mit den Versionen 3.0.0 bzw. 6.2.0 entfernt:

gtmAddToCart
gtmRemoveFromCart
shopwareGTM.orderCompleted