Documentation / Product / Integrations / Amazon Web Services / Amazon Pinpoint

Amazon Pinpoint Export

Export Lytics audiences to add audience membership data to your Pinpoint endpoints, and send targeted notifications using Pinpoint as users enter or exit Lytics audiences.

Integration Details

This integration utilizes the Pinpoint REST APIs to send Pinpoint events that set an attribute for a Pinpoint Endpoint as a user enters or exits an audience in Lytics.

  1. As users enter or exit the Lytics audience, a new event is sent with the identifier lytics_audience with the slug of the exported Lytics audience. For example, lytics_highly_engaged is sent with the value true if they have entered the audience, and false if they have exited the audience.
  2. When building a campaign in Pinpoint, this attribute can be used to trigger a send event. In the Pinpoint campaign setup step "Choose when to send the campaign" you can target the attribute Lytics Audience for when the exported Lytics audience slug is set to true.
  3. The Lytics audience is also added as a Pinpoint endpoint attribute which can be used in Pinpoint to create custom segments.

Fields

By default, Lytics exports the following fields to Pinpoint.

Lytics User FieldDescriptionPinpoint FieldType
customAddress FieldAddress for channelstring
AudienceExported Audiencelytics_audiencebool

Configuration

Follow these steps to set up and configure an export of a Lytics audience to Pinpoint.

  1. From Data > Integrations, select the Amazon AWS Services tile. aws
  2. Select New workflow.
  3. Select Pinpoint Export workflow.
  4. From the Audience input, select Lytics Audiences to emit events from. Each enter/exit event from the selected audience will be sent as a Pinpoint email event.
  5. From the Region input, select the AWS region that Pinpoint resides in (e.g. us-east-2).
  6. From the Pinpoint Project input, select your Pinpoint Project.
  7. From the Pinpoint Channel Type input, select the channel type, e.g., Email or SMS, to send to (channel must first be activated in Pinpoint).
  8. From the Address Field input, select the Lytics field that contains the user's endpoint address for the selected channel, e.g. "Email Address" if the selected channel type is "EMAIL".
  9. (Optional) From the User ID Field input, select the Lytics field that contains the user's unique ID that is used in Pinpoint to tie channel endpoints together.
  10. Select the Existing Users checkbox to send an enter event for users who are already in the selected Lytics audience.
  11. Click Start Export. pinpoint export

If the Existing Users option is selected, audience data should be in Pinpoint within minutes. Otherwise, data will be seen when a new user enters or exits the exported audience.

In Pinpoint, segments can be created to target the Lytics audience by defining a segment with the exported Lytics segment slug name set to true.

pinpoin segment