Tealium Learning Center

SkyGlue is the simplest and most powerful online visitor behavior tracking tool that complements Google Analytics. You can receive immediate visitor insights and and understand which changes increase conversion rates. In this article: 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: SG Account: Your SkyGlue account ID, which is a sequence of letters. Load Rules Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the   Load Rules   documentation. ... View more

This article describes how to set up the Partnerize Event Tracker tag in your Tealium iQ Tag Management account. Partnerize enables brands to directly connect with their marketing partners to dramatically increase customer acquisition and drive high-margin revenues from online marketing channels. In this article: Tag Tips Order Currency defaults to the E-Commerce extension value. This tag uses the following E-Commerce extension parameters: Order ID Order Currency Order Promo Code List of SKUs List of Categories List of Quantities List of Prices Custom Product Parameter mappings should be arrays. Custom Conversion Parameter mappings should be strings. 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: Campaign: The default Campaign. Adref: A Partnerize-provided value. Customer Type: The default customer type. Country: The two-letter ISO code for the country of the visitor or point of sale. Default Currency: The three-letter ISO code for the currency the conversion occurs in. Load Rules Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation. 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: Standard Variable Description Campaign (campaign) Customertype (customertype) Custref/Customer ID (customer_id) Country (country) Adref (adref) Custom Conversion Parameter (conversion.###) Custom Product Parameter (product.###) E-Commerce Variable Description Conversionref/Order ID (order_id) (Overrides _corder) Currency (currency) (Overrides _ccurrency) Voucher/Promo Code (voucher) (Overrides _cpromo) List of SKUs (product_sku) (Overrides _csku) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] ... View more

This article provides examples of data transformation functions and event and visitor functions. In this article: Data Transformation Function Examples Delete a Variable In this example, the function deletes a variable containing sensitive data (email address). transform (( event ) => { delete event . data . udo . user . email ; }); Populate a Variable The following example populates the page_name variable with the title. transform (( event ) => { if (! event . data . udo . page_name ) { event . data . udo . page_name = event . data . dom . title ; } }); Create a Variable This example create a page_hierarchy variable from multiple variables. transform (( event ) => { const { site_region , site_section , category_name } = event . data . udo ; event . data . udo . page_hierarchy = '${site_region}:${site_section}:${category_name}' ; }); The following example creates site_section , site_category , and site_subcategory variables based on the pathname . transform (( event ) => { const [, site_section , site_category , site_subcategory ] = event . data . dom . pathname . split ( "/" ); Object . assign ( event . data . udo , { site_section , site_category , site_subcategory }) }); Map a Value to a Variable The following example maps a value to category_name based on the value of category_id : const categoryNameById = { 38 : "Mobile" , 39 : "Engagement" , 40 : "Monitoring" }; transform (( event ) => { event . data . udo . products = event . data . udo . products . map ( product => ({ ... product , category_name : categoryNameById [ product . category_id ] })); }); Modify an Existing Variable The following example changes a variable to all lowercase. transform (( event ) => { const searchKeyword = event . data . udo . search_keyword ; if ( searchKeyword ) { event . data . udo . search_keyword = searchKeyword . toLowerCase (); } }); This example renames a variable by setting its value to a new variable and deleting the existing variable. transform (( event ) => { event . data . udo . page_title = event . data . udo . page_name ; delete event . data . udo . page_name ; }); Concatenate Values and Create a New Variable This example concatenates two values and deletes one of the values. It also creates a new variable. import flatten from 'tealium/util/flatten' ; // "transform" function allows you to access event and apply changes transform (( event ) => { // concatenate test1 and test2 properties const { test1 , test2 } = event . data . udo ; event . data . udo . test_concatenated = `${test1}:${test2}` ; // delete test1 property delete event . data . udo . test1 ; // add a new test3 property event . data . udo . test3 = 'TEST3' ; console . log ( JSON . stringify ( event , null , 2 )); }) Event and Visitor Function Examples Sending Event Data with HTTP POST The following example shows how to make an HTTP POST request to an endpoint with event data in the request body JSON. // Send event data - HTTP POST import {event} from 'tealium'; console.log(JSON.stringify(event)); fetch('https://webhook.site/87bb160f-475a-4258-b117-693bb2378a4d', { method: 'POST', body: JSON.stringify(event), headers: { 'Content-Type': 'application/json' } }) .then(response => { if (!response.ok) { throw new Error('Network response was not ok. Status code: ${response.status}.'); } return response.json(); }) .then(data => console.log('Response:', JSON.stringify(data))) .catch(error => console.log('Error:', error.message)); Sending Event Data with HTTP GET The following example shows how to make an HTTP GET request to an endpoint with event data as query string parameters. // Send event data - HTTP GET import {event} from 'tealium'; console.log(JSON.stringify(event)); fetch(encodeURI('https://webhook.site/87bb160f-475a-4258-b117-693bb2378a4d?param=${event.data}')) .then(response => { if (!response.ok) { throw new Error('Network response was not ok. Status code: ${response.status}.'); } return response.json(); }) .then(data => console.log('Response:', JSON.stringify(data))) .catch(error => console.log('Error:', error.message)); Sending Visitor Data with HTTP POST The following example shows how to make an HTTP POST request to an endpoint with visitor profile data in the request body JSON. // Send visitor data - HTTP POST import {visitor} from 'tealium'; console.log(JSON.stringify(visitor)); fetch('https://webhook.site/87bb160f-475a-4258-b117-693bb2378a4d', { method: 'POST', body: JSON.stringify(visitor), headers: { 'Content-Type': 'application/json' } }) .then(response => { if (!response.ok) { throw new Error('Network response was not ok. Status code: ${response.status}.'); } return response.json(); }) .then(data => console.log('Response:', JSON.stringify(data))) .catch(error => console.log('Error:', error.message)); Sending Visitor Data with HTTP GET The following example shows how to make an HTTP GET request to an endpoint with visitor profile data as query string parameters. // Send visitor data - HTTP GET import {visitor} from 'tealium'; console.log(JSON.stringify(visitor)); fetch(encodeURI('https://webhook.site/87bb160f-475a-4258-b117-693bb2378a4d?param=${visitor.data}')) .then(response => { if (!response.ok) { throw new Error('Network response was not ok. Status code: ${response.status}.'); } return response.json(); }) .then(data => console.log('Response:', JSON.stringify(data))) .catch(error => console.log('Error:', error.message)); Querying Visitor Data and Sending It to the Tealium Collect HTTP API The following example shows how to make an HTTP GET request to retrieve weather data, then send that data to the Tealium Collect HTTP API. In this example, the function uses the IP address to get the location city, gets weather information for that city, and sends the city and weather information to the Tealium Collect HTTP API. import { auth, visitor, event } from "tealium"; console.log(JSON.stringify(visitor)); const ip_stack_api_key = 'your_api_key', weather_api_key = 'your_weather_api_key', ip_address = visitor?.current_visit?.properties?.ip_address; console.log(ip_address); (async function() { if(ip_address) { try { // Use IP address to get location city let city_response = await fetch('https://api.ipstack.com/${ip_address}?access_key=${ip_stack_api_key}&format=1'), city_data = await city_response.json(); console.log(JSON.stringify(city_data)); // Use location city to get local weather let weather_response = await fetch(encodeURI('https://api.openweathermap.org/data/2.5/weather?q=${city_data.city}&appid=${weather_api_key}')), weather_data = await weather_response.json(); console.log(JSON.stringify(weather_data)); // Send city and weather description back into collect endpoint await fetch(encodeURI('https://collect.tealiumiq.com/event?tealium_account=cloud-functions-usecases&tealium_profile=main&tealium_visitor_id=${visitor._id}&lookup_city=${weather_data?.name}&weather=${weather_data?.weather?.[0]?.description}&country=isp=${city_data?.connection?.isp}')); } catch(e) { console.error(e); return false; } } else { console.error("Could not locate users IP address") } })(); Getting a Facebook Authentication Token The following code example shows how to get a Facebook authentication token: import { auth } from 'tealium'; const token = auth.get('facebook_token'); fetch('https://graph.facebook.com/v8.0/act_12345678/customaudiences??access_token=${token}&fields=approximate_count%2Csubtype%2Cname%2Cdata_source&limit=10') .then(response => response.json()) .then(data => console.log('Data:', data)) .catch(error => console.log('Error:', error.message)); Sending Data to Facebook The following example shows how to send event data to the Facebook Graph or Marketing API to create a campaign (https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group). import {auth, event} from 'tealium'; const ACT_ID = 11111111111; const ACCESS_TOKEN = auth.get("facebook_token"); fetch('https://graph.facebook.com/v8.0/act_${ACT_ID}/campaigns?access_token=${ACCESS_TOKEN}', { method: 'POST', body: 'name=${event.data}&objective=PAGE_LIKES&status=PAUSED&special_ad_categories=[]' }) .then(response => { if (!response.ok) { throw new Error('Network response was not ok. Status code: ${response.status}.'); } return response.json(); }) .then(data => console.log('Response:', JSON.stringify(data))) .catch(error => console.log('Error:', error.message)); Multiple HTTP Requests and Different EndPoints The following example shows making an HTTP request, and then, depending on the response, make another HTTP request to a separate endpoint. import { auth } from "tealium"; const ACT_ID = 11111111111; const ACCESS_TOKEN = auth.get("facebook_token"); (async function () { console.time('function'); try { console.log('Creating campaign...'); let campaignId = await createCampaign({ campaignName: 'My Campaign' }); console.log('Campaign ID', campaignId); console.log('Creating custom audience...'); let customAudienceId = await createCustomAudience({ caName: 'My_Audience' }); console.log('Custom Audience ID', customAudienceId); console.log('Creating ad set...'); customAudienceId = 23846304008770411; let adSetId = await createAdSet({ campaignId: campaignId, customAudienceId: customAudienceId }); console.log('Ad Set ID', adSetId); console.log('Creating ad creative...'); // let adCreativeId = await createAdCreative(); // current API call not working, use an ID created manually before let adCreativeId = 'adCreativeId'; console.log('AdCreative ID ', adCreativeId); console.log('Creating ad...'); let adId = await createAd({ adsetId: adSetId, adCreativeId: adCreativeId }); console.log('Ad ID', adId); console.timeEnd('function'); } catch (error) { console.log(error); } })(); async function createAd({ adsetId, adCreativeId }) { const params = { 'status': 'PAUSED', 'adset_id': adsetId, 'name': 'My Ad', 'creative': { 'creative_id': adCreativeId }, }; let result = await fetch('https://graph.facebook.com/v7.0/act_${ACT_ID}/ads?access_token=${ACCESS_TOKEN}', { method: 'POST', body: jsonToRequestBodyString(params) }); let json = await result.json(); return json.id; } async function createAdSet({ campaignId, customAudienceId }) { const params = { 'name': 'AdSet', 'lifetime_budget': '1000', 'start_time': '2020-07-01T23:41:41-0800', 'end_time': '2020-07-07T23:41:41-0800', 'campaign_id': campaignId, 'bid_amount': '1', 'billing_event': 'IMPRESSIONS', 'optimization_goal': 'LINK_CLICKS', 'targeting': { "geo_locations": { "countries": ["US"], }, "age_min": 25, "age_max": 40, "custom_audiences": [{ "id": customAudienceId }] }, 'status': 'PAUSED' }; let result = await fetch('https://graph.facebook.com/v7.0/act_${ACT_ID}/adsets?access_token=${ACCESS_TOKEN}', { method: 'POST', body: jsonToRequestBodyString(params) }); let json = await result.json(); return json.id; } async function createCustomAudience({ caName }) { const params = { 'name': caName, 'subtype': 'CUSTOM', 'description': 'People who purchased on my website', 'customer_file_source': 'USER_PROVIDED_ONLY', }; let result = await fetch('https://graph.facebook.com/v7.0/act_${ACT_ID}/customaudiences?access_token=${ACCESS_TOKEN}', { method: 'POST', body: jsonToRequestBodyString(params) }); let json = await result.json(); return json.id; } async function createCampaign({ campaignName }) { const params = { 'objective': 'LINK_CLICKS', 'status': 'PAUSED', 'buying_type': 'AUCTION', 'name': campaignName, 'special_ad_categories': 'NONE' }; let result = await fetch('https://graph.facebook.com/v8.0/act_${ACT_ID}/campaigns?access_token=${ACCESS_TOKEN}', { method: 'POST', body: jsonToRequestBodyString(params) }); let json = await result.json(); return json.id; } function jsonToRequestBodyString(json) { return Object.keys(json).map(function (key) { return encodeURIComponent(key) + '=' + ((typeof json[key] === 'string' || json[key] instanceof String) ? encodeURIComponent(json[key]) : JSON.stringify(json[key])); }).join('&'); } Additional Information About Functions Managing Functions Writing Functions Data Transformation Functions Event and Visitor Functions - V2 Event and Visitor Functions - V3 Migrating a V2 Function to the V3 Runtime Adding an Authentication to a Function Using Tealium Functions to Generate a UID2.0 Token Data Transformation Functions Example Code V3 Event and Visitor Functions Example Code ... View more

This article describes how to set up the Ipsos iris (formerly Dotmetrics) tag in your Tealium iQ Tag Management account. Ipsos iris is a state-of-the-art hybrid methodology that combines a nationally representative establishment survey, a passively measured single-source panel, and site-centric census measurement. Data collected through tags ensures Ipsos iris measures completely across all devices to represent a publisher’s brands fully to the market. Ipsos iris through a flexible and intuitive reporting interface provides a rich understanding of digital audience behaviour on a daily, weekly, and monthly basis to ultimately support more informed decisions In this article: Tag Tips Use mappings to override or dynamically set the tag configurations. Each website tag contains a unique section ID. If the user's website consists of more than one site section and the user desires to measure data for each section separately (for example, news, sports, weather, and so on). Please note alphanumeric values throughout this document support the following: Up to 20 character length Lowercase characters Characters [a-z] Numbers [0-9] 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: Numeric Site Section Id: Will be used by default if no Site Section Name String is provided. Site Section Name String: Alphanumeric website section keyword. Region: There are 3 variations of the base script. Ipsos iris does not have Geolocation functionality so they have clients deploy different tags based on region to hit the correct regional servers. Load Rules Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation. 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: Standard Variable Description Numeric Site Section Id (numericSiteSectionId) [String] Site Section Name String (siteSectionNameString) [String] Region (region) [String] Events To map events, refer to Create an Event Mapping. Variable Description Page View (pageview) pageview ... View more

Learn about the new features and fixes released in October 2022. Tealium iQ Tag Management Updated to resolve issue with the Load Rules Filter closing after every click. Updated to resolve browser crashing when profiles inherit libraries with numerous extensions that require the JavaScript Editor. Updated to resolve problem with display of publish locations. Client-Side Tags New/Cool Stuff: New marketplace tag — LINE New marketplace tag for Tealium for Pharma — PulsePoint HCP365 Pixel Fixes: Updated AT Internet Piano Analytics tag to add new mapping parameters and events. Updated Braze Web SDK tag standard initOpt parameters and added initOpt.custom functionality. Updated the Mapp Intelligence tag template to version 5. Updated The Trade Desk Cookie Matching Service tag to add mappable domain parameter. Server-Side Connectors New/Cool Stuff: New Talon.One Webhook connector configuration New marketplace connector: LinkedIn Matched Audiences Fixes: Updated Adobe Analytics connector to remove empty event parameters when no value is mapped. Updated Basis Technologies DSP connector to support pageSize query parameter and pagination for retrieval of audience segments Updated Criteo connector to properly handle empty response from vendor. Updated Criteo Audience Match connector API to v2022.04. Updated Emarsys connector to better support custom parameters and identifier parameters. Updated Epsilon Event API connector to accept customer query string parameter mapping. Updated Facebook Conversions connector insights to improve messaging for EMQ errors when Pixel overrides are used and improve messaging for dynamically set Pixel IDs. Updated Facebook App Events, Facebook Audiences, Facebook Conversions, Facebook Offline Conversions, and Facebook Messenger connectors to Facebook Marketing API v15. Updated the Google Ads Enhanced Conversions - Legacy connector to support App Incrementality data. Updated Google Ads Conversions, Google Ads Customer Match, Google Ads Enhanced Conversions for Leads, and Google Ads Enhanced Conversions for Web connectors to use Google Ads API v11. Updated Google Ads Conversions to support additional actions Conversion Restatement and Conversion Retraction Updated Google Campaign Manager 360 to version 4, added mappable parameters, and tooltip text descriptions. Updated Hubspot connector to latest APIs, added mapping. Updated Salesforce, Salesforce Audience Studio, Salesforce DMP, Salesforce Email Studio, Salesforce EMail Studio OAuth2, Salesforce Journey Builder with OAuth, Salesforce Stand Objects connectors to Version 55 of the Salesforce API Updated the Selligent connector to allow for support of Custom input for lists Updated TikTok Events connector to support additional parameters in the Contents array. Updated Veeva CRM connector to Version 55 of the Salesforce API and corrected error occurring during Authentication. Installations Mobile iOS — Updated to support Chartbeat Remote Command. Android and iOS Swift — Updated to support Flutter Firebase Remote Command. Android Kotlin — Updated to add visitor switching. ... View more

This article describes how to configure a webhook to send custom request actions using template variables for the Talon.One API. In this article: Overview Talon.One is a powerful promotion engine that enables you to create targeted and customized marketing promotions built around your visitor and session data. Create, manage, and track discounts, coupon codes, referral, loyalty, and product bundles all in one holistic platform. The Talon.One integration allows you to stream visitor data (standardized, unified, and enriched) in real-time from Tealium to Talon.One to create personalized promotions in your marketing campaigns. Prerequisites Set up Talon.One Promotions Platform Set up Tealium EventStream API Hub or Tealium AudienceStream CDP How it Works The Tealium for Talon.One outgoing webhook enables integrations with Talon.One's powerful promotion engine. You can use Tealium’s robust real-time data collection to send more relevant personalized data to Talon.One to identify and target individual customers with highly relevant campaigns. To get started, do the following: Configure Talon.One. In Tealium, configure a webhook to send data to Talon.One. You can now submit HTTP requests to send first-party personalized data (event data from Tealium EventStream API Hub) or user data (from Tealium AudienceStream CDP) to Talon.One. Talon.One supports webhook configurations that use basic authentication. For more information, see the Webhook Connector Setup Guide. Configure Talon.One Open the Talon.One Application in the Campaign Manager and click Settings > Developer settings. Click Create API Key. For more information, see Managing API Keys in the Talon.One documentation. For Do you want to use this API Key with a 3rd party service?, select Yes. Select Customer Data Platform from the dropdown. Enter an expiry date and click Create API Key. Copy the API Key, which will be used to configure a webhook in Tealium. For more information on setting up this integration, see the Talon.One documentation. Configure an Outgoing Webhook for Talon.One The following data mappings are required for the webhook: Set Method to POST . Set URL to  https://integration.talon.one/cdp/audiences For example: To send data to Talon.One, you also need to configure mappings for the following: Body Data Body Content Type The variables you want to send to Talon.One. Example Webhook Configuration In this example, the request body is a JSON message with a customizable body template. For more information on configuring a webhook connector, see the Webhook Template Variables Guide. This example webhook sends a PageView request with parameters to identify the user, as follows: Method: POST URL: Https://integration.talon.one/cdp/audiences Body Content Type: application/json Body Data: Map {{data}} To Body Template Variables: Map "PageView" to Intent Map customer_id to ID Map tealium_firstparty_visitor_id to Cookieidvalue Map Last event timestamp to time Templates: Name: data ... View more

We're excited to announce that the Custom Triggers feature for Tealium Data Transformation Functions is now available.  Custom triggers are rules you create to specify when to execute a function. How It Works Custom trigger rules are similar to load rules and use boolean logic to combine conditions in a rule. The conditions for a rule can be based on any property of the  event  parameter, but are commonly based on the data source key, data source platform, and the  tealium_event  attribute.  For any data transformation functions that were created before custom triggers were introduced, a rule is automatically created that  specifies the ID of the data source associated with the function. The function is triggered for every event from the specified data source. You can edit this rule to trigger the function for specific events. Learn More About Functions Managing Functions Writing Functions Data Transformation Functions Functions Example Code ... View more

This article describes how to set up the Google Ad Manager Conversion tag in your Tealium iQ Tag Management account. Google Ad Manager (formerly DoubleClick for Publishers) is a complete platform to grow all of your digital ad revenues in all the new ways and places people are watching, playing, and engaging. In this article: Tag Tips The Google Ad Manager Conversion tag, formerly the page view tag for DoubleClick for Publishers, has the following features: Supports the E-Commerce Extension for Order ID. If Order ID is not set, its value is set to a randomly generated number. 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: Activity ID (xsp): Order ID (ord): Value can be an Order ID, or a randomly generated number if left blank and not mapped. Load Rules Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation. 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: Standard Variable Description Activity ID (xsp) Order ID (ord) ... View more

Learn about the new features and fixes released in June 2022 . Tealium iQ Tag Management Fixed an issue with  resource locks not being enforced for labels. Resource locks are now enforced for labels. If you do not have manage resource and save profile permissions, you cannot edit or delete a resource locked label. Updated Add Label button in the Load Rules screen with a new dropdown featuring a quick add for new labels. Client-Side Tags New/Cool Stuff New marketplace tag: CJ Affiliate Mobile Application New marketplace tag: Paypal Shopping Analytics Fixes Added mapping event for setCustomerID event for Adobe Experience Cloud ID Service tag Improved Transaction ID automapping logic, which is now part of the conversion object instead of the user data object, for the Google Ads Conversions tag. Data Sources Updated the Python data source code for the Add Data Source wizard to correct a problem with library initialization. Server-Side Connectors New/Cool Stuff New marketplace connector: Doceree New marketplace connector: Google Ads Enhanced Conversions for Leads New marketplace connector: Twitter Conversions New marketplace connector: Veeva Systems, please contact your account manager if you are interested in this connector Fixes Updated theFacebook Conversions connector to add more robust support for template variables. Updated the Google Ads Customer Match connector to add the ability to retrieve user list information via the Google Ads API searchStream method. Updated the Google Analytics connector to decouple product impression data from ecommerce actions. Updated the  Pinterest Audiences connector to better support audience creation lists within Pinterest ads. Installations Mobile Android Airship Remote Command updated to latest version. Flutter Plugin Added collect profile override. Upgraded to latest Swift and Android library versions. ... View more

This article describes how to set up the Amazon Advertising tag in your Tealium iQ Tag Management account. The Amazon Advertising System is an online advertising service that run ads on the Amazon network. It is used to drive traffic and boost sales. In this article: Tag Tips Use mappings to override or dynamically set the tag configurations. By default, the Amazon Advertising base code always includes Page View and Pageview events, which track when a visitor lands on your website. 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: Region: Tag IDs: Supports multiple values provided in CSV format Automatic Pageview Tracking: When Automatic Pageview Tracking is set to true,  if event equals view, Amazon event is set to to Pageview. Automatic Purchase Tracking: When Automatic Purchase Tracking is set to true, if order_id is defined , Amazon event is set to to Purchase. Load Rules Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation. 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 Configuration Variable Description Region (region) [String] Tag IDs (ids) [String] Automatic Pageview Tracking (auto_page_tracking) [Boolean] Automatic Purchase Tracking (auto_purchase_tracking) [Boolean] Events Variable Description PageView PageView AddToCart AddToCart ViewContent ViewContent SignUp SignUp Login Login Checkout Checkout Purchase Purchase Custom Custom ... View more

How It Works Data Transformation Functions  are invoked after an event is collected from the data source and before the event is processed, as shown in the following data pipeline diagram. Data transformation functions support all event types except for file import events. Get Started On the server-side, click   Functions, then click   Overview. Click   + Add Function  and select the Data Transformation trigger. Learn more about data transformation functions: About Functions Managing Functions Writing Functions Data Transformation Functions Functions Example Code ... View more

Event and visitor functions are invoked after the event or visitor is processed. You can use event and visitor functions to retrieve data from other systems, augment Tealium data, or send data to other endpoints.  This article provides details on the named exports provided for event and visitor functions, as well as information on sending an event to Tealium Collect and using the fetch API to make HTTP requests. For information on adding authentication for an event or visitor function, see Adding an Authentication to a Function. In this article: Named Exports The Tealium module exports five named exports for event and visitor functions: auth , event , visitor , store , and tealium . A function imports the named exports as follows: import { auth, visitor, event, store, tealium } from "tealium"; Event Object The event object is available when a function is triggered by the event feed and contains the event data. Property Data Type Description event.id string Tealium Event ID.   event.visitor_id string Tealium Visitor ID. event.account string Tealium Account. event.profile string Tealium Profile. event.data object An object that contains event attribute data, such as event.data.udo.page_category or event.data.udo.order_id . Event Object Example The following shows an example of event object data: { "account": "your-account", "profile": "main", "event_id": "run-test-event-id", "visitor_id": "run-test-visitor-id", "data": { "dom": { "viewport_height": 766, "referrer": "", "viewport_width": 1440, "domain": "www.example.com", "title": "Home Page", "query_string": "q=help", "hash": "", "url": "https://www.example.com/?q=help", "pathname": "/" }, "udo": { "tealium_event": "page_view", "ut.account": "your-account", "ut.visitor_id": "0176cb4f3482110a5ba4702e147b0006d005a065104f2", "page_name": "Home Page", "ut.event": "view", "search_keyword": "help", "ut.domain": "example.com", "tealium_profile": "main", "ut.version": "ut4.46.202006020705", "tealium_session_id": "1609910608323", "tealium_account": "your-account", "ut.profile": "main", }, "firstparty_tealium_cookies": { "utag_main__sn": "12", "utag_main_dc_visit": "12", "utag_main_ses_id": "1609910610822", "utag_main_dc_region": "us-east-1", "utag_main__st": "1609913306118", "utag_main_v_id": "0176cb4f3482110a5ba4702e147b0006d005a065104f2", "utag_main__se": "66", "utag_main__ss": "0", "utag_main_dc_event": "60", "utag_main__pn": "5" } }, "env": "prod", "post_time": 1537305808000 } Event data can be accessed in a function as follows: const data = {}; // DOM variables are stored in event.dom data.current_url = event?.dom?.url; // Standard UDO event variables are stored in event.data.udo data.session_id = event?.data?.udo?.tealium_session_id; // First Party cookies are stored in event.firstparty_tealium_cookies data.trace_id = event?.firstparty_tealium_cookies?.trace_id; // Meta variables are stored in event.meta data.meta_description = event?.meta?.description; data.tealium_event = event?.data?.udo?.tealium_event; data.tealium_account = event?.data?.udo?.tealium_account; data.tealium_profile = event?.data?.udo?.tealium_profile; Visitor Object The visitor object is available when a function is triggered by the audience feed and contains the visitor data. Property Data Type Description visitor.metrics Record<string, number> Visitor metrics. visitor.metrics_sets Tally<string, number>   visitor.dates Record<string, number> Visitor dates. visitor.audiences_joined_at Record<string, number> Timestamp when the visitor joined audiences. visitor.properties Record<string, any> Visitor properties. visitor.properties.account string Tealium Account. visitor.properties.profile string Tealium Profile. visitor.properties.visitor_id string Tealium Visitor ID. visitor.property_sets Set<string, any>   visitor.audiences string[] List of joined audiences. visitor.badges string[] List of badges. visitor.creation_ts number Visitor creation timestamp. visitor.flags Map<string, Boolean>   visitor.current_visit Record<string, any> Current visit object. visitor.current_visit.metrics Record<string, number> Current visit metrics. visitor.current_visit.metrics_sets Tally<string, number>   visitor.current_visit.dates Record<string, number> Current visit dates. visitor.current_visit.properties Record<string, any> Current visit properties. visitor.current_visit.flags Map<string, Boolean> Current visit flags. visitor.current_visit.property_sets Set<string, any> Current visit property sets. visitor.current_visit.creation_ts number Current visit creation timestamp. visitor.current_visit.total_event_count number Current visit total event count. visitor.current_visit.events_compressed boolean Current visit events compressed. Example Visitor Object Data The following is an example of visitor object data: { "metrics": { "Metric 1": 1, "Metric 2": 2 }, "dates": { "Date 1": 1603373790000, "Date 2": 1603373522000, }, "properties": { "profile": "username", "visitor_id": "017560818b67001bc185a07f1cd703078003405000b7e", "account": "user-account", }, "audiences": [ "Audience 1", "Audience 2" ], "badges": [ "Badge 1", "Badge 2" ], "creation_ts": 1603373522000, "current_visit": { "metrics": { "Metric 1": 1.3, "Metric 2": 6, }, "dates": { "Date 1": 1603373868000, "Date 2": 1603373790000, }, "properties": { "Property 1": "Chrome", "Property 2": "https://URL-for-website ", }, "flags": { "Flag 1": true, "Flag 2": false }, "property_sets": { "Property Set 1": [ "Mac desktop" ], "Property Set 2": [ "Chrome" ] }, "creation_ts": 1603373790000, "total_event_count": 2, "events_compressed": false }, "audiences_joined_at": { "Audience 1": 1603363523014, "Audience 2": 1603363523014 } } Auth Object: auth.get() Functions require authentication to access some service providers, such as Facebook or Google. For more information, see Adding an Authentication to a Function. When you add an authentication, an access token is returned. The auth.get() method returns a string that contains a unique auto-generated ID for the authentication token. When a function makes an HTTP request using this token ID, it is automatically replaced with the token before the request is sent. Parameter Data Type Description tokenKey string Specifies the token to get, which is the name entered when the authentication provider was added.  Tealium Object: sendCollectEvent() The sendCollectEvent() method sends an event to Tealium Collect HTTP API and returns a string. The Response interface of the Tealium Collect HTTP API represents the response to a request. The response model is the same as for fetch API, except that the URL is not available in the result of the Tealium Collect HTTP API. Parameter Data Type Description event EventsClientEventObject An event object to send to Tealium Collect HTTP API. account string Optional. If specified, replaces the value of event.tealium_account. profile string Optional. If specified, replaces the value of event.tealium_profile. dataSourceId string Optional. If specified, replaces the value of event.tealium_datasource. Store Object: store.get() The store object contains key/value pairs that specify variables or constants that can be used in multiple functions. A function can retrieve a value for a key by calling the store.get() method and passing the key as the parameter. For more information on adding and editing global variables, see Managing Functions. Parameter Data Type Description globalParameterKey string Specifies the key of the global variable to get. For example, if you create a global variable with a key named date , a function would retrieve the value for date as follows:   store.get('date') Getting an Attribute Name or Attribute Value by Attribute ID Attribute names can be changed, which can cause problems when code references attributes by name. To avoid problems with attribute names changing, you can reference attributes by ID. Event and visitor objects have a getAttributeNameById() method that you can use to get an attribute name based on its ID. You can also get the value of an attribute using the getAttributeValueById() method. The following example shows how this works. If you enter the following in the code editor, when you enter the opening parenthesis, a list of attributes and associated IDs is displayed: You can enter part of the attribute name to filter the list. When you select an attribute, its ID is added to your code after the parenthesis. The list of attributes works the same way for getAttributeValueById() . Sending an Event to Tealium Collect The following example shows how to send an event to the Tealium Collect HTTP API. The response interface of the Tealium Collect HTTP API represents the response to a request. The response model is the same as for the fetch API, except that the URL is not accessible in the result from the collect client. Example import {event, tealium} from 'tealium'; var newEvent = {‘key’: ‘value’}; tealium.sendCollectEvent(newEvent, 'newAccount', 'newProfile', 'datasourceId') .then(response => { if (!response.ok) { throw new Error(`Network response was not ok. Status code: ${response.status}.`); } console.log('Status code:', response.status); return response.text(); }) .then(data => console.log('Result:', data)) .catch(error => console.error('Error:', error.message)); Using the fetch() API to Make HTTP Requests The fetch API is available for functions to make HTTP requests, as shown in the following example. For more information, see Fetch. fetch('https://restcountries.eu/rest/v2/name/usa') .then(response => { if (!response.ok) { throw new Error(`Network response was not ok. Status code: ${response.status}.`); } return response.json(); }) .then(data => console.log('Capital:', data[0].capital)) .catch(error => console.log('Error:', error.message)); The following example shows fetching a resource from the network, returning a promise that is fulfilled when the response is available. const fetchResponsePromise = fetch(resource [, init]) The Request interface of the Fetch API represents a resource request and is defined as follows: const myRequest = new Request(input[, init]); Functions can use the Headers interface of the Fetch API to perform various actions on HTTP request and response headers. Headers() is defined as follows: const myHeaders = new Headers(init); The Response interface of the Fetch API represents the response to a request and is defined as follows: const myResponse = new Response(body, init); The following browser-specific functionality is not supported: cache credentials referrer referrerPolicy signal keepalive redirect mode Using URLSearchParams Methods to Build a URL Query String The URLSearchParams interface defines utility methods to work with the query string of a URL. This example shows using URLSearchParams to build a query string for a URL. function jsonToURLSearchParams(data) { const params = new URLSearchParams(); buildURLSearchParams(params, data); return params; } function buildURLSearchParams(params, data, parentKey) { if (data && typeof data === 'object' && !(data instanceof Date)) { Object.keys(data).forEach(key => { buildURLSearchParams(params, data[key], parentKey ? `${parentKey}[${key}]` : key); }); } else { const value = data == null ? '' : data; params.append(parentKey, value); } } Additional Information About Functions Managing Functions Writing Functions Data Transformation Functions Adding an Authentication to a Function Using Tealium Functions to Generate a UID2.0 Token Functions Example Code ... View more

This article describes how to set up the Epsilon Site Tag in your Tealium iQ Tag Management account. Epsilon is the leader in outcome-based marketing with a rich, 50-year heritage in helping marketers anticipate, activate, and prove measurable business outcomes. In this article: Tag Configuration First, go to the tag marketplace and add the Epsilon Site Tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Domain and Tag Path: The domain to be used within the tag. Refer to the tagging document provided by Epsilon. Reverse Proxy Directory Path: If you are using a Reverse Proxy, enter the path of the Reverse Proxy (typically /tag_path or the custom path you have setup as the root of your Reverse Proxy). Company ID: dtm_cid Secondary Company ID: dtm_cmagic Form ID: dtm_fid  Integration Type: Default or Limited. Limited integrations should only be used if specified by Epsilon. 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 Configuration Variable Description Domain (tag_domain) [String] Reverse Proxy Directory Path (tag_path) [String] Company ID (dtm_cid) [String] Secondary Company ID (dtm_cmagic) [String] Form ID (dtm_fid) [String] Integration Type (integration_type) [Boolean] Standard Variable Description Promo ID (dtm_promo_id) [String] GDPR Consent String (dtmc_tcf_string) [String] Email Hash (dtm_email_hash) [String] User ID (dtm_user_id) [String] Custom (custom.myvar) [String] Page Visit Variable Description Department (dtmc_department) [String] Category (dtmc_category) [String] Sub-Category (dtmc_sub_category) [String] Product ID (dtmc_product_id) [String] Manufacturer Brand (dtmc_brand) [String] Manufacturer UPC (dtmc_upc) [String] Manufacturer Model Part Number (dtmc_mpn) [String] Conversion Variable Description Conversion Type (dtmc_conv_type) [String] Store Location (dtmc_conv_store_location) [String] Order ID (dtmc_transaction_id) (Overrides _corder) [String] Order Subtotal (dtm_conv_val) (Overrides _csubtotal) [String] Order Currency (dtm_conv_curr) (Overrides _ccurrency) [String] Product IDs (product_id) (Overrides _cprod) [Array] Product Quantities (product_quantity) (Overrides _cquan) [Array] Product Prices (product_unit_price) (Overrides _cprice) [Array] Product Discount Amount (product_discount) (Overrides _cpdisc) [Array] Custom Items Attributes (dtm_items.myvar) [Array] ... View more

This article describes how to set up the Coherent Path Signal tag in your Tealium iQ Tag Management account. Coherent Path is the leading expert in email personalization. Top retailers trust us to deliver the right content, at the right times, to the right customers — creating increased revenue, driving engagement with their most high-value categories, and building strong, lasting relationships with every customer. In this article: Tag Tips Use mappings to: - Dynamically override configuration data - Dynamically override the E-Commerce extension values - Send additional data values - Event trigger Supports the following E-Commerce extension values: - Customer ID - Order ID - Order Sub Total - List of Product Discounts - List of Product IDs - List of Product Names - List of Product Quantities - List of Product Prices Tag Configuration First, go to the tag marketplace and add the Coherent Path Signal tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Access Token: Coherent Path Signal API access token. 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 Configuration Variable Description Access Token (config_access_token) [String] Base URL (config_base_url) (Defaults to https://track.coherentpath.com) [String] Currency code (config_currency_code) (Defaults to USD) [String] Debug Flag (config_debug) (Defaults to false) [Boolean] Event Parameters Variable Description Contact ID (contact_id) [String] Customer Email (customer_email) [String] Order Discount (order_discount) [String] Order Processed Date (order_processed_at) (Defaults to the current time) [String] Page Referrer (page_referrer) (Defaults to the current page referrer) [String] Page Title (page_title) (Defaults to the current page title) [String] Page URL (page_url) (Defaults to the current page URL) [String] List of Product Variant IDs (product_variant_id) [Array] List of Product Variant Names (product_variant_name) [Array] List of Product Variant Prices (product_variant_price) [Array] List of Product Variant's Product IDs (product_variant_product_id) (Links Product Variant to Product) [Array] Search Term (search_term) [String] Source (source) [String] List of Metadata Tags (metadata_tags) [Array] Metadata Attributes (metadata_attributes) [Object] E-Commerce Variable Description Customer ID (customer_id) (Overrides _ccustid) [String] Order ID (order_id) (Overrides _corder) [String] Order Sub Total (order_subtotal) (Overrides _csubtotal) [String] List of Product Discounts (product_discount) (Overrides _cpdisc) [Array] List of Product IDs (product_id) (Overrides _cprod) [Array] List of Product Names (product_name) (Overrides _cprodname) [Array] List of Product Quantities (product_quantity) (Overrides _cquan) [Array] List of Product Prices (product_unit_price) (Overrides _cprice) [Array] Events Variable Description Forget Forget Identity Identity Order Cancelation OrderCancelation Order Completion OrderCompletion Order Refund OrderRefund Page View PageView Product Page View ProductPageView Product Search ProductSearch ... View more

This article describes how to set up the Kochava tag in your Tealium iQ Tag Management account. Kochava enables people-based marketers to establish and enrich user identities, segment and activate audiences, and measure and optimize their campaigns across all connected devices. In this article: Tag Tips Use mappings to: Override standard configuration values and set custom parameters. Trigger standard and custom events. Autopage — Set to true in order to send a page event automatically on every page load. Set to false to send a page load only on manual calls to the page function. Cache — Set to true to allow browsers to cache the SDK code. Set to false to force the SDK code to be loaded with every page load. Verbose — Set to true for Verbose logging to the console. Set to false to suppress all logging. Cookie Collection — Set to true to drop Cookie on the website to track a device across sub-domains. Set to false to not drop the Cookie and rely only on local storage for tracking. Tag Configuration First, go to the tag marketplace and add the Kochava tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Kochava App GUID Autopage Cache Verbose Cookie Collection 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: Configuration Parameters Variable Description App ID (app_guid) App Tracking Transparency Enabled (app_tracking_transparency_enabled) [true/false] Identity Link IDs (identity_link_ids) Log Level (log_level) Events Variable Description Ad Click adclick Ad View adview Add to Cart addtocart Add to Wish List addtowishlist Achievement achievement Checkout Start checkoutstart Tutorial Complete tutorialcomplete Level Complete levelcomplete Purchase purchase Rating rating Registration Complete registrationcomplete Search search Start Trial starttrial Subscribe subscribe View view QSS. (Quality Steaming Session >5mins) qss First_Video_View first_video_view Share_with_friend share_with_friend Authentication_Success authentication_success Watch_later watch_later Custom custom All Parameters Variable Description Action (action) Background (background) Checkout as Guest (checkout_as_guest) Completed (completed) Content ID (content_id) Content Type (content_type) Currency (currency) Date (now_date) Description (description) Destination (destination) Duration (duration) End Date (end_date) Item Added From (item_added_from) Level (level) Ad Campaign ID (ad_campaign_id) Ad Campaign Name (ad_campaign_name) Ad Group ID (ad_group_id) Ad Group Name (ad_group_name) Ad Mediation Name (ad_mediation_name) Ad Network Name (ad_network_name) Placement (placement) Ad Size (ad_size) Ad Type (ad_type) Max Rating Value (max_rating_value) Name (name) Order ID (order_id) Origin (origin) Price (price) Quantity (quantity) Rating Value (rating_value) Receipt ID (receipt_id) Referral From (referral_from) Registration Method (registration_method) Results (results) Score (score) Search Term (search_term) Spatial X (spatial_x) Spatial Y (spatial_y) Spatial Z (spatial_z) Start Date (start_date) Success (success) User ID (user_id) User Name (user_name) URI (uri) Validated (validated) Event Parameters Variable Description Ad Click adclick Ad View adview Add to Cart addtocart Add to Wish List addtowishlist Achievement achievement Checkout Start checkoutstart Tutorial Complete tutorialcomplete Level Complete levelcomplete Purchase purchase Rating rating Registration Complete registrationcomplete Search search Start Trial starttrial Subscribe subscribe View view QSS. (Quality Steaming Session >5mins) qss First_Video_View first_video_view Share_with_friend share_with_friend Authentication_Success authentication_success Watch_later watch_later Custom custom ... View more

This article describes how to set up the LivePerson LiveEngage 2.0 tag in your Tealium iQ Tag Management account. Deliver a personalized user experience throughout your customer’s life cycle by proactively engaging visitors with real time solutions for chat, voice and content, plus a full range of open APIs. In this article: Tag Tips Use mapping to override the standard configurations  values dynamically. Uses the following E-Commerce variables _corder _ctotal _ccustid _cprodname _ccat _csku _cquan _cprice Market Source - Channel 0-Direct 1-Search 2-Social 3-Email 4-Referral 5-Paid Search 6-Display Service - Status 0-Complete 1-In Progress 2-Approved 3-cancelled 4-Not Approved 5-Reviewed 6-Missing Details 7-Closed 8-Removed 9-Assigned Tag Configuration First, go to the tag marketplace and add the LivePerson LiveEngage 2.0 tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Site ID: The site value (i.e. 23954343) Section: Comma separated list of section values Allow Mappings: True - Allow Site ID to be mapped, library loaded on send False - Library is loaded on tag load Merge E-Commerce: True - Use E-Comm extension for basis of all mappings False - Does not use the E-Comm Extension as the data base 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: Standard Variable Description Site ID (site) Event Type (type) Section (section) [Array/CSV] Taglets (taglets) Page URL (page_url) (Overrides dom.url) Events Variable Description Cart (cart) cart Purchase (purchase) purchase Product View (prodView) prodView Customer Info (ctmrinfo) ctmrinfo Marketing Source (mrktinfo) mrktinfo Personal (personal) personal Lead (lead) lead Service (service) service Search (searchInfo) searchInfo Error (error) error E-Commerce Variable Description Order ID (order_id) (Overrides _corder) Order Total (order_total) (Overrides _ctotal) List of Names (product_name) (Overrides _cprodname) [Array] List of SKUs (product_sku) (Overrides _csku) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] Cart E-Commerce Variable Description Order Total (cart.order_total) (Overrides _ctotal) List of Names (cart.product_name) (Overrides _cprodname) [Array] List of SKUs (cart.product_sku) (Overrides _csku) [Array] List of Categories (cart.product_category) (Overrides _ccat) [Array] List of Quantities (cart.product_quantity) (Overrides _cquan) [Array] List of Prices (cart.product_unit_price) (Overrides _cprice) [Array] Purchase E-Commerce Variable Description Order ID (purchase.order_id) (Overrides _corder) Order Total (purchase.order_total) (Overrides _ctotal) List of Names (purchase.product_name) (Overrides _cprodname) [Array] List of SKUs (purchase.product_sku) (Overrides _csku) [Array] List of Categories (purchase.product_category) (Overrides _ccat) [Array] List of Quantities (purchase.product_quantity) (Overrides _cquan) [Array] List of Prices (purchase.product_unit_price) (Overrides _cprice) [Array] Prod View E-Commerce Variable Description List of Names (prodView.product_name) (Overrides _cprodname) [Array] List of SKUs (prodView.product_sku) (Overrides _csku) [Array] List of Categories (prodView.product_category) (Overrides _ccat) [Array] List of Prices (prodView.product_unit_price) (Overrides _cprice) [Array] Customer Info Variable Description Customer ID (customer_id) (Overrides _ccustid) Customer Lifecycle Status (vi.cstatus) Customer Type (vi.ctype) Financial Balance (vi.balance) [Float] Social ID (vi.socialId) Unique Device Or Phone Identifier (vi.imei) Username (vi.userName) Company Size (vi.companySize) [Integer] Company Name (vi.accountName) Role/Title (vi.role) Last Payment Date - Day (vi.lpd_day) [Integer] Last Payment Date - Month (vi.lpd_month) [Integer] Last Payment Date - Year (vi.lpd_year) [Integer] Registration Date - Day (vi.rd_day) [Integer] Registration Date - Month (vi.rd_month) [Integer] Registration Date - Year (vi.rd_year) [Integer] Marketing Source Variable Description Channel (ms.channel) Affiliate (ms.affiliate) Campaign ID (ms.campaignId) Personal Info Variable Description First Name (per.firstname) last Name (per.lastname) Age (per.age) Year of Birth (per.year) Month of Birth (per.month) Day of Birth (per.day) Email Address (per.email) Phone Number (per.phone) Gender (per.gender) Company (per.company) Language (per.language) Lead Variable Description Topic (lead.topic) Value (lead.value) Lead ID (lead.id) Service Variable Description Topic (serv.topic) Status (serv.status) Category (serv.category) Service ID (serv.id) Search Variable Description Search Keywords (search.keywords) Error Variable Description Message (err.msg) Code (err.code) ... View more

This article describes how to set up the Adobe Media Analytics (3.x SDK) tag in your Tealium iQ Tag Management account. Adobe Media Analytics provides support for tracking video and ad metrics, including total views/impressions, time spent, and completion rates. In this article: Tag Tips Adobe Media Analytics requires the Adobe Experience Cloud ID Service as well as AppMeasurement for JS to be loaded first, preferably bundled. This tag is fired via "utag.track('video', data);" which should be implemented in your video event handlers. Tag Configuration First, go to the tag marketplace and add the Adobe Media Analytics (3.x SDK) tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Tracking Server: Adobe Media Analytics tracking server. This field is required (example.hb.omtrdc.net). Publisher: Publisher name as provided by Adobe. This field is required. Use SSL: Specifies whether or not to send heartbeat calls over HTTPS. The default value is false, meaning SSL is disabled. Set the value to true to send tracking calls securely. S-Object Name: Required. Set your own custom s-object variable name. Use defaults if not sure. Video Platform Name: The name of the online video platform through which content gets distributed. This field is optional. Video Player SDK: The version of the video player app/SDK. This field is optional. 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: Standard Variable Description Adobe Media Analytics Tracking Server (tracking_server) Adobe Media Analytics Publisher (publisher) Adobe Media Analytics SSL Flag (ssl) Adobe Media Analytics Channel (syndication_channel) Adobe Media Analytics Video Platform Name (online_video_platform_name) Adobe Media Analytics Player SDK (player_sdk) Adobe Media Analytics Debug Logging Flag (debug_logging) Video Events Variable Description Video Load (video_load) video_load Video Start (video_start) video_start Video Playing (video_playing) video_playing Video Pause (video_pause) video_pause Video Play (video_play) video_play Video Stop (video_stop) video_stop Video Resume (video_resume) video_resume Video Complete (video_complete) video_complete Video Seek (video_seek) video_seek Video Buffer (video_buffer) video_buffer Video Skip (video_skip) video_skip Video Error (video_error) video_error Video Variable Description Video ID (video.id) Video Title (video.title) Video Length (video.length) Video Current Playhead (video.current_playhead) Video Stream Type (video.stream_type) Video Is Full Episode (video.is_full_episode) Video Channel Name (video.channel_name) Video Series Name (video.series_name) Video Player Name (video.player_name) Video Is Ad (video.is_ad) Video FPS (video.fps) Video Bit Rate (video.bit_rate) Video Startup Time (video.startup_time) Video Dropped Frames (video.dropped_frames) Video Error ID (video.error_id) Video Error Is Fatal (video.error_is_fatal) Chapter Variable Description Chapter Name (chapter.name) Chapter Length (chapter.length) Chapter Position (chapter.position) Chapter Start Time (chapter.start_time) Chapter Custom Metadata (chapter_meta_data.custom) Ad Variable Description Ad Break Name (adbreak.name) Ad Break Position (adbreak.position) Ad Break Start Time (adbreak.start_time) Ad ID (ad.id) Ad Title (ad.title) Ad Type (ad.type) Ad Length (ad.length) Ad Position (ad.position) Video Metadata Variable Description Video Custom Metadata (meta_data.custom) Video Metadata Show (meta_data.show) Video Metadata Season (meta_data.season) Video Metadata Episode (meta_data.episode) Video Metadata Asset (meta_data.asset) Video Metadata Genre (meta_data.genre) Video Metadata Air Date (meta_data.airDate) Video Metadata Digital Air Date (meta_data.digitalDate) Video Metadata Rating (meta_data.rating) Video Metadata Originator (meta_data.originator) Video Metadata Network (meta_data.network) Video Metadata Type (meta_data.type) Video Metadata Ad Load (meta_data.adLoad) Video Metadata Day Part (meta_data.dayPart) Video Metadata Feed (meta_data.feed) Video Metadata Format (meta_data.format) Ad Metadata Variable Description Ad Custom Metadata (ad_meta_data.custom) Ad Metadata Advertiser (ad_meta_data.advertiser) Ad Metadata Campaign (ad_meta_data.campaign) Ad Metadata Creative (ad_meta_data.creative) Ad Metadata Placement (ad_meta_data.placement) Ad Metadata Site (ad_meta_data.site) Ad Metadata Creative URL (ad_meta_data.creativeURL) ... View more

This article describes how to set up the PushEngage tag in your Tealium iQ Tag Management account. PushEngage is a browser push notification platform that helps content website managers engage visitors by automatically segmenting and sending web push messages. The cloud-based tool offers features for setting up notification triggers, customer segmentation, automatic responses, A/B testing, and more In this article: Tag Tips Tag Configuration First, go to the tag marketplace and add the PushEngage tag (Learn more about how to add a tag). After adding the tag, configure the following settings: API Key: Your PushEngage API Key. API key allows you to access PushEngage service. 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: Standard Variable Description API key (apiKey) [String] Segment Name (segmentName) [String/Array] Profile ID (profileId) [String] Days (days) [Number/Array] Events Variable Description Add a Segment to a Subscriber at the time of subscription init Add a Segment to a Subscriber on page load of your site add-to-segment Add a Dynamic Segment to a Subscriber add-to-dynamic-segment Remove a Subscriber from a Segment remove-to-segment Add Profile Id to a Subscribers add-to-profile ... View more

This article describes how to set up the Microsoft Advertising UET tag in your Tealium iQ Tag Management account. Microsoft Advertising UET Tag is used for track conversions and re-messaging. In this article: Tag Tips Use mapping to: - Override the standard config values - Override the E-Commerce extension values - Pass custom parameters - Set up event triggers Mapping to a Custom Property/Parameter in the Standard tab sends that parameter with all events. Use the Event Parameters tab to send data only to certain events Supports the following E-Commerce extension values: - Order ID - Order Sub Total - Order Shipping - Order Tax - Order Currency - Order Coupon/Promo Code - List of Product IDs - List of Names - List of Brands - List of Categories - List of Quantities - List of Prices Tag Configuration First, go to the tag marketplace and add the Microsoft Advertising UET tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Tag ID: Your Microsoft Advertising Tag ID 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: Standard Variable Description Tag ID (tagid) Event Category (event_category) Event Action (event_action) Event Label (event_label) Event Value (event_value) Error Description (description) Error Fatal (fatal) Method (method) Screen Name (screen_name) Search Term (search_term) Content Type (content_type) Content ID (content_id) List of Promotion Creative Names (promotion_creative_name) List of Promotion Creative Slots (promotion_creative_slot) List of Promotion IDs (promotion_id) List of Promotion Names (promotion_name) Custom Property/Parameter (custom.myvar) E-Commerce Variable Description Checkout Step (checkout_step) Checkout Option (checkout_option) Order ID (order_id) (Overrides _corder) Sub Total (order_subtotal) (Overrides _csubtotal) Shipping Amount (order_shipping) (Overrides _cship) Tax Amount (order_tax) (Overrides _ctax) Currency (order_currency) (Overrides _ccurrency) Promo Code (order_coupon_code) (Overrides _cpromo) List of Product IDs (product_id) (Overrides _cprod) [Array] List of Names (product_name) (Overrides _cprodname) [Array] List of Brands (product_brand) (Overrides _cbrand) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] List of Product Creative Names   List of Product Creative Slots   List of Product Location IDs   Events and Engagements Variable Description Add Payment Info (add_payment_info) add_payment_info Add to Cart (add_to_cart) add_to_cart Add to Wishlist (add_to_wishlist) add_to_wishlist Begin Checkout (begin_checkout) begin_checkout Checkout Progress (checkout_progress) checkout_progress Exception (exception) exception Generate Lead (generate_lead) generate_lead Login (login) login Page View (page_view) page_view Purchase (purchase) purchase Refund (refund) refund Remove from Cart (remove_from_cart) remove_from_cart Screen View (screen_view) screen_view Search (search) search Select Content (select_content) select_content Set Checkout Option (set_checkout_option) set_checkout_option Share (share) share Sign Up (sign_up) sign_up Timing Complete (timing_complete) timing_complete View Item (view_item) view_item View Item List (view_item_list) view_item_list View Promotion (view_promotion) view_promotion View Search Results (view_search_results) view_search_results Custom Event Custom Product Audience Events Variable Description Retail (retail) retail Travel (travel) travel Hotel (hotel) hotel Event Parameters Variable Description Event Category event_category Event Action event_action Event Label event_label Event Value event_value Custom Property/Parameter Custom Error Description description Error Fatal fatal Method method Screen Name screen_name Search Term search_term Content Type content_type Content ID content_id Checkout Step checkout_step Checkout Option checkout_option Order ID order_id Order Total order_total Revenue Value revenue_value Sub Total order_subtotal Shipping Amount order_shipping Tax Amount order_tax Currency order_currency Promo Code order_coupon_code List of Product IDs product_id List of Names] product_name List of Brands product_brand List of Categories product_category List of Quantities product_quantity List of Prices product_unit_price List of Product Creative Names product_creative_name List of Product Creative Slots product_creative_slot List of Promotion Creative Names promotion_creative_name List of Promotion Creative Slots promotion_creative_slot List of Promotion IDs promotion_id List of Promotion Names promotion_name Product Audience Parameters Variable Description Product ID ecomm_prodid Page Type ecomm_pagetype Total Value ecomm_totalvalue Category ecomm_category Destination ID travel_destid Origin ID travel_originid Page Type travel_pagetype Start Date travel_startdate End Date travel_enddate Total Value travel_totalvalue Hotel Base Price hct_base_price Hotel Total Price hct_total_price Obfuscated Booking Reference Number hct_booking_xref Hotel Checkin Date hct_checkin_date Hotel Checkout Date hct_checkout_date Hotel Length of Stay hct_length_of_stay Hotel Partner ID hct_partner_hotel_id Hotel Page Type hct_pagetype Product Audience - Retail Variable Description Product ID (ecomm_prodid) Page Type (ecomm_pagetype) [home, searchresults, category, product, cart, purchase, other] Total Value (ecomm_totalvalue) Category (ecomm_category) Product Audience - Travel Variable Description Destination ID (travel_destid) Origin ID (travel_originid) Page Type (travel_pagetype) [home, searchresults, offerdetail, conversionintent, conversion, cancel, other] Start Date (travel_startdate) [YYYY-MM-DD] End Date (travel_enddate) [YYYY-MM-DD] Total Value (travel_totalvalue) Product Audience - Hotel Variable Description Hotel Base Price (hct_base_price) Hotel Total Price (hct_total_price) Hotel Checkin Date (hct_checkin_date) [YYYY-MM-DD] Hotel Checkout Date (hct_checkout_date) [YYYY-MM-DD] Hotel Length of Stay (hct_length_of_stay) Hotel Partner ID (hct_partner_hotel_id) Obfuscated Booking Reference Number (hct_booking_xref) Hotel Page Type (hct_pagetype) [home, searchresults, property, cart, purchase, cancel, other] ... View more

