Tealium Learning Center

Summary The Tealium Cartridge lets marketers manage tagging requirements by themselves via a single line of code and an intuitive web interface – no IT resources required. Unlike other solutions that favor a code-centric approach, Tealium delivers easy-to-use templates that require no JavaScript knowledge. This makes it easy to add, edit or remove any digital marketing vendor tag within seconds. Tealium is designed from the ground up to help marketers be more agile and efficient. With the basic installation of the Tealium Cartridge, Tealium automatically gathers a rich set of visitor event data, including content navigation, search tracking, product viewing, checkout and order tracking, all without any further customization. The Tealium Cartridge will unlock the full potential of a marketer’s vendor tag suite by shifting much of the effort from server-side Commerce Cloud implementations to the simple Tealium client-side console. The Tealium Cartridge requires a Tealium subscription. Use Cases With the basic installation of the Tealium Cartridge, Tealium automatically gathers a rich set of visitor event data, including content navigation, search tracking, product viewing, checkout and order tracking, all without any further customization. Then, Tealium iQ unlocks the potential of the marketer by providing seamless and complete vendor tag integration without the need for IT resources, or Commerce Cloud Storefront changes. Setup Follow these directions to integrate the Tealium Cartridge into your Commerce Cloud Storefront. These steps are based on a standard Site Genesis storefront. Import the Tealium cartridge into the Commerce Cloud Studio Workspace: Open Commerce Cloud Studio.. Click File > Import > General > Existing Projects Into Workspace. Browse to the “int_tealium” directory. Click Finish. Click OK when prompted to link the cartridge to the sandbox. Import the Custom Site Preferences into the Commerce Cloud Business Manager. Log into the Commerce Cloud Business Manager. Click Administration > Site Development > Import & Export. Click Upload. Browse for the Tealium_Meta.xml file:   ./int_tealium/metadata/Tealium_Meta.xml   Click the << Back button at the bottom of the page. Click Import. Select the Tealium_Meta.xml file. Click Next. Click Import. Configure Tealium Custom Preferences using the Commerce Cloud Business Manager Log into the Commerce Cloud Business Manager for each site onto which Tealium is to be configured: Select the correct site from the tabs across the top of the page. Click Merchant Tools > Site Preferences > Custom Preferences > Tealium. Fill in the Site Preferences as directed by Tealium. Parameter values will be provided by Tealium during implementation. For Tealium Environment use “dev”, “qa”, or “prod” (i.e. use “dev” for Sandbox/Development Instances). Check the box to enable this integration and click Apply near the bottom of the page. Append the Tealium Cartridge to the Effective Cartridge Path. Log into the Commerce Cloud Business Manager on the Staging Server Click Administration > Sites > Manage Site for each site listed and the Business Manager Site: Select the site from the list. Click the Settings tab. Append ":int_tealium" to the "Cartridges:" field. Click Apply. Include the Tealium footer code in footer.isml Open Commerce Cloud Studio. Open storefront "footer" file: /cartridge/templates/default/components/footer/​pageFooter.isml   Place the following text in this file: <isinclude url="${URLUtils.url('Tealium_utag-RenderTealium', 'title', request.pageMetaData.title, 'pagecontexttype', ('pageContext' in this && !empty(pageContext)) ? ''+pageContext.type : null, 'pagecontexttitle', ('pageContext' in this && !empty(pageContext)) ? ''+pageContext.title : null, 'searchterm', request.httpParameterMap.q.stringValue, 'searchresultscount', (!empty(pdict.productSearch) ? ''+pdict.productSearch.count : null), 'productid', (!empty(pdict.product) && !empty(pdict.product.id) ? ''+pdict.product.id : null), 'pagecgid', request.httpParameterMap.cgid.stringValue, 'orderno', (!empty(pdict.order) ? pdict.order.orderNumber : null) )}"/> A few Commerce Cloud templates (.isml files) need to be updated to include pageContext object: Open Commerce Cloud Studio. Open storefront file: /cartridge/templates/default/cart/​cart.isml . Add this line towards the top of the template: <isscript>var pageContext={title:'Cart', type:'cart', ns:'cart'};</isscript> Open storefront file: /cartridge/templates/default/checkout/​checkout.isml . Add this line towards the top of the template: <isscript>var pageContext={title:'Checkout',type:'checkout',ns:'checkout'};</isscript> Open storefront file: /cartridge/templates/default/account/order/​history.isml . Add this line towards the top of the template: <isscript>var pageContext={title:'OrderHistory',type:'orderhistory',ns:'orderhistory'};</isscript> Configuration Be sure to configure the proper Tealium account and Tealium profile in the Tealium settings, as specified in steps 3 from the Setup section above. No other Commerce Cloud configuration required. Discuss with your Tealium Account Manager on how to customize your marketing tags using Tealium iQ. Custom Code For the basic integration, no custom code beyond the Setup steps defined above are required. Compatibility For legacy installations before the latest SFRA updates, view and download the older versions in GitHub found here: ​https://github.com/Tealium/integration-demandware/releases External Interfaces The Tealium iQ console can now be used to manage your marketing tags, without requiring IT intervention. Please see your Tealium Account Manager for more details. Privacy, Payment The Tealium Cartridge is designed to collect the same level of user behavior as that of traditional web analytics vendors. The Tealium Cartridge can be customized to increase or decrease the level of data collected in order to fully respect the privacy policy of the Commerce Cloud client. Support Please contact your Tealium Account Manager for any needed support. Testing Once deployed, the most effective test to ensure a proper deployment is to view the page source of your storefront from within your browser. Your footer should now contain a JSON structure set to a variable named utag_data . Simply search for this variable for confirmation. There is an additional script to include the utag.js file just below this. The script block on every page will be as follows. The Tealium ACCOUNT, PROFILE and ENVIRONMENT values should match what was configured in Setup - Step 3. <script type="text/javascript"> (function(a,b,c,d){ a='//tags.tiqcdn.com/utag/​ACCOUNT​/​PROFILE​/​ENVIRONMENT​/utag.js'; b=document;c='script';d=b.createElement(c); d.src=a;d.type='text/java'+c;d.async=1; a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a); })(); </script> Home Page On the Home page, the data layer is minimal. <script type="text/javascript"> var utag_data = { "page_name": "SiteGenesis Online Store", "page_type": "content", "page_context_type": "storefront", "page_context_title": "storefront", "user_anonymous": "true", "user_authenticated": "false", "user_registered": "false", "customer_id": "abZAaNVUFZJNZz7PUAZrRjr1E5" }; </script> Search Results Page Search results page adds new data points “search_results” (count) and “search_term” (keyword) used. <script type="text/javascript"> var utag_data = { "page_name": "Sites-SiteGenesis-Site", "page_type": "search", "page_context_type": "search", "page_context_title": "product search results", "user_anonymous": "true", "user_authenticated": "false", "user_registered": "false", "customer_id": "abZAaNVUFZJNZz7PUAZrRjr1E5", "search_results": "7", "search_term": "suit" }; </script> Product Detail Page On the “Product Detail” page, we expect page_type as “product.” The “product_XX” array values all have a single string value. Note that a “null” string value may indicate product catalog database is incomplete in Commerce Cloud. These values below are sample values. Most likely only page_type and page_context_type will be the same for your site. <script type="text/javascript"> var utag_data = { "page_name": "Platinum Blue Stripes Easy Care Fitted Shirt ", "page_type": "product", "page_context_type": "product", "page_context_title": "platinum blue stripes easy care fitted shirt", "user_anonymous": "true", "user_authenticated": "false", "user_registered": "false", "customer_id": "abZAaNVUFZJNZz7PUAZrRjr1E5", "product_id": [ "008884303989" ], "product_sku": [ "null" ], "product_name": [ "Platinum Blue Stripes Easy Care Fitted Shirt " ], "product_brand": [ "null" ], "product_category": [ "womens-clothing-tops" ], "product_unit_price": [ "75.00" ] }; </script> View Cart Page This shows multiple product-specific coupons applied to both items in the cart. Discount is total discounted amount for all items of same product id. <script type="text/javascript"> var utag_data = { "page_name": "Sites-SiteGenesis-Site", "page_type": "checkout", "page_context_type": "cart", "page_context_title": "cart", "user_anonymous": "true", "user_authenticated": "false", "user_registered": "false", "customer_id": "abZAaNVUFZJNZz7PUAZrRjr1E5", "coupon_codes": ["FIVEOFF"], "product_id": [ "750518894553", "sanyo-dp50747" ], "product_sku": [ "null", "null" ], "product_name": [ "Charcoal Single Pleat Wool Suit", "Sanyo 50\" LCD High Definition Television" ], "product_brand": [ "null", "Sanyo" ], "product_category": [ "mens-clothing-suits", "electronics-televisions-flat-screen" ], "product_unit_price": [ "299.99", "2996.25" ], "product_quantity": [ "1", "5" ], "product_coupon_discount": [ "-5", "-25" ], "product_coupon_promo": [ "FIVEOFF", "FIVEOFF" ] }; Order “Thank You” Page Order Thank You page shows the details about the order and adds all values beginning “order_”. This data layer also includes all of the items that were purchased. The “product_” arrays should have the same number of items in each array and each item corresponds to the item in the same position in the other arrays. <script type="text/javascript"> var utag_data = { "page_name": "confirmation", "page_type": "checkout", "page_context_type": "orderconfirmation", "page_context_title": "order confirmation", "user_anonymous": "true", "user_authenticated": "false", "user_registered": "false", "customer_id": "abZAaNVUFZJNZz7PUAZrRjr1E5", "order_id": "00000451", "order_discount": "0.00", "order_subtotal": "75.00", "order_tax": "4.05", "order_shipping": "5.99", "order_payment_type": "BML", "order_total": "85.04", "order_currency": "USD", "order_postal_code": "92868", "product_name": [ "Platinum Blue Stripes Easy Care Fitted Shirt " ], "product_brand": [ "null" ], "product_unit_price": [ "75" ], "product_sku": [ "null" ], "product_id": [ "008884304023" ], "product_category": [ "womens-clothing-tops" ], "product_quantity": [ "1" ], "product_coupon_discount": [ "0" ], "product_coupon_promo": [ "" ] }; </script> Order History Page Order History shows the details about previous or outstanding orders. This data layer should *not* include all of the items that were previously purchased. <script type="text/javascript"> var utag_data = { "page_name": "Sites-SiteGenesis-Site", "page_type": "content", "page_context_type": "orderhistory", "page_context_title": "order history", "user_anonymous": "false", "user_authenticated": "true", "user_registered": "true", "customer_id": "adtkksWZjpbo9fdawQex7njjMb", "customer_email": "xxxxxxxxxx@yahoo.com" }; </script>   ... View more

