Targeting Box Display to Iterable User Attributes or Lists

Digioh App Marketplace


Digioh supports targeting (and anti-targeting) of box displays to known Iterable User’s Attributes and/or list membership. An Iterable user is “known” to Digioh if a Digioh box collected their email, or if the user has clicked on a URL linking to your site that has userId or email parameters on the query string.

To use the app, you will need at least one authenticated Iterable Integration configured in your Digioh account.

To install the app, from the Digioh HQ go to your profile menu top right, pick Custom JS (Apps), then find and install “Target Iterable user attributes and lists”.

To configure the app, add Account-level metadata iterable_proxy_integration_id, with the ID of the authenticated integration from the Integrations list.

This app works by retrieving and caching Iterable user attributes in real-time, and making the data available in a JavaScript object DIGIOH_API.itrbl that you can reference in Box conditions:

All Iterable user attributes are converted to properties of the DIGIOH_API.itrbl object, so you can reference like this:

DIGIOH_API.itrbl.attributeName

Similarly, list membership is targetable property:

DIGIOH_API.itrbl.lists[numericListId] = true

To anti-target user attributes, you need to be careful. The JS Var condition does not equal will be true for unknown users, so if you want to anti-target known users that do not have favoriteColor = green you should also check if they are known:

Without the second condition here, the box would display to all unknown users, which is probably not what you want.

This app is “silent”, but you can see helpful diagnostic information when using ?boxqamode on the URL.

Linking Iterable User Identity to Digioh

Digioh will retain and use the identity (email) of users where a Digioh box collected their email, but you can and should expand this to include existing Iterable users too. To do this, you need to update your Iterable email templates so that all links to your site include ?email={{email}} on the query string:

This way, any clicks on an email will identify that user to Digioh and activate targeting capabilities. You don’t have to instrument all of your emails in this way, but we recommend that you do so for links in your most commonly clicked emails to maximize the “penetration” of identity sync within your user base. For example, if you have a double opt in email signup process and/or a welcome email, definitely add the email parameter to those.

Questions? Comments? Let us know at contact@digioh.com