About the iOS ATS Mobile SDK

The iOS Mobile SDK allows you to easily retrieve envelopes or Deal ID (ATS on-device) from a mobile application in a few simple steps. The SDK comes packed with features so you don't have to spend time tinkering with codes while ensuring that user consent is being respected.

From Version 2.0 and above, the SDK comes with a functionality to enable ATS On-Device. ATS On-Device allows you to match identifiers directly on users' devices, enabling you to handle identifiers from users who have opted out of AppTrackingTransparency (ATT) or any similar framework.



iOS Mobile SDK is only compatible for iOS 10 and above.


ATS On-Device is Available in Closed Beta

ATS On-Device is currently available in closed beta; their functionality will not work out-of-the-box during this phase.

If you want to be part of the closed beta release, contact your LiveRamp representative to get ATS On-device enabled.

Before You Begin

You must have the following already set up in Console:

  • An approved ATS Placement tied to the bundle IDs of the apps you want to run ATS in;
  • An SDK Config ID generated as illustrated below.

  • An Integration Key as illustrated below to enable the handling of ATT-opt-out users through ATS On-Device:

See our Console documentation on Implementing ATS Mobile SDK to learn how to complete the prerequisites.


If your ATS placement is still pending for an approval, you can still continue with the initialization. SDK configurations linked to unapproved placements will return fake envelopes which you can utilize for testing purposes until the placement is approved.

Additionally, your application must be able to handle user consent (typically by a CMP) as per IAB standards. The SDK will automatically perform a geolocation check to ensure consent is properly set for GDPR and CCPA.

What’s Next

Ready to get started with iOS ATS Mobile SDK?