Tealium Learning Center

This article describes how to set up the Reddit Pixel tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use mapping to override the standard configuration values and trigger events. Purchase event fires when Order ID is set. Tag Configuration First, go to the tag marketplace and add the Reddit Pixel tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Account ID Your Reddit Account ID. Send Page Visit By default, Page Visit events are automatically recorded each page on your site. If you do not want the snippet to send a Page Visit event to the Reddit Pixel, set the this option to false. 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 account_id String Account ID send_page_visit Boolean Send Page Visit Events Variable Description PageVisit Page Visit Enter the value of the mapped variable needed to trigger the selected event. ViewContent View Content Enter the value of the mapped variable needed to trigger the selected event. Search Search Enter the value of the mapped variable needed to trigger the selected event. AddToCart Add to cart Enter the value of the mapped variable needed to trigger the selected event. AddToWishlist Add to Wish List Enter the value of the mapped variable needed to trigger the selected event. Purchase Purchase Enter the value of the mapped variable needed to trigger the selected event. Lead Lead Enter the value of the mapped variable needed to trigger the selected event. SignUp SignUp Enter the value of the mapped variable needed to trigger the selected event. ... View more

Learn about the new features and fixes released in June 2021. Tags New/Cool Stuff New marketplace tag: Quantcast Cookie Matching Service (Learn more) Updated the Google Ads Conversion Tracking and Remarketing (gtag.js) tag to include custom events and added mapping properties to specific events. (Learn more) Updated the CIM gemiusPrism tag to include section mapping. (Learn more) Updated the PerimeterX Bot Defender tag branding and expanded vendor description. (Learn more) Updated the Yahoo Dot (Verizon) tag to support multiple Pixel IDs. (Learn more) Fixes Updated the Adlucent tag to remove TAX and SHIPPING from mapping and descriptions. (Learn more) The previously unavailable Kayak tag is now updated and available in the tags marketplace. (Learn more) Updated the Adobe Analytics tag to set s.cookieDomainPeriods to ensure that the correct cookie domain for plugins is received. (Learn more) Updated the Commission Junction (CJ) Global tag to include static variables pointOfSale=web and trackingSource=Tealium for all queries. (Learn more) Updated the Criteo OneTag to correctly set the setCustomerId field. (Learn more) Corrected issue with the Bing tag where event label was not populated and corrected the variable reference for mapping event_label . (Learn more) Corrected issues with custom even mapping for the Google Analytics 4 (GA4) tag. (Learn more) Corrected regex issues with the Google Analytics 4 (GA4) tag where the view_item_list event only returned a single item. (Learn more) Connectors New/Cool Stuff New marketplace connector: Snapchat Conversions (Learn more) New marketplace connector: Kayak Conversion Tracking (Learn more) New marketplace connector: Oracle Infinity Analytics (Learn more) Updated the Twitter Ads connector API version from Version 8 to Version 9 and updated the name of the connector from Twitter Tailored Audiences to Twitter Custom Audiences. (Learn more) Updated the Facebook Conversions connector parameters to include validation to the client IP address and client user agent. (Learn more) Updated the Tealium approval email address for the Snapchat Audience Match connector. (Learn more) Fixes Fixed an issue with the Webhook connector when using the Print Attribute Names setting that caused visitor ID attributes to be printed as their IDs instead of as their names. iQ Tag Management New/Cool Stuff Added a new extension scope for use with the JavaScript Code or Advanced JavaScript Code extensions named utag Sync that associates an extension to the utag.sync.js file. (Learn more) When using the Usercentrics extension to import new Data Processing Services, changed and removed services are now highlighted in the interface before the changes are introduced. (Learn more) Fixes Corrected an issue causing an unnecessary error message to display when switching profiles. Updated the user interface to correct an issue where overly long version names prevented the Save/Publish button from displaying properly. Corrected an issue where concurrent users with proper permissions were to not be able to merge versions in some cases. Updated the Edit Tag Template screen to not display the template drop-down list when viewing directly from the tag view. Customer Data Hub Fixes Disabled the Load Profile button in the profile switcher modal in cases where the Profiles field is blank. Corrected the scope selection drop-down list displayed in the AudienceStream Add Attribute screen. Installations Mobile Android Fixed an issue with the Location module for Kotlin that caused the module to crash on startup when the device was offline. Corrected React Native issue with Kotlin 2.x where launch events were not immediately sent when the application launched, but in the next lifecycle event. iOS Removed the UIWebView cookie migration code and the cookie migration listener. Corrected issue with Swift that caused persistent data (app cache) to be deleted after an OS upgrade. Corrected a CoreTelephony log issue with Swift. Updated iOS deep linking and QR Trace to support SceneDelegate by using the UISceneWillConnectNotification to initiate the "swizzle" proxy. Added the WKWebView processPool fix to the Objective C library. ... View more

This article describes how to set up the Adlucent tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use the E-Commerce extension to set the following parameters: Order ID Customer ID List of SKUs List of Quantities List of Prices List of Categories Use mapping to: Dynamically override the standard config values Dynamically override the E-Commerce extension values Set a value for Customer Type Tag Configuration First, go to the tag marketplace and add the Adlucent tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Retailer ID: Your Adlucent retailer 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 Retailer ID (retailer) Customer ID (customerID) Customer Type (customerType) Order ID (orderKey) List of SKUs (sku) [Array] List of Quantities (qty) [Array] List of Prices (price) [Array] List of Categories (category) [Array] ... View more

This article describes how to set up the Yahoo Dot tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use mapping to: Dynamically override the standard config values Dynamically override the E-Commerce extension values Set values for these Standard custom event parameters: Event Category ( ec ) Event Action ( ea ) Event Label ( el ) Event Value ( ev ) Goal Value ( gv ) If you are using the e-commerce extension, Goal Value ( gv ) will automatically be populated with the E-Commerce extension value for Order Subtotal. Map a value directly to Goal Value to override the E-Commerce extension value. Tag Configuration First, go to the tag marketplace and add the Yahoo Dot tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Project ID The projectId value from your Yahoo Dot code snippet. Pixel ID The pixelId value from your Yahoo Dot code snippet. You may enter multiple Pixel IDs in a comma-separated list. 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: Yahoo Dot Variable Description Project ID (projectId) Pixel ID (pixelId) [String or Array] User Email (userEmail) User Hashed Email (userHashedEmail) Custom Event Parameters Variable Description Event Category (ec) [String or Array] Event Action (ea) [String or Array] Event Label (el) [String or Array] Event Value (ev) [String or Array] Goal Value (gv) (Overrides E-Commerce Order Subtotal) [Number] Timestamp (timestamp) Advertiser ID (advertiser_id) E-Commerce Variable Description Sub Total (order_subtotal) (Overrides _csubtotal) List of Product IDs (product_id) (Overrides _cprod) [Array] ... View more

This article describes how to set up the PerimeterX Bot Defender tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use mapping to dynamically override standard config values. Tag Configuration First, go to the tag marketplace and add the PerimeterX Bot Defender tag (Learn more about how to add a tag). After adding the tag, configure the following settings: AppID: Your Unique Application Identifier 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 appId AppID _pxParam1 Custom Param 1 _pxParam2 Custom Param 2 _pxParam3 Custom Param 3 _pxParam4 Custom Param 4 ... View more

This article describes how to set up the CIM gemiusPrism tag in your Tealium iQ Tag Management account. In this article: Tag Tips lan language of the page must be in all capitals. Pre-defined values are NL/FR/EN/GE/LU//OTHER key free keyword to describe the content of the site subs subsection of the web site, not official CIM section free free field Example: Use to to add content type Each parameter name and parameter value can be together up to 50 characters long, including the equal sign (=). The total number of characters in parameter names and their values may be up to 200. The vertical bar (|) and the equal sign (=) symbols are not allowed in parameters. The slash (/) character can be used as a separator between levels of the structure and therefore cannot be used in the name of one node of the tree Letters with accent marks (á, ą, â, ă, ä, etc.) are not allowed and must be changed to Latin letters The following characters are not allowed in the values of parameters 'lan' and 'key' { } [ ] ()" ' ~ ` ! @ # $ % ^ & * ? ; , : / | = Tag Configuration First, go to the tag marketplace and add the CIM gemiusPrism tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Identifier Supplied by CIM gemiusPrism Language The language of the page. Example: NL. You can dynamically override this value via mapping. 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 identifier Account Identifier lanuage Language key Keyword subs Subsection free Free field section Section ... View more

This article describes how to set up the KAYAK tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use event mappings to configure when confirmation and cancellation pixels are fired. The Commission Currency value will default to the e-commerce Currency value if one is not provided. Tag Configuration First, go to the tag marketplace and add the KAYAK tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Partner Code Supplied by KAYAK, this is the internal KAYAK code. Click ID Query Parameter Name Name of the query parameter that will be used to pass the click id in the tracking url. Data Mappings Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see data mappings. The available categories are: Tag Configurations Variable Description Partner Code (partner_code) Booked On Date (bookedon) Kayak Commission Amount (kayakcommission) Commission Currency (commissioncurrency) Booking Type (bookingtype) Kayak Commission Percentage (commissionpercentage) Custom Field 1 (tag1) Custom Field 2 (tag2) E-Commerce Variable Description Order ID/Booking ID (order_id) (Overrides _corder) Order Total (order_total) (Overrides _ctotal) Currency (order_currency) (Overrides _ccurrency) Hotel Variable Description Booking Check In Date (checkin) Booking Check Out Date (checkout) Booked Property ID (hid) Number of Travelers (travelers) Number of Rooms (rooms) Flight Variable Description Itinerary Description (itin) Origin Airport Code (origin) Destination Airport Code (destination) Fare Class (fareClass) Cabin Type (cabinType) Car Variable Description Pick Up Date (pickup) Drop Off Date (dropoff) Pick Up Location ID (pickupid) Drop Off Location ID (dropoffid) Car Agency ID (agency) Events Variable Description Confirmation Confirmation Cancellation Cancellation ... View more

