Skip to main content

Implement ATS Mobile SDK

The ATS Mobile SDK allows you to handle envelopes from both Android and iOS devices without having to spend time coding. The SDK includes the ability to retrieve, refresh, and cache envelopes while ensuring that user consent is respected.

Before You Begin

Obtain Config ID for ATS Mobile SDK

Before initializing the SDK, you must first obtain the Config ID in Console.

  1. Log in to Console.

  2. Go to ATS > Mobile.

  3. Click New.

  4. Enter a configuration name and select a placement.

    Tip

    If you'd like to first test the SDK workflow, create and select a new ATS placement that hasn't been approved yet. SDK configurations linked to unapproved placements will only return fake envelopes until the placement is approved.

  5. Click Let's Go.

A Config ID will be automatically generated and displayed in the "SDK Configurations" area.

Note

We recommend creating a separate Config ID for each of your iOS or Android titles. This ensures the segregation of data and allows for separate reporting further down the road.

See the ATS Mobile SDK Settings

To view the SDK settings, click on a configuration from the "On Device Configurations" area. Click Advanced on the Envelope or Developer Options section. You can see the following information (more to be added):

  • Envelope Expiration Time: The time period after which an envelope that wasn't refreshed should expire and a new envelope will be fetched. This option is set to 15 days by default.

  • Envelope Min. Refresh Interval: The time interval between each envelope refreshes. This option is set to 15 minutes by default.

  • Enable Logging: When this option is enabled, all log levels will be logged to Xcode or Logcat console during development. The SDK will only log errors and warning levels by default.

Implement the ATS Mobile SDK

Once you have obtained the Config ID, you're ready to initialize the SDK. Learn the complete steps in our developer documentation: