Tealium Learning Center

This article describes how to access your AudienceStore and EventStore services. These services store your unstructured audience and event data as compressed JSON files on Tealium's Amazon S3 bucket. These services must be activated for your account. Contact your account manager for more information. In this article: Prerequisites Tealium DataAccess Active AudienceStore Connector For detailed information, see the AudienceStore Connector Setup Guide. – OR – Active EventStream Feeds For detailed information, see the Event Feed Setup Guide. How It Works The Tealium Collect tag (or other Collect library) sends event data to the Customer Data Hub where it's captured in Tealium's Amazon S3 bucket as flattened JSON data. When the S3 bucket reaches a size of 100 MB (uncompressed) or 1 hour elapses, whichever comes first, the data is compressed and prepared for Redshift. The compressed data is then copied and imported into the Redshift database for your account. AudienceStore File Paths Data files for AudienceStream are stored in the S3 bucket with a path structure that matches your account name, profile name, and the action ID of the AudienceStore connector: {account_name}/{profile_name}/audiences/{action_id} The action ID can be found in the Details of the AudienceStore connector action, as seen here: Example path to AudienceStore file: my-account/main/audiences/bafc28ca-9542-3929-3b94-577a84f3d672 EventStore File Paths Data files for EventStore are stored in the S3 bucket as follows: {account_name}/{profile_name}/events/{event_feed_id} The event feed ID can be found in the URL for the event feed. Navigate to Live Events and click the feed to select it and inspect the URL to retrieve the feed ID, as seen here: Example path to EventStore file: my-account/main/events/bafc28ca-9542-3929-3b94-577a84f3d672 Viewing Files in the Console You can browse the files associated with each audience or event feed using the DataAccess console. This is an easy way to verify that data is flowing through the system and a quick way to download a sample file to get familiar with the format. Use the following steps to access files using the DataAccess console: In the sidebar, go to DataAccess > EventStore or DataAccess > AudienceStore. Select the number of weeks of data to display. Select the name of the Event Feed or the AudienceStore Action. Click Reload. Click a date to expand the list of file details. Find the file you want and click Download. The .gzip file is saved to your computer where you can use an unzip utility to open the file. Using Third-party Tools to View Files You can also access files using third-party tools such as an FTP client or the Amazon S3 command line interface. To allow these tools access to your files, you need the Amazon S3 access key for your S3 bucket. Amazon S3 Access Key To get the Amazon S3 Access Key: In the sidebar, go to DataAccess > EventStore or DataAccess > AudienceStore. Click Get Amazon Access Key. The following fields are displayed: Access Key ID Secret Access Key Path For security purposes the secret access key is only displayed once, so it's important to store it securely for later use. If you ever lose this value you can regenerate a new one, but it invalidates all previous connections that used the old value. FTP Clients with Amazon S3 Support We recommend using a desktop application for a more convenient method of downloading a large number of files. Here are some client applications that work with Amazon S3. Windows: Cyberduck, CrossFTP Mac: Cyberduck, CrossFTP, Transmit The primary benefit of using a GUI-based FTP client with S3 support is that you can point-and-click on individual files and folders to download from Amazon S3. The following screen capture of Cyberduck shows how to configure the connection. Note that the configuration wizard does not have a field for the Secret Access Key. You are prompted for the Secret Access Key upon a connection attempt. The Secret Access Key is saved for future use. Viewing Files using the Amazon Command Line Interface For more technical users, the Amazon Command Line Interface (CLI) can be installed to give you full control over accessing your data files. The primary benefit of using a Amazon CLI is the ability to customize for your specific needs, such as syncing and automating the file retrieval from Amazon S3. The following are a few of the uses for the Amazon CLI: Initial bulk download of all historical log files Schedule hourly incremental download to grab only the newest generated log files Synchronize a local folder on your desktop or server to a remote folder on S3 so that they contain exactly the same log file content Download files before and/or after a certain LastModified date To install the Amazon CLI, refer to the following Amazon instructions: Installing, updating, and uninstalling the AWS CLI When you call aws configure , you are prompted for your Access Key and Access Key ID (you can leave Region Name and Output Format blank). After you configure the CLI, you can make queries using the s3api method. The s3api method is used in the following CLI examples. List Objects in S3 The list-objects method lists objects in your S3 directory. This is needed to get the key for each object to download individual files. List All Objects in the Root Folder: aws s3api list-objects --bucket uconnect.tealiumiq.com \ --prefix {account}/{profile}/ List All Event Feeds aws s3api list-objects --bucket uconnect.tealiumiq.com \ --prefix {account}/{profile}/events/ List All Objects in a Specific Events Folder aws s3api list-objects --bucket uconnect.tealiumiq.com \ --prefix {account}/{profile}/events/{feed-id}/ List All Audiences aws s3api list-objects --bucket uconnect.tealiumiq.com \ --prefix {account}/{profile}/audiences/ List All Objects in a Specific Audiences Folder aws s3api list-objects --bucket uconnect.tealiumiq.com \ --prefix {account}/{profile}/audiences/{action-id}/ Get a Single Events Object The get-object method downloads one specific remote key to a local location on your desktop or server. aws s3api get-object --bucket uconnect.tealiumiq.com \ --key {account}/{profile}/events/{feed-id}/{filename}.gz ./ Get a Single Audiences Object The get-object method downloads one specific remote key to a local location on your desktop or server. aws s3api get-object --bucket uconnect.tealiumiq.com \ --key {account}/{profile}/audiences/{action-id}/{filename}.gz ./ Synchronize Local and Remote Folders The sync method takes a remote folder on Amazon S3 and synchronizes it with a local folder on your desktop or server. The following example synchronizes a specific remote EventStream or AudienceStream folder to a local folder on the desktop. The --dryrun argument shows you what files would actually sync, without actually doing the download. To execute the actual download, remove the --dryrun argument. aws s3 sync s3://uconnect.tealiumiq.com/{account}/{profile}/audiences// \ ~/Desktop/temp --dryrun Lastly, you can also filter the sync method to only download files matching a specific filter. In this example, only the files that match the wildcard filter of "*2015.06.14*" are downloaded. aws s3 sync s3://uconnect.tealiumiq.com/{account}/{profile}/events// \ ~/Desktop/temp --exclude "*" --include "*2015.06.14*" --dryrun   ... View more

Badge Associations allow you to quickly assign multiple Badges based on other Badges the visitor has earned. There are two ways to create Badge Associations: either create an Enrichment or use the interactive Badge Associations wizard. In this article: Table of Contents Placeholder Creating the Enrichment (for new or existing Badges) Navigate to the Attributes menu located under the Enrich tab. Add a new Badge or click the edit icon for the Badge to which you want to append other Badge(s). Click 'Create Enrichment' and select "Assign Badge from another Badge". From the drop-down, select the Badge you wish to assign. Repeat steps 2 - 4 to assign more Badges. Click Save. When you are done, save your profile to apply the changes. Using the Badge Association Wizard (for existing Badges only) In the Attributes tab, locate the Badge to which you want to assign and expand its settings. Click the Badge Association icon in the top-right tip of the panel. Click the + icon and select a Badge that you wish to assign. Understanding the Badge Association Wizard Click on an existing Badge to display this wizard. You will notice the currently-assigned Badge is always in the center column with arrows on each side. The arrows always point in the direction of the recipient Badge. You can assign any number of Badges to the current and the recipient badge; however you can't reassign a recipient back to its donor Badge. Take a look at the example below. Notice the 'Car Badge' in the center is currently assigned to qualifying visitors. Here's how the other Badge assignments will trigger. Qualifying visitors receive the Car Badge. Car Badge visitors are automatically assigned 'Tesla' and 'Fun Cars' badges. Fancy Cars Badge visitors are automatically assigned 'Car', 'Tesla' and 'Fun Cars' badges. Electric Badge visitors are automatically assigned 'Car', 'Tesla' and 'Fun Cars' badges. REMEMBER: You can't assign any of the recipient Badges ('FancyCars' or 'Electric') back to its donors ('Tesla or Fun Cars'). If you attempt to do so, you will see this error message. ... View more

