Azure: Export Audiences (Event Hub)
The export job to Azure Event Hub allows you to send audience triggers when users enter or exit your Lytics audiences.
Integration Details
- Implementation Type: Server-side.
- Type: REST API.
- Frequency: Continuous update.
- Resulting Data: User enter/exit event of Lytics audience sent to Event Hub.
This integration uses the Azure Event Hubs REST API to send enter/exit event of Lytics audiences to Event Hub. Each run of the job will proceed as follows:
- Scan through the users in the selected audience and send to the Event Hub.
- Keep the job active to export any users that enter or exit the audience.
Fields
Lytics sends enter/exit event information about the user to Event Hub. An event might get triggered due to the following:
- A new data event.
- User Profile scoring gets updated occasionally.
- A scheduled trigger evaluation.
A trigger of "has done X of Y in last 7 days" may get scheduled to be evaluated 7 days after last X event. When the user gets updated, audience membership is re-evaluated and a trigger is sent if the user has moved in or out of the audience. Below is an example of the message sent to Event Hub:
{
"data": {
"_created": "2016-06-29T18:50:16.902758229Z",
"_modified": "2017-03-18T06:12:36.829070108Z",
"email": "[email protected]",
"user_id": "user123",
"segment_events":[
{
"id": "d3d8f15855b6b067709577342fe72db9",
"event": "exit",
"enter": "2017-03-02T06:12:36.829070108Z",
"exit": "2017-03-18T06:12:36.829070108Z",
"slug": "demo_segment"
},
{
"id": "abc678asdf",
"event": "enter",
"enter": "2017-03-02T06:12:36.829070108Z",
"exit": "2099-03-18T06:12:36.829070108Z",
"slug": "another_segment"
}
]
},
"meta":{
"object":"user",
"subscription_id": "7e2b8804bbe162cd3f9c0c5991bf3078",
"timestamp": "2017-03-18T06:12:36.829070108Z"
}
}
Configuration
Follow these steps to set up and configure an export of user event to Azure Event Hub in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.
- Select Microsoft Azure from the list of providers.
- Select the Export Audiences (Event Hub) job type from the list.
- Select the Authorization you would like to use or create a new one.
- Enter a Label to identify this job you are creating in Lytics.
- (Optional) Enter a Description for further context on your job.
- From the Audience list, select the Lytics audience you want to export. The event from the Audience list on the right side will be exported.
- (Optional) Select the Existing Users checkbox to enable a backfill of the current members of the audience(s) to Event Hub immediately.
- Click Start Export.