Airship Web Notify Tag Setup Guide
This article describes how to set up the Airship Web Notify tag in your Tealium iQ Tag Management account.
Web push notifications help you deliver relevant, personalized, in-the-moment messaging wherever your users are online. Airship’s Web Notify provides the tools necessary to reach new web visitors with powerful engagement strategies, encouraging repeat visits and driving conversion.
Tag tips
- All of the tag configurations can be set dynamically via mappings.
secureIframeUrl
is only needed if Airship Web Notify is loading on non-securepages.- Safari support requires additional configuration within your Airship dashboard.
- After Safari configuration make sure to download your new SDK bundle containing new keys and tokens.
- Supports these E-Commerce extension parameters:
- Order ID (_corder)
- Order Subtotal (_csubtotal)
- List of Product IDs (_cprod)
- List of Brands (_cbrand)
- List of Categories (_ccat)
Tag configuration
Navigate to the Tag Marketplace to add a new tag. Read the Tag Overview article for general instructions on how to add a tag.
When adding the tag, configure the following settings:
- appKey: Your Airship-provided appKey. This identifies which Airship project this web site is connected to.
- Token: Your Airship-provided token. This is the bearer token that authenticates actions taken by the JS SDK against Urban Airship’s platform APIs.
- vapidPublicKey: Your Airship-provided
vapidPublicKey
. This is the public half of a cryptographic key pair used by the browser and browser vendor when registering for and sending notifications. - secureIframeUrl: The URL of the iframe used by Airship for non-HTTPS pages so that the SDK can post messages to its parent window. This is only used for non-secure domains.
- Auto Prompt Enabled: Select true to automatically prompt the user to register for push notifications, allowing the push-worker.js file to handle the frequency with which visitors are prompted. If you select false, then you must manually trigger the prompt.
Data mappings
Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.
The available categories are:
Tag Configurations
Variable | Description |
---|---|
appKey (app_key) | [string] |
vapidPublicKey (vapid_public_key) | [string] |
Token (token) | [string] |
secureIframeUrl (secure_iframe_url) | [string] |
Auto Prompt Flag (auto_prompt) | [“true”/“false”] |
E-Commerce
Variable | Description |
---|---|
Is New Item (is_new_item) | [“true”/“false”] |
List of Product Brands (product_brand) (Overrides _cbrand) | [Array] |
List of Product Categories (product_category) (Overrides _ccat) | [Array] |
List of Product Descriptions (product_description) | [Array] |
List of Product IDs (product_id) (Overrides _cprod) | [Array] |
Transaction/Order ID (transaction_id) (Overrides _corder) | [String] |
Value/Order Subtotal (value) (Overrides _csubtotal) | [String] |
Media
Variable | Description |
---|---|
Author (media_author) | [String] |
Category (media_category) | [String] |
Description (media_description) | [String] |
Feature (media_feature) | [“true”/“false”] |
Identifier (media_identifier) | [String] |
Published Date (media_published_date) | [String] |
Type (media_type) | [String] |
Social Media
Variable | Description |
---|---|
Source (source) | [String] |
Medium (medium) | [String] |
Account
Variable | Description |
---|---|
Category (account_category) | [String] |
Events
Variable | Description |
---|---|
register | register |
BrowsedContentEvent | BrowsedContentEvent |
ConsumedContentEvent | ConsumedContentEvent |
SharedContentEvent | SharedContentEvent |
StarredContentEvent | StarredContentEvent |
AddedToCartEvent | AddedToCartEvent |
BrowsedEvent | BrowsedEvent |
PurchasedEvent | PurchasedEvent |
SharedProductEvent | SharedProductEvent |
StarredProductEvent | StarredProductEvent |
RegisterEvent | RegisterEvent |
Custom | Custom |
This page was last updated: April 14, 2021