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”]


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]


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]


Variable Description
Category (account_category) [String]


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

Was this page helpful?

This page was last updated: April 14, 2021