This article provides details on the data transformation functions, custom trigger rules, the event parameter, and the flatten library. For examples of data transformation functions, see Functions Example Code. Data transformation functions are invoked after an event is collected from the data source and before the event is processed and can be used for a variety of purposes, including the following: Flattening the event object passed to the function. Removing sensitive data, such as a phone number or an email address. Modifying variables in the event object. For example, you can change variables to lower-case. Populating variables in the event object based on other values. Renaming variables, which is done by assigning the value to a different variable and deleting the original variable. File import events are not currently supported for data transformation functions. In this article: How it Works Data transformation functions are invoked after an event is collected from the data source and before the event is processed. A function is executed for an event when the trigger conditions are met. The transformation function runs transform(event) , where the event parameter is a metadata object for the incoming event. You will add code to the function to modify the event attributes found in the event.data.udo object. When you save and publish after creating a data transformation function, it can take up to 300 seconds for the change to take effect. Function Code The default function code imports the flatten library and flattens the incoming event data object and assigns the result back to event.data.udo . Use the code editor to customize the function for your needs. import flatten from "tealium/util/flatten"; // "transform" function allows you to access event and apply changes transform((event) => { // changes are applied via mutation of the original event event.data.udo = flatten(event.data.udo); console.log(JSON.stringify(event, null, 2)); }) Custom Triggers Data transformation functions execute based on custom triggers. Custom triggers are rules you create to specify when to execute a function. The conditions can be based on any property of the event parameter, but are commonly based on the data source key, data source platform, and the tealium_event attribute. Data transformation functions execute after the event is collected from the data source and before the event is processed by EventStream. For more information, see Custom Triggers. Event Parameter The transformation function has one parameter named event . The event parameter is a metadata object that contains several properties and nested objects describing the event. The actual event data is referenced in the event.data.udo object. The event parameter object is read-only, except for the custom event data in event.data.udo and some tealium_ properties. For more information, see Event Data Object. Event Parameter Object The event parameter object contains the following properties: Property Type Description Writable account String Account information. No client_ip String Client IP address. No data Object See Event Data Object. No dataSourcePlatform String Name of the data source platform. See Data Source Platform Values. No enrichmentOnly Boolean Always false for live events. If false DataAccess is enabled, the event can be sent to DataAccess. May be true for bulk import events (when event.type="BULK_IMPORT" ). If true , event data can be used only for enrichment. File import events are not currently supported for data transformation functions. No env String Specifies the execution environment (dev or prod). No event_id String Event ID. No new_visitor Boolean True if this is the first visit for the user, otherwise false. No page_url Object An object of URL properties. See URL Object. Omitted for mobile events. No post_time Number Time stamp for the event. No profile String Profile for the account. No referrer_url Object An object of URL properties. See URL Object. Omitted for mobile events. No type String Specifies whether the event is from a live visit or a bulk import event. Values are LIVE or BULK_IMPORT .  File import events are not currently supported for data transformation functions. No useragent String Specifies the software the user is using, such as the web browser. No visitor_id String Visitor ID. No _forwarding_visitor_ids String[] Contains the IDs of the visitor(s) forwarding this event. Used in the visitor stitching process. No   Data Source Platform Values The value of the dataSourcePlatform property can be one of the following: default adobe_launch affirm android braze cordova cSharp fileImport* googleAMP google_tag_manager http_api_flattened hubspot_wf intercom iOS iterable java javascript mailchimp python RES roku salesforce sendgrid slack swift tiqJavascript tvOS watchOS zapier * File import events are not currently support for data transformation functions. Event Data Object The event.data object represents the incoming event and contains the event.data.udo object that can be transformed: Property Type Description Writable dom Object Contains information about the page on which the event occurred (domain, query string, etc.) Omitted for mobile events. For more information, see Data Layer. No firstparty_tealium_cookies Object Object contains cookie properties specified in your data layer. Omitted for mobile events. No js Object Object contains JavaScript variable properties specified in your data layer. Omitted for mobile events. No meta Object Object contains metadata properties specified in your data layer. Omitted for mobile events. No udo Object Object contains the properties of the incoming event. Some properties are read-only. See Writable Properties. Yes   Writable Properties All custom event attributes in event.data.udo are writable, but only some of the tealium_ properties can be modified. The following tealium_ properties can be modified, but not deleted: event.data.udo.tealium_datasource event.data.udo.tealium_environment event.data.udo.tealium_event event.data.udo.tealium_firstparty_visitor_id event.data.udo.tealium_thirdparty_visitor_id event.data.udo.tealium_library_name event.data.udo.tealium_library_version event.data.udo.tealium_random event.data.udo.tealium_timestamp_epoch event.data.udo.tealium_timestamp_local event.data.udo.tealium_timestamp_utc event.data.udo.tealium_session_number Read-Only Properties The following object properties are read-only and cannot be modified: event.data.udo.tealium_cf_ttl event.data.udo._dc_ttl_ event.data.udo.platform event.data.udo.tealium_visitor_id event.data.udo.tealium_account event.data.udo.tealium_profile event.data.udo.tealium_session_id URL Object The URL object contains the following standard URL properties: PROPERTY TYPE DESCRIPTION WRITABLE domain String Domain of the URL. No full_url String Full URL. No path String Path from the URL. May be empty. No query_params Object An Object that contains one or more key.value pairs. Each key/value pair specifies a query string in the URL. For example: "query_params": { "utm_medium": "PPC", "utm_source": "LinkedIn" } No querystring String Query string from the URL. No scheme String Specifies the protocol to use for the web site, such as HTTP or HTTPS. No Example Event Parameter Object The following shows an example event parameter object: { "account": "XYZ_admin_acct", "profile": "main", "env": "prod", "data": { "dom": { "url": "https://www.example.com", "pathname": "/", "domain": "example.com", "hash": "", "query_string": "", "title": "Homepage" }, "js": {}, "meta": {}, "udo": { "page_view": "view", "tealium_account": "XYZ_admin_acct", "tealium_profile": "main", "page_name": "Homepage", "page_type": "main", "tealium_event": "page_view", "user": { "browser_lang": "en-us", "ipcinfo": "en-us", "signedin": false, "city": "san diego", "country": "us", "country_name": "united states", "registry_city": "san diego", "registry_country_code": "us", "registry_state": "ca", "state": "ca" } }, "firstparty_tealium_cookies": { "trace_id": "" } }, "type": "LIVE", "enrichmentOnly": false, "event_id": "example-event-id", "visitor_id": "example-visitor-id", "post_time": 1655410928993, "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/102.0.0.0 Safari/537.36", "client_ip": "", "new_visitor": false } Custom Triggers Data transformation functions support custom triggers, which are rules that specify when to execute the function. Custom trigger rules are similar to load rules and use boolean logic to combine conditions in a rule. For example, in the following rule, the function is triggered when a purchase event comes from a specific data source ( r2rbm8 ). A condition is based on a selector that specifies a property in the event parameter object, a comparison operator, and a comparison value. A selector is a JSONPath expression (see JsonPath) and can reference any property in event . An event can trigger only one function. If an event matches more than one function trigger, the function with the oldest Date Modified is the only function that is triggered. For information on creating a data transformation function and a custom trigger, see Managing Functions. Rule Limitations Selector and Value fields are limited to 128 characters. The regular expression operator is not available. The size of a rule is limited to 10 KB. The number of OR blocks is limited to 10. The number of conditions in an AND block is limited to 10. Converting Existing Functions to Custom Triggers Custom triggers were introduced after the initial release of data transformation functions. For any data transformation functions that existed before custom triggers were introduced, a condition similar to the following is automatically created: This new condition specifies the data source ID, which is set to the ID of the data source associated with the function. The function is triggered for every event from the data source. You can edit this condition to trigger the function for more specific events. Flattening Nested Objects The flatten library is a standard library that is imported in the default code for a data transformation function. This library provides the flatten() utility, which converts a nested Object into an Object that is not nested. flatten() returns an Object that contains strings and arrays of strings. flatten() accepts two parameters, as follows: flatten(target[, options]) target is the event Object passed to the data transformation function. options is an Object that specifies how nested keys are handled during the conversion. The options parameter contains the following properties: PROPERTY DATA TYPE DESCRIPTION delimiter string, default is ".". Specifies the character used to combine parent and child property names. prefix string, default is "". The prefix is concatenated at the beginning of the new key name followed by the delimiter . ignoreKeys string[], default is []. Specifies keys that should be omitted from the output. replaceKeys Object {string}, default is {}. Specifies new names for keys using key/value pairs, where the key is the existing key in the object, and The following examples show how the options properties are used. These examples use the following nested Object as the target to be flattened: const object = { page: { id: 1 }, user: { id: 1 }, util: ["1", "2", "3"] }; delimiter If delimiter is "_", the following object is returned: { page_id: 1, util: ["1", "2", "3"] } prefix If prefix is "fl", the following object is returned: { "fl.user.id": 1, "fl.page.id": 1, "fl.util": ["1", "2", "3"] } ignoreKeys If ignoreKeys is ["page", "util"], the following object is returned: { "user.id": 1 } replaceKeys if replaceKeys is defined as follows: const replaceKeys = { "user": "", "page": "p" } The following object is returned: { "id": 1, "p.id": 1, "util": ["1", "2", "3"] }Data Transformation Function Examples Example of Flattening a Complex Object import flatten from 'tealium/util/flatten'; const options = { delimiter: "_", ignoreKeys: ["array_of_strings"], replaceKeys: { "number": "float", "array_of_objects": "modified_array_of_strings", "ordinal": "" }, prefix: "t" } const output = flatten({ "boolean": true, "number": 12.34, "string": "value", "date": new Date(1631009413904), "array_of_strings": ["first", "second"], "array_of_arrays": [ [1, 2], [3, 4] ], "array_of_objects": [{ "ordinal": "first" }, { "ordinal": "second" }], "object": { "child_boolean": true, "child_number": 12.34, "child_string": "value", "child_array_of_strings": ["first", "second"], "child_array_of_arrays": [ [1, 2], [3, 4] ], "child_object": { "gchild_boolean": true, "gchild_number": 12.34, "gchild_string": "value", "gchild_array_of_strings": ["first", "second"], "gchild_array_of_arrays": [ [1, 2], [3, 4] ] } } }, options); The following object is returned by flatten() : { "t_boolean": "true", "t_float": "12.34", "t_string": "value", "t_date": "2021-09-07T10:10:13.904Z", "t_array_of_arrays": ["1","2","3","4"], "t_modified_array_of_strings": ["first","second"], "t_object_child_boolean": "true", "t_object_child_number": "12.34", "t_object_child_string": "value", "t_object_child_array_of_strings": ["first","second"], "t_object_child_array_of_arrays": ["1","2","3","4"], "t_object_child_object_gchild_boolean": "true", "t_object_child_object_gchild_number": "12.34", "t_object_child_object_gchild_string": "value", "t_object_child_object_gchild_array_of_strings": ["first","second"], "t_object_child_object_gchild_array_of_arrays": ["1","2","3","4"] } Additional Information About Functions Managing Functions Writing Functions Event and Visitor Functions Adding an Authentication to a Function Using Tealium Functions to Generate a UID2.0 Token Functions Example Code ... View more

