Comment on page

Email views and clicks

You can track read and click actions in emails sent to your customers.
To track the opening of the emails, you have to include a pixel
To track the clicks on the links included in your emails, you have to replace each of your links with a Click Tracking URL
For each event, the datamart will identify the users reading/clicking the email by:
Recommended option: using the user's Email Hash, included by you in the pixel/tracking URL
Reading their cookies if possible:
It is always working when the users are clicking (e.g. Click Tracking URL)
It is sometimes possible when the users are opening the emails, depending on their email client (e.g. Pixel)
Activities tracked through this method will be of EMAIL $type and NO_SESSION $session_status. See User activity object for more information.
Pixel Touch for Email Opening
Calls to those URLs generate events.
https://events.mediarithmics.com/v1/touches/pixel?  
  $ev=$email_view&  
  $dat_token=<DATAMART_TOKEN>&  
  $email_hash=78b04074e616166938cf672f70f41b4d&  
  Any Custom Properties ...
or if your are using the $uids field (see Passing user identifiers in pixel-based tracking)  
https://events.mediarithmics.com/v1/touches/pixel?  
  $ev=$email_view&  
  $dat_token=<DATAMART_TOKEN>&  
  $uids=jso-[{"$tpe":"EM","$eh":"78b04074e616166938cf672f70f41b4d"}]&
  Any Custom Properties ...
or if you are using a custom domain:
https://analytics.custom-domain.com/v1/touches/pixel? 
    $ev=$email_view& 
    $dat_token=<DATAMART_TOKEN>& 
    $email_hash=78b04074e616166938cf672f70f41b4d& 
    Any Custom Properties ...
It is possible to set custom properties
Field
Type
Description
$ev
String
The event name. $email_view for email opening tracking
$dat_token
String
The id of the audience datamart in the mediarithmics platform.
$cuid
String (Optional)
The user account id.
$email
String (Optional)
The user email.
$email_hash
String (Optional)
The user email hash.
$cb
String (Optional)
The cache buster parameter. It should contain a random string.
$uids
JSON as string (Optional)
The list of user identifiers of the user.
any custom property name
Any Type
Any custom property
Click Tracking for Emails 
Calls to those URLs generate click events​
https://events.mediarithmics.com/v1/touches/click?
    $ev=$email_click&
    $dat_token=<DATAMART_TOKEN>&
    $email_hash=78b04074e616166938cf672f70f41b4d&
    Any Custom Properties &
    $redirect=<CLICK_URL>

It is also possible to set custom properties.

The $redirect parameter is used to define the destination of the url redirection. The URL put in the $redirect parameter should be URL Encoded (RFC 3986).
Field
Type
Description
$ev
String
The event name. $email_click for email opening tracking
$dat_token
String
The id of the audience datamart in the mediarithmics platform.
$redirect
String
The redirect url. This string should url encoded. (RFC 3986). Warning: this parameters must be placed at the end of the URL. Any parameters that will be placed after the $redirect parameters will not be saved.
$cuid
String (Optional)
The user account id.
$email
String (Optional)
The user email.
$email_hash
String (Optional)
The user email hash.
$cb
String (Optional)
The cache buster parameter. It should contain a random string.
$uids
JSON as string (Optional)
The list of user identifiers of the user.
any custom property name
Any Type (Optional)
Any custom property.

Field	Type	Description
$ev	String	The event name. $email_view for email opening tracking
$dat_token	String	The id of the audience datamart in the mediarithmics platform.
$cuid	String (Optional)	The user account id.
$email	String (Optional)	The user email.
$email_hash	String (Optional)	The user email hash.
$cb	String (Optional)	The cache buster parameter. It should contain a random string.
$uids	JSON as string (Optional)	The list of user identifiers of the user.
any custom property name	Any Type	Any custom property

Field	Type	Description
$ev	String	The event name. $email_click for email opening tracking
$dat_token	String	The id of the audience datamart in the mediarithmics platform.
$redirect	String	The redirect url. This string should url encoded. (RFC 3986). Warning: this parameters must be placed at the end of the URL. Any parameters that will be placed after the $redirect parameters will not be saved.
$cuid	String (Optional)	The user account id.
$email	String (Optional)	The user email.
$email_hash	String (Optional)	The user email hash.
$cb	String (Optional)	The cache buster parameter. It should contain a random string.
$uids	JSON as string (Optional)	The list of user identifiers of the user.
any custom property name	Any Type (Optional)	Any custom property.

Conversions tracking

Tracking API

Last modified 18d ago