Skip to main content

Event tracking with the Dotdigital Tag

The Dotdigital Tag APIs streamline event tracking and user identification for your site.

Laura Russell avatar
Written by Laura Russell
Updated this week

This feature is in Public preview and may be subject to short notice changes or improvements.

The Dotdigital Tag API methods are client-side functions which send user interaction data to a server, ensuring consistent data capture for events such as page views, user logins, products browsed, and cart updates.

For joint customers of Dotdigital and Fresh Relevance, the Dotdigital Tag enables a single implementation which makes your tracking data available across both platforms.


Key tracking events

The Dotdigital Tag encompasses a number of methods, each of which correspond to a specific event type. Each event type has its own data schema.

For more detailed technical information, see our Developer Hub.

Event type

Method

Description

Page change

window.ddg.track(data)

Tracks page visits.

User identification

window.ddg.identify({...})

Identifies a user with specific attributes such as email, mobile number, and name.

Product browse

window.ddg.productBrowse( {...} )

Tracks product browsing events with detailed product information.

Product list

window.ddg.productList({data})

Tracks a list of products viewed by the contact.

Cart update

window.ddg.cartUpdate({...})

Updates cart information with detailed cart and product data.

Checkout

window.ddg.checkout({...})

Tracks checkout events.

When used, the cart Insight data’s CartPhase in Dotdigital is set to ORDER_CHECKOUT .

Purchase complete

window.ddg.purchaseComplete({...})

Tracks purchase completion events.

When used, the cart Insight data’s CartPhase in Dotdigital is set to ORDER_COMPLETE .**

Custom signal*

window.ddg.signal("SignalName",{...})

Sends custom event signals.

* Custom signals in Dotdigital are only available in our CXDP account package. Learn more in Use signals with the Dotdigital Tag.

**You can use this method to create order Insight records if you’re not otherwise syncing orders into Dotdigital. Learn more in Add the Dotdigital Tag to your website: Advanced settings.

Did this answer your question?