This article describes how to set up the Branch.io tag in your Tealium iQ Tag Management account. Branch provides the leading mobile linking platform, with solutions that unify user experience and measurement across different devices, platforms, and channels. In this article: Tag Configuration First, go to the tag marketplace and add the Branch.io tag (learn more about how to add a tag). After adding the tag, configure the following settings: Branch key: Your Branch live key, or (deprecated) your app ID. 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: Initial Variable Description Branch key   Branch View ID (branch_view_id) [String] Branch Match ID (branch_match_id) [String] No Journeys (no_journeys) [Boolean] Disable Entry Animation (disable_entry_animation) [Boolean] Disable Exit Animation (disable_exit_animation) [Boolean] Retries (retries) [Integer] Retry Delay (retry_delay) [Integer] Timeout (timeout) [Integer] Metadata (metadata) [Object] Nonce (nonce) [String] Tracking Disabled (tracking_disabled) [Boolean] Metadata Variable Description Transaction Id (transaction_id) [String] Currency (currency) (Overrides _ccurrency) [String] Revenue (revenue) (Overrides _ctotal) [String] Shipping (shipping) (Overrides _cship) [String] Tax (tax) (Overrides _ctax) [String] Coupon (coupon) (Overrides _cpromo) [Number] Affiliation (affiliation) [Number] Description (description) [Array] Purchase loc (purchase_loc) [String] Store pickup (store_pickup) [Object] Registration Id (registration_id) [Object] Customer Event Alias (customer_event_alias) [String] E-Commerce Variable Description Content Schema ($content_schema) [String] Og Title ($og_title) [String] Og Description ($og_description) [String] Og Image Url ($og_image_url) [String] Canonical Identifier ($canonical_identifier) (Overrides _cprod) [String] Publicly Indexable ($publicly_indexable) [Boolean] Price ($price) (Overrides _cprice) [Number, Array] Locally Indexable ($locally_indexable) [Boolean] Quantity ($quantity) (Overrides _cquan) [Number, Array] Sku ($sku) (Overrides _csku) [String, Array] Product Name ($product_name) (Overrides _cprodname) [String, Array] Product Brand ($product_brand) (Overrides _cbrand) [String, Array] Product Category ($product_category) (Overrides _ccat) [String, Array] Product Variant ($product_variant) [String] Rating Average ($rating_average) [Number] Rating Count ($rating_count) [Number] Rating Max ($rating_max) [Number] Creation Timestamp ($creation_timestamp) [Number] Exp Date ($exp_date) [String] Keywords ($keywords) [Array] Address Street ($address_street) [String] Address City ($address_city) (Overrides _ccity) [String] Address Region ($address_region) (Overrides _cstate) [String] Address Country ($address_country) (Overrides _ccountry) [String] Address Postal Code ($address_postal_code) (Overrides _czip) [String] Latitude ($latitude) [Number] Longitude ($longitude) [Number] Image Captions ($image_captions) [Array] Condition ($condition) [String] Custom fields ($custom_fields) [Object] Events Variable Description Add To Cart add_to_cart Add To Wishlist add_to_wishlist View Cart view_cart Initiate Purchase initiate_purchase Add Payment Info add_payment_info Click Ad click_ad Purchase purchase Reserve reserve Spend Credits spend_credits View Ad view_ad Search search View Item view_item View Items view_items Rate rate Share share Initiate Stream initiate_stream Complete Stream complete_stream Complete Registration complete_registration Complete Tutorial complete_tutorial Achieve Level achieve_level Unlock Achievement unlock_achievement Invite invite Login login Start Trial start_trial Subscribe subscribe Custom custom Event Parameters Variable Description Add To Cart add_to_cart Add To Wishlist add_to_wishlist View Cart view_cart Initiate Purchase initiate_purchase Add Payment Info add_payment_info Click Ad click_ad Purchase purchase Reserve reserve Spend Credits spend_credits View Ad view_ad Search search View Item view_item View Items view_items Rate rate Share share Initiate Stream initiate_stream Complete Stream complete_stream Complete Registration complete_registration Complete Tutorial complete_tutorial Achieve Level achieve_level Unlock Achievement unlock_achievement Invite invite Login login Start Trial start_Trial Subscribe subscribe Custom custom ... View more

