Context vs Events for Analytics

information sent to monetate generally falls into two categories context — session derived data such as geographic and technographic information or custom variables events — data used for calculating analytics and key performance indicators (kpis) context is determined per session and can safely be sent multiple times—by both the monetate tag and engine api, for example—with no effect on analytics ensure that you include the end user’s useragent string so that sessions are registered properly as stealth or not if the value of useragent lacks specific browser or os details, then it's identified as automated and put into stealth mode however, events can potentially be recorded by both the monetate tag and engine api in types of implementations be aware of the following factors api events are recorded at the session level for experience analytics, but you can view the aggregate count (how many times the event occurred) in raw data product views are recorded individually but are only used for processing recommendation algorithms what matters is if a product was viewed in a session, not how many times it was viewed the most viewed (product detail page) recommendation algorithm can be influenced by multiple views in a given session collaborative recommendation algorithms , such as viewed and also viewed and purchased and also purchased, aren't effected by multiple views in a given session and solely function based on whether a product was viewed in a session cart events are recorded as an event, and monetate considers the most recent event for behavioral purposes for this reason, even for traditional monetate tag–based implementations, properly recording all applicable cart items on every track is important purchases are recorded individually but are deduplicated by the purchaseid value if a monetate tag–based integration and engine api integration report the same purchaseid value, then only one is recorded page views aren't currently supported by the engine api as a result, average page views and bounce rate metrics cannot be calculated for omnichannel experiences custom events you can send any event, such as clicks and impressions, that falls outside of monetate's built in events by using model monetate\ record\ pageevents example request with monetate\ record\ pageevents { "eventtype" "monetate\ record\ pageevents", "pageevents" \[ "myevent" ] } the list of events sent can be any event configured in monetate by following the steps in context vs events for analytics docid\ eiblb8ns18mafa 2yt05 these events are identified in the api by their unique key, an alphanumeric string set when you create the event you can't use monetate\ record\ pageevents to send an event that doesn't have a unique key you can configure any event to have a unique key requests referencing this key from the time the key is set result in that event being sent to monetate when one or more of these events are sent via the engine api, they're recorded within monetate as having occurred for the customer at the time sent for example, in the example monetate\ record\ pageevents request, an event with the unique key myevent is sent this value was set using the unique key field in the create engine api event modal in the monetate platform a number of rules govern how unique keys function each key must be unique and can only be used if it actively references the event in question you can't set a key retroactively but you can change it if you send a unique key in a monetate\ record\ pageevents request before you create the key, then the unique key is ignored the engine api also ignores any unique key value in a request that no longer references an event, such as when an unique key is changed custom events are useful for reporting and for use as goal metrics in monetate experiences creating a custom engine api event follow these steps to create a custom engine api event in the monetate platform log into the monetate platform click components in the top navigation bar and then select events callout of the events option in the components menu of the monetate platform click the arrow to the right of create event and then select create engine api event callout of the 'create engine api event' option in the 'create event' selector in the create engine api event modal, give the event a title and description, then enter into unique key the value to be sent when this event occurs leave api as the selected option for category optionally, enter a subcategory and any action conditions click save monetate recommends creating one or more action conditions to limit the event to pages on which it should be tracked when a customer meets the criteria of the event, send a request with monetate\ record\ pageevents that contains the unique key that you input for the custom event you also must add the custom api event to the why settings of an omnichannel experience as a secondary metric follow steps 5 and 6 in add custom metrics to an experience to add and select the event in the monetate platform's experience editor