This article provides the data layer definition for a retail e-commerce property. Table of Contents Placeholder  Data Layer Attributes Variable Description Example Type click_category During click tracking events, the category of the element clicked. eg. Header, Navigation, etc. "footer" String click_label During click tracking events, the name of the element clicked. eg. Submit, Login, etc. "Submit" String click_type During click tracking events, distinguish between different elements clicked, eg. 'link', 'button', 'field', 'image', etc. "button" String content_author The name of the author of the content "John Smith" String content_id The unique identifier of the page content "38121" String content_publish_date The publish date of the page content, in format YYYY/MM/DD eg. '2015/02/09' "2015/02/09" String content_title The title of the content on the page "Top 7 Outdoor Sleeping Bags" String country_code The two-character country code of the site eg. us, uk, mx, ca, jp, etc. "us" String customer_city The customer's city of residence "San Diego" String customer_country The customer's country of residence "United States" String customer_email The customer's email address "johnsmith@example.com" String customer_first_name The first name of the customer "John" String customer_id The unique customer identifier (if not customer_email) "8237572" String customer_is_logged_in A flag to indicate if the current user is logged in eg. '1' or '0' "1" String customer_last_name The last name of the customer "Smith" String customer_postal_code The customer's postal code "92101" String customer_state The customer's state/province of residence "CA" String customer_type Distinguishes between registered users and guests eg. 'registered', 'guest' "guest" String language_code The two-character language code of the site eg. us, es, fr, etc. "en" String page_friendly_url The canonical URL of the page, might be different than the URL in the browser location bar "/travel/national_parks" String page_name The user-friendly name of the page "Homepage" String page_number For paginated content or galleries, the current page number in view eg. '2' "2" String page_type The Tealium variable to identify the type of page or template eg. home, section, category, search, content, etc. "content" String search_keyword The search text entered by the user eg. 'camping' "napa valley" String search_results The number of search results returned eg. '42' "42" String site_display_format The display format of the site in view eg. 'desktop', 'tablet', or 'mobile' "mobile" String site_section The top-level section of your site eg. Travel, Sports, News, etc. "Travel" String site_subsection1 The 1st level category of the page hierarchy "National Parks" String site_subsection2 The 2nd level category of the page hierarchy "California" String site_subsection3 The 3rd level category of the page hierarchy "Yosemite" String site_subsection4 The 4th level category of the page hierarchy "'Camping" String slide_title On a gallery page, the title of the current slide in view "#2 Yellowstone" String social_network During social share events, the name of the social network used "facebook" String   Tracked Pages Home Page Identifier tealium_event="page_view" Description The home page. Sample URL http://www.example.com/ Sample Code {     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/home",     "page_name"              : "Homepage",     "page_type"              : "home",     "site_display_format"    : "desktop",     "site_section"           : "Home", "tealium_event" " "page_view" } Section Page Identifier tealium_event="page_view" Description A parent-category or top-level section page. Sample URL http://www.example.com/top-level/ Sample Code {     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/travel",     "page_name"              : "Travel Home",     "page_type"              : "section",     "site_display_format"    : "desktop",     "site_section"           : "Travel", "tealium_event" : "page_view" } Category Page Identifier tealium_event="category_view" Description A category page, usually displaying a list of products. Sample URL http://www.example.com/top-level/category/ Sample Code {     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/travel/national_parks/yosemite_camping",     "page_name"              : "Homepage",     "page_number"            : "2",     "page_type"              : "category",     "site_display_format"    : "desktop",     "site_section"           : "Travel",     "site_subsection1"       : "National Parks",     "site_subsection2"       : "California",     "site_subsection3"       : "Yosemite",     "site_subsection4"       : "Camping", "tealium_event" : "category_view" } Content Page Identifier tealium_event="content_view" Description A content page. Sample URL http://www.example.com/section/category/content.html Sample Code {     "content_author"         : "Sue Smith",     "content_id"             : "38121",     "content_publish_date"   : "2015/02/09",     "content_title"          : "Top 7 Outdoor Sleeping Bags",     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/travel/parks/ca/gear/bags.html",     "page_name"              : "Camping Gear: Top Sleeping Bags",     "page_type"              : "content",     "site_display_format"    : "desktop",     "site_section"           : "Travel",     "site_subsection1"       : "National Parks",     "site_subsection2"       : "California",     "site_subsection3"       : "Yosemite",     "site_subsection4"       : "Camping", "tealium_event" : "content_view" } Gallery Page Identifier tealium_event="content_view" Description A page of content displayed as a gallery of slides. Sample URL http://www.example.com/section/category/gallery.html Sample Code {     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/travel/national_parks",     "page_name"              : "Top Parks Gallery",     "page_number"            : "2",     "page_type"              : "gallery",     "site_display_format"    : "desktop",     "site_section"           : "Travel",     "site_subsection1"       : "National Parks",     "slide_title"            : "#2 Yellowstone", "tealium_event" : "content_view" } Search Page Identifier tealium_event="search" Description A search results page. Sample URL http://www.example.com/search?query=term Sample Code {     "country_code"           : "us",     "customer_email"         : "johnsmith@example.com",     "customer_first_name"    : "John",     "customer_id"            : "8237572",     "customer_is_logged_in" : "1",     "customer_last_name"     : "Smith",     "customer_type"          : "registered",     "language_code"          : "en",     "page_friendly_url"      : "/search/napa_valley/",     "page_name"              : "Search results for: napa valley",     "page_number"            : "1",     "page_type"              : "search",     "search_keyword"         : "napa valley",     "search_results"         : "42",     "site_display_format"    : "desktop",     "site_section"           : "Travel", "tealium_event" : "search" } Tracked Events User Login Identifier tealium_event="user_login" Description Upon successful user login. Sample Code {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA",     "tealium_event"         : "user_login" } User Logout Identifier tealium_event="user_logout" Description Upon successful user logout. Sample Code {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA",     "tealium_event"         : "user_logout" } User Registration Identifier tealium_event="user_register" Description Upon successful user registration. Sample Code {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA",     "tealium_event"         : "user_register" } User Update Identifier tealium_event="user_update" Description Upon successful update of user profile information. Sample Code {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA",     "tealium_event"         : "user_update" } Email Signup Identifier tealium_event="email_signup" Description Upon successful signup for email newsletter. Sample Code {     "customer_email" : "john.smith@example.com",     "tealium_event"   : "email_signup" } Custom Click Identifier tealium_event="custom_click" Description Tracking of specific click interactions with the page. Sample Code {     "link_category" : "Header",     "link_name"      : "Login", "tealium_event" : "custom_click" } Social Share Identifier tealium_event="social_share" Description Tracking of social media sharing actions. Sample Code {     "content_id"         : "38121",     "page_friendly_url" : "/travel/national_parks",     "page_name"          : "Travel: National Parks",     "social_network"     : "facebook", "tealium_event" : "social_share" } ... View more

