Airship incoming webhook setup guide

Prerequisites

• Tealium EventStream and/or Tealium AudienceStream
• Airship account

How it works

To connect Airship with Tealium EventStream or Tealium AudienceStream, use the Airship Webhook API to send outgoing requests to the custom Airship data source endpoint in your Tealium account.

After you configure the webhook, you can create subscriptions based on topics and receive related push notifications to automate use cases, stay informed, and increase productivity.

Airship data source

Adding the Airship data source to your Tealium Customer Data Hub profile generates a unique URL to use in your webhook configuration in following format:

https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY

To add the Airship data source to your Tealium Customer Data Hub profile, see Data Sources. After adding and connecting the data source, save and publish your profile.

Airship setup

After you connect Airship to your Tealium Customer Data Hub profile, configure the webhook using the following steps:

1. Log in to your Airship account and navigate to Settings > Project Configuration and click Manage to configure your Real-Time Data Streaming integrations.

2. Under Real-Time Data Streaming, click Tealium.

   Previously configured integrations are listed under Enabled Integrations.

3. Enter a name and description.

4. Enter the custom endpoint URL created by adding the Airship data source to your Tealium profile. For example

   https://collect-us-east-1.tealiumiq.com/integration/event/{account}/{profile}/{data_source_key}
   

5. Select whether to send anonymous visitors to Tealium.

6. Select the event types to send to Tealium.

7. Click Save.

Events and attributes

All incoming Airship event attributes are prefixed with airship_. For example, Airship will send the id attribute to Tealium and it will be converted to airship_id (all lowercase).

The Airship webhook API sends flattened JSON objects to Tealium as shown in the following example of an Airship Email Subscription event:

{
  "airship_id": "62f3b7ac-4048-4f22-a0b5-22c01ef172a9",
  "airship_offset": "1000022265027",
  "airship_occurred": "2021-10-01T16:52:07.131Z",
  "airship_processed": "2019-04-01T13:00:23.456Z",
  "airship_device_channel": "6b46c724-494b-4491-9fe7-1b903d266110",
  "airship_device_device_type": "EMAIL",
  "airship_device_named_user_id": "Tealium",
  "airship_device_delivery_address": "test1@tealium.com",
  "airship_body_event_type": "registration",
  "airship_body_identifiers_address": "new.subscription@emaildomain.com",
  "airship_body_properties_commercial_opted_in": "2019-01-04T20:56:00.000Z",
  "airship_body_properties_transactional_opted_in": "2019-01-04T20:56:00.000Z",
  "airship_type": "SUBSCRIPTION",
  "tealium_timestamp_epoch": 1634740696399,
  "tealium_event": "airship_subscription"
}

For a full list of webhook events and attributes generated by Airship, see the Airship Events Documentation.

Vendor documentation

• Airship Real-Time Data Streaming Documentation
• Airship Events Documentation