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.