This article provides the data layer definition for a retail e-commerce property. Table of Contents Placeholder Data Layer Attributes Variable Description Example Type brand_name Name of the brand for brand specific pages eg. 'Ralph Lauren' "Ralph Lauren" String browse_refine_type Array of browse refinement types eg. ['Size', 'Color'] ["Size", "Color"] Array browse_refine_value Array browse refinement values eg. ['XL', 'Red'] ["XL", "Red"] Array cart_product_id On 'cart_add' event, an array of all product ID's currently in the cart ["PROD123", "PROD456"] Array cart_product_price On 'cart_add' event, an array of all product prices currently in the cart ["12.99", "25.99"] Array cart_product_quantity On 'cart_add' event, an array of all product quantities currently in the cart ["2", "2"] Array cart_product_sku On 'cart_add' event, an array of all product skus currently in the cart ["PR-RED-1234", "PR-BLK-6789"] Array cart_total_items Total number of all items in the cart. "4" String cart_total_value Total value for all items in the cart as a string with only digits and decimal "77.96" String category_id A unique identifier for the category being viewed eg. '243', 'MENS_SHOES', etc. "243" String category_name A user-friendly name for the category being viewed eg. 'Shoes: Boots' "Shoes: Boots" String country_code Country Code eg. us, uk, mx, ca, jp, etc. "us" String customer_city Contains the customer's city of residence. "San Diego" String customer_country Contains the customer's country of residence. "United States" String customer_email Contains the customer's email address. "user@example.com" String customer_first_name The first name of the customer. "John" String customer_id Contains the unique customer ID. "8237572" String customer_last_name The last name of the customer. "Smith" String customer_postal_code Contains the customer's postal code. "92101" String customer_state Contains the customer's state of residence. "CA" String event_name Tealium variable to identify unique events eg. cart_add, user_login, email_signup, etc. "cart_add" String language_code Language Code eg. us, es, fr, etc. "en" String link_category During click tracking events, the category of the element clicked. eg. Header, Navigation, etc. "Header" String link_name During click tracking events, the name of the element clicked. eg. Submit, Login, etc. "Login" String order_currency_code Currency code for the site eg. USD, GBP, EUR, CAD "USD" String order_discount_amount Contains the order-level discount amount. eg. 10.00 as a string with only digits and decimal "10.00" String order_id Unique Identifier for an order, should only be populated on Order Confirmation page. "ORD123456" String order_merchandise_total Contains price of all items not including any product or order level discounts, tax, or shipping as a string with only digits and decimal "55.98" String order_payment_type Contains the type of payment eg. visa, paypal "paypal" String order_promo_code String list of comma separated promotion codes. "SPRFREE,PROMO10" String order_shipping_amount Contains the total value for shipping as a string with only digits and decimal. "6.99" String order_shipping_type Contains the type of shipping. eg. 'FedEx Priority'. "UPS" String order_store Identifier of store type (i.e. web or mobile web) "mobile web" String order_subtotal Contains price of all items including any product or order level discounts, but excluding tax and shipping as a string with only digits and decimal "45.98" String order_tax_amount Total tax amount for this order as a string with only digits and decimal. "2.50" String order_total Total Amount of the Order including tax and shipping but less all discounts as a string with only digits and decimal "54.47" String order_type The type of conversion that just took place or user that is on the site. "email" String page_name Tealium variable to identify the page name "Homepage" String page_type Type of page eg. home, category, product, search, cart, checkout, receipt, account "product" String product_brand An array of product brands. ["Ralph Lauren", "Lucky"] Array product_category An array of product categories ["Shirts", "Pants"] Array product_discount_amount An array of product discount amounts, usually as a result of product-level coupons as strings with only digits and decimal ["2.98", "0.00"] Array product_id An array of product IDs ["PROD123", "PROD456"] Array product_image_url An array of URLs to the main product image. ["//domain.com/123.gif", "//domain.com/456.gif"] Array product_name An array of product names. ["Product One", "Expensive Product Two"] Array product_on_page An array of product IDs of other products that are displayed on the page. ["PROD123", "PROD456"] Array product_original_price An array of original suggested retail product prices, omitting commas and symbols ["29.99", "1015.00"] Array product_price An array of product selling prices, omitting commas and symbols ["12.99", "1010.98"] Array product_promo_code An array of promo/coupon codes applied to specific products eg. SHOES10OFF ["SHIRT10OFF",""] Array product_quantity An array of quantities for each product. ["2","2"] Array product_sku An array of product skus ["PR-RED-1234", "PR-BLK-6789"] Array product_subcategory An array of product sub-categories ["T-Shirts", "Dress Pants"] Array product_url An array of URLs to the individual product page ["//domain.com/123.html", "//domain.com/456/html"] Array search_keyword Value of search text entered by user. eg. 'long sleeve' "cargo" String search_results Number of results returned by search. eg. '42' "42" String site_section The high-level sections of your site eg. Apparel, Accessories, Help, etc. "Clothing" String   Tracked Pages Home Page Identifier tealium_event="page_view" Description The home page. Sample URL http://www.example.com/ Sample { "cart_total_items" : "4", "cart_total_value" : "77.96", "country_code" : "us", "language_code" : "en", "page_name" : "Homepage", "page_type" : "home", "site_section" : "Clothing", "tealium_event" : "page_view" } Section Page Identifier tealium_event="page_view" Description A parent-category or top-level section page. Sample URL http://www.example.com/top-level/ Sample {     "brand_name"        : "Ralph Lauren",     "cart_total_items" : "4",     "cart_total_value" : "77.96",     "category_id"       : "243",     "category_name"     : "Shoes: Boots",     "country_code"      : "us",     "language_code"     : "en",     "page_name"         : "Homepage",     "page_type"         : "section",     "product_on_page"   : ["PROD123", "PROD456"],     "site_section"      : "Clothing", "tealium_event" : "page_view" } Category Page Identifier tealium_event="category_view" Description A category page, usually displaying a list of products. Sample URL http://www.example.com/top-level/sub-level/ Sample {     "brand_name"           : "Ralph Lauren",     "browse_refine_type"   : ["Size", "Color"],     "browse_refine_value" : ["XL", "Red"],     "cart_total_items"     : "4",     "cart_total_value"     : "77.96",     "category_id"          : "243",     "category_name"        : "Shoes: Boots",     "country_code"         : "us",     "language_code"        : "en",     "page_name"            : "Homepage",     "page_type"            : "category",     "product_on_page"      : ["PROD123", "PROD456"],     "site_section"         : "Clothing", "tealium_event" : "category_view" } Product Page Identifier tealium_event="product_view" Description A product detail page. Sample URL http://www.example.com/top-level/sub-level/product.html Sample {     "cart_total_items"        : "4",     "cart_total_value"        : "77.96",     "category_id"             : "243",     "category_name"           : "Shoes: Boots",     "country_code"            : "us",     "language_code"           : "en",     "page_name"               : "Homepage",     "page_type"               : "product",     "product_brand"           : ["Ralph Lauren", "Lucky"],     "product_category"        : ["Shirts", "Pants"],     "product_id"              : ["PROD123", "PROD456"],     "product_image_url"       : ["//domain.com/path/image.gif"],     "product_name"            : ["Product One", "Fancy Product Two"],     "product_on_page"         : ["PROD123", "PROD456"],     "product_original_price" : ["29.99", "1015.00"],     "product_price"           : ["12.99", "1010.98"],     "product_sku"             : ["PR-RED-1234", "PR-BLK-6789"],     "product_subcategory"     : ["T-Shirts", "Dress Pants"],     "product_url"             : ["//domain.com/cat/prod/prod123.html"],     "site_section"            : "Clothing", "tealium_event" : "product_view" } Search Page Identifier tealium_event="search" Description A search results page. Sample URL http://www.example.com/search?query=term Sample {     "browse_refine_type"   : ["Size", "Color"],     "browse_refine_value" : ["XL", "Red"],     "cart_total_items"     : "4",     "cart_total_value"     : "77.96",     "country_code"         : "us",     "language_code"        : "en",     "page_name"            : "Homepage",     "page_type"            : "search",     "product_on_page"      : ["PROD123", "PROD456"],     "search_keyword"       : "cargo",     "search_results"       : "42",     "site_section"         : "Clothing", "tealium_event" : "search" } Cart Page Identifier tealium_event="cart_view" Description The shopping cart page, displaying product contents of cart. Sample URL http://www.example.com/cart Sample {     "cart_total_items"         : "2",     "cart_total_value"         : "2524.00",     "country_code"             : "us",     "language_code"            : "en",     "page_name"                : "Shopping Bag",     "page_type"                : "cart",     "product_brand"            : ["Ralph Lauren", "Lucky"],     "product_category"         : ["Shirts", "Pants"],     "product_discount_amount" : ["2.98", "0.00"],     "product_id"               : ["PROD123", "PROD456"],     "product_image_url"        : ["//domain.com/path/image123.gif", "//domain.com/path/image456.gif"],     "product_name"             : ["Product One", "Fancy Product Two"],     "product_price"            : ["12.00", "1250.00"],     "product_promo_code"       : ["SHIRT10OFF",""],     "product_quantity"         : ["2","2"],     "product_sku"              : ["PR-RED-1234", "PR-BLK-6789"],     "product_subcategory"      : ["T-Shirts", "Dress Pants"],     "product_url"              : ["//domain.com/cat/prod/prod123.html", "//domain.com/cat/prod/prod456.html"], "tealium_event" : "cart_view" } Checkout Page Identifier tealium_event="checkout" Description The checkout pages, usually the shipping, payment, and billing info pages. Sample URL http://www.example.com/checkout/billing/shipping Sample {     "cart_total_items" : "2",     "cart_total_value" : "2524.00",     "country_code"      : "us",     "language_code"     : "en",     "page_name"         : "Checkout : Payment",     "page_type"         : "checkout", "tealium_event" : "checkout" } Order Page Identifier tealium_event="purchase" Description The order confirmation ("thank you") page. Sample URL http://www.example.com/checkout/success/order.html Sample {     "cart_total_items"         : "2",     "cart_total_value"         : "2524.00",     "country_code"             : "us",     "customer_city"            : "San Diego",     "customer_country"         : "United States",     "customer_email"           : "john.smith@example.com",     "customer_first_name"      : "John",     "customer_id"              : "8237572",     "customer_last_name"       : "Smith",     "customer_postal_code"     : "92101",     "customer_state"           : "CA",     "language_code"            : "en",     "order_currency_code"      : "USD",     "order_discount_amount"    : "10.00",     "order_id"                 : "ORD123456",     "order_payment_type"       : "paypal",     "order_promo_code"         : "SPRFREE,PROMO10",     "order_shipping_amount"    : "6.99",     "order_shipping_type"      : "UPS",     "order_store"              : "mobile web",     "order_subtotal"           : "2524.00",     "order_tax_amount"         : "25.00",     "order_total"              : "2549.00",     "page_name"                : "Order Confirmation - Thank You",     "page_type"                : "order",     "product_brand"            : ["Ralph Lauren", "Lucky"],     "product_category"         : ["Shirts", "Pants"],     "product_discount_amount" : ["5.00", "0.00"],     "product_id"               : ["PROD123", "PROD456"],     "product_image_url"        : ["//domain.com/path/image123.gif", "//domain.com/path/image456.gif"],     "product_name"             : ["Product One", "Fanct Product Two"],     "product_price"            : ["12.00", "1250.00"],     "product_promo_code"       : ["SHIRT10OFF",""],     "product_quantity"         : ["2","2"],     "product_sku"              : ["PR-RED-1234", "PR-BLK-6789"],     "product_subcategory"      : ["T-Shirts", "Dress Pants"],     "product_url"              : ["//domain.com/cat/prod/prod123.html", "//domain.com/cat/prod/prod456.html"], "tealium_event" : "purchase" } Account Page Identifier tealium_event="page_view" Description User account profile pages. Sample URL http://www.example.com/account/profile Sample {     "cart_total_items"      : "4",     "cart_total_value"      : "77.96",     "country_code"          : "us",     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "johnsmith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA",     "language_code"         : "en",     "page_name"             : "Homepage",     "page_type"             : "account", "tealium_event" : "page_view" } Tracked Events Add to Cart Identifier tealium_event="cart_add" Description Add to cart action. Sample {     "cart_product_id"          : ["PROD123", "PROD456"],     "cart_product_price"       : ["12.00", "25.99"],     "cart_product_quantity"    : ["2", "2"],     "cart_product_sku"         : ["PR-RED-123", "PR-BLK-456"],     "product_category"         : ["Shirts"],     "product_id"               : ["PROD678"],     "product_image_url"        : ["//domain.com/path/image.gif"],     "product_name"             : ["Product Three"],     "product_price"            : ["18.00"],     "product_quantity"         : ["2"],     "product_sku"              : ["PR-BLU-678"],     "product_subcategory"      : ["T-Shirts"], "tealium_event" : "cart_add" } Remove from Cart Identifier tealium_event="cart_remove" Description Remove from cart action. Sample { "cart_product_id" : ["PROD123", "PROD456"], "cart_product_price" : ["12.00", "25.99"], "cart_product_quantity" : ["2", "2"], "cart_product_sku" : ["PR-RED-123", "PR-BLK-456"],     "product_category"         : ["Shirts"],     "product_id"               : ["PROD456"],     "product_image_url"        : ["//domain.com/path/image.gif"],     "product_name"             : ["Product Two"],     "product_price"            : ["12.00"],     "product_quantity"         : ["2"],     "product_sku"              : ["PR-BLK-456"],     "product_subcategory"      : ["T-Shirts"], "tealium_event" : "cart_remove" } User Registration Identifier tealium_event="user_register" Description Upon successful user registration. Sample {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA", "tealium_event" : "user_register" } User Update Identifier tealium_event="user_update" Description Upon successful update of user profile information. Sample {     "customer_city"         : "San Diego",     "customer_country"      : "United States",     "customer_email"        : "john.smith@example.com",     "customer_first_name"   : "John",     "customer_id"           : "8237572",     "customer_last_name"    : "Smith",     "customer_postal_code" : "92101",     "customer_state"        : "CA", "tealium_event" : "user_update" } Email Signup Identifier tealium_event="email_signup" Description Upon successful signup for email newsletter. Sample {     "customer_email" : "john.smith@example.com", "tealium_event" : "email_signup" } Custom Click Identifier tealium_event="custom_click" Description Tracking of specific click interactions with the page. Sample {     "link_category" : "Header",     "link_name"      : "Login", "tealium_event" : "custom_click" } ... View more

