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.
"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",""
"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",""
"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"
Categories