Skip to Content
DocumentationiOS SDKATT & IDFA

Tracking permission and sharing

ATT prompting is disabled by default. The current SDK uses an app-instance UUID for ingestion regardless of ATT status; it does not fall back to fingerprint matching when permission is denied.

Optional ATT prompt

If your app’s actual tracking use requires ATT, provide an accurate purpose string under NSUserTrackingUsageDescription in the built app’s Info.plist before requesting permission. Missing this key can terminate the app when the request is made.

Request from your app’s appropriate active UI flow:

AttributeHQ.shared.requestATTPermission { status in
    // Update your app's UI using the actual iOS status.
    print("Tracking permission: \(status)")
}

For automatic requesting, set config.requestATTOnInit = true before initialization. An ATT grant alone does not establish Meta sharing eligibility or paid attribution.

Advertising-sharing preferences

These APIs connect to your existing settings/consent flow; they do not display another popup. Unknown means no SDK preference has been reported, not consent. Explicit restrictions block sharing in the sandbox evidence pipeline.

// When the person opts out:
AttributeHQ.shared.setAdvertisingSharing(AdvertisingSharing(.denied))

General denial takes priority over partner settings. Preferences persist per app installation. They currently travel through the opt-in sandbox evidence path, not all production SDK events. This control does not stop basic analytics collection or erase data.

The separate setApplicationTrackingEnabled API records the app’s actual tracking choice for sandbox evidence. It does not replace iOS ATT or automatically grant partner sharing.

SKAdNetwork scope

Version 1.1.0-beta.1 does not write SKAdNetwork conversion values. The host app or another designated SDK owns that schema. A complete AttributeHQ Apple postback receiver and campaign reconciliation have not passed acceptance. Do not add an invented AttributeHQ ad-network ID or assume no further setup is needed. Coordinate conversion-value ownership before combining measurement SDKs.

Event TrackingAPI Reference