Purpose The Tealium class serves as the main API entry point for all additional modules. Almost all API calls will go through the Tealium class. Supported Platforms iOS tvOS watchOS macOS Installation Included with the TealiumCore framework CocoaPods pod 'tealium-swift/TealiumCore' import TealiumSwift Carthage TealiumCore.framework import TealiumCore Public API Tealium Constructor for a new Tealium object. Tealium(config: TealiumConfig) Parameters Type Description config TealiumConfig object Initialize the Tealium object with a TealiumConfig object containing your account details. let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "your_environment") let tealium = Tealium(config: config) Optionally, you may pass a completion closure block. If you need to use the RemoteCommands feature, or need to send tracking calls immediately after initialization, you should do so in the completion block. Tealium(config: TealiumConfig, completion: Closure) Parameters Type Description config TealiumConfig object Initialize the Tealium object with a TealiumConfig object containing your account details. completion Closure to be called on init completion ()-> Void )? let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "your_environment") let completionHandler = { responses in // responses contains the list of module responses indicating success or failure for each module print("Tealium ready - your completion code goes here!") } let tealium = Tealium(config: config, completion: completionHandler) track Tracks an event with associated data and, optionally, triggers a callback function. track(title:String, data:[String:Any], completion:ClosureType) Parameters Type Description title String The name of the event to be tracked data Dictionary An object of key/value pairs with data associated with the event to be tracked completion ClosureType A function to execute upon completion of the tracking call // Sample tracking let mydata = ["someKey": "someValue"] // track call with type specified and completion block tealium?.track(title: "someEvent", data: mydata, completion: { (success: Bool, info: [String:Any]?, error: Error?) in // Any follow up code here }) trackView Tracks a screen view with associated data and, optionally, triggers a callback function. trackView(title:String, data:[String:Any], completion:ClosureType) Parameters Type Description title String The name of the screen view to be tracked data Dictionary object An object of key/value pairs with data associated with the event to be tracked completion ClosureType A function to execute upon completion of the tracking call // Sample tracking let mydata = ["someKey": "someValue"] // track call with type specified and completion block tealium?.trackView(title: "some screen title", data: mydata, completion: { (success: Bool, info: [String:Any]?, error: Error?) in // Any follow up code here }) Future Improvements No planned changes Change Log Build 1.6.5 Made some methods and properties public to support modularization. Module responses removed from completion closure for simplicity Build 1.4.0 Removed deprecated track method with TealiumTrackType. Should now call trackView or trackEvent methods instead to differentiate between track call types "tealium_event_type" has been removed from all outgoing track calls, as it is now derived in UDH Event Specs and does not need to be sent Added "call_type" variable to view calls. Added "screen_title" to view calls, which is set to the "title" parameter passed into the trackView call. For "track" calls, "tealium_event" is set to the String value that is passed in as the first parameter. ... View more

Purpose Object provides a central place for configuring tracking options for the Tealium API. Individual modules provide their own extensions for the TealiumConfig class if they are enabled. Supported Platforms iOS tvOS watchOS macOS Installation Included with the TealiumCore framework CocoaPods pod 'tealium-swift/TealiumCore' import TealiumSwift Carthage TealiumCore.framework import TealiumCore Public API TealiumConfig Constructor for a TealiumConfig object. This object is required to initialize the library for your specific account. TealiumConfig(account:String, profile:String, environment:String, optionalData:Dictionary, dataSource:String) Parameters Type Description account String Tealium account name profile String Tealium profile name (usually "main") environment String Tealium environment: "dev", "qa", or "prod" optionalData [String: Any]? Parameter is optional, and may be omitted if you don't need it. See explanation on optionalData below datasource String Datasource key (available from UDH). Optional. // SAMPLE // standard basic config object let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // with optionaldata and datasource let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod", optionalData: nil, datasource: "2f5s1") // with datasource but no optionalData let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod", datasource: "2f5s1") optionalData Allows certain default behavior to be overridden at init time. Generally, it is better to use the override methods, rather than explicitly specifying an optionalData object. OptionalData key Data Type Function TealiumTagManagementConfigKey.maxQueueSize Int Integer representing the maximum queue size for cached (offline) events TealiumTagManagementConfigKey.overrideURL String Override URL for Tag Management webview TealiumCollectKey.overrideCollectUrl String Override URL for Tealium Collect HTTPS requests TealiumDeviceDataModuleKey.isMemoryReportingEnabled Bool Turns low-level device memory reporting on (true) or off (false - default) TealiumAttributionKey.isSearchAdsEnabled Bool Enables support for the Apple Search Ads API in the attribution module (default off - false) setModulesList The list of modules to be enabled or disabled. (see Modules List) setModulesList(TealiumModulesList) Parameters Type Description modulesList TealiumModulesList* List of modules to enable or disable // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // blacklists the autotracking module let modulesList = TealiumModulesList(isWhitelist: false, moduleNames: ["autotracking"] config.setModulesList(modulesList) *TealiumModulesList struct Parameters Type Description isWhiteList Bool Determines if modules list is a blacklist ( false ) or a whitelist ( true ) modulesList [String] Array of module names to enable or disable getModulesList Returns the current module list object. (see Modules List) getModulesList() -> TealiumModulesList // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // blacklists the autotracking module let modulesList = config.getModulesList() setLogLevel Sets a new log level setLogLevel(logLevel: TealiumLogLevel) Parameters Type Description logLevel TealiumLogLevel New Log Level (see Swift Module: Logger) // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // .none .errors .warnings .verbose let newLogLevel = TealiumLogLevel.errors config.setLogLevel(logLevel: newLogLevel) getLogLevel Returns the current log level (see Swift Module: Logger) getLogLevel() -> TealiumLogLevel let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let logLevel = config.getLogLevel() setTagManagementOverrideURL Overrides the default URL used by the non-rendered UIWebView used by the Tag Management module. This should generally be avoided unless you are self-hosting your Tealium JavaScript files. setTagManagementOverrideURL(string: String) Parameters Type Description string String String representing a URL to be loaded by the Tealium UIWebView // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let url = "https://tags.mycdn.com/utag/myaccount/myprofile/myenv/mobile.html" config.setTagManagementOverrideURL(string: url) setTagManagementQueueSize Sets the maximum tag management queue size setTagManagementQueueSize(to: Int) Parameters Type Description to Int Maximum queue size // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.setTagManagementQueueSize(to: 1) setCollectOverrideURL Overrides the Tealium Collect URL to send data to a different endpoint. setCollectOverrideURL(string:String) Parameters Type Description string String String representing a URL for the Collect module to send data to. Can be used to force data collection to stay within a particular region (e.g. EU Central/Germany) // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // force override tealium collect base URL to EU Central let url = "https://collect-eu-central-1.tealiumiq.com/vdata/i.gif?" config.setCollectOverrideURL(string: url) setMemoryReportingEnabled Enables or disables memory reporting in the DeviceData module (default: disabled). setMemoryReportingEnabled(Bool) Parameters Type Description enabled Bool Enables or disables memory reporting in the Device Data module. // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.setMemoryReportingEnabled(true) isMemoryReportingEnabled Returns a Bool indicating whether memory reporting is currently enabled or disabled. isMemoryReportingEnabled() -> Bool // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let enabled = config.isMemoryReportingEnabled() setSearchAdsEnabled Enables or disables memory reporting in the DeviceData module (default: disabled). setSearchAdsEnabled(Bool) Parameters Type Description enabled Bool Enables or disables Apple Search Ads API in the Attribution module // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.setSearchAdsEnabled(true) isSearchAdsEnabled Returns a Bool indicating whether the Apple Search Ads API is currently enabled or disabled in the Attribution module. isSearchAdsEnabled() -> Bool // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let enabled = config.isSearchAdsEnabled() disableRemoteHTTPCommand Disables the built-in remote HTTP command (see Swift Module: RemoteCommands). disableRemoteHTTPCommand() // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.disableRemoteHTTPCommand() enableRemoteHTTPCommand Enables the built-in remote HTTP command (see Swift Module: RemoteCommands). enableRemoteHTTPCommand() // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.enableRemoteHTTPCommand() dispatchQueue Returns the current dispatch queue used for all Tealium processes. dispatchQueue() -> DispatchQueue let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let dispatchQueue = config.dispatchQueue() setDispatchQueue Sets a new dispatch queue for Tealium to use. Not recommended. Default is DispatchQueue.main. setDispatchQueue(DispatchQueue) Parameters Type Description DispatchQueue DispatchQueue A dispatch queue to be used by Tealium let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let dispatchQ = DispatchQueue(label: "com.tealium.myqueue") config.setDispatchQueue(dispatchQ) defaultDispatchQueue Returns the default dispatch queue (DispatchQueue.main). defaultDispatchQueue() -> DispatchQueue let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let dispatchQueue = config.dispatchQueue() addDelegate Adds a new delegate conforming to the TealiumDelegate protocol. addDelegate(Delegate) Parameters Type Description delegate TealiumDelegate A class conforming to the TealiumDelegate protocol // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") // assuming current module has implemented the TealiumDelegate protocol config.addDelegate(self) delegates Returns an array of the currently-enabled delegates. delegates() -> [TealiumDelegate] // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let delegates = config.delegates() setConnectivityRefreshEnabled If enabled (default), the connectivity module will check for a connection at a specified interval (controlled via setConnectivityRefreshInterval ). Queued dispatches will then be sent as soon as a connection is resumed. setConnectivityRefreshEnabled(Bool) Parameters Type Description enabled Bool Sets the enabled state of the connectivity refresh feature in the Connectivity module. Default true // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.setConnectivityRefreshEnabled(true) // set to false to disable this feature setConnectivityRefreshInterval Sets the default connectivity refresh interval in seconds. Default is 30 seconds if not set on the TealiumConfig instance. setConnectivityRefreshInterval(Int) Parameters Type Description interval Int Number of seconds after which the connectivity module will test for connectivity if the device is offline // sample let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config. setConnectivityRefreshInterval(5) // sets interval to 5 seconds addRemoteCommand Adds remote commands for later execution addRemoteCommand(TealiumRemoteCommand) Parameters Type Description command TealiumRemoteCommand Instance of a TealiumRemoteCommand to be added // run prior to Tealium initialization #if os(iOS) let remoteCommand = TealiumRemoteCommand(commandId: "test", description: "test") { response in print("Remote Command 'test' executed") } config.addRemoteCommand(remoteCommand) #endif getRemoteCommands Returns an array of remote commands set on the TealiumConfig instance getRemoteCommands() ->[TealiumRemoteCommand]? let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") let remoteCommands = config.getRemoteCommands() setLegacyDispatchMethod Forces Collect module to use the legacy "vdata" GET request dispatcher instead of the default "/event" POST request dispatcher. setLegacyDispatchMethod(Bool) Parameters Type Description _ Bool If true , forces Collect module to use legacy "vdata" dispatch method let config = TealiumConfig(account: "your_account", profile: "your_profile", environment: "dev/qa/prod") config.setLegacyDispatchMethod(true) Future Improvements No planned changes. Change Log 1.6.5 TealiumModulesList is no longer required if you are only importing the specific modules you require. It will, however, continue to function as expected if present. Added methods for Connectivity module 1.4.0 Documentation updates Additional config methods/properties added for new module functionality ... View more

This guide shows how to add Tealium to your Roku app to track user activity.  Before you begin, here's a video introduction to the platform: Table of Contents Placeholder Installation Requirements Before proceeding, ensure you have satisfied the following requirements: Roku SDK 7.2 or higher Active Roku Developer Account Roku Device Tealium account enabled for AudienceStream, DataAccess, or EventStream We recommend developing in Eclipse with the Roku plugin. Get the Code The code for the Tealium Roku library is stored on Github. You must download and install the library. Download: Tealium for Roku We recommend cloning the library (instead of downloading) to make it easier to update to future releases. Code Setup The code is organized as a sample app. The Tealium code files are located in sample_app/source/tealium . The following files must be imported into your project's source folder: tealium.brs tealiumCollect.brs tealiumLog.brs If you are using Eclipse, refresh your project to access the Tealium components. The code for a sample app is available in the sample_app/source/application/main.brs file. Here you will see examples of adding button tracking and defining a callback function. Watch this video for an overview of the installation and setup of the code: Initialization Once the Tealium components are added to your project you are ready to start coding. The Tealium instance must be invoked with the following parameters before you can begin tracking: account - the name of your account profile - the name of your profile log level - a number 0-3 where 0=None, 1=Errors, 2=Warnings, and 3=Verbose environment - (optional) one of "qa" or "prod" datasource - (optional) the data source key rom UDH Tealium objects are constructed using a builder pattern. builder = TealiumBuilder("ACCOUNT", "PROFILE", 1) builder.SetEnvironment("prod") builder.SetDatasource("DATASOURCE") teal = builder.Build() Be sure to set an appropriate log level when your app is released to production. Tracking Once the Tealium instance has been defined you can begin tracking events with the method TrackEvent() , which takes the following parameters: Event Name (required) - a name to identify the event Event Data (optional) - Object with event data as key/value pairs Callback Function (optional) - Object with a function assigned to the "callback" key data = CreateObject("roAssociativeArray") data.someKey = "someValue" cb = CreateObject("roAssociativeArray") cb.callBack = Function (event) responseHeaders = event.GetResponseHeaders() responseKeys = responseHeaders.Keys() responseCode = event.GetResponseCode() for each key in responseKeys value = responseHeaders[key] print key + " : " + value End for End Function teal.TrackEvent("someEvent", data, cb)  The callback function can be used for a number of purposes, such as: building a retry or fallback system for failed calls building a queueing or throttling system customizing the Logger chaining application logic  Validation Use LiveEvents or Trace to validate that Tealium is receiving your tracking calls. Follow these steps to create a Stream for Roku events: Go to Live Events and cilck Add Stream Set the Title to "Roku Events" Set the Condition to tealium_library_name equals (Custom Value) "roku" Save the Stream Now you can easily filter events using the "Roku Events" Stream. Follow these steps to add a Trace to your app: Get a Trace ID from Visitor Trace in UDH Add a  tealium_trace_id  variable to the data object of your tracking calls and assign it the Trace ID. Trigger events in your Roku app Verify those tracking calls in Visitor Trace Watch this video for a demonstration of using and Trace to validate your implementation: Function Definitions This section specifies the syntax of the functions available in the Tealium for Roku library. Apps for Roku are written in BrightScript, a powerful scripting language. For more information read Roku's BrightScript Language Reference. TealiumBuilder() TealiumBuilder(account as String, profile as String, logLevel as Integer) as Object A builder function to help initialize the Tealium object. Set optional parameters using the utility functions. Create the Tealium object by calling Build(). builder = TealiumBuilder("ACCOUNT", "PROFILE", 1) builder.SetEnvironment("prod") builder.SetDatasource("DATASOURCE") teal = builder.Build() Parameters Type Description account String Tealium account name profile String Tealium profile name (default: "main") environment (optional) String Tealium environment: "qa" or "prod" datasource (optional) String A data source key from UDH eg. "abc123" createTealium() createTealium(account as String, profile as String, env as String, logLevel as Integer) as Object Creates a Tealium object that will be used to track events. teal = createTealium("account", "profile", "env", 3)  Parameters Type Description account String Tealium account name profile String Tealium profile name (usually "main") env String Tealium environment: "qa" or "prod" log level Integer Log level: 0=None, 1=Errors, 2=Warnings, 3=All trackEvent() trackEvent(eventType as String, eventName as String, data as Object, callback as Object) as Void Tracks an event with associated data and, optionally, triggers a callback function. Parameters Type Description eventType String Tealium event type (activity, conversion, derived, interaction, or view) eventName String Name of event (becomes the event_name  attribute in UDH) data Object Contextual event data, an "roAssociativeArray" Object containing keys and values callback Object An Object with a function property named 'callback' that accepts a "roEvent" argument. The callback function will be triggered upon completion of the TrackEvent call. data = CreateObject("roAssociativeArray") data.testKey = "testValue" cb = CreateObject("roAssociativeArray") cb.callBack = Function(event) print "Callback called!" End Function teal.trackEvent("activity", "someEvent", data, cb)  resetSessionId() resetSessionId() as Integer Resets and returns a new session ID. The session ID identifies the current user session, similar to a website session, but it does not expire. A new session ID is created each time createTealium() is called.  teal.resetSessionId() toStr() toStr() as String Returns a readable string containing the configuration details of the current Tealium instance eg. "Tealium instance for account: ACCOUNT profile: PROFILE environment: ENV" print teal.toStr()   Change Log - 1.1.0 Update trackEvent takes an additional String type arg with one of the following values: activity conversion derived interaction view Additional Tealium variable: tealium_event_type - 1.0.0 Initial Release ... 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

The Tealium Lifecycle Module provides app lifecycle tracking capability to an existing 5.x implementation of the Tealium Android framework.   This guide covers the following topics:   Table of Contents Placeholder Installing The Lifecycle Module dependency can be added manually, or via Tealium's Maven repository.   Manual Install  The module can be downloaded here: Tealium Android Lifecycle Tracking Module. Follow these steps add the module to your app: Add tealium.lifecycle-1.x.x.aar to <PROJECT_ROOT>/<MODULE>/libs . Add the Tealium library dependency to your build.gradle file: dependencies { implementation(name:'tealium.lifecycle-1.1.2', ext:'aar') }   Maven Install  Ensure you have the Tealium Maven repo added in your project's build.gradle file // Top-level build file where you can add configuration options common to all sub-projects/modules. buildscript { repositories { jcenter() } dependencies { classpath 'com.android.tools.build:gradle:2.3.3' } } allprojects { repositories { jcenter() // Tealium Maven repo directive maven { url "http://maven.tealiumiq.com/android/releases/" } } } In your app-level build.gradle  file, add the Tealium lifecycle module. The current version is 1.1.2: dependencies { // only add if not already present implementation 'com.tealium:library:5.5.4' // add lifecycle to list of dependencies implementation 'com.tealium:lifecycle:1.1.2' } Tracking The module tracks the following lifecycle events: launch sleep wake These events are indicated in the lifecycle_type  variable. Automatic Tracking Tealium Lifecycle tracking solely associates usage with the Activity lifecycle. The library leverages the Application.ActivityLifecycleCallbacks API and evaluates its conditions on onActivityResumed and onActivityPaused. To enable, call: Tealium.Config config = Tealium.Config.create(application, "YOUR_ACCOUNT", "YOUR_PROFILE", "ENVIRONMENT"); boolean isAutoTracking = true; // Additional instance for Lifecycle tracking LifeCycle.setupInstance("INSTANCE_NAME", config, isAutoTracking); // Standard Tealium instance Tealium.createInstance("INSTANCE_NAME", config);   Launch Event Generated on the first onActivityResumed to occur. If onActivityPaused is called before onActivityResumed (when the library is initialized in the middle of the Activity lifecycle), then the module creation time is used to generate a launch event. Sleep Event Generated 5 seconds after onActivityPaused is called and onActivityResumed was not called. This indicates that the application has been backgrounded because a new view has not been presented. Wake Event Generated during onActivityResumed when more than 5 seconds has elapsed since the last onActivityPaused . This indicates that onActivityResumed is called because the app is foregrounding and not because of a view change. Manual Tracking Available for specific lifecycle paradigms and unconventional lifecycle tracking. This approach is not recommended for most implementations. To allow manual lifecycle tracking update your lifecycle initiation code to set isAutoTracking to false . Tealium and the attached LifeCycle multitons are remote-killable by pubish settings in Tealium iQ. Null checks should be performed when getting the instances to call their methods.  Launch Event To manually track a launch event, call trackLaunchEvent : LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID); if(lifeCycle != null) { // OPTIONAL Map<string, string=""> data = new HashMap<>(); data.put("boot_time", "5ms"); lifeCycle.trackLaunchEvent(data); } Sleep Event To manually track a sleep event, call trackSleepEvent : LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID); if(lifeCycle != null) { // OPTIONAL Map<string, string=""> data = new HashMap<>(); data.put("foreground_time", "4000ms"); lifeCycle.trackSleepEvent(data); } Wake Event To manually track a wake event, call trackWakeEvent : LifeCycle lifeCycle = LifeCycle.getInstance(TEALIUM_INSTANCE_ID); if(lifeCycle != null) { // OPTIONAL Map<string, string=""> data = new HashMap<>(); data.put("background_time", "600000ms"); lifeCycle.trackWakeEvent(data); } Crash Detection When a launch event follows a wake event or vice-versa, this indicates a crash has occurred since the app did not successfully sleep . If the aforementioned sequence occurs because of a Tealium library shutdown, this is not considered to be a crash event. When a crash event is detected, the launch or wake event data will have the lifecycle_diddetectcrash  variable will be added. { "lifecycle_type" : "launch", "lifecycle_diddetectcrash" : "true", //... } Data Layer Variables The module adds the following additional variables for the listed event types (launch, wake, sleep): Variable Description Type Example Event lifecycle_dayofweek_local Local day of week that call was made - 1=Sunday, 2=Monday, etc.) Number "13" all lifecycle_dayssincelaunch Days since first launch in integer increments Number "23" all lifecycle_dayssinceupdate Days since the last detected app version update in integer increments Number "46" all lifecycle_dayssincelastwake Days since last detected wake in integer increments Number "1" all lifecycle_diddetectcrash Only present if a launch event follows a wake event (crash inferred from missing prior sleep event) Boolean "true" launch lifecycle_firstlaunchdate GMT timestamp of very first detected launch/wake in ISO8601 format from Zulu time String "2013-07-11T17:55:04Z"  all   lifecycle_firstlaunchdate_MMDDYYYY  GMT Timestamp formatted as MM/DD/YYYY  String "01/18/2012"   all lifecycle_hourofday_local Local hour of day that call was made (24 hour format)  String "true"  all lifecycle_isfirstlaunch Only present if call is very first launch call String "true" launch lifecycle_isfirstlaunchupdate  Only present if call is first launch after a detected updated Boolean "true" launch lifecycle_isfirstwakemonth Only present if call is first launch/wake of the month Boolean "true" launch, wake  lifecycle_isfirstwaketoday Only present if call is first launch/wake of the day  Boolean  "true" launch, wake lifecycle_launchcount Total number of launches this version of your app (since the last updtae) Number "3"   all lifecycle_secondsawake Whole seconds app was awake since last wake/launch. Sent only with lifecycle_type:sleep or lifecycle_type:terminate calls Number "30" all   lifecycle_priorsecondsawake  Whole seconds app was awake since last launch only. Aggregates total from all wakes prior. Sent only with lifecycle_type: launch calls.  Number  "126"   all lifecycle_sleepcount Total number of times your app has gone to sleep (resets if updated)  Number  "5"    all lifecycle_totalcrashcount Total number of crashes counted since install  (only reset if app deleted)  Number  "21"    all lifecycle_totallaunchcount Total number of launches since install  (only reset if app deleted)  Number  "3"    all lifecycle_totalsecondsawake  Total number of seconds your app has been in a woken/active state since app install  (only reset if app deleted)  Number  "36"   all lifecycle_totalsleepcount  Total number of times your app has gone into the background since app install  (only reset if app deleted)   Number  "400"   all lifecycle_totalwakecount  Total number of launches + wakes since install (only reset if app deleted)  Number   "563"   all lifecycle_type   Type of lifecycle call String "initial", "launch", "wake", "sleep", "terminate"   all lifecycle_updatelaunchdate  GMT timestamp of first wake/launch after a version update has been detected  String  "2014-09-08T18:10:01Z"   all lifecycle_wakecount  Total number of launches + wakes in this version of your app (resets if updated)  Number   "29"   all     ... View more

Once you have the Tealium for Android library added to your app and have configured your mobile iQ profile you are ready to validate your installation. The type of installation will determine the best method for validating. Before You Begin We recommend using a build of your app configured for the "dev" environment rather than "prod" environment. This allows you to use the iQ Publish Environments to isolate your  "dev" configuration from your "production" configuration. The environment is set in the Initialization part of your app's code. This article covers the following topics related to validating your Tealium for Android installation: Table of Contents Placeholder Configuring Your Android App to Use Live Events You can use the Live Events feature of EventStream for the purpose of validating your mobile apps. Live Events will show tracking calls in real-time and is the easiest way to verify that your mobile app is sending data. EventStream/AudienceStream Customers For customers with EventStream/AudienceStream, there are two ways that data will come into the Live Events service: (1) through the Tealium Collect Tag configured for mobile apps using Tag Management and (2) directly from the device for mobile apps using the Collect dispatch service. Read more about these mobile configuration options. Non-AudienceStream Customers Access to Live Events is still available, but is limited to the "dev" environment. If you enable this in a production environment you will be charged for the number of events Tealium processes. Remember to disable these settings prior to a production release. Your EventStream/AudienceStream account must be published before live events will be detected. To send data to Live Events through Tag Management: In your mobile iQ Profile, add the Tealium Collect tag. In the Advanced Settings of the tag, toggle off the QA and Prod publish environments. Publish the Profile to the "Dev" environment. Configure your app to load the "Dev" environment. To send data to Live Events through the mobile Collect library: In your mobile iQ Profile, go to the Mobile Publish settings and enable the Tealium Collect dispatch service. Publish the Profile to the "Dev" environment. Configure your app to load the "Dev" environment. Now when you launch and use your app the tracking calls can be monitored in Live Events. Creating a Live Events Stream for Mobile Live Events will display event activity coming from all tracking sources, but you can create an event feed based on any of the event attributes being passed. This can helpful when validating your mobile installation. To create an event feed for your mobile app: Navigate Live Events. Click Add Event Feed. Enter a title eg. "Mobile Events". Add the condition: tealium_library_name equals (Custom Value) "Android" Click Save The event feed condition can be based on any attribute that uniquely identifies events coming from your app. Read more about creating event feeds.   ... View more

The following variables are populated by the Tealium Android Library as part of the mobile data layer. These variables are included automatically in each tracking call from the library and can now be used in your iQ or AudienceStream configurations. These variables are added to the data layer of your iQ profile when you activate the profile for mobile use.  Addition variables are available in the Lifecycle Tracking Module for 5.0.x. Variable Name Android Version Description app_build 5.4+ App build version e.g. "1" app_name 1.1+ Application name (from the <application> manifest attribute "android:label") app_memory_usage 5.4+ Memory in use by app process (MB) e.g. "57" app_rdns 3.0+ Reverse DNS application ID (from the root manifest attribute "package") app_version 1.1+ Application version [any string] call_type 2.0+ Call type [view/link] carrier 1.1+ Carrier device is currently on [ATT, Verizon, etc.] carrier_iso 1.1+ Carrier iso country code - ISO 3166-1 carrier_mcc 1.1+ Mobile country code - ITU-T Recommendation E.212 carrier_mnc 1.1+ Mobile network code connection_type 1.1+ [wifi, cellular, etc.] device 1.1+ [iphone, ipad, etc.] device_android_runtime 5.4+ Android Runtime version e.g. "2.1.0" device_available_external_storage 5.4+ Total available external storage on device device_available_system_storage 5.4+ Total available storage on device e.g. 273772544 device_architecture 3.0+ Bit architecture of the device [32, 64, etc] device_battery_percent 4.0+ Whole number percent representation of device's remaining power [20, 50,...] device_cputype 3.0+ Cpu type [arm6, arm7, arm7s, etc] device_ischarging 4.0+ Is the device actively charging [true, false] device_language 3.0+ Two-letter ISO-639-1 language setting identifier [en, ja, etc.] device_orientation 5.0+ Orientation of device at time of call [Portrait, Landscape Left, Landscape Right, Portriat UpsideDown, Face Up, Face Down, Unknown] device_os_build 5.4+ Operating System build version e.g. "4499259" device_os_version 5.0+ Operating System version on device [7.0] event_name 5.0+ "mobile_link" required by vdata library_version 1.2+ The version of the Tealium library your app has installed lifecycle_dayofweeklocal* 1.2+ Local day of week that call was made (ie 1=Sunday, 2=Monday, etc.) lifecycle_day ssincelastwake * 1.2+ Days since last detected wake in integer increments lifecycle_dayssincelaunch* 1.2+ Days since first launch in integer increments lifecycle_dayssinceupdate* 1.2+ Days since the last detected app version update in integer increments lifecycle_diddetectcrash* 5.0.3+ Populated 'true' on launch events if crash was determined. lifecycle_firstlaunchdate* 1.2+ GMT timestamp of very first detected launch/wake in ISO8601 format from Zulu time (ie 2013-07-11T17:55:04Z) lifecycle_firstlaunchdate_MMDDYYYY* 1.2+ GMT Timestamp formatted as MM/DD/YYYY (ie 01/18/2012) lifecycle_hourofday_local* 1.2+ Local hour of day that call was made (24 hour format) lifecycle_isfirstlaunch* 1.2+ Only present if call is very first launch/wake call (value = true) lifecycle_isfirstlaunchupdate* 1.2+ Only present if call is first launch/wake after a detected updated lifecycle_isfirstwakemonth* 1.2+ Only present if call is first launch/wake of the month (value = true) lifecycle_isfirstwaketoday* 1.2+ Only present if call is first launch/wake of the day (value = true) lifecycle_lastlaunchdate* 1.2+ GMT timestamp of last recorded launch in ISO8601 format from Zulu time (ie 2013-07-11T17:55:04Z) lifecycle_lastsleepdate* 1.2+ GMT timestamp of last recorded sleep in ISO8601 format from Zulu time (ie 2013-07-11T17:55:04Z) lifecycle_lastwakedate* 1.2+ GMT timestamp of last recorded wake in ISO8601 format from Zulu time (ie 2013-07-11T17:55:04Z) lifecycle_launchcount* 1.2+ Total number of launches this version of your app (resets if app version updates) lifecycle_priorsecondsawake * 1.2+ Whole seconds app was awake since last launch only. Aggregates total from all wakes prior. Sent only with lifecycle_type: launch calls lifecycle_secondsawake* 1.2+ Whole seconds app was awake since last wake/launch. Sent only with lifecycle_type:sleep lifecycle_sleepcount* 1.2+ Total number of times your app has gone to sleep (resets if app version updates) lifecycle_totalcrashcount* 5.0.4+ Total number of times crashes were detected. Does not reset unless app resintalled. lifecycle_totallaunchcount* 1.2+ Total number of launches since install. Does not reset unless app resintalled. lifecycle_totalsecondsawake* 1.2+ Total number of seconds your app has been in a woken/active state. Does not reset unless app resintalled. lifecycle_totalsleepcount* 1.2+ Total number of times your app has gone into the background since install. Does not reset unless app resintalled. lifecycle_totalwakecount* 1.2+ Total number of launches + wakes since install. Does not reset unless app resintalled. lifecycle_type* 1.2+ Type of lifecycle call (ie launch, wake, sleep) lifecycle_updatelaunchdate* 1.2+ GMT timestamp of first wake/launch after a version update has been detected. ISO8601 format from Zulu time (ie 2013-07-11T17:55:04Z) lifecycle_wakecount* 1.2+ Total number of launches + wakes in this version of your app (resets if app version updates) link_id 1.0+ (EVENT CALLS ONLY) General event or link title - this could be a button title or an object's Tealium ID [any string] orientation 2.0+ DEPRECATED Orientation of device at time of call [Portrait, Landscape Left, Landscape Right, Portriat UpsideDown, Face Up, Face Down, Unknown] origin 3.0+ Constant that can be used in mapping to distinguish mobile from web implementations [mobile] os_version 1.1+ Operating System version on device [7.0] page_type 5.0+ "mobile_view" constant that can be used in mapping to distinguish mobile view / page changes from mobile or web events - required by vdata platform 1.0+ [iOS, Android, BB10, etc.] screen_title 1.0+ (VIEW CALLS ONLY) General view title [any string] timestamp 1.1+ Timestamp to seconds of event occurrence (ie 2013-07-11T19:57:47Z) [ISO8601 at Zulu] timestamp_local 2.0+ Local Timestamp to seconds of event occurrence (ie 2013-07-11T19:57:47) [ISO8601 without offset] timestamp_offset 2.0+ Local timezone offset of device's location in hours (ie -3) timestamp_unix 1.1+ GMT/UTC Unix timestamp (ie 1373498679) of event occurrence. timestamp_unix_milliseconds 5.5.1 GMT/UTC Unix timestamp in milliseconds (ie 1373498679123) of event occurrence. uuid 1.2+ (Universally Unique Identifier) Unique for each installation of an app on a device. [any string] visitor_id 5.0+ Tealium-generated visitor_id   ... View more

This guide shows how to add Tealium to your Android Mobile or Android TV app to track user activity. Table of Contents Placeholder Requirements Android Studio Android API Level 19 and higher (KitKat/4.4) For use with iQ Tag Management: Mobile Profile in iQ (see Creating a Mobile Profile) For use with Universal Data Hub: Account enabled for AudienceStream, DataAccess, or EventStream. Get the Code The code for the Tealium Android library can be found on Github. You must download and install the library before proceeding. Download: Tealium for Android Cloning the library, instead of downloading, will make it easier to update to future releases. Installation The current version of the Tealium Android library is 5.5.4, released on 1/23/2019 Tealium uses Maven to install and manage dependencies. Add the Tealium Maven URL to your project root  build.gradle  file: allprojects { repositories { jcenter() maven { url "http://maven.tealiumiq.com/android/releases/" } } } Add the Tealium dependency to your project module  build.gradle file: dependencies { implementation 'com.tealium:library:5.5.4' } Add to Project Manually You can also add the dependency manually. Add flatDir to your project root  build.gradle file: allprojects {     repositories {         jcenter()         flatDir {             dirs 'libs'         }     } } Add tealium-5.x.x.aar to <PROJECT_ROOT>/<MODULE>/libs . Add the Tealium library dependency to your build.gradle file:  dependencies {     implementation(name:'tealium-5.5.4', ext:'aar') }  Initialization The Tealium instance must be configured with the following parameters before it will begin tracking: account - the name of your account profile - the name of your profile environment - one of "qa" or "prod" datasource - (optional) the data source key from UDH instance - a unique name for your instance (multiple instances are supported) Add the following code to the onCreate method in the Application sub-class: Tealium.Config tealConfig = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT"); // Currently optional - add a 6 character alphanumeric data source ID. // If you have not been given a data source ID, you can omit this. Note that this is a mock value tealConfig.setDataSourceId("abc123"); /* setForceOverrideLogLevel - optional - forces the log level to be set to one of "dev", "qa", "prod" or "silent". * Overrides remote publish setting. Remote publish settings used if omitted. */ tealConfig.setForceOverrideLogLevel("prod"); Tealium.createInstance("INSTANCE", tealConfig); When Collect is enabled, v.5.5.1 and above - data will be sent to profile provided in Tealium.Config object v.5.5.0 and below - data will be sent to "main" profile Tracking Views Every time a user opens or changes a screen in the app a tracking call should be made.   A view is tracked by calling trackView()  with two parameters: the name of the screen and (optionally) contextual view data.  The screen name will be populated in the event data as the screen_title  variable. Map<String, Object> data = new HashMap<>(1); data.put("someKey", "someValue"); Tealium.getInstance("INSTANCE").trackView("screenName", data); Tracking Events All non-view activity should be tracked as an event. This is easily done by calling trackEvent() with two parameters: an event name and (optionally) contextual event data. The event name will be populated in the event data as the tealium_event  variable. Map<String, Object> data = new HashMap<>(1); data.put("someKey", "someValue"); Tealium.getInstance("INSTANCE_NAME").trackEvent("someEvent", data);  Overriding The Default Log Level By default, the amount of logging performed by the Tealium library is controlled by the remote publish settings. Sometimes, however, this is not convenient for developers who may not have access to Tealium iQ to change the settings. Since release 5.3.1 of the Tealium library, we now support overriding the log level locally at initialization time. To set a specific log level, use the following snippet: Tealium.Config tealConfig = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT"); /* Options are: * "dev" (warnings, errors, info) * "qa" (errors & warnings only) * "prod" (errors only) * "silent" (no logging, but may produce a couple of lines of log output in cases where the config object hasn't yet been initialized) */ tealConfig.setForceOverrideLogLevel("dev"); // forces the log level to be set to dev Cookie Management  v5.1.0 and above - CookieManager is enabled by default.   v5.0.4 and below - CookieManager is disbabled by default. Enabling CookieManager is required if using Tag Management If you have enabled Tag Managements in your mobile profile then the following code can be added to activate cookie management. This code allows the Tag Management Webview to: acceptCookies acceptThirdPartyCookies acceptFileSchemeCookies This must be placed after the initialization statement. config.getEventListeners().add(createCookieEnablerListener()); private static WebViewCreatedListener createCookieEnablerListener() { return new WebViewCreatedListener() { @Override public void onWebViewCreated(WebView webView) { final CookieManager mgr = CookieManager.getInstance(); // Accept all cookies mgr.setAcceptCookie(true); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { mgr.setAcceptThirdPartyCookies(webView, true); } if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB_MR1) { CookieManager.setAcceptFileSchemeCookies(true); } Log.d(TAG, "WebView " + webView + " created and cookies enabled."); } }; } Additional Resources  Sample Apps API Documentation ... View more

