Documentation / Product / Integrations / Airship

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

This integration utilizes the Airship APIs to receive event data. On each run of the job, it will:

  1. 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.
  2. Collect event data into the airship_events stream.

Fields

The following fields are included in the default mapping of the airship_events stream:

Source FieldLytics User FieldDescriptionType
epochms()airship_last_app_event_tsLast App Eventdate
epochms()airship_created_tsCreated Datedate
body.currentairship_app_tagsApp Tags[]string
device.amazon_channelairship_amazon_devices unique idAmazon Device IDsstring
device.android_channelairship_android_devices unique idAndroid Device IDsstring
device.ios_channelairship_apple_devices unique idApple Device IDsstring
device.named_userairship_user_id unique idNamed User IDstring

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.

  1. Select Airship from the list of providers.
  2. Select the Import Activity Data job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Complete the configuration steps for your job. Configure Import Airship

  7. (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.

  8. (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.
  9. (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.
  10. (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.
  11. (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.
  12. Click Start Import.