This article describes how to set up the Google Analytics (gtag.js) tag in your Tealium iQ Tag Management account. Google Analytics provides APIs to collect, configure, and report on user-interactions with your online content. Using gtag.js lets you benefit from the latest tracking features and integrations as they become available. In this article: Table of Contents Placeholder Tag Tips Use mappings to: Dynamically override the E-Commerce extension values Setup event triggers Add custom Metrics, Dimensions, and Content Groups Replace cst in custom event variables with your desired event name Supports the following E-Commerce extension values:  Order ID Order Total Shipping Amount Tax Amount Store Promo Code Customer ID List of Product IDs List of Names List of Brands List of Categories List of Prices List of Quantities List of Discounts Tag Configuration First, go to Tealium's tag marketplace and add the Google Analytics (gtag.js) tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Tracking ID Tracking ID of the Google Analytics property to which you want to send data Example: UA-12345678-1 Use a comma-separated list to send data for multiple 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. Cross-Tracking Domains A comma-separated list of domains to use with Cross-Domain Tracking ( setAllowLinker ). To use this list, Cross-Domain Tracking must be set to true. Should be the top level domain, such as tealiumiq.com. Cross-Domain Tracking Sets the value for setAllowLinker and enables the cross-domain tracking plugin. To use this feature, one or more domains must be specified in the "Cross-Tracking Domains" field or be mapped to crossDomainTrack . Display Advertising Features Enables Google Analytics to collect data about your traffic via the Google Ad Manager (DoubleClick) cookie, in addition to data collected through the standard Google Analytics implementation. Enhanced Link Attribution If unsure, use the default value (false). Google Analytics provides enhanced link attribution to improve the accuracy of report data by: Automatically differentiating between multiple links to the same URL on a single page. Using link element IDs. Track Screen Views Enables App/Screen tracking. When enabled, a separate screenview request is sent after the initial pageview. Anonymize IP Tells Google Analytics to anonymize the information sent by the tracker objects by removing the last octet of the IP address prior to its storage. Slightly reduces the accuracy of geographic reporting. Clear Vars Clears items usually set for the lifetime of the tracker after each tracking request. Optimize Container ID Sets the optimize_id and enables the Google Optimize plugin. This ID is found in your Optimize accounts page. Example: GTM-XXXXXX Use AMP Client ID The Google AMP Client ID allows you to uniquely identify users that engage with your content on AMP and non-AMP pages. If you opt-in, Google Analytics uses the AMP Client ID to determine that multiple site events belong to the same user when those users visit AMP pages via a Google AMP viewer. Data Layer Name By default, the data layer initiated and referenced by the global site tag is named dataLayer . Only rename the data layer if your project requires a separate name. 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 tracking_id Tracking ID Tracking ID of the Google Analytics property to which you want to send data Example: UA-12345678-1 Use a comma-separated list to send data for multiple properties. config.page_title Page Title config.page_location Page Location config.page_path Page Path config.cookie_name Cookie Name config.cookie_domain Cookie Domain config.cookie_expires Cookie Expires config.linker.accept_incoming Boolean Cross-Domain Tracking Sets the value for setAllowLinker and enables the cross-domain tracking plugin. To use this feature, one or more domains must be specified in the "Cross-Tracking Domains" field or be mapped to crossDomainTrack . config.linker.domains Array Cross-Tracking Domains  A comma-separated list of domains to use with Cross-Domain Tracking ( setAllowLinker ). To use this list, Cross-Domain Tracking must be set to true. Should be the top level domain, such as tealiumiq.com. config.allow_display_features Boolean Display Advertising Features Enables Google Analytics to collect data about your traffic via the Google Ad Manager (DoubleClick) cookie, in addition to data collected through the standard Google Analytics implementation. config.link_attribution.cookie_name Link Attribution Cookie Name config.link_attribution.cookie_expires Link Attribution Cookie Expiration config.link_attribution.levels Link Attribution Levels config.campaign.id Campaign ID config.campaign.name Campaign Name config.campaign.source Campaign Source config.campaign.medium Campaign Medium config.campaign.content Campaign Content config.campaign.term Campaign Term/Keyword config.anonymize_ip Boolean Anonymize IP Tells Google Analytics to anonymize the information sent by the tracker objects by removing the last octet of the IP address prior to its storage. Slightly reduces the accuracy of geographic reporting. clear_global_vars Boolean Clear Vars  Clears items usually set for the lifetime of the tracker after each tracking request. config.optimize_id Optimize Container ID Sets the optimize_id and enables the Google Optimize plugin. This ID is found in your Optimize accounts page. Example: GTM-XXXXXX config.use_amp_client_id Boolean Use AMP Client ID The Google AMP Client ID allows you to uniquely identify users that engage with your content on AMP and non-AMP pages. If you opt-in, Google Analytics uses the AMP Client ID to determine that multiple site events belong to the same user when those users visit AMP pages via a Google AMP viewer. config.sample_rate Sample Rate config.site_speed_sample_rate Site Speed Sample Rate customer_id User ID Overrides _ccustid config.client_id Client ID Event Variable Description event_name Event Action event.event_category Event Category event.event_label Event Label event.value Event / Timing Value event.name Timing Variable Name event.description Exception Description event.non_interaction Non-Interaction event.fatal Boolean Fatal Error event.search_term Search Term event.method Method event.content_type Content Type event.content_id Content ID event.destination Destination event.start_date Start Date Date format is YYYYMMDD. event.end_date End Date <meta charset="utf-8" /> Date format is YYYYMMDD. event.custom Custom Event Data event.anonymize_ip Boolean Anonymize IP Tells Google Analytics to anonymize the information sent by the tracker objects by removing the last octet of the IP address prior to its storage. Slightly reduces the accuracy of geographic reporting. event.send_to Override Default Routing App / Screen Tracking Variable Description screen_view Boolean   Track Screen Views Enables App/Screen tracking. When enabled, a separate screenview request is sent after the initial pageview. event.screen_name Screen Name config.app_name Application Name config.app_id Application ID config.app_version Application Version IDconfig.app_installer_id  Application Installer  Content Groups Variable Description   content_group1 Content Group 1   content_group2 Content Group 2   content_group3 Content Group 4   content_group4 Content Group 4   content_group5 Content Group 5 Dimensions Variable Description dimension1 Dimension 1 dimension2 Dimension 2 dimension3 Dimension 3 dimension4 Dimension 4 dimension5 Dimension 5 dimension6 Dimension 6 dimension7 Dimension 7 dimension8 Dimension 8 dimension9 Dimension 9 dimension10 Dimension 10 dimension11 Dimension 11 dimension12 Dimension 12 dimension13 Dimension 13 dimension14 Dimension 14 dimension15 Dimension 15 dimension16 Dimension 16 dimension17 Dimension 17 dimension18 Dimension 18 dimension19 Dimension 19 dimension20 Dimension 120 -- Premium Dimension-- 0 dimension21 - dimension200 Dimension 21 through Dimension 100 Metrics Variable Description metric1 metric1 metric2 metric2 metric3 metric3 metric4 metric4 metric5 metric5 metric6 metric6 metric7 metric7 metric8 metric8 metric9 metric9 metric10 metric10 metric11 metric11 metric12 metric12 metric13 metric13 metric14 metric14 metric15 metric15 metric16 metric16 metric17 metric17 metric18 metric18 metric19 metric19 metric20 metric20 -- Premium Metric-- 0 metric21 - metric200 metric21 Enhanced E-Commerce Variable Description Checkout Step (checkout_step) [Number] Checkout Option (checkout_option) Currency (order_currency) (Overrides _ccurrency) Order ID (Transaction ID) (Overrides _corder) Value/Order Total (order_total) (Overrides _ctotal) Shipping Amount (order_shipping) (Overrides _cship) Tax Amount (order_tax) (Overrides _ctax) Affiliation/Store (order_store) (Overrides _cstore) Promo Code/Coupon (order_coupon_code) (Overrides _cpromo) User ID (customer_id) (Overrides _ccustid) List of IDs (product_id) (Overrides _cprod) [Array] List of Names (product_name) (Overrides _cprodname) [Array] List of Brands (product_brand) (Overrides _cbrand) [Array] List of Categories (product_category) (Overrides _ccat) [Array] List of Variants (product_variant) [Array] List of Prices (product_unit_price) (Overrides _cprice) [Array] List of Quantities (product_quantity) (Overrides _cquan) [Array] List of Discounts (product_discount) (Overrides _cdisc) [Array] List of Promo Codes/Coupons (product_promo_code) [Array] Product Action List (product_action_list) [Array] Product Position (product_list_position) [Array] Product Name (product_list_name) [Array] Enh E-Comm: Engagement Variable Description Product Impression ID (impression_id) [Array] Product Impression Name (impression_name) [Array] Product Impression Category (impression_category) [Array] Product Impression Brand (impression_brand) [Array] Product Impression Variant (impression_variant) [Array] Product Impression Price (impression_price) [Array] Product Impression List (impression_list_name) Product Impression Position (impression_list_position) [Array] Promotion ID (promo_id) [Array] Promotion Name (promo_name) [Array] Promotion Creative (promo_creative_name) [Array] Promotion Position (promo_creative_slot) [Array] ... View more