Question How do I access the iOS device logs? Answer Install XCode on your computer. Connect your iOS to your computer with a USB or Lightning cable. Go to Window > Devices and select your device from the list. Click the "up" triangle at the bottom left of the right hand panel. All logs from all apps on the device will be displayed here. If the app is a production build,  it is likely that only critical errors/crashes will be logged. ... View more

Question How do I troubleshoot the hidden web view in Safari? Answer Follow Apple's instructions to enable the web inspector in Safari for Mac OS X and in the iOS device settings. Once you can see your device in the "Develop" menu, open "tags.tiqcdn.com/utag/[account]/[profile]/[environment]/mobile.html" in the list of open web pages on the device. Follow the guide for inspecting mobile.html. This also works when using the iOS Simulator to debug your app ... View more

Question How do I add IDFA to my mobile Data Layer? Answer The following is example code for adding an app's IDFA string to the Data Layer. Learn more about ASIdentifierManager. // Objective-C // 1. Place into a helper class that calls Tealium // 2. Add import statement at the top of the class with other imports - DON'T FORGET to // add the AdSupport.framework in your project's target build. @import AdSupport ; // 3. Add this class function + ( NSString *) identifierForAdvertising { if ([[ ASIdentifierManager sharedManager ] isAdvertisingTrackingEnabled ]){ NSUUID * idfa = [[ ASIdentifierManager sharedManager ] advertisingIdentifier ]; return [ idfa UUIDString ]; } return nil ; } // 4. Example Tealium initialization & adding the IDFA as a persistent data point. + ( void ) startTealium { TEALConfiguration * config = [ TEALConfiguration configurationWithAccount :@ "(account)" profile :@ "(profile)" environment :@ "(environment)" ]; Tealium * tealium = [ Tealium newInstanceForKey :@ "(uniqueId)" configuration : config ]; // Alternatively just add the following 2 lines to wherever a Tealium instance is // already initialized. NSString * idfa = [ self identifierForAdvertising ]; [ tealium addPersistentDataSources :@{@ "idfa" : idfa }]; }   ... View more

