Recos analytics event format

Custom Event Name in Analytics Tool: ab_recos

Recos Analytics Event properties

Name	Description	Possible values	Reco analytic events action name	Potions analytics event action name	Comments
action_id	The action that led to sending the event	An Action ID	show, set_experiment_audience, add_to_cart_items, add_to_cart_item, go_to_page, convert_XXX		See 'Recos Analytic Events Actions' below to find the list of possible values for action_id
reco_id	The id of the experience concerned by the action	A Reco UUID	show, add_to_cart_items, add_to_cart_item, go_to_page, convert_XXX, close
item_id	The specific item concerned by the action (like the item added to cart in an “add_to_cart_item” action)	An Item ID	add_to_cart_item, got_to_page
item_ids	A list of items concerned by the action (like the items shown in a “show” action)	An Array of Item ID	show, add_to_cart_items	go_to_page, add_to_cart_item

Recos Analytic Events Actions

action_id	Description	Required properties	Optional properties	Click action
show	when an experience is shown to the user.	reco_id, action_id, item_ids		❌
go_to_page	when an item is clicked	reco_id, action_id, item_id	item_ids	✅
add_to_cart_item	when an item is added to cart in a recommendation	reco_id, action_id, item_id	item_ids	✅
add_to_cart_items	when alls the items recommended are added to cart (like in bundles)	reco_id, action_id, item_ids		✅
set_experiment_audience	when an experiment audience is set	action_id		❌
close	when an experience is closed	reco_id		✅
convert_XXX	when a conversion button is clicked (XXX can be anything)	reco_id, action_id		✅

Example: Event Logs in the DataLayer

When a recommendation banner appears:

{
  "event": "ab_recos_[uuid]",
  "recos": {
    "reco_id": "[RECO_ID]",
    "action_id": "show",
    "item_id": "",
    "item_ids": "[\"21222\",\"12073\",\"21464\",\"6762\"]",
    "debug_mode": false,
    "non_interaction": false
  }
}

When a product card is clicked:

{
  "event": "ab_recos_[uuid]",
  "recos": {
    "reco_id": "[RECO_ID]",
    "action_id": "go_to_page",
    "item_id": "21222",
    "item_ids": "[\"21222\",\"12073\",\"21464\",\"6762\"]",
    "debug_mode": false,
    "non_interaction": false
  }
}

Each event includes a unique uuid to prevent collisions in the dataLayer.