Here is a collection of debugging articles. Universal Tag (utag.js) How to Validate and Troubleshoot Tags Debugging utag.js and Console Output Debugging with Charles Proxy Mobile Mobile Troubleshooting ... View more

This article shows how to troubleshoot a mobile implementation of iQ Tag Management via the published file mobile.html. In this article: Table of Contents Placeholder Overview When you activate a mobile profile in Tealium iQ a file named mobile.html is published to the following path on the CDN: http://tags.tiqcdn.com/utag/ACCOUNT/PROFILE/ENVIRONMENT/mobile.html This file is used by the native mobile library to receive mobile publish settings and to facilitate the Tag Management module. This file can be useful to perform some basic troubleshooting of your mobile implementation. Inspecting mobile.html The behavior of utag.js on the mobile.html page will be similar to that of a standard desktop website page. The utag.js file is loaded and subsequent vendor tags are executed. To inspect the mobile.html page: Load the mobile.html URL for your iQ profile in a new browser window. Open the developer tools or web console of the browser to inspect the page source: From here you can now perform many of the same troubleshooting techniques that you would use for a website witih Tealium's utag.js installed. Verifying the Publish Timestamp The first thing to verify is that your most recently published changes are being loaded in mobile.html. This is done by matching the timestamp from the HTML source to the timestamp from the iQ Versions screen. To verify the publish timestamp: At the top of the page source of mobile.html, look for the published timestamp on the first line. The timestamp in mobile.html has the following pattern: ut.4.0.YYYYMMDDHHMM . (Time is always in GMT.) In your iQ profile, go the Versions screen and find the most recently published version of the same environment. The timestamp of this publish should match the timestamp found inside mobile.html. Inspecting Mobile Publish Settings JavaScript Object The mobile.html page uses a JavaScript object named mps to store the values of the mobile publish settings. You can inspect this object to verify your settings. To inspect the mps object: Type "mps" into the web console and hit enter. The properties marked "4" and "5" correspond to versions 4.x and 5.x of your mobile library respectively. Simulating Tracking Calls The behavior of utag.js on this page will be similar to that of a standard desktop website page. This means you can watch the network activity to see which utag.*.js files are loaded and you can trigger tracking calls from the browser console to verify that your tags are working as expected. To simulate tracking calls in mobile.html: From the browser console, type utag.view({screen_title : "Test Page"}) and hit enter. Go to the network activity screen to inspect the outgoing vendor tracking activity. ... View more

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