Question Does Tealium for iOS support HTTPS and TLS? Answer Yes, the Tealium iOS library supports HTTPS and TLS. The Tealium iOS library uses HTTPS for all communication with and the Tealium Multi-CDN was updated to meet Apple's TLS requirements at the end of 2015.  If you override the library's configuration URL with an HTTP location an exception will have be made in your App Transport Security exceptions.   ... View more

The code for the Tealium iOS library and other Tealium plugins can be found on Github. Version 5.x Tealium for iOS  Version 4.x Tealium for iOS Tealium PhoneGap Plugin Tealium Titanium Plugin Tealium Unity Plugin ... View more

Once you have the iOS library added to your app and have configured your mobile iQ Profile you are ready to validate your installation. The type of installation will determine the best method for validating. Before You Begin We recommend using a build of your app configured for the "dev" environment rather than "prod" environment. This allows you to use the iQ Publish Environments to isolate your  "dev" configuration from your "production" configuration. The environment is set in the Initialization part of your app's code. This article covers the following topics related to validating your Tealium for iOS installation: Table of Contents Placeholder Configuring Your iOS App to Use Live Events You can use the Live Events feature of AudienceStream for the purpose of validating your mobile apps. Live Events will show tracking calls coming into Tealium in real-time and is the easiest way to verify that your mobile app is sending data to Tealium correctly. AudienceStream Customers For customers with an AudienceStream account, there are two ways that data will come into the Live Events service: (1) through the Tealium Collect Tag configured for mobile apps using Tag Management and (2) directly from the device for mobile apps using the Collect dispatch service. Read more about these mobile configuration options. Non-AudienceStream Customers Access to Live Events is still available, but is limited to the "dev" environment. If you enable this in a production environment you will be charged for the number of events Tealium has processed. Remember to disable these settings prior to a production release. To send data to Live Events through Tag Management: In your mobile iQ Profile, add the Tealium Collect tag. In the Advanced Settings of the tag, toggle off the QA and Prod publish environments. Publish the Profile to the "Dev" environment. Configure your app to load the "Dev" environment. To send data to Live Events through the mobile Collect library: In your mobile iQ Profile, go to the Mobile Publish settings and enable the Tealium Collect dispatch service. Publish the Profile to the "Dev" environment. Configure your app to load the "Dev" environment. By default, the data sent using this method will be go to the "main" Profile in your account and not the currently selected Profile. You can change which Profile data is sent to by overriding the display URL in the library code. To send data to a custom Profile by overriding the dispatch URL, use the following code snippets with the desired account/profile: TEALConfiguration * configuration = [ TEALConfiguration configurationWithAccount :@ "[account]" profile :@ "[profile]" environment :@ "dev" ]; [ configuration setOverrideCollectDispatchURL : @ "https://collect.tealiumiq.com/ vdata/i.gif?tealium_account=[account]&tealium_prof ile=[profile]" ]; When using the mobile Collect service you will not see any data from the web view (e.g. cookie data or extension-generated data). You will only see the exact data that was passed to Tealium by the app itself. Now when you launch and use your app the tracking calls can be monitored in Live Events. Creating a Live Events Stream for Mobile Live Events will display event activity coming from all tracking sources, but you can create a filtered Stream of events based on any of the event attributes being passed. This can helpful when validating your mobile installation. To create a filtered Stream for your mobile app: In Universal Data Hub, navigate to Discover > Live Events. Click Add Stream > Filter by Event Attribute. Enter a title eg. "Mobile Events". Leave Event Data Storage disabled. Add the condition: tealium_library_name equals (Custom Value) "iOS" Click Save The Stream condition can be based on any attribute that uniquely identifies events coming from your app. Read more about Creating Streams.   ... View more

