Tealium Learning Center

This article describes how to set up the Kochava Mobile Remote Command tag in your Tealium iQ Tag Management account. In this article: Tag Tips Use mappings to: Override standard config values and set custom parameters Trigger standard and custom events This is a Mobile Remote Command companion tag for the native mobile app SDK. Tag Configuration First, go to the tag marketplace and add the Kochava Mobile Remote Command tag (Learn more about how to add a tag). After adding the tag, configure the following settings: App ID App Tracking Transparency Enabled Data Mappings Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see data mappings. The available categories are: Configuration Parameters Variable Description app_guid App ID app_tracking_transparency_enabled App Tracking Transparency Enabled Value are true or false. identity_link_ids Identity Link IDs log_level Log Level Events Variable Description adclick Ad Click adview Ad View addtocart Add to Cart addtowishlist Add to Wish List achievement Achievement checkoutstart Checkout Start tutorialcomplete Tutorial Complete consentgranted Consent Granted initialize Initialize invalidate Invalidate levelcomplete Level Complete purchase Purchase pushopened Push Opened pushreceived Push Received rating Rating registrationcomplete Registration Complete search Search sendidentitylink Send Identity Link sleeptracker Sleep Tracker setsleep Set Sleep starttrial Start Trial subscribe Subscribe view View custom Custom All Parameters <<<<<<<<<<<<<< Variable Description action Action ad_campaign_id Ad Campaign ID ad_campaign_name Ad Campaign Name ad_device_type Ad Device Type ad_group_id Ad Group ID ad_group_name Ad Group Name ad_mediation_name Ad Mediation Name ad_network_name Ad Network Name ad_size Ad Size ad_type Ad Type app_store_receipt_encoded App Store Receipt Encoded apple_watch_id Apple Watch ID background Background checkout_as_guest Checkout as Guest completed Completed content_id Content ID content_type Content Type currency Currency custom_event_name Custom Event Name date_now Date description Description destination Destination duration Duration end_date End Date from_apple_watch From Apple Watch item_added_from Item Added From level Level max_rating_value Max Rating Value name Name order_id Order ID origin Origin placement Placement price Price quantity Quantity rating_value Rating Value receipt_id Receipt ID referral_from Referral From registration_method Registration Method results Results score Score search_term Search Term sleep Sleep spatial_x Spatial X spatial_y Spatial Y spatial_z Spatial Z start_date Start Date success Success user_id User ID user_name User Name uri URI validated Validated custom Custom Event Parameters Variable Description adclick Ad Click adview Ad View addtocart Add to Cart addtowishlist Add to Wish List achievement Achievement checkoutstart Checkout Start completetutorial Complete Tutorial consentgranted Consent Granted initialize Initialize invalidate Invalidate levelcomplete Level Complete purchase Purchase pushopened Push Opened pushreceived Push Received rating Rating registrationcomplete Registration Complete search Search sendidentitylink Send Identity Link setsleep Set Sleep sleeptracker Sleep Tracker starttrial Start Trial subscribe Subscribe view View custom Custom ... View more