This article describes how to set up the Firebase Mobile Remote Command tag in your Tealium iQ Tag Management (TiQ) account. In this article: Table of Contents Placeholder Tag Tips The config command is automatically sent on the first load if it is not found in the event list. If the appropriate data is provided, the event_login and event_signup can automatically send a setUserId and setUserProperty . If the appropriate data is provided, the event_view_item_list , event_view_item , event_ecommerce_purchase , and event_begin_checkout can automatically send a setScreenName . Use only the singular parameters or the e-commerce arrays, not both. Tag Configuration First, go to Tealium's tag marketplace and add the Firebase Mobile Remote Command tag (Learn more about how to add a tag). After adding the tag, configure the following settings: Enable Debug Mode 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: Firebase Configuration Variable Description firebase_session_timeout_seconds Integer as String firebase_session_minimum_seconds Integer as String firebase_analytics_enabled Boolean as String firebase_log_level String firebase_event_name String firebase_event_params JSON firebase_screen_name String firebase_screen_class String firebase_property_name String firebase_property_value String firebase_user_id String command_name String Standard Variable Description param_achievement_id String Achievement ID param_ad_network_click_id String Ad Network Click ID param_affiliation String Affiliation param_cp1 String CP1 param_campaign String Campaign param_character String Character param_checkout_option String Checkout Option param_checkout_step Long Checkout Step param_content String Content param_content_type String Content Type param_coupon String Coupon param_creative_name String Creative Name param_creative_slot String Creative Slot param_currency StringCurrency param_destination String Destination param_end_date String End Date param_flight_number String Flight Number param_group_id String Group ID param_index String Index param_item_brand String Item Brand param_item_category String Item Catego param_item_id String Item ID param_item_list String Item List param_item_location_id String Item Location ID param_item_name String Item Name param_item_variant String Item Variant param_level Long Level param_location Long Location param_medium String Medium param_number_nights Long Number Of Nights param_number_pax Long Number Of Passengers param_number_rooms Long Number Of Rooms param_origin String Origin param_price Double Price param_quantity Long Quantity param_score Long Score param_search_term String Search Term param_shipping Double Shipping param_method String Method param_source String Source param_travel_class String Travel Class param_virtual_currency_name String Virtual Currency Name param_start_date String Start Date param_term String Term param_tax Double Tax param_transaction_id String Transaction ID param_value Long or Double Value param_level_name String Level Name param_success String Success E-Commerce Variable Description checkout_step Long Checkout Step checkout_option String Checkout Option order_id String Order ID Overrides _corder order_total Long or Double Order Total Overrides _ctotal order_shipping Double Shipping Amount Overrides _cship order_tax Double Tax Amount Overrides _ctax order_currency String Currency Overrides _ccurrency order_coupon_code String Promo Code Overrides _cpromo product_id Array List of Product IDs Overrides _cprod product_name Array List of Names Overrides _cprodname product_brand Array List of Brands Overrides _cbrand product_category Array List of Categories Overrides _ccat product_quantity Array List of Quantities Overrides _cquan product_unit_price Array List of Prices Overrides _cprice param_item_list Array List of Presentation Lists param_item_variant Array List of Variants param_index Array List of Indexes Events Variable Description config Configuration setScreenName Set Screen Name setUserProperty Set User Property setUserId Set User ID logEvent Log Event resetData Reset Data event_add_payment_info Add Payment Information event_add_to_cart Add To Cart event_add_to_wishlist Add To Wishlist event_app_open App Open event_begin_checkout Begin Checkout event_campaign_details Campaign Detail event_checkout_progress Checkout Progress event_earn_virtual_currency Earn Virtual Currency event_ecommerce_purchase E-Commerce Purchase event_generate_lead Generate Lead event_join_group Join Group event_level_up Level Up event_level_start Level Start event_level_end Level End event_login Login event_post_score Post Score event_present_offer Present Offer event_purchase_refund Purchase Refund event_remove_cart Remove From Cart event_search Search event_select_content Select Content event_set_checkout_option Set Checkout Option event_share Share event_signup Sign Up event_spend_virtual_currency Spend Virtual Currency event_tutorial_begin Tutorial Begin event_tutorial_complete Tutorial End event_unlock_achievement Unlock Achievement event_view_item View Item event_view_item_list View Item List event_view_search_results View Search Results Parameters Parameters vparam_number_nights Variable Description firebase_event_name Event Name firebase_event_params Event Params firebase_screen_name Screen Name firebase_screen_class Screen Class firebase_property_name Property Name firebase_property_value Property Value firebase_user_id User ID command_name Command Name param_achievement_id Achievement ID param_ad_network_click_id Ad Network Click ID param_affiliation Affiliation param_cp1 CP1 param_campaign Campaign param_character Character param_checkout_option Checkout Option param_checkout_step Checkout Step param_content Content param_content_type Content Type param_coupon Coupon param_creative_name Creative Name param_creative_slot Creative Slot param_currency Currency param_destination Destination param_end_date End Date param_flight_number Flight Number param_group_id Group ID param_index Index param_item_brand Item Brand param_item_category Item Category param_item_id Item ID param_item_list Item List param_item_location_id Item Location ID param_item_name Item Name param_item_variant Item Variant param_level Level param_location Location param_medium Medium Number Of Nights param_number_pax Number Of Passengers param_number_rooms Number Of Rooms param_origin Origin param_price Price param_quantity Quantity param_score Score param_search_term Search Term param_shipping Shipping param_method Method param_source Source param_travel_class Travel Class param_virtual_currency_name Virtual Currency Name param_start_date Start Date param_term Term param_tax Tax param_transaction_id Transaction ID param_value Value param_level_name Level Name param_success Success param_checkout_step Checkout Step param_checkout_option Checkout Option param_transaction_id Order ID param_value Order Total param_shipping Shipping Amount param_tax Tax Amount param_currency Currency param_coupon Promo Code param_item_id List of Product IDs param_item_name List of Names param_item_brand List of Brands param_item_category List of Categories param_quantity List of Quantities param_price List of Prices param_item_list List of Presentation Lists param_item_variant List of Variants param_index List of Indexes param_item_location_id List of Location IDs custom Custom ... View more

