Customer.io Object | Captured in Hull as | Description |
---|---|---|
Customer Subscribed Event | User Event | Captured as a User Event in Hull |
Customer Unsubscribed Event | User Event | Captured as a User Event in Hull |
Email Bounced Event | User Event | Captured as a User Event in Hull |
Email Clicked Event | User Event | Captured as a User Event in Hull |
Email Delivered Event | User Event | Captured as a User Event in Hull |
Email Converted Event | User Event | Captured as a User Event in Hull |
Hull Object | Sent to Customer.io as | Description |
---|---|---|
User Event | Email Delievered Event | Any Hull Event |
User | User User | Hull Users will be sent to Customer.io along with the selected attributes |
The Customer.io Connector enables your team to automate customer lifecycle emails and campaigns by synchronizing users from Hull with Customer.io. It also has the ability to send email activity events to Hull.
The Customer.io Connector allows you to:
The Customer.io Connector supports the actions update traits
and create events
.
SITE ID
and API KEY
.SITE ID
and API KEY
.That’s it! The connector is now ready to send data to Customer.io!
To receive customer activity from Customer.io you need to tell Customer.io to send events to Hull when something happens.
Settings
tab in Hull, and copying the generated Webhook URL: If you aren’t seeing the “Reporting Webhooks” integration in Customerio, refer to this section instead. To receive customer activity from Customer.io you need to tell Customer.io to send events to Hull when something happens.
Settings
tab in Hull, and copying the generated Webhook URL: That’s it! The connector is now ready to receive data to Customer.io!
When connector is authorized against Customer.io API, it’s time to define what data exactly will be send and received from Customer.io.
Start with Outgoing Mapping section in the settings.
The most important decision you have to make here is which user attribute to send as the **customerId**
to Customer.io which is the unique identifier within Customer.io. Our recommendation is to either use the external_id
if you assign your own identifier to users in Hull or use the Hull id
.
To send users to Customer.io, first define which whitelisted segments users will need to belong to. If the segments are not specified, users will not be sent to Customer.io. Second, specify which attributes will be sent from Hull to Customer.io. By default, the attributes email
, customerId
and hull_segments
(all the segments the user belongs to) will be sent to Customer.io.
IMPORTANT: Please keep in mind that Customer.io API allows to send maximum 30 attributes per API call so bigger number of selected attributes will double the number of API calls and can make the connector slower.
When users leave all whitelisted segments, you have to ability to remove that user from Customer.io. To enable this feature, toggle on enable user deletion and the connector will automatically remove users from Customer.io if they no longer belong to any of the whitelisted segments. Otherwise, if a user leaves all whitelisted segment it will be kept in Customer.io, but will no longer receive updates.
Furthermore, you can specify which events will be sent to Customer.io by selecting the events from the dropdown list. By default no events are sent. Each outgoing event will create a new activity in Customer.io. For all events except Page View Events (see below), the activity type will be set to “Event” and the activity name will have the same name as the Hull event, which allows basic segmentation in Customer.io.
Customer.io allows you the option to handle Page View Events differently than generic events. To begin sending these events to Customer.io, in the connector settings, add the page
event to whitelisted events list. The connector will then send all future Page View Events to Customer.io as activities. Unlike generic events, the type of the activity will be set to “Page” and the name of the activity will be the url of the Page View. This is aligned with Customer.io documentation on tracking page views and allows you to build more fine grained segments in Customer.io. The url of the Page View activity will be picked from Hull Event url property, or, if not available, will fall back to the page_url context property. Additionally, a referrer will be added to the Customer.io activity.
You can also activate Anonymous Events, which is an advanced feature in Customer.io. If you are not familiar with this feature, please refer to Customer.io’s documentation.
You are able to limit the events Hull will receive from Customer.io. The list of all events is available in the Customer.io docs under https://Customer.io/docs/webhooks#events.
To customize this list, navigate to your Customer.io dashboard, select Integrations from the menu on the left, and navigate to Email Activity Webhook card:
On the next page, you can select the events you want to receive from the list and save your changes:
Learn how Hull unifies and syncs customer data by watching our product tour