Urban Airship Web Notify Tag Setup Guide

[#1]

This article describes how to set up the Urban 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. Urban Airship’s Web Notify provides the tools necessary to reach new web visitors with powerful engagement strategies, encouraging repeat visits and driving conversion.

In this article:

Table of Contents Placeholder

Tag Tips

• All of the tag configurations can be set dynamically via mappings.
• secureIframeUrl is only needed if Urban Airship Web Notify is loading on non-securepages.
• Safari support requires additional configuration within your Urban Airship dashboard. https://docs.urbanairship.com/tutorials/getting-started/channels/web-notify/#safari
• 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

First, go to Tealium's tag marketplace and add the Urban Airship Web Notify tag (Learn more about how to add a tag).

After adding the tag, configure the following settings:

• appKey: Your Urban Airship-provided appKey. This identifies which Urban Airship project this web site is connected to.
• Token: Your Urban Airship-provided token. This is the bearer token that authenticates actions taken by the JS SDK against Urban Airship's platform APIs.
• vapidPublicKey: Your Urban 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 Urban 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