Airship Attributes connection airship-attributes-destination
Overview overview
Airship is the leading Customer Engagement Platform, helping you deliver meaningful, personalized omnichannel messaging to your users at every stage of the customer lifecycle.
This integration passes Adobe profile data into Airship as Attributes for targeting or triggering.
To learn more about Airship, see the Airship Docs.
Prerequisites prerequisites
Before you can send your audiences to Airship, you must:
- Enable attributes in your Airship project.
- Generate a bearer token for authentication.
Supported audiences supported-audiences
This section describes which types of audiences you can export to this destination.
Export type and frequency export-type-frequency
Refer to the table below for information about the destination export type and frequency.
Enable attributes enable-attributes
Adobe Experience Platform profile attributes are similar to Airship attributes and can be easily mapped to one another in Platform using the mapping tool demonstrated further below on this page.
Airship projects have several predefined and default attributes. If you have a custom attribute, you must define it in Airship first. See Set Up and Manage Attributes for details.
Generate bearer token bearer-token
Go to Settings » APIs & Integrations in the Airship dashboard and select Tokens in the left-hand menu.
Click Create Token.
Provide a user-friendly name for your token, e.g., “Adobe Attributes Destination”, and select “All Access” for the role.
Click Create Token and save the details as confidential.
Use cases use-cases
To help you better understand how and when you should use the Airship Attributes destination, here are sample use cases that Adobe Experience Platform customers can solve by using this destination.
Use case #1
Leverage profile data collected within Adobe Experience Platform for personalization of the message and rich content within any of Airship’s channels. For example, leverage Experience Platform profile data to set location attributes within Airship. This will enable a hotel brand to display an image for the nearest hotel location for each user.
Use case #2
Leverage Attributes from Adobe Experience Platform to further enrich Airship profiles and combine it with SDK or Airship predictive data. For example, a retailer can create an audience with loyalty status and location data (attributes from Platform) and Airship predicted to churn data to send highly targeted messages to users in the gold loyalty status who live in Las Vegas, NV, and have a high probability of churning.
Connect to the destination connect
To connect to this destination, follow the steps described in the destination configuration tutorial. In the configure destination workflow, fill in the fields listed in the two sections below.
Authenticate to destination authenticate
To authenticate to the destination, fill in the required fields and select Connect to destination.
- Bearer token: the bearer token that you generated from the Airship dashboard.
Fill in destination details destination-details
To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.
- Name: enter a name that will help you identify this destination.
- Description: enter a description for this destination.
- Domain: select either a US or EU data center, depending on which Airship data center applies to this destination.
Enable alerts enable-alerts
You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.
When you are finished providing details for your destination connection, select Next.
Activate audiences to this destination activate
-
To activate data, you need the View Destinations, Activate Destinations, View Profiles, and View Segments access control permissions. Read the access control overview or contact your product administrator to obtain the required permissions.
-
To export identities, you need the View Identity Graph access control permission.
{width="100" modal="regular"}
See Activate audience data to streaming audience export destinations for instructions on activating audiences to this destination.
Mapping considerations mapping-considerations
Airship attributes can be set either on a channel, which represents device instance, e.g., iPhone, or a named user, which maps all of a user’s devices to a common identifier such as a customer ID. If you have plain text (unhashed) email addresses as primary identity in your schema, select the email field in your Source Attributes and map to the Airship named user in the right column under Target Identities, as shown below.
For identifiers that should be mapped to a channel, i.e., a device, map to the appropriate channel based on the source. The following images show how two mappings are created:
- IDFA iOS Advertising ID to an Airship iOS channel
- Adobe
fullName
attribute to Airship “Full Name” attribute
Map identity
Select source field:
Select target field:
Map attribute
Select source attribute:
Select target attribute:
Verify mapping:
Data usage and governance data-usage-governance
All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, see the Data Governance overview.