Data Export

AIRSHIP MAINTAINED INTEGRATION

This integration is maintained by Airship. Please contact Airship for support.

Using Real-Time Data StreamingA service that delivers user-level events in real time to your backend or third-party systems using the Data Streaming API., Airship event data is uploaded in batched CSV files to a cloud storage provider: Amazon S3 , Azure Blob Storage , or Google Cloud Storage (GCS).

Data Export integration requirements

This integration requires these accounts:

Your own cloud storage with Amazon S3, Google Cloud Storage, or Azure Blob Storage
Airship — Must include both:
- Messaging
- Real-Time Data Streaming

Configuring a cloud storage provider

Before setting up this integration, you must create an Amazon S3 bucket, Google Cloud Storage bucket, or Microsoft Azure container. Also, you must set credentials the integration will use to upload data to the storage location:

Amazon S3 — Configure an IAM user and retrieve the account access keys. Follow Amazon’s documentation: Managing access keys .
Azure — Configure an Azure connection string. Follow Azure’s documentation: Configure Azure Storage connection strings .
Google Cloud Storage — Create a JSON-formatted service account key with role Storage Object Creation. Follow Create and delete service account keys in Google’s IAM documentation.

Configuring the Data Export integration

You will need the following information about your cloud storage:

Amazon S3 — Access key ID, secret access key, and bucket name, and AWS Region
Azure — Connection string and container name
Google Cloud Storage — Bucket name and JSON-formatted service account key

In Airship:

Next to your project name, select the dropdown menu (), then Settings.
Under Project settings, select Partner Integrations.
Select Data Export.
Select Configure for the outbound integration and follow the onscreen instructions to:
- Select your storage provider and enter your credentials. For Amazon S3, you must also select your region.
- Select a file layout: Standard, Simplified, or Flattened.
- Select the Airship events to send to your storage location.
- Options:
  - Specify a folder path to prepend to the file storage path.
  - Compress your data to save on storage space.
  - (For Amazon S3) Enable encrypting your data using server-side encryption .

After completing configuration, it may take several minutes to begin populating events.

Structure and files

You can select one of three file layouts for your Data Export integration:

Standard — The default layout, with date folders.
[folder_path]/appKey/integrationId/eventType/YYYY_MM_DD/YYYY_MM_DD_HH_mm_ss.csv
Simplified — Date components are included in the file names.
[folder_path]/appKey/integrationId/eventType/YYYY_MM_DD_HH_mm_ss.csv
Flattened — All components are included in the file names.
[folder_path]/appKey/integrationId/eventType_YYYY_MM_DD_HH_mm_ss.csv

For all layouts, there will be one file generated per hour, assuming a relevant event occurred within that hour. Each CSV file will also contain a header row.

Example CSVs

The following are examples of CVSs exported by Airship.

Send example

"id","offset","occurred","processed","app_key","channel","device_type","named_user","custom_identifiers","locale_variant","locale_country_code","locale_timezone","locale_language_code","iana_timezone","app_version","device_model","connection_type","ua_sdk_version","push_opt_in","device_os","carrier","location_enabled","location_permission","background_push_enabled","web_browser_name","web_browser_type","web_browser_version","web_user_agent_string","open_platform_name","alerting","campaigns","push_id","group_id","variant_id"
"00000198-ba5e-5bf0-c014-662065e32f58","1000085767854","2025-08-17 23:30:02.864 +00:00","2025-08-17 23:30:02.907 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","{""categories"":[""Airware-Survey""]}","","7aad0ec7-2b18-494f-ba9c-d82defa7b43c",""
"00000198-ba6b-22c6-4950-0827892bac22","1000085767855","2025-08-17 23:44:00.198 +00:00","2025-08-17 23:44:00.253 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","","","9f27ad9a-31f1-4a57-b844-07dcc3f98f94",""
"00000198-ba79-f92c-6551-79a344ce1896","1000085767856","2025-08-18 00:00:12.588 +00:00","2025-08-18 00:00:12.661 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","","","c1f450bf-7b5d-4a2e-b246-b83ab5fb25be",""

Uninstall example

