The Attribution module adds the user-resettable advertising identifier (IDFA) to each tracking call and, optionally, implements the Apple Search Ads API to gather attribution information. Learn more for details about Apple Search Ads.
Usage of this module is optional. Take the time to read about its functionality and decide if you need it, as it introduces additional dependencies. You are required to explain to Apple why you are using IDFA when you submit your app. If you do not state that you are using IDFA, Apple rejects your app. Learn more about IDFA usage and rejections.
The following platforms are supported:
Install the Attribution module with CocoaPods or Carthage.
To install the Attribution module with CocoaPods, add the following pod to your Podfile:
The framework is auto-instantiated. It has a dependency on the TealiumCore pod. Learn more about CocoaPods installation for iOS.
To install the Attribution module with Carthage, following these steps:
Go to the app target’s General configuration page in Xcode.
Add the following framework to the Embedded Binaries section:
The framework is auto-instantiated. It has a dependency on TealiumCore. No additional import statements are necessary. Learn more about Carthage installation for iOS.
The following variables are transmitted with each tracking call while the module is enabled:
The corresponding ad’s campaign ID
The corresponding ad’s campaign name
The ID of the Creative Set which the corresponding ad was part of.
The name of the Creative Set which the corresponding ad was part of.
The corresponding ad’s campaign group ID
The corresponding ad’s campaign group name
The keyword that drove the ad impression which led to the corresponding ad click
This may either be Broad, Exact or Search Match.
The corresponding ad’s campaign organization ID
The corresponding ad’s campaign organization name
Date and time the user first downloaded your app. In the case where iadconversion-type = “Redownload”, this represents the original purchase date. This may or may not have been associated with an Apple Search Ad.
Identifies the country or region associated with the campaign which drove this install.
Boolean indicating if user clicked on a Search Ads impression within 30 days prior to app download
Identifies new download or re-download of the app
Date and time the user clicked on a corresponding ad
Date and time the user downloaded the app
Boolean indicating if the user allowed ad tracking (if false, the advertising ID appears as a string of zeroes)
User-resettable advertising identifier (IDFA)
Unique ID guaranteed to be the same across all apps on the same device from a single vendor (apps with the same 1st 2 parts of the RDNS bundle identifier. For example, com.tealium or com.acme)
The variables prefixed with ad_ are only enabled if Search Ads has been explicitly enabled in the TealiumConfig object. These variables are only retrieved from Apple’s servers once during the app’s lifetime, but they are stored as persistent variables so they are available on future app launches.