User guidesDeveloper websiteHelp centerLog in

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)

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)

any custom property name

Any Type (Optional)

Any custom property.

PreviousConversions trackingNextTracking API

Last updated