"id","offset","occurred","processed","app_key","channel","device_type","named_user","custom_identifiers","locale_variant","locale_country_code","locale_timezone","locale_language_code","iana_timezone","app_version","device_model","connection_type","ua_sdk_version","push_opt_in","device_os","carrier","location_enabled","location_permission","background_push_enabled","web_browser_name","web_browser_type","web_browser_version","web_user_agent_string","open_platform_name","alerting","campaigns","push_id","group_id","variant_id"
"00000198-ba5e-5bf0-c014-662065e32f58","1000085767854","2025-08-17 23:30:02.864 +00:00","2025-08-17 23:30:02.907 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","{""categories"":[""Airware-Survey""]}","","7aad0ec7-2b18-494f-ba9c-d82defa7b43c",""
"00000198-ba6b-22c6-4950-0827892bac22","1000085767855","2025-08-17 23:44:00.198 +00:00","2025-08-17 23:44:00.253 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","","","9f27ad9a-31f1-4a57-b844-07dcc3f98f94",""
"00000198-ba79-f92c-6551-79a344ce1896","1000085767856","2025-08-18 00:00:12.588 +00:00","2025-08-18 00:00:12.661 +00:00","ISex_TTJRuarzs9-o_Gkhg","","","","","","","","","","","","","","","","","","","","","","","","","","","","c1f450bf-7b5d-4a2e-b246-b83ab5fb25be",""

Push Body example