The Tealium Support Desk is designed to provide a self-service support portal. We know that many questions can be answered in the user forums or in the product documentation, but for those issues that require expertise or special attention you can submit a request directly to our support team. In this article: Table of Contents Placeholder Accessing Support Desk Support Desk is located at: https://support.tealiumiq.com/ You must sign in to submit a new support request or to review your past requests. Use the same credentials you use to access the Tealium Customer Data Hub and Tealium Learning Center. Submitting a support request You must be signed in to Support Desk to submit a new support request. Our goal is to provide the best service possible in a timely manner. You can help us by entering as much detailed information as possible in the request form. Following these steps and best practices will help expedite your request. Use the following steps to submit a new support request in the Tealium Support Desk portal: Click Submit a request at the top of the page. Enter a descriptive subject line. Example: "Facebook Pixel not firing on Confirmation page" instead of "Pixel broken" Enter a detailed description of the request. The following information is typically needed: Tag UID/Connector name Steps to reproduce QA site access information ie. username/password Test credit card/transaction details Vendor pixel code Relevant Load Rules, Data Mappings, or Extensions Attach any relevant screenshots or vendor documentation. The file size limit for attachments is 20MB. What to expect after submission Within one business day of submitting your ticket, a Tealium representative will be in contact to confirm your ticket submission and follow up with any clarifying questions. Next, your Tealium representative will work on assigning an appropriate resource to your request within two business days after submission. Checking the status of a support request You must be signed in to the Support Desk to check the status of a support request. To check the status of a request: At the top of the page click My activities. To filter the requests displayed, enter a search term in the Search requests or select an option from the Status menu. Click the title of the request to see the details. Creating a follow-up support request Once a solved request has been inactive, it will automatically be closed for additional comments and cannot be reopened.  To create a follow-up to a solved request: At the top of the page, click My activities. In the Status menu, select "Solved" to filter the list of requests. Click the title of the request to see its details. At the bottom of the request, click create a follow-up. Frequently Asked Questions  How do I link two related support requests? It's common for two requests to be related and it can be useful to reference one from the other. In the comment of a request mention the related request by typing the number sign ("#") followed by the request number eg. #123456. This will automatically be linked to the related request.  I have a question that's not listed here. What should I do? It's possible that someone else has your same question, or has already answered it. Trying searching the user forums for an existing article on your question. If nothing comes up you can be the first to post it to the community, and now the next person that has that question will find it in the forums.  ... View more