This article describes how to set up the ContentSquare Mobile Remote Command tag in your Tealium iQ Tag Management account. ContentSquare unlocks customer insights for your entire digital team. It's one platform that's powerful enough for every digital role, from marketers to product managers to IT. In this article: Tag Tips Use mappings to: - Dynamically override config data - Dynamically override the E-Commerce extension values - Send additional data values - Event Specific Parameters - Event trigger Supports the following E-Commerce extension values: - Order ID - Product Price - Currency This is a Mobile Remote Command companion tag for the native mobile app SDK. Tag Configuration First, go to the tag marketplace and add the ContentSquare Mobile Remote Command tag (Learn more about how to add a tag). After adding the tag, configure the following settings: 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: Settings Variable Description Screen Name (screen_name) (required) [String] Dynamic Variable (dynamic_var) (required) E-Commerce Variable Description Price (purchase.price) (Overrides _cprice) (required) [Array] Currency (purchase.currency) (Overrides _ccurrency) (required) [String] Transaction Id (purchase.transaction_id) (Overrides _corder) [String] Events Variable Description Send Screen View (sendscreenview) sendscreenview Send Transaction (sendtransaction) sendtransaction Send Dynamic Var (senddynamicvar) senddynamicvar Stop Tracking (stoptracking) stoptracking Resume Tracking (resumetracking) resumetracking Forget Me (forgetme) forgetme Opt In (optin) optin Opt Out (optout) optout Custom custom Event Parameters Variable Description Send Screen View (sendscreenview) sendscreenview Send Transaction (sendtransaction) sendtransaction Send Dynamic Var (senddynamicvar) senddynamicvar Stop Tracking (stoptracking) stoptracking Resume Tracking (resumeTracking) resumeTracking Forget Me (forgetme) forgetme Opt In (optin) optin Opt Out (optout) optout Custom custom ... View more