Finding the correct CSS selector of a page element you want to track is crucial to the success of the jQuery onHandler Extension. This article will show some methods for determining the CSS selector of a page element. In this article: Table of Contents Placeholder Google Chrome Developer Tools Finding the selector of an element in Chrome only takes a couple clicks using the built-in Developer Tools. To find the CSS selector of a page element: Right-click the element in the page. The Developer Tools window will open. In the Elements tab of Developer Tools, right-click the highlighted element and select Copy > Copy selector. That's it! The selector string is now in your clipboard and you can paste it into the jQuery extension. Tealium Tool: CSS Selector Tool If you already have the Tealium Tools browser plugin, then the CSS Selector Tool makes it easy to find the selector.  Follow the instructions on how to use the CSS Selector Tool. Web Companion Web Companion offers a slightly less accurate selector tool, but it can help pre-configure a jQuery extension for you. Follow the instructions on how to use the On-Page Element Selector tool in Web Companion. Testing a Selector Use this method to test a selector before using it in an extension. Paste this into the Console of the developer tools and make sure to replace <jQuery selector> with the real selector that should be used: jQuery("<jQuery Selector>").on("mousedown",function(e){ alert("It worked!!"); }); Test this by clicking down (but not up) on the desired element. If your selector was correct then you will see a popup with the word, “It worked!!”. Primary Selectors A primary selector should be used when the element you want to target is not available on page load. The primary selector is a higher-level element on the page. For example, let's say you have a table of data that gets populated dynamically with AJAX after the page loads. You want to track certain links within the table, but they don't exist until after the table is populated. If the table tag looks like this: <table id="myTable"></table> And your links looks like this: <td><a href="" class="myLinks">Click Here</a></td> Then the selectors you use might looks like this: Primary Selector: table#myTable Selector: td > a.myLinks ... View more