Learn about the new features and fixes released in May 2021. Tags New/Cool Stuff Updated the Contentsquare UX Analytics tag to add currency support for e-commerce transactions. (Learn more) Updated the Adobe Target tag to add support for Adobe Target version 2.4.1. (Learn more) Fixes Updated the AT Internet SmartTag template to remove incorrect default configuration placeholders. Connectors New/Cool Stuff New marketplace connector: Impact Page Loads (Learn more) New marketplace connector: Quantcast Audiences (Learn more) Updated the Amplitude connector by adding built-in logic to skip empty values. (Learn more) Updated Facebook Conversions and Offline Conversions connectors to improve ID validation and ensure mapped data is a valid number and not a string. Fixes Updated the Salesforce and Salesforce Standard Objects connectors to correctly produce unique keys for each customer and avoid key collisions. Updated the Amazon EventBridge connector to include missing session token and corrected an error that occurred when an event source was configured manually. Corrected an issue causing inaccurate error reporting related to email hashing for the Google Enhanced Conversions connector. iQ Tag Management New/Cool Stuff The Site Scan service is now deprecated and no longer available from Tealium Tools. Increased the size of the code editor window for the JavaScipt Code (Basic) extension and added full screen pop-out capabilities. Fixes Corrected an issue where the code contents of inherited JavaScript extensions did not display in child profiles. Corrected an issue in the Consent Manager user interface where users were not able to scroll to select the consent language. Corrected an issue where an incorrect version of the cmShowpreferences template displayed in the Template Status Checker. Customer Data Hub Fixes Corrected issue so that using regex inside of rules no longer converts to invalid regex, which previously caused the profile to not save. Installations Mobile Remote Commands Corrected issue with the Android Firebase Remote Command implementation to correctly report events when either no event or firebase_event_params exists. Android (Kotlin) Corrected issue with Kotlin HTTP that caused requests to not send if no response listener is passed. React Native Updated the Braze Remote Command tag to correct issue with ReactNative importing the com.tealium.remotecommands:braze:1.0.0 artifact. iOS Swift Corrected issue where the decline_consent event did not correctly send for .gdpr (config.consentPolicy = .gdpr) . (Learn more) Updated Firebase to correctly map custom parameters for events. Corrected consent policy issue where the key policy was inadvertently changed to consent_policy , thus invalidating the event specifications for consent. ... View more

We have expanded and simplified how you manage code in the utag.sync.js file. A new extension scope named utag Sync associates an extension to the utag.sync.js file. The utag Sync scope is available for the JavaScript Code or Advanced JavaScript Code extensions. What's New Previously, the utag.sync.js file could only be updated by editing the tag template. This method was inflexible, prone to error, and limited to users with the permission to manage templates. The new scope allows you to manage the contents of the utag.sync.js file with all the conveniences of extensions. How It Works Use the utag Sync scope to publish code from a JavaScript Code extension into utag.sync.js instead of editing the tag template. Add a JavaScript Code or Advanced JavaScript Code extension and set the scope to utag Sync. When the profile is published, the placeholder ##UTSYNC## in utag.sync.js is replaced by the code from the scoped extensions. Benefits Convenience of Extensions Enjoy the convenience of extensions while managing utag.sync.js . Enable or disable the code in utag.sync.js by turning on or off the associated extensions and easily publish utag.sync.js to different environments using publish locations. Support for Inheritance and Libraries Create and manage shared utag Sync extensions with libraries, which will be inherited to child profiles. This allows you to easily manage common sync code across profiles. Support for Publishing Approval and Environment Lock Advanced and Basic JavaScript extensions can be restricted from publishing to specific environments, which provides you with more control over the environments to which you deploy your sync changes. GitHub Integration Increase efficiency and code quality by using the GitHub integration with the Advanced JavaScript Code extension to publish code from an external repository into the utag.sync.js file. How do I enable the feature? To enable this feature, toggle on the Generate utag.sync.js File option in your Publish Configuration settings, as follows: Click Save/Publish. Click Configuration Publish Settings. From the General Publishing tab, scroll down to the Implementation section and toggle the Generate utag.sync.js File option to On. Click Save. Save and Publish your changes to the desired environments. Additional Information Using the utag.sync.js Script Advanced JavaScript Code Extension Extensions JavaScript Code Extension (Basic) Load Order Manager Order of Operations ... View more

Learn about the new features and fixes released in April 2021. Tags New/Cool Stuff New marketplace tag: Adjust Mobile Remote Command (Learn more) Updated the Google Analytics (gtag.js) tag to include the send_to parameter on page_view events. (Learn more) Updated the Rakuten Marketing from "Rakuten Marketing" to "Rakuten Advertising", added the nonCentCurrencies parameter, and updated endpoint configurations. (Learn more) Connectors New/Cool Stuff Updated Adobe Analytics Connector to support event serialization. (Learn more) Improved error deserialization for Google Ads Conversion connector to handle 429 HTTP responses. (Learn more) Deprecated current Criteo Audience Match connector and introduced new Criteo connector. (Learn more) Fixes Updated logic in Google Floodlight connector to correctly account for partially successful API responses. iQ Tag Management Fixes Corrected an issue causing tags to display incorrect history data. Corrected an issue causing the inability to scroll load rules. Corrected an issue with extensions using the Preloader scope that resulted in utag.js failure. Corrected issue causing DOM Ready extensions to not display properly in Load Order Manager. Customer Data Hub Fixes Corrected issue in AudienceStream > Audience Discovery where users could not access the Audiences drop-down list. Installations Mobile Remote Commands Applied HTTP remote command updates to format the request body based on the content-type header. Android (Java) Updated the Android SDK to allow suppression of remote_api events. Android (Kotlin) Updated the Kotlin SDK to allow for custom consent policies. Updated the device collector for Kotlin to include device_language . Added os_name to Kotlin for consistency with Swift. Added module_names , enabled_modules , and enabled_modules_versions to Kotlin events to improve the debugging experience. Added the tealium_profile override setting to the CollectDispatcher for Kotlin. Updated the Kotlin CollectDispatcher to correctly encode the receipt of collections and non-standard characters in EventStream. Updated Kotlin to correctly include REQUEST_UUID for each track in the event request payload. Corrected the Kotlin library_version key to be the tealium_library_version key. Flutter Updated the Tealium for Flutter API with the ability to use the Swift library. Updated the Tealium for Flutter API with the ability to use the Kotlin library. React Native Added a Remote Command adapter to enable any remote command to be added to the React Native plug-in. Added "on-ready" callback support for Tealium initialization using React Native. iOS Swift Updated the Swift SDK to allow for custom consent policies. Updated the Swift crash reporter module to correctly include crash_count for the total number of crashes. To successfully set and sync cookies, added the ability to allow a process pool for multiple webviews to be set up each time WKWebview is instantiated. ... View more

