Transactions and basket events

Tracking transactions lets you use features such as eCommerce analytics, product purchase segmentation, or cart/transaction based automations.

Authentication

Requests to the SDK may require customer authentication. For more details, see this article.

Using Google Data Layer

If you use Google Analytics 4 e-commerce, you can send data to it when using Synerise event tracking.

Important: If you created the tracking code with the generator, you don’t need to edit it.

If your tracking code was created without the generator, add the dataLayer and gaVersion properties to SR.init():

SR.init({
    "trackerKey":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "dataLayer": dataLayer,
    "gaVersion": "CHOOSE_VERSION"
});

The gaVersion parameter is used to set the Google Analytics implementation. You can only choose one implementation for use with Synerise tracking.

To send events to Google Analytics 4 Tag Manager implementation, set the value to GA_4
To send events to Google Analytics 4 gtag.js implementation, set the value to GA_4_TAG

When you send events to Google Data Layer, some item parameters are saved in Synerise under different names than in the Data Layer request:

Parameter name in Data Layer	Parameter name in Synerise
`item_category`	`$categories` (array)
`item_id`	`$sku`
`price`	`$finalUnitPrice`
`item_name`	`$title`
`quantity`	`$quantity`
`value`/`revenue`	`$totalAmount`
`transaction_id`	`orderId`
`item_*`	`item_` is removed, for example `item_variant` is saved as `variant`

Other parameters are saved without changing their names.

Product added to shopping cart

This call creates a product.addToCart event.

dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 7.77,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 9.99,
      quantity: 1
    }
    ]
  }
});

Product removed from shopping cart

This call creates a product.removeFromCart event.

dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 7.77,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 9.99,
      quantity: 1
    }
    ]
  }
});

Purchase details

This call creates a transaction.charge event and corresponding product.buy events.

dataLayer.push({
  event: "purchase",
  ecommerce: {
      transaction_id: "T_12345",
      value: 25.42,
      tax: 4.90,
      shipping: 5.99,
      currency: "USD",
      coupon: "SUMMER_SALE",
      items: [
       {
        item_id: "SKU_12345",
        item_name: "Stan and Friends Tee",
        affiliation: "Google Merchandise Store",
        coupon: "SUMMER_FUN",
        discount: 2.22,
        index: 0,
        item_brand: "Google",
        item_category: "Apparel",
        item_category2: "Adult",
        item_category3: "Shirts",
        item_category4: "Crew",
        item_category5: "Short sleeve",
        item_list_id: "related_products",
        item_list_name: "Related Products",
        item_variant: "green",
        location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
        price: 9.99,
        quantity: 1
      },
      {
        item_id: "SKU_12346",
        item_name: "Google Grey Women's Tee",
        affiliation: "Google Merchandise Store",
        coupon: "SUMMER_FUN",
        discount: 3.33,
        index: 1,
        item_brand: "Google",
        item_category: "Apparel",
        item_category2: "Adult",
        item_category3: "Shirts",
        item_category4: "Crew",
        item_category5: "Short sleeve",
        item_list_id: "related_products",
        item_list_name: "Related Products",
        item_variant: "gray",
        location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
        price: 20.99,
        promotion_id: "P_12345",
        promotion_name: "Summer Sale",
        quantity: 1
      }]
  }
});

Tracking transactions without Google Data Layer

If you’re not integrated with Google Data Layer, you can create your own array variable and connect it to Synerise using the SDK:

SR.init({
    "trackerKey":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "dataLayer": window["syneriseLayer"] = []
});

After this configuration, you can send objects like the ones above to the syneriseLayer variable instead of the dataLayer variable:

syneriseLayer.push({...})