We are excited to announce the launch of a redesigned TLC experience!  More than a redesign This project is more than just a redesign, but of course the new look of the site is the most obvious change. Here are the high-level improvements you'll see: Responsive Design Our previous design didn't work well on devices other than a computer screen. This redesign overhauls the underlying page code so that TLC can be easily accessed from any device. Developer Docs There is now a new site just for developer documentation. The minimalistic layout and simplified design put the documentation front and center so that developers can get what they want quickly. TLC Resources We have so many great learning resources to share, but we realized it wasn't always obvious where to find them. We love the sidebar navigation in the UDH, so we brought the idea of the global nav into TLC to highlight our top-level offerings. Solidify Branding We think it's important to provide a cohesive user experience as you navigate through our many sites, so we've applied a new style consistently across all of TLC.  What's Changing? New Name First off, "TLC" now means Tealium Learning Center. TLC is more than just a community. The change from "community" to "center" broadens the meaning of TLC to encompass all of the valuable learning resources that it offers. New Logo We have a new logo that follows the branding style of some changes coming to the product platform. This simplified design gives TLC its own identity within the Tealium ecosystem. Global Sidebar Navigation It's no coincidence that sidebar navigation is becoming ubiquitous among web applications -- it's an effective and unobtrusive tool to let visitors quickly switch to the top-level areas of a site. This is exactly what we want to offer in TLC. The new sidebar navigation provides quick links to the best of what TLC has to offer.  The following links are available: TLC Home Forums Product Guides Developer Docs Product Ideas Education TLC Blog Support Desk   Developer Docs The documentation for our SDKs and installation libraries has been moved to a new site that is dedicated to developers: https://docs.tealium.com The TLC sidebar navigation appears on this site, too, so you'l always know where you are within TLC. Education We provide a neverending stream of educational content, from bootcamps and webinars to online courses and certification training. Everything you need to know about Education can be found on the Education landing page within TLC.  TLC Blog That's right! Did we mention the new blog? Watch this area closely for some special member spotlights, thought leadership insights and trending topics from customers like you. TLC Blog Support Desk Tealium Support Desk is now accessed from the global sidebar navigation.   Additional Notes Community Feedback If you have any questions about the updates, or anything else in TLC, post your question in the Community Feedback forum. We hope you enjoy getting to know the new Tealium Learning Center! ... View more