Airship: Import Events
By importing your Airship events into Lytics, you'll be able to use Lytics powerful insights into the channels your users use the most.
Integration Details
- Implementation Type: Server-side.
- Implementation Technique: Streaming REST API.
- Frequency: Real-time, with one time backfill of events after setup.
- Resulting Data: Activity-based user fields and raw events from Airship.
This integration utilizes the Airship APIs to receive event data. On each run of the job, it will:
- Open event stream using the configured device and event type filters, and event latancey. After the first run, the request will include the offset of the last event read.
- Collect event data into the
airship_eventsstream.
Fields
The following fields are included in the default mapping of the airship_events stream:
| Source Field | Lytics User Field | Description | Type |
|---|---|---|---|
| epochms() | airship_last_app_event_ts | Last App Event | date |
| epochms() | airship_created_ts | Created Date | date |
| body.current | airship_app_tags | App Tags | []string |
| device.amazon_channel | airship_amazon_devices unique id | Amazon Device IDs | string |
| device.android_channel | airship_android_devices unique id | Android Device IDs | string |
| device.ios_channel | airship_apple_devices unique id | Apple Device IDs | string |
| device.named_user | airship_user_id unique id | Named User ID | string |
Configuration
Follow these steps to set up and configure an import job for Airship in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.
- Select Airship from the list of providers.
- Select the Import Activity Data 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.
Complete the configuration steps for your job.
(Optional) In the Maximum Event Age (days) text box, enter the maximum age of a message to be imported. If left blank, only new events will be imported.
- (Optional) Using the Device Types input, select the types of device you would like events from. Devices on the right will be included. If no Devices are selected, all device types will be imported.
- (Optional) Using the Event Types input, select the types of events you would like to import. Event Types on the right will be included. If no Event Types are selected, all event types will be imported.
- (Optional) In the Push ID text box, enter the ID of a push message to only import events related to that push. Note: you may only include one of Group ID and Push ID.
- (Optional) In the Group ID text box, enter the ID of a group to only import events related to that group. Note: you may only include one of Group ID and Push ID.
- Click Start Import.