The Tealium Lifecycle Module provides app lifecycle tracking capability to an existing 5.0.x implementation of the Tealium iOS framework.   This guide covers the following topics:   Table of Contents Placeholder Installing The Lifecycle Module must be added to your app. The module can be downloaded here: Tealium iOS Lifecycle Tracking Module. To add the Lifecycle Module to your app: Add the TealiumIOSLifecycle.framework to your project Add the framework to your Project's: Target: General: Embedded Binaries section In any abstraction class (like TealiumHelper.h) replace any @import TealiumIOS with @import TealiumIOSLifecycle Tracking The module tracks the following lifecycle events: launch sleep wake none (for data added to events but not associated with a lifecycle event) These events are indicated in the lifecycle_type  variable. Automatic Tracking The module can be configured to automatically listen for the standard UIApplication notifications to automatically trigger launch, wake and sleep events. API options to disable are not currently public. Unlink or remove the TealiumTVOS_Lifecycle.framework from your project to remove lifecycle tracking.   Launch Event Generated on when a UIApplicationDidFinishLaunchingNotification notification detected. Sleep Event Generated on when a UIApplicationWillEnterForegroundNotification notification detected. Wake Event Generated on when a UIApplicationWillResignActiveNotification notification detected. Manual Tracking Available for specific lifecycle paradigms and non-conventional lifecycle tracking. These commands will be ignored if the setLifecycleAutotrackingIsEnabled: is set to YES / true Launch Event To manually track a launch event, call: [[Tealium instanceForKey:@"(uniqueInstanceId)"] launch]; Sleep Event To manually track a sleep event, call: [[Tealium instanceForKey:@"(uniqueInstanceId)"] sleep]; Wake Event To manually track a wake event, call: [[Tealium instanceForKey:@"(uniqueInstanceId)"] wake]; Data Layer Variables The module adds the following additional variables: Variable Description Type Example lifecycle_dayofweek_local Local day of week that call was made - 1=Sunday, 2=Monday, etc.) Number "13" lifecycle_dayssincelaunch Days since first launch in integer increments Number "23" lifecycle_dayssinceupdate Days since the last detected app version update in integer increments Number "46" lifecycle_dayssincelastwake Days since last detected wake in integer increments Number "1"   lifecycle_diddetectcrash Only present if a crash was detected.  Boolean "true" lifecycle_firstlaunchdate GMT timestamp of very first detected launch/wake in ISO8601 format from Zulu time String "2013-07-11T17:55:04Z"  lifecycle_firstlaunchdate_MMDDYYYY  GMT Timestamp formatted as MM/DD/YYYY  String "01/18/2012" lifecycle_hourofday_local Local hour of day that call was made (24 hour format)  String "true" lifecycle_isfirstlaunch Only present if call is very first launch/wake call String "true" lifecycle_isfirstlaunchupdate  Only present if call is first launch/wake after a detected updated Boolean "true" lifecycle_isfirstwakemonth Only present if call is first launch/wake of the month Boolean "true" lifecycle_isfirstwaketoday Only present if call is first launch/wake of the day  Boolean  "true" lifecycle_launchcount Total number of launches this version of your app (since the last updtae) Number "3" lifecycle_secondsawake Whole seconds app was awake since last wake/launch. Sent only with lifecycle_type:sleep or lifecycle_type:terminate calls Number "30" lifecycle_priorsecondsawake  Whole seconds app was awake since last launch only. Aggregates total from all wakes prior. Sent only with lifecycle_type: launch calls.  Number  "126" lifecycle_sleepcount Total number of times your app has gone to sleep (resets if updated)  Number  "5"  lifecycle_totalcrashcount Total number of crashes counted since install  (only reset if app deleted)  Number  "21"  lifecycle_totallaunchcount Total number of launches since install  (only reset if app deleted)  Number  "3"  lifecycle_totalsecondsawake  Total number of seconds your app has been in a woken/active state since app install  (only reset if app deleted)  Number  "36" lifecycle_totalsleepcount  Total number of times your app has gone into the background since app install  (only reset if app deleted)   Number  "400" lifecycle_totalwakecount  Total number of launches + wakes since install (only reset if app deleted)  Number   "563" lifecycle_type   Type of lifecycle call String "initial", "launch", "wake", "sleep", "terminate" lifecycle_updatelaunchdate  GMT timestamp of first wake/launch after a version update has been detected  String  "2014-09-08T18:10:01Z" lifecycle_wakecount  Total number of launches + wakes in this version of your app (resets if updated)  Number   "29"     ... View more