Airship Incoming Webhook Setup Guide

[#1]

This article describes how to use the Airship data source to create a webhook in your Airship account and send actionable events to Tealium EventStream.

In this article:

• Prerequisites
• How It Works
• Airship Data Source
• Airship Setup
• Events and Attributes
• Vendor Documentation

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, for the id attribute, Airship will send the matching EventStream event attribute 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