Integration tiles sync data to and from services outside of Iterable when users reach that step of a journey. There are four types of integration tiles:
- Live Data (Beta)
- Webhook
- Google Ads
# In this article
# Live Data tiles
Beta Feature
The Live Data tile is currently available as part of the Journey Live Data beta for select Iterable customers. If you're interested in using the feature during beta, reach out to your customer success manager to request access.
Live Data tiles fetch data from an external source using a journey webhook. This in-memory data only persists for the duration of a user's path through a journey and supports intelligent, real-time, contextual decisioning and personalization in journeys, such as stock updates and offer eligibility.
Under Webhook, select the journey webhook that the Live Data tile uses to retrieve data.
To use a webhook with Live Data, enable Data Retrieval and define up to 10 fields from the webhook payload as live data fields for your journey. For setup instructions, see Creating Journey Webhooks.
Under Dynamic Parameters, enter any variables you wish to add to the endpoint's URL to populate dynamic content from user profile data or custom events. For example, let's say you're running an experiment and you want to pass the different variant IDs to determine which variant users received. You could set up the following:
The resulting endpoint looks like this:
https://api.yourdomain.com/experiments/exposure?experimentId={{dataFields.experimentId}}&variant={{dataFields.variant}}&userId={{userId}}
NOTE
You can also define variables for an endpoint URL while configuring the journey webhook. When you do this, the same variables apply to all journey tiles that reference the webhook. Configuring these variables at the tile level allows you to reuse one webhook across multiple journeys and populate dynamic data in each journey tile. Before you define variables, consider your use case and whether you prefer the one-time setup of defining variables at the webhook level or need the flexibility of defining variables on a per-tile basis.
To manage the traffic coming into your endpoints, check the box next to Set a rate limit to limit how fast Iterable calls the webhook. Journeys are powerful and can process thousands of requests per second. When calling external services, it's important to understand if they can handle the load of high-volume journeys and use rate limiting to implement the necessary guardrails for calling these services.
Optionally, give the liveData object a name. This name is used to identify the
live data object and reference the data fields you defined in the journey webhook
downstream in the journey.
For example, if you name the liveData object thunderGameStats, you could
reference the current score like this:
{{liveData.thunderGameStats.currentScore}}
The Live Data Fields box shows the fields that are available to reference in
downstream tiles. You can use the "copy" icon to copy a field's Handlebars code
reference (for example, {{liveData.thunderGameStats.currentScore}}) to your
clipboard. You can then paste this code into a message template or select it as
filter criteria in a Yes/No Split tile or Attribute Split tile.
To learn more and get started with Live Data tiles, see Journey Live Data Overview.
# Example: Avoid promotional sends for out-of-stock products
You could use a Live Data tile to check inventory levels before sending a promotional
message in a cart abandonment journey. Configure a Live Data tile to query your
inventory API right before a Yes/No Split tile, fetching the in_stock value (and
optionally quantity and restock_eta) for the SKU(s) tied to that user. If
in_stock = true, send a promotional message with a CTA to purchase the item.
If in_stock = false, send an alternate product recommendation or skip the
send.
# Webhook tiles
Webhook tiles send data from Iterable to an external server or third-party service. You can use Webhook tiles to connect apps like Segment, Amplitude, and Inkit to your Iterable journeys, or send data to your own servers.
Select Use Existing Webhook to choose one of the webhooks you've previously created on the Journey Webhooks page.
Alternatively, you can create a new webhook from within the tile. To do this, select Endpoint URL and enter an endpoint URL and optional authorization token.
IMPORTANT
Webhooks you create in the Webhook tile don't save to your Journey Webhooks page and can't be reused in multiple journeys (unless you manually recreate them each time). Before creating a journey webhook, consider whether you plan to apply it to a single journey, or reuse it for more journey use cases.
This creates a new webhook that sends POST requests to the endpoint URL, along
with information about the triggering event. Iterable discards any response it
receives from the server.
To help protect external endpoints from high-volume journeys, check the box next to Set a rate limit to limit how fast Iterable calls the webhook. This can help ensure that the destination service can handle the request volume.
# Example: Triggering a send from another service or app
Let's say you're building a customer win-back journey, and you want to send users a postcard in the mail at a certain step. You could add a Webhook tile and set it up to trigger a send from one of Iterable's direct-mail integrations (like Inkit, Poplar, or Paperplanes).
# Facebook tiles
Facebook tiles let you build Facebook custom audiences from your Iterable journeys.
To use the Facebook tile in your journeys, you must have a Facebook ad account.
First, select whether you want to add or remove users from a Facebook Custom Audience when they reach this stage of the journey.
Then, enter your Facebook ad account ID and select which audience you want to update when users reach the tile.
# Example: Triggering a Facebook ad
Let's say you want to display a Facebook ad to users who have shown interest in one of your products by clicking a link in an email. You could set up a Yes/No Split tile that checks whether users have clicked the link, then connect the Yes branch to a Facebook tile that adds users to a Facebook custom audience for ad targeting.
# Google Ads tiles
Google Ads tiles let you build Google Ads audience segments from your Iterable journeys.
To use the Google Ads tile in your journeys, you must have a Google Ads account and complete the integration setup steps.
To set up a Google Ads tile:
First, select whether you want to add or remove users from a Google Ads Customer Match audience when they reach this stage of the journey.
Then, select your Google Ads account and choose which audience(s) you want to update when users reach the tile.
# Example: Retargeting users who haven't converted
Let's say you want to retarget users who clicked through a promotional message but haven't made a purchase. You could add a Yes/No Split tile that checks for a purchase event, then connect the No branch to a Google Ads tile that adds users to a Customer Match audience for follow-up advertising.
# Want to learn more?
For more information about some of the topics in this article, check out these resources:
Support docs