This article describes how to set up the Branch Mobile Remote Command tag in your Tealium iQ Tag Management account. Branch provides the leading mobile linking platform, with solutions that unify user experience and measurement across different devices, platforms, and channels. In this article: Tag Tips Use mappings to: Override standard configuration values and set custom parameters Trigger standard and custom events Supports the following E-Commerce extension values: Currency (_ccurrency) Customer ID (_ccustid) Promo Code (_cpromo) List of Brands (_cbrand) List of Categories (_ccat) List of SKUs (_csku) List of Names (_cprodname) List of Categories 2 (_ccat2) List of Prices (_cprice) List of Quantities (_cquan) Tax Amount (_ctax) This is a Mobile Remote Command companion tag for the native mobile app SDK. Tag Configuration First, go to the tag marketplace and add the Branch Mobile Remote Command tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Branch Key: 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: Link Variable Description Channel (link.channel) [String] Feature (link.feature) [String] Campaign (link.campaign) [String] Stage (link.stage) [String] Duration (link.duration) [String] Control parameters (link.control_parameters) [String] Settings Variable Description Branch Key (dev_key) [String] Enable Logging (settings.enable_logging) [Boolean] Collect Device Id (settings.collect_device_id) [Boolean] Event Variable Description Tealium Event (event.description) [String] Customer Id (event.user_id) (Overrides _ccustid) [String] Product Quantity (event.quantity) (Overrides _cquan) [String] Currency Type (event.currency) (Overrides _ccurrency) [String] Order Tax (event.tax) (Overrides _ctax) [Number] Revenue (event.revenue) [Number] Search Query (event.search_query) [String] Buo Variable Description Title (buo.title) [String] Description (buo.description) [String] Item Id (buo.canonical_identifier) [String] Item Url (buo.canonical_url) [String] Image Url (buo.image_url) [String] Content Metadata (buo.content_metadata) [String] Metadata Variable Description Latitude (metadata.latitude) [Number] Longitude (metadata.longitude) [Number] Currency Code (metadata.currency_type) (Overrides _ccurrency) [String] Coupon (metadata.coupon) (Overrides _cpromo) [String] Product Brand (metadata.product_brand) (Overrides _cbrand) [String] Product Category (metadata.product_category) (Overrides _ccat) [String] Product Id (metadata.sku) (Overrides _csku) [String] Product Name (metadata.product_name) (Overrides _cprodname) [String] Product Variant (metadata.product_variant) (Overrides _cprice) [String] Product Unit Price (metadata.price) (Overrides _ccustid) [Number] Events Variable Description Initialize (initialize) initialize Set User Id (setuserid) setuserid Logout (logout) logout Create Deep Link (createdeeplink) createdeeplink Achieve Level (achievelevel) achievelevel Add Payment Info (addpaymentinfo) addpaymentinfo Add to Cart (addtocart) addtocart Add to Wish List (addtowishlist) addtowishlist Tutorial Complete (completetutorial) completetutorial Ad Click (clickad) clickad Complete Registration (completeregistration) completeregistration Complete Stream (completestream) completestream Initiate Purchase (initiatepurchase) initiatepurchase Initiate Stream (initiatestream) initiatestream Invite (invite) invite Login (login) login Purchase (purchase) purchase Rate (rate) rate Reserve (reserve) reserve Search (search) search Share (share) share Spend Credits (spendcredits) spendcredits Start Trial (starttrial) starttrial Subscribe (subscribe) subscribe Unlock Achievement (unlockachievement) unlockachievement View Ad (viewad) viewad View Cart (viewcart) viewcart View Item (viewitem) viewitem View Items (viewitems) viewitems Custom custom Event Parameters Variable Description Initialize (initialize) initialize Set User Id (setuserid) setuserid Logout (logout) logout Create Deep Link (createdeeplink) createdeeplink Achieve Level (achievelevel) achievelevel Add Payment Info (addpaymentinfo) addpaymentinfo Add to Cart (addtocart) addtocart Add to Wish List (addtowishlist) addtowishlist Tutorial Complete (completetutorial) completetutorial Ad Click (clickad) clickad Complete Registration (completeregistration) completeregistration Complete Stream (completestream) completestream Initiate Purchase (initiatepurchase) initiatepurchase Initiate Stream (initiatestream) initiatestream Invite (invite) invite Login (login) login Purchase (purchase) purchase Rate (rate) rate Reserve (reserve) reserve Search (search) search Share (share) share Spend Credits (spendcredits) spendcredits Start Trial (starttrial) starttrial Subscribe (subscribe) subscribe Unlock Achievement (unlockachievement) unlockachievement View Ad (viewad) viewad View Cart (viewcart) viewcart View Item (viewitem) viewitem View Items (viewitems) viewitems Custom custom ... View more

