Event

Iterable is a multi-channel growth marketing and user engagement platform that powers marketing, transactional, and lifecycle campaigns on email, web and mobile. Iterable requires your application to be collecting email addresses. This can be done by calling the setUserIdentity SDK method.

There are two components to the Iterable event integration. All event forwarding is handled server-side by mParticle. To support Iterable’s deeplinking capabilities, you must also include the Iterable Kit as part of your mParticle SDK installation. The embedded kit handles only deeplinking. Even if the kit is included, all event data is forwarded server-side.

The Iterable integration supports Android, iOS and Web data.

Prerequisites

In order to forward events to Iterable, you must have an account with Iterable.

1. Sign into your Iterable account at https://app.iterable.com/login/

2. Create your Iterable API keys

a. Select Integrations -> API Keys from the left navigation menu.

b. Click the Create New API Key button

c. Select to create a key of type Standard

d. Click Create

d. Save the value in the Key column of the table. This value is need to configure Iterable in the mParticle Service Integration.

3. Create Push Integrations

If you will be sending push registration events, you will need to provide the Iterable Push Integration names as part of the mParticle configuration. This can be done from the Iterable platform.

a. Select Push Integrations -> Mobile Push from the left navigation menu.
b. Click Add Push Integration and enter the push integration name and platform.
c. Depending on the platform selected, you will need to enter additional parameters:

• For GCM, you will need to enter your API Key
• For APNS and APNS Sandbox, you will need to enter your app certificate.

Supported User Identities

mParticle will forward the following identifiers to Iterable where available:

• Email
• Customer ID
• Apple Vendor ID (IDFV)
• Google Advertising ID (GAID)
• Android ID

Supported Event Types

• Custom Event
• Product Action
• Push Subscription
• Push Message Receipt
• User Identity Change

Subscription Preferences

The Iterable integration allows you to map a custom event to Iterable’s Update User Subscriptions api call. See the Platform Guide for general help with Custom Mappings. The ‘Update Subscriptions’ event takes the following attributes, all optional.

Iterable Kit Integration

mParticle also supports an Iterable Kit integration, which you can use to access Iterable’s Deep Linking features. To use this integration, you need to include the Iterable kit in your installation of the mParticle SDK. The kit integration handles only Deep Linking. All other data is still sent server-to-server. The source code for each kit is available on Github:

• iOS
• Android

To add the Iterable Kit to your iOS or Android app, see the Cocoapods and Gradle examples below, and reference the Apple SDK and Android SDK guides to read more about kits.

//Sample Podfile
target '<Your Target>' do
    pod 'mParticle-iterable', '~> 6'
end

//Sample build.gradle
dependencies {
    compile 'com.mparticle:android-iterable-kit:4+'
}

Configuration Settings

Connection Settings