"id","offset","occurred","processed","app_key","campaigns","group_id","payload","resource","trimmed"
"00000198-ba5e-5bf0-c014-662065e32f58","1000085767854","2025-08-17 23:30:02.864 +00:00","2025-08-17 23:30:02.907 +00:00","ISex_TTJRuarzs9-o_Gkhg","{""categories"":[""Airware-Survey""]}","7aad0ec7-2b18-494f-ba9c-d82defa7b43c","eyJzY2hlZHVsZSI6eyJzY2hlZHVsZWRfdGltZSI6IjIwMjQtMTAtMTdUMDc6MzA6MDAiLCJyZWN1cnJpbmciOnsiY2FkZW5jZSI6eyJ0eXBlIjoiaG91cmx5IiwiY291bnQiOjF9LCJ0YXJnZXRfdGltZXpvbmUiOiJFdXJvcGUvTG9uZG9uIiwicGF1c2VkIjpmYWxzZX19LCJwdXNoIjp7ImF1ZGllbmNlIjp7ImFuZCI6W3siYW5kIjpbeyJ0YWciOiJkdW5jYW51bmlxdWUiLCJncm91cCI6ImRldmljZSJ9XX0seyJhbmQiOlt7ImFjdGl2aXR5IjoibWVzc2FnZV9yZWNlaXZlZCIsIm1ldHJpYyI6ImNvdW50Iiwib3BlcmF0b3IiOiJlcXVhbHMiLCJ2YWx1ZSI6IjAiLCJhZnRlciI6IjEiLCJwcmVjaXNpb24iOiJkYXlzIiwid2hlcmUiOnsiYW5kIjpbeyJwcm9wZXJ0eSI6IiQuX21zZy5jYW1wYWlnbnMuY2F0ZWdvcmllc1sqXSIsIm9wZXJhdG9yIjoiZXF1YWxzIiwidmFsdWUiOiJBaXJ3YXJlLVN1cnZleSIsImNvbXBhcmVfYXMiOiJ0ZXh0In1dfX1dfV19LCJkZXZpY2VfdHlwZXMiOlsiaW9zIiwiYW5kcm9pZCIsImFtYXpvbiJdLCJub3RpZmljYXRpb24iOnsiaW9zIjp7ImFsZXJ0IjoiSSBzaG91bGQgb25seSByZWNlaXZlIG9uZSBvZiB0aGVzZSBtZXNzYWdlcyJ9LCJhbmRyb2lkIjp7ImFsZXJ0IjoiSSBzaG91bGQgb25seSByZWNlaXZlIG9uZSBvZiB0aGVzZSBtZXNzYWdlcyJ9LCJhbWF6b24iOnsiYWxlcnQiOiJJIHNob3VsZCBvbmx5IHJlY2VpdmUgb25lIG9mIHRoZXNlIG1lc3NhZ2VzIn19LCJvcHRpb25zIjp7Il9fdWlfaWQiOiI5V3REcGg3R1NnU0xpQlkxd053UVJnIiwibWVzc2FnZV9uYW1lIjoicmVjdXJyaW5nIHRlc3QifSwiY2FtcGFpZ25zIjp7ImNhdGVnb3JpZXMiOlsiQWlyd2FyZS1TdXJ2ZXkiXX0sIm1lc3NhZ2VfdHlwZSI6ImNvbW1lcmNpYWwifSwiZ3JvdXBfaWQiOiI3YWFkMGVjNy0yYjE4LTQ5NGYtYmE5Yy1kODJkZWZhN2I0M2MifQ==","SCHEDULES","false"
"00000198-ba6b-22c6-4950-0827892bac22","1000085767855","2025-08-17 23:44:00.198 +00:00","2025-08-17 23:44:00.253 +00:00","ISex_TTJRuarzs9-o_Gkhg","","9f27ad9a-31f1-4a57-b844-07dcc3f98f94","eyJzY2hlZHVsZSI6eyJsb2NhbF9zY2hlZHVsZWRfdGltZSI6IjIwMjAtMTAtMDdUMTA6NDQ6MDAiLCJyZWN1cnJpbmciOnsiY2FkZW5jZSI6eyJ0eXBlIjoiZGFpbHkiLCJjb3VudCI6MX0sImVuZF90aW1lIjoiMjAyMS0xMS0wMVQxNDozMDowMCIsImV4Y2x1c2lvbnMiOlt7ImRhdGVfcmFuZ2UiOiIyMDIxLTEwLTAxVDAwOjAwOjAwLzIwMjEtMTAtMDJUMDA6MDA6MDAifSx7ImhvdXJfcmFuZ2UiOiIyMi02In1dLCJwYXVzZWQiOnRydWV9fSwibmFtZSI6IkRhaWx5IHJlY3VycmluZyBzY2hlZHVsZWQgbWVzc2FnZSB1cGRhdGUgd2hpbGUgcGF1c2VkIiwicHVzaCI6eyJhdWRpZW5jZSI6eyJ0YWciOiJ0YWNvIn0sImRldmljZV90eXBlcyI6WyJpb3MiLCJhbmRyb2lkIl0sIm5vdGlmaWNhdGlvbiI6eyJhbGVydCI6IlFBIFRlc3QgUmVjdXJyaW5nIFVwZGF0ZSJ9fSwiZ3JvdXBfaWQiOiI2YmNlMWE0YS0yYjMwLTQ1YmEtOTFhMi1mM2YzZGNkMjJlNmEifQ==","SCHEDULES","false"
"00000198-ba79-f92c-6551-79a344ce1896","1000085767856","2025-08-18 00:00:12.588 +00:00","2025-08-18 00:00:12.661 +00:00","ISex_TTJRuarzs9-o_Gkhg","","c1f450bf-7b5d-4a2e-b246-b83ab5fb25be","eyJzY2hlZHVsZSI6eyJzY2hlZHVsZWRfdGltZSI6IjIwMjItMDgtMjZUMTI6MDA6MDAiLCJyZWN1cnJpbmciOnsiY2FkZW5jZSI6eyJ0eXBlIjoiaG91cmx5IiwiY291bnQiOjF9LCJwYXVzZWQiOmZhbHNlfX0sIm5hbWUiOiJhdGxhbnRpY2dpYW50IGhvdXJseSIsInB1c2giOnsiYXVkaWVuY2UiOnsidGFnIjoiYXRsYW50aWNnaWFudCJ9LCJkZXZpY2VfdHlwZXMiOlsic21zIiwiaW9zIiwid2ViIiwiZW1haWwiXSwibm90aWZpY2F0aW9uIjp7ImFsZXJ0IjoiSGVsbG8gYXRsYW50aWNnaWFudCBob3VybHkiLCJlbWFpbCI6eyJtZXNzYWdlX3R5cGUiOiJ0cmFuc2FjdGlvbmFsIiwic2VuZGVyX25hbWUiOiJBaXJzaGlwIiwic2VuZGVyX2FkZHJlc3MiOiJ1YUBzcGFya3Bvc3Qtc3RhZ2luZy51cmJhbmFpcnNoaXAuY29tIiwicmVwbHlfdG8iOiJ1YUBzcGFya3Bvc3Qtc3RhZ2luZy51cmJhbmFpcnNoaXAuY29tIiwic3ViamVjdCI6IkhlbGxvIGF0bGFudGljZ2lhbnQgaG91cmx5IiwicGxhaW50ZXh0X2JvZHkiOiJIZWxsbyBhdGxhbnRpY2dpYW50IGhvdXJseSJ9fX0sImdyb3VwX2lkIjoiYzFmNDUwYmYtN2I1ZC00YTJlLWIyNDYtYjgzYWI1ZmIyNWJlIn0=","SCHEDULES","false"

Feedback

Was this page helpful?