Learn about the new features and fixes released in March 2021. Tags New/Cool Stuff The Google Analytics 4 (GA4) tag was moved out of beta. (Learn more) New marketplace tag: Amobee Cookie Matching Service (Learn more) Updated the Firebase Mobile Remote Command tag to the latest SDK, including eCommerce function updates. (Learn more) The legacy version of the Facebook pixel tag is now deprecated and no longer available from the tag marketplace. (Learn more) Updated the Google Analytics (gtag.js ) tag to add support for List Name as an array type. (Learn more) Fixes Updated tag tips for the Google DoubleClick and AdWords Cookie Matching service tag to accurately reflect the name of the google_gid cookie value variable sent to AudienceStream. (Learn more) Updated the Adobe Analytics AppMeasurement for JS tag to correctly map linkTrackVars and linkTrackEvents. (Learn more) Updated the Google Analytics (gtag.js) tag to remove unsupported mapping for   config.linker.domains and config.linker.accept_incoming . (Learn more) Connectors New/Cool Stuff The Google Ads Enhanced Conversions connector is now available as a beta experiment. (Learn more) The Xandr Real Time Segments (Tealium-Provided Credentials) connector is now available as a beta experiment. (Learn more) Updated the Google Ads Customer Match connector to allow multiple mappings for the UserIdentifier parameter. (Learn more) Updated the Criteo connector to support a mapping for IP address. (Learn more) The Impact Radius connector was renamed to Impact Conversions. (Learn more) Updated the End-User License Agreement (EULA) for all Google Customer Match connectors. Fixes Updated the Criteo connector to validate that the audienceId parameter is entered as a number. (Learn more) Updated the Adobe Campaign Classic Batch connector to correctly flag error identifiers. (Learn more) The beta experiment version of the Xandr Real Time Segments (Customer-Provided Credentials) connector is no longer available. Corrected issue in connector workflow causing text the inability to edit selected text. iQ Tag Management Fixes Updated the Template Status Checker to correctly look for the new version of the mobile.html template and corrected the ability to open the template. Updated the Template Status Checker to include Consent Manager templates in the summary view and total template count. Corrected issue causing merge to not display the extensions, variables, and load rules as having changed when included in the merge but not specifically changed. Corrected an issue in Web Companion for private client environments where the title for tags and extensions incorrectly displays as "No Title". Corrected a UTF-8 display issue preventing Web Companion from loading properly. Corrected an issue causing extensions with the Run Once option not to display in a filtered list. Corrected a display issue that occurred on user account screens when enabling MFA for an account. Corrected an issue in the code editor that caused syntax errors to display when editing templates with placeholder code. Customer Data Hub New/Cool Stuff New data source: Adobe Experience Platform Launch. (Learn more) The HTTP API - Flattened data source was renamed to HTTP API - Advanced. (Learn more) Added Trimou template functions substring , substringAfter , substringAfterLast , substingBefore , substringBeforeLast , substringBetween . (Learn more) Installations Web Updated the Universal Tag (utag.js) to support secure cookies using a JavaSciript preloader extension. (Learn more) Mobile Updated NativeScript to support consent expiration (Learn more). Updated the media tracking modules for the Swift and Kotlin libraries to support background playback. Android Updated to support autotracking of push notifications for Kotlin. Updated for Kotlin to move _http  command activity to a background thread. Corrected issue with ReactNative for Android for the NoSuchKeyExpection on versions v.062 and below. Corrected issue to correctly start offline tracking when the mobile application is started offline. Swift Updated to match Kotlin functionality to use tealium_event_type=view and tealium_event_type=event instead of call_type=view . Updated the ConsentPolicy protocol to public to support the creation of custom consent policies. Corrected issue to automatically reset lifecycle crash key on the launch event. Corrected issue with crash reporter module using Carthage. ... View more

This article describes how to set up the Amobee Cookie Matching Service tag in your Tealium iQ Tag Management account. In this article: Tag Tips Sends the following server-side attribute back to Tealium:   amobee_id If left blank, the Tealium account and profile names are automatically populated. Tag Configuration First, go to the tag marketplace and add the Amobee Cookie Matching Service tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Amobee Token (Your Amobee Token) Tealium Account: Tealium Profile 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 amobee_token Amobee token Your Amobee token, as provided by Amobee. tealium_account Tealium account name tealium_profile Tealium profile name ... View more

This article describes how to use the HTTP API - Advanced data source to create an HTTP endpoint to collect real-time event data with support for flattening complex objects. In this article: Table of Contents Placeholder How It Works A Webhook API sends outgoing requests to an endpoint that you specify. These requests inform Tealium EventStream and AudienceStream about customer activity from your external systems. When you add a webhook data source, a unique endpoint is generated. This endpoint is used to configure a webhook in your external system. Once configured, you can create subscriptions based on topics and receive related push notifications to automate use cases, stay informed, and increase productivity. The HTTP API - Advanced data source is a generic data source that can conditionally parse incoming request bodies. This data source offers an HTTP endpoint to collect real-time event data with support for flattening complex objects. The endpoint is flexible and can be implemented as a tracking pixel in a web page or as a JSON API in your custom application. This data source is similar to the HTTP API data source, but with additional support for complex objects. Events sent using HTTP POST with a complex JSON object will be flattened as follows: Event keys are created by lowercasing and connecting key paths to a prefix. For example, a value of true located at alpha.beta displays as "alpha_beta":true . Numbers, Booleans, and strings inside of an array are preserved. Objects and arrays inside of an array are stringified. Use this data source type when you need to send data in real time and do not have the ability to modify the request to meet format requirements for the standard Tealium Collect endpoint. Requirements Tealium EventStream or Tealium AudienceStream Supported Parameters The following default parameters are supported in each request: Parameter Description tealium_event Optional The name of the event. tealium_trace_id Optional For use with Trace. tealium_visitor_id Optional* For use with AudienceStream If batched events are being used and there is no tealium_visitor_id present in the event, all events in the same batch generate the same tealium_visitor_id . This implies that the events will be tied together in the same visitor profile, regardless of visitor stitching. Setup The following sections provide guidance on how to add the HTTP API - Advanced data source and create a webhook. Add the Data Source The HTTP API - Advanced data source supports both the GET and POST methods using the following endpoint: https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY Add the HTTP API - Advanced data source before proceeding, then copy the generated endpoint for use in an external system. Related: How to Add a Data Source Examples The following sections provide examples of input code and the resulting (flattened) output for complex objects. Complex Object Before Flattening { "boolean": true, "number": 12.34, "string": "value", "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] ] } } } After Flattening { "boolean": true, "number": 12.34, "string": "value", "array_of_strings": ["first", "second"], "array_of_arrays": ["[1,2]", "[3,4]"], "array_of_objects": ["{\"ordinal\":\"first\"}", "{\"ordinal\":\"second\"}"], "object_child_boolean": true, "object_child_number": 12.34, "object_child_string": "value", "object_child_array_of_strings": ["first", "second"], "object_child_array_of_arrays": ["[1,2]", "[3,4]"], "object_child_object_gchild_boolean": true, "object_child_object_gchild_number": 12.34, "object_child_object_gchild_string": "value", "object_child_object_gchild_array_of_strings": ["first", "second"], "object_child_object_gchild_array_of_arrays": ["[1,2]", "[3,4]"] } JSON Object Before Flattening A JSON object is treated as a single event by default. { "events": [ { "id": "1", "name": "Event A" }, { "id": "2", "name": "Event B" }, { "id": "3", "name": "Event C" } ] } After Flattening Unless the parser is overwritten by custom logic used to parse out batched events, the JSON object is transformed into a single event with stringified JSON array values. { "events": [ "{\"id\":\"1\",\"name\":\"Event A\"}", "{\"id\":\"2\",\"name\":\"Event B\"}", "{\"id\":\"3\",\"name\":\"Event C\"}" ] } ... View more