This article describes how to set up the TikTok Pixel tag in your Tealium iQ Tag Management account. The TikTok Pixel is a powerful measurement tool that tracks your TikTok ads impact on your website. This clever bit of code enables you to monitor sales, user activity, and find the right audience for your ads. In this article: Tag Tips Use mappings to override or dynamically set the tag configurations. You can use the Crypto Extension to encrypt and populate the Hashed Email and Phone Number values. By default, the pixel base code always includes page view events, which track when a visitor lands on your website. The content_type object property's value must be set to either "product", or "product_group". Tag Configuration First, go to the Tealium Tag Marketplace and add the TikTok Pixel tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Pixel ID Your TikTok Pixel ID. The Pixel ID appears as a long series of numbers in the code snippet. You may enter multiple Pixel IDs using a comma-separated list, without spaces. Example: ttq("init", "12345678901234"); Generate Event ID Automatically generate an Event ID for every TikTok tracking event. This setting defaults to False. Event ID attributes follow the naming convention: tiktok_event_id_<TikTok Event> Example: tiktok_event_id_Purchase_32 : "028b2ade7478..." Unique Event IDs The tag can generate a unique Event ID for each event tracked and send it to Tealium EventStream for use in the TikTok Events connector. If you enable this feature, the Event ID parameter must be mapped in the connector to synchronize web-based and server-based integrations. This feature requires an active Tealium Collect tag. The tag generates new event attributes using the following naming convention: tiktok_event_id_<TikTok Event>_<Tag UID> For example: tiktok_event_id_Purchase_32 : "028b2ade7478..." or tiktok_event_id_PageView_32 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 Configuration Variable Description Pixel ID (pixel_code) [String] Automatic Pageview Tracking (auto_page_tracking) [Boolean] Automatic Purchase Tracking (auto_purchase_tracking) [Boolean] User Parameters Variable Description User Email (user_email) [String] User Phone Number (user_phone_number) [String] User Hashed Email (sha256_email) [String] User Hashed Phone Number (sha256_phone_number) [String] E-Commerce Variable Description Order ID (order_id) (Overrides _corder) [String] Sub Total (order_subtotal) (Overrides _csubtotal) [String] Currency (order_currency) (Overrides _ccurrency) [String] Customer ID (customer_id) (Overrides _ccustid) [String] List of Product IDs (product_id) (Overrides _cprod) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] Standard Tracking Parameters Variable Description Currency (currency) [String] Content Category (content_category) [String,Array] Content Name (content_name) [String,Array] Content ID (content_id) [String] Value (value) [Number] Quantity (quantity) [Number] Price (price) [Number] Query (query) [String] Contents (contents) [Array of objects] Content Type (content_type) [String] Events Variable Description AddPaymentInfo AddPaymentInfo AddToCart AddToCart AddToWishlist AddToWishlist ClickButton ClickButton CompletePayment CompletePayment CompleteRegistration CompleteRegistration Contact Contact Download Download InitiateCheckout InitiateCheckout PlaceAnOrder PlaceAnOrder Search Search SubmitForm SubmitForm Subscribe Subscribe ViewContent ViewContent Custom Custom ... View more

This article describes how to set up the Emarketeer tag in your Tealium iQ Tag Management account. In this article: Tag Configuration First, go to the tag marketplace and add the Emarketeer tag (Learn more about how to add a tag). After adding the tag, configure the following settings: User Secret Your Emarketeer User Secret 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: Standard Variable Description EMUserSecret String Emarketeer User Secret ... View more