All pages
Powered by GitBook
1 of 1

Loading...

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)

Calls to those URLs generate .

or if your are using the $uids field (see )

or if you are using a custom domain:

It is possible to set custom properties

Field
Type
Description

Calls to those URLs generate click

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 .

Field
Type
Description

It is sometimes possible when the users are opening the emails, depending on their email client (e.g. Pixel)

$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 of the user.

any custom property name

Any Type

Any custom property

$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 of the user.

any custom property name

Any Type (Optional)

Any custom property.

https://events.mediarithmics.com/v1/touches/pixel?  
  $ev=$email_view&  
  $dat_token=<DATAMART_TOKEN>&  
  $email_hash=78b04074e616166938cf672f70f41b4d&  
  Any Custom Properties ...
https://events.mediarithmics.com/v1/touches/pixel?  
  $ev=$email_view&  
  $dat_token=<DATAMART_TOKEN>&  
  $uids=jso-[{"$tpe":"EM","$eh":"78b04074e616166938cf672f70f41b4d"}]&
  Any Custom Properties ...
https://analytics.custom-domain.com/v1/touches/pixel? 
    $ev=$email_view& 
    $dat_token=<DATAMART_TOKEN>& 
    $email_hash=78b04074e616166938cf672f70f41b4d& 
    Any Custom Properties ...

$ev

String

The event name. $email_view for email opening tracking

$dat_token

String

https://events.mediarithmics.com/v1/touches/click?
    $ev=$email_click&
    $dat_token=<DATAMART_TOKEN>&
    $email_hash=78b04074e616166938cf672f70f41b4d&
    Any Custom Properties &
    $redirect=<CLICK_URL>

$ev

String

The event name. $email_click for email opening tracking

$dat_token

String

Activities tracked through this method will be of EMAIL $type and NO_SESSION $session_status. See UserActivity object for more information.

Pixel Touch for Email Opening

Click Tracking for Emails

events
Passing user identifiers in pixel-based tracking
events
URL Encoded (RFC 3986)

The id of the audience datamart in the mediarithmics platform.

The id of the audience datamart in the mediarithmics platform.

user identifiers
user identifiers