This article describes how to manage server-side users and permission roles for the Tealium Customer Data Hub. This article covers the following topics: How It Works Server-side user permissions provide control over the degree of access users have for each profile by creating a separation of access between the Tealium client-side interface and the server-side interface. From the server-side Manage Users screen, you can do the following: Grant Access to New Users New users are added to accounts in Tealium iQ Tag Management. After new users are added, the new users display in the server-side user permissions list where server-side access can be granted, by profile. To add new users to an account, you must have the Manager Users permission. To assign roles on the server-side, you you must have the Manage Account permission. Specify Access Account administrators can grant access to users only for the areas that they intend to work on as well as grant Save and Publish permissions for client-side products for a profile that do not carry over to server-side products for that profile. Set Permissions for Future Profiles For active profiles, you can set the permissions for future profiles, which allows user admins to define a profile-level permission role for users of new profiles created for an account. Add and Edit Bulk Users You can add and edit users in bulk (up to 25 users at a time) and search user profiles and filter users by permission type. Admin Users Admins of the server-side interface are the only users that have the ability to change the permissions of server-side users. None of the server-side permission roles grant this ability. To be an admin on the server-side, you must have the Manage Account permission in the client-side interface. Only the Manage Users permission on the client-side grants the ability to add users to the account. To learn more about managing user permission in Tealium iQ Tag Management, see Managing User Permissions in iQ Tag Management. Server-Side Permission Roles Server-side access is controlled using predefined permission roles. For each profile in the account, users are assigned a permission role to determine their access level. The following table describes the four available server-side permission roles: PERMISSION ROLE DESCRIPTION No Access (default) This is the default role for all users other than account administrators. The No Access permission role does not grant any access to the server-side profile. If the user attempts to access the server-side, their profile is blocked and an "Access Denied" message displays. Reader The Reader permission grants read-only access to the server-side profile. A user in this role can browse the profile configuration, but Save/Publish is disabled. Users with this role cannot save any changes. Editor The Editor permission grants edit and save access to the server-side profile. With this role, you can save but not publish. Users with this role can also access and edit settings from the Profile Admin > Settings menu. Publisher (Admin default) This is the default role for account administrators. The Publisher permission grants the same access as the Editor role, with the addition of the ability to save and publish the profile. Profile access between the server-side and client-side product is mutually exclusive. For example, you can grant Save and Publish permissions for client-side products without impacting server-side product permissions for a given profile. In addition, if you remove or change user access to a profile on the client-side, it is not removed or changed on the server-side. Add a Server-Side Only User To give a user access to server-side, you must first add them in the client-side interface. In the client-side interface you must have the Manage Users permission to add users to your account and the Manage Account permission to manage permissions in the server-side interface. To add a user with only permission to a server-side profile, follow these steps: In the client-side interface, add the user, but do not select any client-side permissions. The user must verify their email address before you can continue, at which point the user has read-only access to the client-side interface and appears in the Manage Users list in the server-side interface. In the server-side interface, go to Manage Users and assign permission roles to grant the user access to a server-side profile, then click Next. Save your changes. Return to the client-side interface. On the User Menu, select Manage Users. In the   User Manager   dialog, select the user you want to remove. Click More and select   Remove User. In the   Remove User   dialog, confirm the user to be removed, then click   Remove User. The user no longer has access to the client-side profile, but retains access to the server-side profile. Edit Server-Side User Permissions To edit server-side user permissions, you must have the Manage Account permission, which is assigned from the client-side interface. Use the following steps to view and edit server-side permissions for a user: Log into the server-side area of the Customer Data Hub. In the user admin menu, select Manage Users. A list of all server-side users displays, including the user's name, email address, and a timestamp for the last login. Click a user to display the permission details. To grant access to a profile, select a Permission Role. Repeat Step 3 through Step 5 for each user you want to edit. If no changes are needed, click X to close the user details and return to the user list. You will be prompted to confirm your intention to disregard changes if you have made adjustments. Click Save to keep your changes or Cancel to discard the changes. Your changes are saved without the need to publish. Set Permissions for Future Profiles Use the following steps to set permissions for future profiles, which allows user admins to define a profile-level permission role for users of new profiles created for an account. Log into the server-side area of the Customer Data Hub. On the user admin menu, select Manage Users. In the Set permissions for future profiles list, select a role to be assigned to users of new profiles created for an account. Click Save to keep your changes or Cancel to discard the changes. Your changes are saved without the need to publish. Edit User Permission Roles in Bulk Use the following steps to edit the permission role for multiple users: On the user admin menu, select Manage Users. Select each user for which you want to change the permission role. Click Bulk Actions and select the permission to assign to the selected users. Click Apply, then click Save. You do not need to publish for your changes to persist. Frequently Asked Questions (FAQ) If a user is removed from the client-side profile, is the user also removed from the server-side profile? No. When a user exists in both client-side and server-side, removing the user from one does not impact the other. Can I grant a user access to a server-side profile without allowing access to a client-side profile? Yes. If a user already exists in the account and has been granted permission to a profile on the server-side, go to iQ Tag Management > Manage Users and remove that user from the client-side interface. For more information, see Add a Server-Side Only User. How does the "All current and future profiles" option impact server-side permissions? There is no impact to server-side users. All server-side users have the default permission role of No Access to all new server-side profiles. What happens if a user has access to only one profile on the server-side and no profile access on the client-side? If the user selects server-side at the login screen, they are automatically loaded into the account/profile accordingly. If the user attempts to log in to the client-side, a modal displays with a denied access message. Can a server-side admin change their own permissions for server-side profiles? Yes. A server-side admin user (granted by the Manage Account permission) can change permissions for all server-side users, including their own. Can a server-side admin update manage permissions for all server-side profiles? Yes. A server-side admin user's access is granted by the Manage Account permission, which is an account-level permission. Users with this permission level have access to the Manage Users screen in the server-side interface where they can manage user permissions for all profiles. How do the new server-side permissions affect the Omnichannel File Status API? Access control to the Omichannel File Status API will change upon final release of the server-side permissions feature. In addition to the standard requirement of needing an API key to authenticate with the API, users must have read access to the relevant Customer Data Hub account. Users using the v1 API only need read access to the Customer Data Hub account. Can a server-side admin add new users to an account? No. The Manage Account permission does not grant access to add new users or delete users from an account. While they can remove access to profiles, only users who have the Manage Users permission assigned in the iQ Tag Management workflow can invite a new user to an account or completely delete a user from an account. Does this feature change the way user management access is granted or controlled within TiQ? No. The Manage Users permission in iQ Tag Management remains the permission that grants a user access to add or remove users from a business account. Users with only the Manage Users permission do not have access to manage permissions on the server-side. Additional Resources Managing User Permissions in iQ Tag Management ... View more

Learn about the new features and fixes released in February 2021. Tags New/Cool Stuff Updated The Trade Desk Cookie Matching Service template to trigger only once per session by default. (Learn more) The Cookie Reports tag is now rebranded to Digital Control Room. (Learn more) Updated the createContexts function for the Snowplow tag to allow arrays of variables to be passed and support sending multiple contexts. (Learn more) Updated the Fullstory tag to support page events for the FS.setVars API. (Learn more) Updated mobile timestamp handling for the Adobe AppMeasurement tag, Versions 1.6.3 and later. (Learn more) Updated the Adobe Target tag to support Version 2.4. (Learn more) Updated the Adobe Experience Cloud ID Service API to support Version 5.2. (Learn more) Connectors New/Cool Stuff Added batching support for the Sailthru connector. (Learn more) Added new, required parameters for the Facebook Conversions connector. (Learn more) Upgraded the Twitter Ads API from from Version 7 to Version 8. Fixes Corrected issue in Facebook Conversions that caused the "Action Source" key in Event Data mapping to display in the wrong area. iQ Tag Management New/Cool Stuff New marketplace extension: Usercentrics CMP, V1. (Learn more) New marketplace extension: Usercentrics CMP, V2. (Learn more) Reintroduced the original JavaScript extension as the JavaScript Code Extension (Basic), which is now available in addition to the Advanced JavaScript extension. (Learn more) Fixes Corrected a cosmetic issue to ensure that single items do not scroll on a page when performing a Load Order Manager bulk move. Corrected an issue where child profiles were able to inherit an "add-once" extension from a parent library, which resulted in multiple extensions in the child profile. Corrected an issue where changing JavaScript Extension scopes from Tag Scoped to DOM Ready created a duplicate of the extension. Corrected an issue that occurred when importing variable bundles that created an additional e-commerce extension for the first time and did not map variables by default as expected. Corrected an issue in Consent Manager (Preferences) that caused omitted tags to fire twice for events with a UIDs array that occurred before a consent decision when the omitted tags were included in the UIDs array. Customer Data Hub Fixes Corrected an issue in the display of server-side versioning that caused the graph to not display property. Corrected issue causing the Data Source tab to not load if the profile contains a deprecated data source. Corrected issue causing problems when filtering Live Events using TraceId . Corrected the visit expiration estimate calculation for visitor profiles. Installations New/Cool Stuff Mobile Android Updated React Native to support the latest Kotlin libraries. Corrected issue causing offline tracking to not be dispatched when an application is started offline. Added public API method to reset and regenerate the Tealium Visitor ID. iOS Applied various enhancements to improve the user experience when working with the Tealium and Adobe visitor services. Swift Updated the Airship remote command integration to support JSON configuration files for Swift 2.0. Updated React Native to support the latest Kotlin libraries. Added NativeScript integration support for mobile SDKs. NativeScript Released Tealium for NativeScript, a set of cross-platform classes that interface with the native Tealium iOS SDKs. (Learn more) ... View more

This article describes how to set up the Digital Control Room (formerly Cookie Reports) tag in your Tealium iQ Tag Management account. In this article: Requirements The unique 8-digit code and language code for your site, supplied by Digital Control Room. Tag Tips Use mapping to override standard configuration values dynamically. Tag Configuration First, go to the tag marketplace and add the Digital Control Room (formerly Cookie Reports) tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Policy Code: //policy.cookiereports.com/XXXXXXXX_panel-en-gb.js Language Code: //policy.cookiereports.com/XXXXXXXX_panel-XX-XX.js 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 policy_code Policy Code language_code Language Code ... View more