Apple's annual user conference took place in June (for the first time, an entirely virtual event), and among all the exciting announcements about new hardware and apps, was the slightly less exciting, but equally headline-worthy change of direction regarding usage of the IDFA (Identifier for Advertisers - Apple's user-resettable marketing ID). The change essentially means that while it's still technically possible for marketers to access the IDFA, they can only do so with the user's explicit consent, which comes in the form of a mandated (and quite intimidating-looking) "permission to track" modal dialog when the app launches for the first time. It's worth noting that users have always had control over the IDFA from the Settings app - if "Limit Ad Tracking" was enabled, apps couldn't access the IDFA at all - but this is the first time that the option to opt out has been presented in such an obvious place, and many users would have been unaware of the old setting and have probably never changed it. With the new setting, if the user declines consent, then the IDFA isn't available to the app, which makes it difficult for app publishers to identify, amongst other things, the effectiveness of their ad campaigns, and makes it more likely that users will see ads that aren't relevant to them. What does this mean for the digital marketing industry? Many advertisers and marketers are understandably concerned about this move, and wondering what it will mean for not only their ad campaigns, but maybe even their jobs; whole industries are built around the current model of attribution, and perhaps advertisers will suddenly decide it's not worth the hassle to spend money on advertising to iOS users. I think this scenario is unlikely, and in the worst case, ad spend may shift temporarily towards Android, but it's easy to see why people are concerned. The industry has come through many tumultuous events in recent years (GDPR, ITP, CCPA), and I'm sure that it will continue past this latest speed bump. What are the main focus points of the new Apple guidelines? The spirit of the new Apple guidelines appears to be that you must gain explicit user permission through the new AppTrackingTransparency framework whenever you track your users in a way that links their data with data from third-party SDKs, ad networks, or data brokers, for example, Oracle Bluekai, Lotame, and MediaMath. What is the impact for Tealium customers? Tealium does not directly use the IDFA, and our SDKs do not collect it by default (there is an optional module you can use if you need this). If you are collecting the IDFA and using it anywhere in the Tealium platform as a visitor identifier (something we don’t recommend due to its transient nature), then it’s important to note that you will no longer have access to it if your users opt out of tracking. Instead, we would recommend using a known first-party identifier, such as a hashed email address. If you are sending the IDFA to any third-party tools using connectors or tags, be aware that these integrations may stop functioning correctly if a user opts-out of tracking. We recommend checking if any of the connectors or tags in your Tealium account are using the IDFA, and if so, contact the vendor and find out what their recommendations are to continue using their software for users who have opted-out (assuming those vendors’ products still comply with Apple’s AppTrackingTransparency guidelines). Do I need the user's permission to enable the Tealium SDK? Apple's guidelines give the following definition of in-app tracking: Tracking refers to the act of linking user or device data collected from your app with user or device data collected from other companies’ apps, websites, or offline properties for targeted advertising or advertising measurement purposes. Tracking also refers to sharing user or device data with data brokers. Source: https://developer.apple.com/app-store/user-privacy-and-data-use/ Retrieved: 24th July 2020 According to this definition, a Tealium customer using the AudienceStream platform to build visitor profiles and act on this data solely using the tools we provide would not fall within this definition, since there are no data brokers (DMPs) involved, and the data is not being sent anywhere outside of the Tealium platform. Tealium also does not provide any advertising or ad measurement capabilities. If you are sending data to an analytics platform that you own, and one that does not incorporate third-party data, then it appears that this would also be allowed under the new rules, without obtaining explicit permission. If, however, your analytics platform is linked to an ad network - for example, if your Google Analytics property is linked to your Google Ads account - this would require explicit permission from the app user. The following table explains in simple terms when you should use the AppTrackingTransparency framework in conjunction with the Tealium SDK. Please note that these are just guidelines, and you should use your own judgement and work with your company's legal team to make sure you are satisfied that your app is compliant, to ensure your app doesn't get rejected when you submit it to the app store. Using the SDK to... Permission Required? Send data to Tealium AudienceStream and use the data solely to enrich what your company knows about the user. No server-side connectors enabled. No Send data to Tealium AudienceStream and forward some of this data to third-party vendors through connectors Yes, unless: The third-party is using the data solely for fraud detection/prevention, and solely on your behalf The vendor is using your data solely in a first-party context, for example, sending profile data to your Optimizely account to allow for on-site personalization on your own website/apps Send data to Tealium EventStream and forward the data to your analytics vendor through a connector No, unless: Your analytics property is linked to an ad network to provide personalized ads Send data to Tealium iQ (client-side) to trigger third-party JavaScript tags Yes, if those tags fall under the tracking definition provided by Apple. No, if you're only sending data to an analytics property that's not linked to an ad network How does this fit with existing privacy legislation? The AppTrackingTransparency framework sits alongside existing privacy requirements, and using this framework alone does not guarantee compliance with local privacy laws, such as GDPR and CCPA. Fortunately, Tealium can help with this; enter the Tealium Consent Management modules, available for both iOS and Android! These modules make it easy to manage your app users' consent settings at a very granular level, and have support for GDPR and CCPA, and are easily extensible to accommodate future privacy laws, such as the catchily-named SB220 for Nevada (other countries also in the process of updating their privacy laws, most of which are modeled after GDPR, include Thailand, Japan, and New Zealand). Depending on the requirements of the active consent policy, the Tealium Consent Management modules allow your users to opt-in/out of all tracking, or a customizable category-based opt-out, with 15 predefined categories to choose from. Whether you need to use the AppTrackingTransparency framework or not, the Tealium Consent Management modules can complement and enhance your app's approach to privacy and user consent, and we encourage you to check them out! Learn more about Consent Management for Mobile. Is this the end for third-party data? Tealium has always strongly advocated for first-party data, as this is always more reliable than third-party data. If you're curious to see third-party data in action, take a look at the Oracle Data Cloud Consumer Data Privacy tool, which enables you to view a PDF report showing all the information Oracle has gleaned from your online activity. It was news to me that I have a brand affinity for Victoria's Secret, Chanel, and Gucci, but perhaps this reveals more about my online shopping habits than I care to share here! Joking aside, there's a lot of high-quality first-party data waiting to be tapped into that you can make use of directly in Tealium without having to send your data to any third parties, and Tealium does not use or share any of this information for our own purposes. How can I measure the effectiveness of my ad campaigns? In a post-IDFA world, assuming most users opt out of tracking, it's pretty much a foregone conclusion that measuring ad campaign effectiveness is going to get harder, and it's a fact that marketers will get much less visibility (at least at a granular per-user level) of how effective their ad spend has been. However, where Apple takes away with one hand, they give with the other, in the form of enhancements to the SKAdNetwork framework. This provides a method for ad networks to validate app installs anonymously, and still measure the effectiveness of individual campaigns via a postback from the App Store directly to the ad network. The only data the ad network receives is confirmation that the app was successfully installed, along with the campaign ID and, optionally, conversion value. About Conversion Value The conversion value helps to assign a monetary or other value to the app install, which helps to see if a particular campaign has been more valuable than another; not simply which campaign generated the most installs. If, for example, your ad appears in an app selling luxury watches, you might find that it generates more revenue per user than if it appeared in a social media app, even if the social media app generated more installs overall. If you need to assign a conversion value, it's worth noting that the time taken to report back to the ad network will increase, so it may take longer to see how successful your campaign has been. How does this work? When your app is first launched, you should call SKAdNetwork.registerAppForAdNetworkAttribution() , which will inform the SKAdNetwork framework that it should send an attribution postback to the ad network. Rather than sending immediately, this API starts a 24 hour timer, after which time, if no conversion events have been registered, the postback will fire some time within the next 24 hours (so in the worst case, you could be waiting 48 hours to see the results). If you wish to report conversion events, you can do this by calling SKAdNetwork.updateConversionValue() , which accepts an integer value representing the amount of the conversion. This value has no unit, so it's up to you (or the ad network) to determine its meaning - be that dollars, pounds, or number of levels completed in a game. Each time you call updateConversionValue() with a new value, you overwrite the previous value, assuming the new value is higher than the current value. Additionally, a new rolling 24 hour timer is started, and only once this expires does the conversion event get sent back to the ad network, so if the user used your app once per day, and each time it was just under 24 hours since they last used it, it could be several days before the install finally gets attributed. When the last timer has expired (meaning updateConversionValue() hasn't been called within the past 24 hours), the conversion event will be reported any time between 0-24 hours later (this is random every time, so the only guarantee you have is that it will be within 24 hours). Can Tealium help with SKAdNetwork attribution? To save developers the monotony of manually adding the required API calls to their app code, we're currently working on a module for the iOS library that will allow you to easily call the SKAdNetwork APIs by using your existing Tealium event tracking to both register for attribution and update conversion values. We hope to have this ready in time for the iOS 14 release, so watch this space for updates! Update - October 2020: SKAdNetwork support for the Tealium Swift library has now arrived! See release notes for details. Requires Tealium Swift 2.1.1. Hopefully this post has made the new privacy changes in iOS14 seem a little less intimidating, but if you're still a little unsure, feel free to start a discussion on our Developer Forum, or contact the support team, who will be happy to help. Sources: https://www.singular.net/blog/idfa-faq https://developer.apple.com/documentation/storekit/skadnetwork ... View more

Hi @Giri3072 Tealium doesn't track this data automatically - you would need to send it when your app is launched from the ad link. This should be fairly simple for your developers to do. We do, however, have modules for Android and Swift that are able to track installs coming via the Google Play store, and Apple Search Ads respectively. In the case of Google Play, we use the Google Play Install Referrer API, which passes utm parameters through to the app, which are in turn tracked by our Install Referrer module: https://docs.tealium.com/platforms/android/referrer-module/. For iOS (Swift), you can find the documentation here: https://docs.tealium.com/platforms/swift/module-list/attribution/. I hope this helps. Let me know if you need further clarification. Craig. ... View more

Purpose Provides a method of accessing a previously-instantiated instance of Tealium , using the key format "account.profile.environment" . 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 getInstanceByName Returns a Tealium instance for a specified account/profile/environment key. getInstanceByName(instanceKey: String) -> Tealium? Parameters Type Description instanceKey String The name of the Tealium class instance to be retrieved (format: "(account).(profile).(environment)") let instanceManager = TealiumInstanceManager.shared let myTealiumInstance = instanceManager.getInstanceByName("tealiummobile.demo.dev") // now call any methods on the Tealium instance you just retrieved // myTealiumInstance?.track("myevent") // note: returns an optional tealiumInstances Property returning a dictionary of all registered Tealium instances. let instanceManager = TealiumInstanceManager.shared let allTealiumInstances = instanceManager.tealiumInstances // do any required processing with the dictionary of valid Tealium instances Change Log 1.6.5 Initial release ... View more

This module provides a convenient implementation of the Tealium Consent Manager, which can help your app to comply with legal obligations, such as GDPR. Once implemented, your user will be able to easily consent to or decline tracking, and the Tealium SDK will store and respect their choice from that point on. In this article: Overview How It Works The Consent Manager module is enabled by default. In its default state, before any consent preferences have been set, it will queue* all events received prior to the initial consent being granted by the user (the "unknown" state). It will continue doing this until such point as the user consents, or revokes their consent. At the point where the app user makes a selection, the following will happen: (*To deactivate this functionality, so that tracking calls are not queued prior to consent being granted, use the "setInitialUserConsentStatus(.notConsented)" on the config object. If this is implemented, tracking calls sent prior to opt-in will be discarded, including Lifecycle hits). If the user consents to tracking All previously-queued tracking calls will be sent The user's consent state will be stored permanently, and will be checked each time a new tracking call is made If the user has set customized preferences, and consented only to specific categories, these categories will be respected when tags or connectors are fired in Tealium iQ and EventStream respectively If Consent Logging is enabled, a single tracking call will be sent to UDH, to keep track of the user's consent preferences for auditing purposes only. If the user grants partial consent (selected categories) If Consent Logging is enabled, a single tracking call will be sent to UDH, to keep track of the user's consent preferences for auditing purposes only If the user declines tracking All previously-queued tracking calls will be purged from the queue All future tracking calls will be canceled No events will be sent to the UDH. Declined consent state cannot be tracked in the UDH. Supported Platforms iOS, tvOS, watchOS, macOS External Dependencies Foundation Recommended Usage Usage of this module is recommended. It is automatically included and enabled in Carthage and CocoaPods framework builds. Disabling Consent Manager If you do not need to use Consent Manager, it can be disabled by including it in the list of disabled modules on the TealiumConfig object at initialization time. Included Variables The following variables will be transmitted with each tracking call while the module is enabled: Variable Name Description Example Value policy The policy under which consent was collected gdpr (default value) consent_status The user's current consent status consented/notConsented consent_categories An array of the user's selected consent categories ["analytics", "cdp"] Public API consentManager class MyClass { var tealium: Tealium? public init () { let config = TealiumConfig(account: "<youraccount>", profile: "demo", environment: "dev", datasource: "abc123", optionalData: nil) self.tealium = Tealium(config) { // Note: this is inside the completion block after initialization // self.tealium is guaranteed to be initialized inside the completion block self.tealium?.consentManager()?.#### // where #### is any public API method on the consentManager object } } } This code shows how to access the consent manager. addConsentDelegate tealium?.consentManager()?.addConsentDelegate(self) Registers a specific class conforming to the TealiumConsentDelegate protocol. Parameters Description delegate A class conforming to TealiumConsentDelegate removeAllConsentDelegates tealium?.consentManager()?.removeAllConsentDelegates() Removes all consent delegates added by you. Retains the built-in delegate created by the TealiumConsentManagerModule class. setUserConsentStatus tealium?.consentManager()?.setUserConsentStatus(.consented) Sets the user's consent status. Designed to be called from your consent management preferences screen in your app when the user enables or disables tracking. Will always set the list of consented categories to include ALL available consent categories, if the status is .consented . Does not allow categories to be set selectively. Parameters Description Example Value status A value from TealiumConsentStatus enum .consented / .notConsented setUserConsentCategories tealium?.consentManager()?.setUserConsentCategories([.analytics,.bigData]) Sets the user's consent categories. Designed to be called from your consent management preferences screen in your app. Will always set consent status to .consented . Parameters Description Example Value categories An array of values from the TealiumConsentCategories enum [.analytics,.bigData] setUserConsentStatusWithCategories tealium?.consentManager()?.setUserConsentStatusWithCategories(status: .consented, categories: [.analytics]) Sets consent status and categories in a single call. Parameters Description Example Value status A value from TealiumConsentStatus enum .consented / .notConsented categories An array of values from the TealiumConsentCategories enum [.analytics] getUserConsentStatus let consentStatus: TealiumConsentStatus? = tealium?.consentManager()?.getUserConsentStatus() Returns the current consent status. getUserConsentCategories let consentCategories: [TealiumConsentCategories]? = self.tealium?.consentManager()?.getUserConsentCategories() Returns the current consent categories. getUserConsentPreferences let prefs: TealiumConsentUserPreferences? = tealium?.consentManager()?.getUserConsentPreferences() Returns the TealiumConsentUserPreferences object (by value -> struct). resetUserConsentPreferences tealium?.consentManager()?.resetUserConsentPreferences() Clears all currently stored consent preferences. Reverts to "unknown" consent state, with no categories. TealiumConfig Methods setConsentLoggingEnabled let config = TealiumConfig(...) config.setConsentLoggingEnabled(true) Enables the Consent Logging feature, which sends all consent status changes to UDH for auditing purposes. Parameters Description Example Value enabled Bool true (default: false) isConsentLoggingEnabled let config = TealiumConfig(...) let isEnabled = config.isConsentLoggingEnabled() Returns the current state of the consent logging feature. setInitialUserConsentStatus let config = TealiumConfig(...) config.setInitialUserConsentStatus(.notConsented) Sets the initial consent status for the user when the library starts up for the first time. If there are saved preferences, these will override any preferences passed in the config object. Will always set the list of consented categories to include ALL available consent categories, if the status is .consented . Does not allow categories to be set selectively. Parameters Description Example Value status A value from TealiumConsentStatus enum .consented/.notConsented setInitialUserConsentCategories let config = TealiumConfig(...) config.setInitialUserConsentCategories([.analytics]) Sets the user's initial consent categories when the library starts up for the first time. If there are saved preferences, these will override any preferences passed in the config object. Will always set consent status to .consented . Parameters Description Example Value categories An array of values from the TealiumConsentCategories enum [.analytics,.bigData] getInitialUserConsentStatus let config = TealiumConfig(...) let status: TealiumConsentStatus? = config.getInitialConsentStatus() Getter for the consent status currently set on the config object. May not match the consent status set in the consentManager if the user has changed their preferences since the library launched. getInitialUserConsentCategories let config = TealiumConfig(...) let categories: [TealiumConsentCategories]? = config.getInitialConsentCategories() Getter for the consent categories currently set on the config object. May not match the consent categories set in the consentManager if the user has changed their preferences since the library launched. setOverrideConsentPolicy let config = TealiumConfig(...) config.setOverrideConsentPolicy("mycustompolicy") Overrides the default policy parameter. Default is gdpr . Parameters Description Example Value policy A string value describing the policy to set for consent logging purposes "mycustompolicy" getOverrideConsentPolicy let config = TealiumConfig(...) let currentPolicy = config.getOverrideConsentPolicy() Returns the current consent policy override, if applicable. Optional. Delegate Methods (TealiumConsentManagerDelegate) willDropTrackingCall func willDropTrackingCall(_ request: TealiumTrackRequest) { print("**** Tracking call DROPPED ******") print(request.data) } This method is called whenever the consent manager is going to drop a tracking call (i.e. the user has declined tracking consent). willQueueTrackingCall func willQueueTrackingCall(_ request: TealiumTrackRequest) { print("**** Tracking call Queued ******") print(request.data) } This method is called whenever the consent manager is in the "unknown" state, and tracking calls are being queued locally until the user grants or declines consent. willSendTrackingCall func willSendTrackingCall(_ request: TealiumTrackRequest) { print("**** Tracking call Sent") print(request.data) } This method is called whenever the user has consented to tracking, and a tracking call is about to pass through the consent manager without being blocked. consentStatusChanged func consentStatusChanged(_ state: TealiumConsentStatus) { print(state) } This method is called whenver the consent state has been successfully updated. userConsentedToTracking func userConsentedToTracking() { print("User Consented") } This method is called whenever the consent state is changed to .consented . userOptedOutOfTracking func userOptedOutOfTracking() { print("User Declined Tracking") } This method is called whenever the user declines/revokes consent (consent status: .notConsented ). userChangedConsentCategories func userChangedConsentCategories(categories: [TealiumConsentCategories]) { print("Categories Changed") } This method is called whenever the user updates their consent categories preferences. Enums and Constants TealiumConsentCategories Enum Values .analytics .affiliates .displayAds .email .personalization .search .social .bigData .mobile .engagement .monitoring .cdm .cdp .cookiematch .misc This enum contains the complete list of supported consent categories. all let allCategories: [TealiumConsentCategories] = TealiumConsentCategories.all() Returns the complete list of supported consent categories. consentCategoriesStringArrayToEnum let selectCategories: [TealiumConsentCategories] = TealiumConsentCategories.consentCategoriesStringArrayToEnum(["analytics","bigData"]) Converts an array of strings containing valid consent categories to an array of enum values. Invalid string values will be omitted from the resulting array. Parameters Description Example Value [String] An array of strings to convert into an array of TealiumConsentCategories ["analytics", "bigData"] TealiumConsentStatus unknown let status: TealiumConsentStatus = .unknown The unknown status is the default setting for the consent manager. In this state, the consent manager will queue events locally until an affirmative consented / notConsented status is provided. consented let status: TealiumConsentStatus = .consented The consented status is set when the user has consented to tracking. In this state, the consent manager allow all tracking calls to continue as normal. notConsented let status: TealiumConsentStatus = .notConsented The notConsented status is set when the user has declined tracking. In this state, the consent manager will drop all tracking calls and halt further processing by the SDK. TealiumConsentConstants (Internal) public enum TealiumConsentConstants { static let consentCategoriesKey = "consent_categories" static let trackingConsentedKey = "tracking_consented" static let consentGrantedEventName = "grant_full_consent" static let consentDeclinedEventName = "decline_consent" static let consentPartialEventName = "grant_partial_consent" static let updateConsentCookieEventName = "update_consent_cookie" static let moduleName = "consentmanager" static let consentLoggingEnabled = "consent_manager_enabled" static let consentStatus = "consent_status" static let policyKey = "policy" static let defaultPolicy = "gdpr" } This enum is used internally by the SDK to provide a central place to configure static key names.   Implemented Code Examples Please see GitHub for latest sample apps Use Case 1: Simple Opt-in func setConsentStatusSimple(_ consented: Bool) { let status: TealiumConsentStatus = consented ? .consented: .notConsented self.tealium?.consentManager()?.setUserConsentStatus(status) } This example shows you how to give your users a simple "Opt-in/Opt-out" option. If the user consents, they will be automatically opted-in to all tracking categories. If they revoke their consent, no categories will be active, and no tracking calls will be sent. Define and call the following method in your Tealium Helper class when your app user consents to or declines tracking. If the user consents to tracking, the Consent Manager will automatically opt them in to all tracking categories. Use Case 2: Grouped Opt-in func updateConsentPreferences(_ dict: [String: Any]) { if let status = dict["consentStatus"] as? String { var tealiumConsentCategories = [TealiumConsentCategories]() let tealiumConsentStatus = (status == "consented") ? TealiumConsentStatus.consented : TealiumConsentStatus.notConsented if let categories = dict["consentCategories"] as? [String] { tealiumConsentCategories = TealiumConsentCategories.consentCategoriesStringArrayToEnum(categories) } self.tealium?.consentManager()?.setUserConsentStatusWithCategories(status: tealiumConsentStatus, categories: tealiumConsentCategories) } } // example function to define groups of categories, and set the consent preferences in the consentManager API. Should be called when the user saves their preferences func setUserConsentPreferences(){ // define a dictionary containing grouped categories let consentGroups = ["Off" : [], "Performance": ["analytics", "monitoring", "big_data", "mobile", "crm"], "Marketing": ["analytics", "monitoring", "big_data", "mobile", "crm", "affiliates", "email", "search", "engagement", "cdp"], "Personalized Advertising": ["analytics", "monitoring", "big_data", "mobile", "crm", "affiliates", "email", "search", "engagement", "cdp", "display_ads", "personalization", "social", "cookiematch", "misc"]] // this is the user's selected preferences level. Would usually be dynamic in a real app let userSelection = "Marketing" if let userList = consentGroups[userSelection] { let settingsDict: [String: Any] = ["consentStatus": "consented", "consentCategories": userList] updateConsentPreferences(settingsDict) } } This example shows a category-based consent model, where tracking categories are grouped into a smaller number of higher-level categories, defined by you. For example, you may choose to group the Tealium consent categories "big_data", "analytics", and "monitoring" under a single category called "performance". This may be easier for the user than selecting from the full list of categories. You may choose to represent this in a slider interface, ranging from least-permissive to most-permissive (all categories). Use Case 3: Category-based Opt-in // helper method to call Tealium consentManager API func updateConsentPreferences(_ dict: [String: Any]) { if let status = dict["consentStatus"] as? String { var tealiumConsentCategories = [TealiumConsentCategories]() let tealiumConsentStatus = (status == "consented") ? TealiumConsentStatus.consented : TealiumConsentStatus.notConsented if let categories = dict["consentCategories"] as? [String] { tealiumConsentCategories = TealiumConsentCategories.consentCategoriesStringArrayToEnum(categories) } self.tealium?.consentManager()?.setUserConsentStatusWithCategories(status: tealiumConsentStatus, categories: tealiumConsentCategories) } } // example function to take a list of categories and pass to the Tealium consentManager API func setUserConsentPreferences(_ categories: [String]){ let settingsDict: [String: Any] = ["consentStatus": "consented", "consentCategories": categories] updateConsentPreferences(settingsDict) } This example shows a category-based consent model where the user must explicitly select each category from the full list of categories. The default state is "Unknown", which will queue hits until the user provides their consent. If the user consents to any category, events are de-queued, and the consented category data is appended to each tracking call. Video Please see this video for an implemented example. Future Improvements Remote configuration options via Tealium iQ Change Log Build 1 Initial release ... View more

This module works in conjunction with the Connectivity module and the Consent Manager module to store any pending dispatches to disk while the device is offline or the user has not yet consented to tracking. When connectivity is restored, or if the user consents to tracking, the queue of dispatches will be sent. There is a default limit of 20 dispatches in the queue. When the limit is exceeded, the oldest dispatch will be cleared to make room for the most recent. Data is stored in UserDefaults. In this article: Table of Contents Placeholder Supported Platforms iOS tvOS watchOS macOS Installation CocoaPods Framework will be auto-instantiated if the pod is installed. Depends on TealiumCore pod. No additional import statements necessary other than  import TealiumSwift . pod 'tealium-swift/TealiumDispatchQueue Carthage Framework will be auto-instantiated if it is compiled into your app (included in "Embedded Binaries"). Depends on TealiumCore . No additional import statements necessary.   TealiumDispatchQueue.framework Recommended Usage Usage of this module is required if using the Consent Manager or Connectivity modules. Otherwise, it is strongly recommended to aid with pre-init queueing of events by the TealiumCore module. Included Variables The following variable will be transmitted with each tracking call while the module is enabled: Variable Name Description Example Value was_queued Indicates that the dispatch was queued true Public API There are no public API methods for this module. Successes and failures may be monitored through the Delegate module. TealiumConfig Methods setMaxQueueSize let config = TealiumConfig(account: "tealiummobile", profile: "demo", environment: "dev", datasource: "test12", optionalData: nil) config.setMaxQueueSize(50) Sets the maximum persistent queue size for dispatch storage. Default is 20 events. getMaxQueueSize let config = TealiumConfig(account: "tealiummobile", profile: "demo", environment: "dev", datasource: "test12", optionalData: nil) config.setMaxQueueSize(50) let queueSize: Int = config.getMaxQueueSize() Gets the maxiumum queue size set on the TealiumConfig object. Future Improvements No planned changes Change Log Build 1 Initial release ... View more