The Tealium Usercentrics extension simplifies the integration between Tag Management and Consent Management by allowing you to map data processing services to specific tags. Implementing this extension ensures the enforcement of end-user privacy preferences (consent) and that only consented services have the ability to transmit data to third parties. The implementation additionally ensures that only mapped tags can actively run on the website, which reduces the privacy risk exposure when changes are introduced. In this article: Table of Contents Placeholder Prerequisites Knowledge of the current or planned version of your Usercentrics implementation. To obtain all of the Data Processing Services in your Consent Management Platform (CMP), follow the instructions outlined in the Usercentrics Direct Implementation Guide. Use a Test Environment for your First Implementation Tealium recommends using a testing environment for your first implementation in order to fully access the CMP to create the mapping table within the extension. Using a testing environment ensures that no end-user data is processed prior to applying the extension in your development environment. Once you have completed the mapping of all data processing services to their corresponding tags, you can release it to production and Tealium iQ Tag Management will handle the enforcement of end-user privacy preferences (consent). Requirements Tealium Universal Tag (utag.js), Version 4.43. (Learn more) The Usercentrics CMP must load before Tealium iQ Tag Management. For this reason, you must do one of the following: Implement the Usercentrics Script (tag) directly within the HTML code of your website. - OR - Go to the Implement the Usercentrics Tag section below and follow the instructions to implement the tag within Tealium iQ Tag Management. Create a Data Processing Service for Tealium iQ Tag Management in your Usercentrics CMP setup. To learn more, see the Usercentrics documentation, Assign a data attribute. Know the name of your Data Processing Service before you begin, as it is required in the configuration steps. Implement the Usercentrics Tag Use the following steps to implement the Usercentrics tag within Tealium iQ Tag Management using the JavaScript Code extension: Go to Tealium iQ Tag Management > Extensions > Add Extension and select the JavaScript Code extension to add the script for Usercentrics V1 or Usercentrics V2. Add the JavaScript Code extension. If you have not previously used the JavaScript Code extension and need to learn how, see JavaScript Code Extension. Name the extension Usercentrics Tag, and set the scope to Pre Loader. Use the script from one of the following examples to create the extension: Usercentrics V1 Script: Supports Usercentrics CMP v1. (function(a, b, c, d) { b = document; c = 'script'; d = b.createElement(c); d.src="XXXXXXXXXXX"; // URL for Usercentrics CMP Version 1 Script. d.type = 'text/java' + c; d.async = true; d.id = 'XXXXXXXXX'; // Usercentrics Settings-ID a = b.getElementsByTagName(c)[0]; a.parentNode.insertBefore(d, a); } )(); Usercentrics V2 Script: Supports Usercentrics CMP V2 Browser SDK (TCF v2.0) (function(a, b, c, d) { b = document; c = 'script'; d = b.createElement(c); d.src="XXXXXXXXXXX"; // URL for Usercentrics CMP Version 2 Script. d.type = 'text/java' + c; d.async = true; d.id = 'usercentrics-cmp'; d.setAttribute('data-settings-id', "XXXXXXXXXXX"); // Usercentrics Settings-ID a = b.getElementsByTagName(c)[0]; a.parentNode.insertBefore(d, a); } )(); Save and publish the JavaScript Code extension to your environment. Create a Tealium Data Processing Service in your Usercentrics CMP You must create a Tealium Data Processing Service in your Usercentrics account to ensure that user consent preferences are enforced and third parties can only process data if allowed to do so. Use the following steps to create a Data Processing Service for Tealium iQ Tag Management in your Usercentrics CMP account: Go to your Usercentrics account . Select the most recent Data Processing template for Tealium iQ Tag Management. Mark the template as Required to ensure that it cannot be opted out. If you customized the Tealium iQ Tag Management service name, it will not be automatically detected by the CMP extension. In the Configuration section of this document, you will manually add the custom service name using the Service Name input field. How it Works The Tealium iQ Tag Management Usercentrics extension is used to ensure that your CMP policy is enforced at the source level, thus blocking or firing tags according to the user's consent preferences. Simple bookmarklet functionality is used to import the Data Processing Services JSON object text to a bookmark in your browser, which is then used to create a mapping table. To use, add the extension, enter the required information, and then use the mapping table to map consent preferences to your tags. Using this method significantly reduces implementation time and provides an extra layer of protection by preventing tags from firing until they are mapped to a CMP service. To prevent privacy risk exposure in instances where a tag is added without being mapped to a Usercentrics data processing service, only mapped tags fire once the extension is active. Configuration The steps in this section describe how to add the extension, install the bookmarklet, copy the data processing services, import the data processing services, and then map your tags to your data processing services. Add the Extension Use the following steps to add the Usercentrics extension: Go to iQ Tag Management > Extensions > Add Extension and click the Privacy tab. Select one of the Usercentrics extensions: Usercentrics V1 or Usercentrics V2. Select the version that corresponds with the version currently in use by your organization. In the Title field, enter a meaningful title to be used for this extension. Note that the Scope field cannot be modified. Enter the Settings-ID (Optional) Under Usercentrics Setting ID, in the Setting ID field, you can manually add your Usercentrics Settings_ID . This step may not be needed as the Usercentrics Settings-ID is automatically added to the extension while importing the data processing services. Under the Tealium iQ Service Name, in the Service Name field, enter the exact name that was given to the Tealium Data Processing Service within Usercentrics. Continue to the next section to install and use the Service Mapper bookmarklet. Install the Service Mapper Bookmarklet Use the following steps to install the bookmarklet: Click the Bookmarklet button. The Usercentrics Service Mapper Bookmarklet dialog displays. Click the Usercentrics Service Mapper link and drag and drop the bookmarklet onto the bookmark bar for your browser. The bookmarklet now displays in your browser bar. Click Close to dismiss the Usercentrics Service Mapper Bookmarklet window. Create a Mapping Table Use the following steps to copy and import your data processing services to create a mapping table: Open another browser tab and navigate to the Usercentrics test environment where your CMP is implemented and click the Usercentrics Service Mapper bookmarklet to launch. A pop-up window displays the text for your Data Processing Services JSON object. Copy the entire text from this window. Navigate back to the Usercentrics configuration dialog in iQ Tag Management and click the Import button. The Import Services dialog displays. Paste the copied JSON text into the window, as shown in the following example. Click Create Mapping Table. Your Usercentrics Settings ID and Tealium iQ Service Name are now automatically populated and the Service Mappings to your data processing services display in a mapping table. The mapping table must be updated each time a new tag is introduced or when your Data Processing Services with the Usercentrics configuration is changes, as described in the Update the Mapping Table section of this document. Map Data Processing Services to Tags Use the following steps to map your data processing services to tags: For each item in the mapping table, click the To UID field and use the prepopulated list to select the appropriate tag UID. You can map more than one tag to a data processing service. The bookmarklet automatically adds a list item for Tealium iQ Tag Management and Usercentrics in the mapping table. Use the trash can icon to delete the Tealium iQ Tag Management and Usercentrics services, as they are not used for consent enforcement. (Optional) Click Add Service to manually add additional services and map them accordingly. When complete, consent is immediately enforced without the necessity of a page reload, which guarantees that end-user privacy preferences are enforced before any data processing takes place. Update the Mapping Table The mapping table must be updated when a new tag is introduced or when your Data Processing Services within the Usercentrics setup changes. Use the bookmarklet functionality as described in the configuration steps and repeat the process to update. The Import function identifies Data Processing Services that already exist, including any that have been recently added and those that were previously deleted, as follows: If the Data Processing Service already exists, mapping is not impacted. If the Data Processing Service was deleted, it also deletes the mapping entry. If the Data Processing Service is newly introduced, a new line item is added to the mapping table and you must map at least one corresponding tag. Troubleshooting To view typical events, log messages, and error messages that may require attention, enable console logging. Use the following steps to enable console logging: Go to JavaScript (Web) Debugging and follow the steps to add the debugging cookie. After the debugging cookie is set, use the "/SENDING|\*\*\*\*/" filter to display only relevant entries. FAQ Can this extension be used in mobile installations? No. Mobile installations, such as iOS and Android, do not support the Tealium iQ Tag Management Usercentrics extension. Additional Information Usercentrics Direct Implementation Guide Usercentrics CMP, Version 1 Usercentrics Web CMP, Version 2 Tealium: Master List of Extensions Become a Tealium Techology Partner ... View more

Beginning February 15th, 2021, website events that are shared using the Facebook Conversions API require additional parameters to remain operational. This notification describes the new parameters and how to configure them using your Facebook Conversions connector. About The new parameters for the Facebook Conversions connector are intended to improve the quality of events used for ad delivery and campaign performance. These parameters are required and must be added to your current Facebook Conversions connector configuration in order for the connector to remain operational. In addition to ensuring the new parameters are added and configured, Tealium recommends checking the following items throughout your Facebook Conversions connector configuration: action sources website events URLs sent User Agent attributes sent What's New The following new parameters are now available in the connector marketplace for the Facebook Conversions connector and must be added and configured before February 15, 2021: Web client_user_agent Required if the Action Source is set to website. The user agent for the browser corresponding to the event. EventStream If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute User Agent in EventStream. AudienceStream If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the vistor's last User Agent in AudienceStream. Customer Information Parameters (Facebook Documentation). action_source Required. This field allows you to specify where your conversions occurred. Valid action sources are: email website app phone_call chat physical_store system_generated other Server Event Parameters (Facebook Documentation). event_source_url Required if the Action Source is set to website. The browser URL where the event happened. EventStream If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute Current URL in EventStream. AudienceStream If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute Last Event URL in AudienceStream. Server Event Parameters (Facebook Documentation). Non-Web action_source Required. This field allows you to specify where your conversions occurred. Valid action sources are: email website app phone_call chat physical_store system_generated other Server Event Parameters (Facebook Documentation). For detailed information about using and configuring the Facebook Conversions connector, see the Facebook Conversions Connector Setup Guide. ... View more

This article describes how to set up the Google Analytics 4 tag (GA4) in your Tealium iQ Tag Management account. In this article: Overview The Google Analytics 4 tag can only be used with GA4 properties. You cannot use the GA4 tag with a Universal Analytics property. However, you can use both the UA and GA4 tags on the same website. Your new GA4 property won't have historical data, so it is recommended that you run both GA4 and Universal Analytics in parallel for a few months before switching to GA4. GA4 has a different structure for events than Google Univeral Analytics. GA4 is event-based with parameters and properties, and does not use event_category , event_action , event_label , or custom dimensions. For more information on setting up a GA4 property and migrating to GA4 from Universal Analytics, see Next Generation of Google Analytics and Migrating from Universal Analytics to Google Analytics 4. Automatic and Recommended Events GA4 automatically generates some events, with no setup required, For more information on these automatically generated events and their parameters, see Google Analytics 4 Automatically Collected Events. GA4 also has recommended events in the following categories: All sites and apps Retail and ecommerce Jobs, education, local deals, and real estate Travel Games For recommended events, data must be mapped to the event parameters. For more information on recommended events and their parameters, see [GA4] Recommended Events. Configuring the Google Analytics 4 Tag Go to the tag marketplace and add the Google Analytics 4 tag. For information on adding a tag, see Tags. After adding the tag, configure the following settings: Measurement ID Measurement ID of the Google Analytics property for which you want to send data. The measurement ID begins with "G-". For example, G-12345678M . Use a comma-separated list of measurement IDs to send data for multiple GA4 properties. Global Object The name of the Global Object used for the event queue. If not specified, gtag is used. Not required for most implementations. Data Layer Name By default, the data layer initiated and referenced by the global site tag is named dataLayer . Rename the data layer only if your project requires a separate name. Send Page View By default, Page View events are automatically recorded for each page on your site. If you do not want to send Page View events to Google Analytics, set this option to false. Clear Vars Clears items usually set for the lifetime of the tracker after each tracking request. Page View Events with Custom Parameters Page view events are automatically sent by the GA4 tag, which means no additional data can be sent with these events. However, you can set Send Page View to False, then map a page view event that is triggered when tealium_event = view and send custom parameters with that event. Other automatic events can be disabled in the GA4 interface. Items Parameter for Recommended Events Some travel events and retail and ecommerce events have an items parameter. For these events, the items array is automatically populated from E-commerce Extension values, such as product name, category, and price. For more information, see E-commerce Extension. Custom Events If you are using Google Universal Analytics and have custom events and dimensions you want to use with GA4, these custom events need to be reconfigured for GA4 due to differences in the event structure for Univeral Analytics and GA4. GA4 is event-based and requires data to be mapped to event parameters. For more information, see Migrating from Universal Analytics to Google Analytics 4. 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. Mapping Custom Events Before creating a custom event, make sure there are no automatically generated events or recommended events for your use case. If you create a custom event, it does not appear in the default GA4 reports. You need to set up custom reports that include custom events. To create a custom event, you typically map a data layer variable that captures event names. The example shown here uses  tealium_event . The Trigger is the value of that data layer variable that corresponds to the event you want to track. The Custom Name is the GA4 custom event name. For example, if your data layer has the following custom event: var utag_data = { "tealium_event" : "my_event_name" }; Then the mapping for GA4 would look like this: Mapping Form Submit Events Mapping form submit events is similar to mapping a custom event. For example: Google Analytics 4 Variables Available for Mapping The following sections list the GA4 variables by the categories in the Data Mappings tab of the Tag Configuration dialog. Standard Variable Description measurement_id Measurement ID clear_global_vars Boolean Clear Vars cookie_domain (config.cookie_domain) cookie_expires (config.cookie_expires) [Integer] cookie_prefix (config.cookie_prefix) cookie_update (config.cookie_update) [Boolean] cookie_flags (config.cookie_flags) send_page_view (config.send_page_view) [Boolean] Allow Advertising Features (config.allow_google_signals) [Boolean] Allow Advertising Personalizations (config.allow_ad_personalization_signals) [Boolean] Transport Type (config.transport_type) page_title (config.page_title) page_location (config.page_location) page_path (config.page_path) cookie_name (config.cookie_name) Campaign Id (config.campaign.id) Campaign Name (config.campaign.name) Campaign Source (config.campaign.source) Campaign Medium (config.campaign.medium) Campaign Content (config.campaign.content) Campaign Term/Keyword (config.campaign.term) Optimize Container ID (config.optimize_id) Use AMP Client ID (config.use_amp_client_id) [Boolean] Sample Rate (config.sample_rate) Site Speed Sample Rate (config.site_speed_sample_rate) User ID (customer_id) (Overrides _ccustid) Client ID (config.client_id) Event Variable Description Event Category (event.event_category) Event Label (event.event_label) Event / Timing Value (value) Timing Variable Name (name) Exception Description (description) Exception Fatal (fatal) [Boolean] Search Term (search_term) Method (method) Content Type (content_type) Content ID (content_id) Destination (destination) Start Date (start_date) [YYYYMMDD] End Date (end_date) [YYYYMMDD] Custom Event Data (event.custom) Non-Interaction (event.non_interaction) Override Default Routing (event.send_to) Event Callback (event.event_callback) Event Triggers Variable Description exception exception generate_lead generate_lead join_group join_group login login Page View page_view screen_view screen_view search search select_content select_content share share sign_up sign_up timing_complete timing_complete add_payment_info add_payment_info add_shipping_info add_shipping_info add_to_cart add_to_cart add_to_wishlist add_to_wishlist begin_checkout begin_checkout purchase purchase refund refund remove_from_cart remove_from_cart select_item select_item select_promotion select_promotion view_cart view_cart view_item view_item view_item_list view_item_list view_promotion view_promotion earn_virtual_currency earn_virtual_currency level_end level_end level_start level_start level_up level_up post_score post_score spend_virtual_currency spend_virtual_currency tutorial_begin tutorial_begin tutorial_complete tutorial_complete unlock_achievement unlock_achievement Custom Event customEvent Game Variable Description Achievement Id (achievement_id) Character (character) Group Id (group_id) Item Name (item_name) Level (level) Level Name (level_name) Score (score) Success (success) Virtual Currency Name (virtual_currency_name) Virtual Currency Value (value) App / Screen Tracking Variable Description Screen Name (screen_name) Application Name (config.app_name) Application ID (config.app_id) Application Version (config.app_version) Application Installer ID (config.app_installer_id) Enhanced E-Commerce Variable Description Order ID (order_id) (Overrides _corder) Order Total (order_total) (Overrides _ctotal) Shipping Amount (order_shipping) (Overrides _cship) Tax Amount (order_tax) (Overrides _ctax) Store (order_store) (Overrides _cstore) 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 SKUs (product_sku) (Overrides _csku) [Array] List of Brands (product_brand) (Overrides _cbrand) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Sub Categories (product_subcategory) (Overrides _ccat2) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] List of Discounts (product_discount) (Overrides _cpdisc) [Array] List of Promotion Ids (product_promotion_id) [Array] List of Promotion Names (product_promotion_name) [Array] List of Creative Names (product_creative_name) [Array] List of Creative Slots (product_creative_slot) [Array] List of Location Ids (product_location_id) [Array] List of Indexes (product_index) [Array] List of Item List Names (product_item_list_name) [Array] List of Item List Ids (product_item_list_id) [Array] List of Affiliations (product_affiliation) [Array] IAB Transparency and Consent Framework v2 Variable Description Enable TCF Support (gtag_enable_tcf_support) (true/false) ... View more

This article describes how to set up the Exactag tag in your Tealium iQ Tag Management account.. In this article: Tag Tips Supports the E-Commerce extension for: Order ID Order Subtotal Order Total Order Coupon Code Customer ID Product ID Product Name Product Category Product Quantity Product Unit Price Conversion data automatically added when Order ID is present. Conversion data can be manually triggered by setting the Is Conversion Flag to true Additional data points can be added through the UI Add Custom Destination option Tag Configuration First, go to the tag marketplace and add the Exactag tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Campaign Code Your brand-specific Campaign Code 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 Code (campaign) Referrer URL (referrer) Host Domain (host) Site Path (site) Search Parameters (search) Site Group (sitegroup) Cross Device ID (crossid) Subid (subid) Is Conversion Flag (is_conversion) E-Commerce Variable Description Level Value (level) Customer Gender (customer_gender) Customer Type (customer_type) Order ID (order_id) (Overrides _corder) Revenue/Order Total (order_total) (Overrides _ctotal) Total Price/Sub Total (order_subtotal) (Overrides _csubtotal) Promo Code (order_coupon_code) (Overrides _cpromo) Cart or Order Type (order_type) (Overrides _ctype) Customer ID (customer_id) (Overrides _ccustid) List of Product IDs (product_id) (Overrides _cprod) [Array] List of Names (product_name) (Overrides _cprodname) [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 describes how to set up the Yahoo! Japan Site General Tag tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use mappings to override the standard configurations. You may enter more than one ID or Label in a comma-separated list. If you enter one ID and multiple Labels, you will trigger one call for each Label, each using the same ID. If you enter multiple IDs and a single Label, you will trigger a call for each ID, each using the same Label. If you enter multiple IDs and Labels for a single tag type, make certain the numbers of IDs and Labels match. In order to trigger a particular tag, set up the trigger condition in the Tag Types tab in the mapping toolbox. Supports these E-Commerce extension values: Order ID (_corder) Order Subtotal (_csubtotal) List of Product IDs (_cprod) List of Product Categories (_ccat) List of Product Quantities (_cquan) List of Product Prices (_cprice) Tag Configuration First, go to the tag marketplace and add the Yahoo! Japan Site General Tag tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Auto Tagging: Enable or disable auto tagging. Display Network Conversion IO: Enter you Yahoo! Japan Display Network (YDN) Conversion IO. Display Network Conversion Label: Enter your Yahoo! Japan Display Network (YDN) Conversion Label. Display Network Retargeting ID: Enter your Yahoo! Japan Display Network (YDN) Retargeting ID. Display Network Retargeting Label: Enter your Yahoo! Japan Display Network (YDN) Retargeting Label. Sponsored Search Conversion ID: Enter your Yahoo! Japan Sponsored Search (YSS) Conversion ID. Sponsored Search Conversion Label: Enter your Yahoo! Japan Sponsored Search (YSS) Conversion Label. Sponsored Search Retargeting ID: Enter your Yahoo! Japan Sponsored Search (YSS) Retargeting 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: Display Network (YDN) Conversion Variable Description Conversion IO (yahoo_ydn_conv_io) [String] Conversion Label (yahoo_ydn_conv_label) [String] Conversion Transaction ID (yahoo_ydn_conv_transaction_id) [String] Conversion Value (yahoo_ydn_conv_value) [String] Display Network (YDN) Retargeting Variable Description Retargeting ID (yahoo_retargeting_id) [String] Retargeting Label (yahoo_retargeting_label) [String] Retargeting Page Type (yahoo_retargeting_page_type) [String] Retargeting Items (yahoo_retargeting_items) [Array] Category ID (category_id) (Overrides _ccat) [Array] Item ID (item_id) (Overrides _cprod) [Array] Price (price) (Overrides _cprice) [Array] Quantity (quantity) (Overrides _cquan) [Array] Sponsored Search (YSS) Conversion Variable Description Conversion ID (yahoo_conversion_id) [String] Conversion Label (yahoo_conversion_label) [String] Conversion Value (yahoo_conversion_value) [String] Sponsored Search (YSS) Retargeting Variable Description Retargeting ID (yahoo_ss_retargeting_id) [String] Custom Params (yahoo_sstag_custom_params) E-Commerce Variable Description Order ID (order_id) (Overrides _corder) [String] Sub Total (order_subtotal) (Overrides _csubtotal) [String] List of Product Categories (product_category) (Overrides _ccat) [Array] List of Product IDs (product_id) (Overrides _cprod) [Array] List of Product Quantities (product_quantity) (Overrides _cquan) [Array] List of Product Prices (product_unit_price) (Overrides _cprice) [Array] Tag Types Variable Description Display Network Conversion yjad_conversion Display Network Retargeting yjad_retargeting Sponsored Search Conversion yss_conversion Sponsored Search Retargeting yss_retargeting Custom Custom Type-Specific Parameters Variable Description Conversion IO (yahoo_ydn_conv_io) yahoo_ydn_conv_io Conversion Label (yahoo_ydn_conv_label) yahoo_ydn_conv_label Conversion Transaction ID (yahoo_ydn_conv_transaction_id) yahoo_ydn_conv_transaction_id Conversion Value (yahoo_ydn_conv_value) yahoo_ydn_conv_value Retargeting ID (yahoo_retargeting_id) yahoo_retargeting_id Retargeting Label (yahoo_retargeting_label) yahoo_retargeting_label Retargeting Page Type (yahoo_retargeting_page_type) yahoo_retargeting_page_type Retargeting Items (yahoo_retargeting_items) yahoo_retargeting_items Item ID (item_id) item_id Category ID (category_id) category_id Price (price) price Quantity (quantity) quantity Conversion ID (yahoo_conversion_id) yahoo_conversion_id Conversion Label (yahoo_conversion_label) yahoo_conversion_label Conversion Value (yahoo_conversion_value) yahoo_conversion_value Retargeting ID (yahoo_ss_retargeting_id) yahoo_ss_retargeting_id Custom Parameters (yahoo_sstag_custom_params) yahoo_sstag_custom_params Custom Parameter Custom_Parameter Display Network (YDN) Conversion yjad_conversion Display Network (YDN) Retargeting yjad_retargeting Sponsored Search (YSS) Conversion yss_conversion Sponsored Search (YSS) Retargeting yss_retargeting Custom Tag Type Custom_Type ... View more

Learn about the new features and fixes released in January 2021. Tags New/Cool Stuff New marketplace tag: Exactag (Learn more) New marketplace tag: Yahoo! Japan Site General (Learn more) Introduced the beta version of the Google Analytics 4 (gtag.js) tag. (Learn more) Updated the Google Analytics (gtag.js) tag to add support for adding or removing multiple items from cart. Added Custom Dimension and Session ID support for the Decibel Insight tag. Updated URL configuration data overrides for the Piwik Pro tag. Added new tag configuration fields and data mappings for the Webtrakk tag, deprecated the heatmap and safetag parameters, and updated to version 4.5.3. Updated the Adobe Experience Platform Web SDK to Version 2.3.0. Updated the AT Internet tag to add support for privacy methods and updated the hosted template to include version 5.27.0 of the AT Internet library. Updated the Criteo OneTag to remove the tag tip indicating that the retailer visitor ID and email are required. Connectors New/Cool Stuff Updated the Google Customer Match connectors to add a clickwrap agreement and an addendum to the MSA for Google Match. Deprecated the Insightly connector and replaced with the Insightly CRM connector, which preserves previous functionality and also allows multiple tag names to be sent per API request. (Learn more) Fixes Added an authorization cache layer and updated the API authentication error messaging for the Salesforce (Classic SOAP) connectors. iQ Tag Management New/Cool Stuff Released new Getting Started guide for web developers. (Learn more) Fixes Corrected an issue where, when performing a global search for a load rule, the results did not direct users to the selected search item. Corrected an issue causing an unrecognized expression error when searching for data layer variables. Corrected an issue where custom environments were not displaying in the Publish Location filters drop-down list. Corrected an issue that allowed users to move extensions out of their scope restrictions. Corrected issue to ensure that, when viewing a profile with inherited tags and extensions, you can view and filter items by publish location in the profile to ensure a clear view of where tags and extensions are published and to what environment. Corrected an issue in Load Order Manager that erroneously displayed special characters in tag titles. Corrected issue in Load Order Manager where the Publish history displayed as empty when the user reordered items prior to saving and publishing. Customer Data Hub New/Cool Stuff New data source: Adobe Launch (Learn more) The number attribute now supports two numeric value types: decimal or integer. (Learn more) Removed the estimated time remaining progress bar from the Audience Sizing interface and changed the same-day date range query from midnight to 11:59 PM. Applied usability enhancements to the Audience Sizing interface and the timing of the tool tip display when the user hovers over the Venn diagram. Enhanced filtering functionality for unpublished feeds in Live Events to improve the ability to filter EventStream data for use in debugging tasks. Updated messaging on the Usage Reports screen to more accurately reflect billing for volume and usage. Applied error messaging enhancements to the search feature in the Manage Users screen. Fixes Corrected an issue in EventStream that caused the query string parameters from a Tealium Collect call to be ignored. Installations New/Cool Stuff Mobile Android Released Tealium for NativeScript, a set of cross-platform classes that interface with the native Tealium iOS and Android SDKs. (Learn more) Added the option to expire consent user preferences in Kotlin. (Learn more) Added crash reporting module for Kotlin. (Learn more) Added support for the Ad Identifier module in Kotlin. (Learn more) Added a public API method to reset and regenerate the Tealium Visitor ID in Kotlin. Enhanced the user experience when working with Tealium and Adobe visitor services. Added a module to interface with the Adobe visitor service from the Tealium SDK. Swift Added a public API method to reset and regenerate the Tealium Visitor ID in Swift. (Learn more) ... View more

Learn about the new features and fixes released in December 2020. Tags New/Cool Stuff New marketplace tag: Microsoft Clarity Updated the Movable Ink tag to allow users to input a subdomain. Added Tealium Trace ID support for the Krux Cookie Matching tag. (Learn more) Added event-specific parameters to the Kochava Remote Command tag. (Learn more) Added support for Version 5.1.1 of the Adobe Visitor API for JavaScript. (Learn more) Updated the Data Integration Library for Adobe Audience Manager to Version 9.5. (Learn more) Added support for Adobe Target, Version 2.3.3. (Learn more) Fixes Corrected an issue where viewTrigger calls were made too early for Adobe Target Versions 2.2.0 through Version 2.3. Connectors New/Cool Stuff New marketplace connector: Agillic Recipients (Learn more) New marketplace connector: Snapchat Audience Match (Learn more) The legacy Snapchat connector is supported but no longer available to new users in the connector marketplace. (Learn more) Fixes Corrected issue that reduced the size of field widths in mapping drop-down menus when using the Safari browser in connector configuration screens. Corrected issue with the HTTP API - Flattened data source to correctly view incoming events and enrichment data in Trace. Corrected issue with the Salesforce Standard Objects connector where required properties for standard objects displayed in an optional section. Updated the Braze connector to ensure that empty user attribute values are converted to null and and then removed from Braze user profile. iQ Tag Management New/Cool Stuff You can now click a library label in a profile to quickly switch to another library for which you have appropriate permissions. Consent Manager CCPA templates are now available in the Template Status Checker when CCPA is enabled and active. (Learn more) Applied enhancements to the manner in which templates are saved in profiles and libraries. (Learn more) Fixes Corrected an issue where some users were not able to view the "X" to quickly remove a tag from a tag-scoped extension. Corrected an issue where Consent Manager v3.0.8 did not check to ensure that Consent Manager was active in instances where partial consent was granted. Corrected a scrolling issue that occurred when viewing Load Order Manager screens. Customer Data Hub New/Cool Stuff Updated the Trace testing and inspecting tool to display date formats using international date formatting standards. (Learn more) Updated the Edit Users screens to offer an optional slide-out panel that walks the user through the workflow. (Learn more) Installations New/Cool Stuff Mobile Android Added module to interface with the Adobe visitor service from the Tealium SDK. Added the option to support consent expiration in Kotlin user preferences. Added ProGuard rules to new Kotlin library to minify and obfuscate specified classes. Added Crash Reporter module to Kotlin. Swift Added NativeScript integration support to Swift library for mobile SDKs. ... View more

This article describes how to set up the Snapchat connector in your Customer Data Hub account. This connector is now deprecated and no longer available in the tag marketplace. For information about the Snapchat Audience Match connector with Tealium-provided credentials, see Snapchat Audience Match Connector Setup Guide . In this article: Table of Contents Placeholder Snap Audience Match (SAM)  allows you to a nonymously match data from your existing contacts (e-mail or device ID) with our community. Connector Actions Action Name AudienceStream EventStream Add User to Custom Audience ✓ ✓ Remove User from Custom Audience ✓ ✓ Configure Settings Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector. After adding the connector, configure the following settings: Client ID To obtain app credentials, request access to the Snapchat Marketing API at Apply for Access to the Snapchat Marketing API. Once you have applied, you will be able to create an OAuth app and get the client_id and client_secret  from (Business Manager) at https://business.snapchat.com under the Billing and Payments section for your organization. Your authorized redirect URIs must be configured to allow redirect URI: https://my.tealiumiq.com/oauth/webhook/callback.html  or if you are using SSO: https://sso.tealiumiq.com/oauth/webhook/callback.html Client Secret See Client ID. Ensure pop-ups are not blocked, and click Establish Connection. Login to your account and confirm access. Once granted, ensure to save your Customer Data Hub profile. When navigating through the connector configuration flow, ensure that you save your Customer Data Hub profile to save your changes. Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. Action - Add User to Custom Audience Parameters Parameter Description Audience ID The audience ID can be found after clicking on the audience within the Audience Library in Snap Ad Manager. User Identifier - Email Plain Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action Snapchat API reference User Identifier - Email Already Hashed - SHA256 Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference User Identifier - Mobile Plain Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference User Identifier - Mobile Already Hashed - SHA256 Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference Action - Remove User from Custom Audience Parameters Parameter Description Audience ID The audience ID can be found after clicking on the audience within the Audience Library in Snap Ad Manager. User Identifier - Email Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference User Identifier - Email Already Hashed - SHA256 Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference User Identifier - Mobile Plain Only configure one user identifier. The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference User Identifier - Mobile Already Hashed - SHA256 Only configure one user identifier The API supports matching via email or mobile identifier. Only use one identifier (either email or mobile ad id) per action. Snapchat API reference ... View more

This article describes how to set up the Braze connector in your Customer Data Hub account. In this article: Table of Contents Placeholder Connector Actions Action Name AudienceStream EventStream Track User ✓ ✓ Delete User ✓ ✓ Consent Categories Analytics Mobile Personalization Configure Settings Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector. After adding the connector, configure the following settings: API Endpoint Required. Select API endpoint for the instance your account is provisioned to. For more information, see API Endpoints. API Key Required. Provide API key with "users.track" and "users.delete" permissions enabled. Use Authentication to ensure that your API key is valid. For more information, see App Group REST API Keys. For additional information see Braze Documentation Braze Technology Partners: Tealium. Action Settings - Parameters and Options Click Next or go to the Actions tab. This is where you configure connector actions. This section describes how to set up parameters and options for each action. The Track User action contains functionality that is the same for AudienceStream and EventStream. As a best practice, Tealium recommends using User Attribute features with AudienceStream and Event and Purchase features with EventStream. Use cases that do not fit these criteria may ignore this best practice. Action - Track User Tealium recommends mapping all User ID parameters for this section. When an action triggers, Tealium evaluates which User IDs to send to Braze for the best performance. When multiple IDs provided, the first non-blank values is selected based on the following priority order: User ID Parameters (Required) External ID Braze ID Alias Name Alias Label For more information, see vendor documentation for User Track. Batch Limits This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met: Max number of requests: 75 Max time since oldest request: 10 minutes Max size of requests: 1 MB Parameter Description External ID External ID of the user to be tracked. When importing Push Tokens, External ID and Braze ID should not be specified. Braze ID Braze ID of the user to be tracked. When importing Push Tokens, External ID and Braze ID should not be specified. User Alias Name The alias name of the user to be tracked. When specifying a user alias, Alias Name and Alias Label should both be set. User Alias Label The alias label of the user to be tracked. When specifying a user alias, Alias Name and Alias Label should both be set. User Attributes Parameters (Optional) Tealium recommends using the Braze best practice of sending only changed user attributes and avoiding sending unchanged attributes. You can do this using Visit and Visitor attribute enrichments and rules that recognize when an attribute has changed. For more information, see Enrichment Rules. Parameter Description Country The country of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Current Location - Latitude The current latitude for the user to be tracked Empty values are converted to null and removed from the Braze user profile.. Current Location - Longitude The current longitude for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Date of First Session The date of the first session of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Date of Last Session The date of the last session of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Date of Birth The date of birth for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Email Address The email address for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Email Subscription Status The email subscription status for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Facebook The Facebook account for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. First Name The first name of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Gender The gender of the user to be tracked. Values are Male (m) or Female (f). Empty values are converted to null and removed from the Braze user profile. Home City The home city for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Image URL Optional The URL for the user's image. Empty values are converted to null and removed from the Braze user profile. Language The language preference of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Last Name The last name of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Marked Email As Spam At User marked email as spam. Empty values are converted to null and removed from the Braze user profile. Phone Number The telephone number of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Push Subscription Status The Push Subscription status of the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Push Tokens ID Array Array. The Push Token ID for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Push Tokens Array Push tokens array. Empty values are converted to null and removed from the Braze user profile. Push Tokens Device ID Array The Push Token Device ID for the user's device. Empty values are converted to null and removed from the Braze user profile. Time Zone The time zone for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Twitter The Twitter account for the user to be tracked. Empty values are converted to null and removed from the Braze user profile. Update Existing Only (Users) Optional Values are true or false. If no user value exists, one is created by default. If set to true, only existing users are updated and no new users are created. Empty values are converted to null and removed from the Braze user profile. Modify User Attribute Parameters (Optional) Parameter Description Modify User Attributes Increment Integer attributes by positive or negative integers. Modify Array attributes by adding or removing values from existing arrays. Event Parameters (Optional) To map data for events, you must map a value for the Braze event name. If the Tealium and Braze event names are not mapped, no data is sent to Braze. Parameter Description App ID The User App ID to be tracked. Name Required The application name to be tracked. Time Time Update Existing Only (Events) Optional Values are true or false. If no event value exists, one is created by default. If set to true, only existing events are updated and no new events are created Map Array type attributes to add multiple events. Array type attributes must be of equal length. Single value attributes can be used and will apply to each event. Purchase Parameters (Optional) To map data for purchases, you must map the values for Product ID, Currency, and Price. Example: The following code sample shows a Braze best practice example for receiving a single Tealium purchase event containing purchases for multiple products: // event to Tealium: { [...] "tealium_event": "purchase, "product_name": ["Backpack","Pencil","Notebook"], "product_quantity": [1,5,3], "product_category": ["Travel","Office","Office"], "product_price": [39.95,1.99,3.99], "order_currency": "USD" } Map the corresponding product arrays to Braze as follows: product_name > Product ID product_quantity > Quantity product_price > Price The results of this example sends the following purchases object to Braze, representing each product accordingly: // payload to Braze via Tealium Connector: { "purchases": [ { "external_id" : "user1", "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad", "product_id" : "Backpack", "currency" : "USD", "price" : 39.95, "time" : "2013-07-16T19:20:30+01:00", }, { "external_id" : "user1", "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad", "product_id" : "Pencil", "currency" : "USD", "price" : 1.99, "time" : "2013-07-16T19:20:30+01:00", }, { "external_id" : "user1", "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad", "product_id" : "Backpack", "currency" : "USD", "price" : 3.99, "time" : "2013-07-16T19:20:30+01:00", } ] } Parameter Description App ID The Event Application ID to be tracked. Product ID Required for every mapped purchase. Currency Required for every mapped purchase. Price Required for every mapped purchase. Quantity Map Array type attributes to add multiple purchase items. Array type attributes must be of equal length. Purchase Time Time of purchase. Automatically set to "now" unless explicitly mapped. Update Existing Only (Purchases) Optional Values are true or false. If no purchase value exists, one is created by default. If set to true, only existing purchases are updated and no new purchases are created. Map Array type attributes to add multiple events. Array type attributes must be of equal length. Single value attributes can be used and will apply to each event. Action - Delete User Parameters Parameter Description External ID Required Must be mapped. External ID of the user to delete. When multiple IDs are specified, the first non-blank values is selected based on the following priority order: External ID Braze ID Alias Name Alias Label For more information, see User Delete Endpoint. Braze ID Required Must be mapped. Braze ID of the user to delete. When multiple IDs are specified, the first non-blank values is selected based on the following priority order: External ID Braze ID Alias Name Alias Label Must include either External ID or Braze ID. User Alias Name Required The alias name of the user to be deleted. When specifying a user alias, Alias Name and Alias Label should both be set. For more information, see User Delete Endpoint. User Alias Label Required The alias label of the user to be deleted. When specifying a user alias, Alias Name and Alias Label should both be set. Frequently Asked Questions How does this connector complement or replace other Braze integrations with Tealium? In addition to the Track User API, Braze has additional data collection methods, both of which support mapping of user attributes in Braze. Tealium supports Braze SDKs for Web and Native Mobile in the following two independent, but similar integrations: Braze Web SDK Tag Setup, Braze Initial SDK Setup Tealium Remote Command for Braze on Android and iOS/Swift (Learn more) These integrations are alternative methods used for Braze to collect user behavior data that is similar to the data collected by the Events and Purchases features of the Braze connector. ... View more