iOS 14

1. Introduction

Tapjoy has released an SDK update which is fully compatible with iOS 14.

This guide provides details on what features are supported in this SDK release, and the changes you will need to make to ensure business continuity on iOS 14.

2. Publishers

Version 12.7.1 of the Tapjoy SDK added full support for SKAdNetwork, and Apple’s new AppTrackingTransparency framework. You can find the latest version of the Tapjoy SDK here.

A. Update Your Info.plist With Tapjoy’s SKAdNetwork Keys

Tapjoy is enrolled as a network partner in Apple’s SKAdNetwork. When updating to v12.7.1 of our SDK, please ensure you add Tapjoy’s network ID to your app’s info.plist file, along with the IDs of the DSP partners listed here in JSON and XML formats:

B. Request App Tracking Transparency authorization

If your application is designed to use App Tracking Transparency, to display the dialog to request permission for accessing the IDFA, update your Info.plist by including the NSUserTrackingUsageDescription key along with a custom message to describe this permission to use IDFA in your application.

For example:

<key>NSUserTrackingUsageDescription</key>
<string>This allows us to deliver personalized ads for you.</string>

image_title

The usage description text will then appear as part of the App Tracking Transparency permission dialog, as shown in the screenshot below:

image_title

Add the AppTrackingTransparency framework to your project, and then call requestTrackingAuthorizationWithCompletionHandler: to display the authorization prompt. As a best practice, we recommend that you wait for the requestTrackingAuthorization completion handler before connecting to Tapjoy so that we can be assured we are using the expected IDFA value in all requests.

Objective-C
Swift
#import <AppTrackingTransparency/AppTrackingTransparency.h>
...
- (void)fetchTrackingAuthorization {
  [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    // Call Tapjoy's connect function here.
  }];
}

C. Mediator Adoption

Please use the table below to track the status of mediators adopting our iOS 14 compliant SDK.

Mediator Expected Release iOS Adapter Version Unity Adapter Version Link
AdMob Live 12.7.1.0 2.6.1 Docs
Fyber Live 12.7.1 12.7.1 Docs
ironSource Live 4.1.15 4.1.19 Docs
MAX Live 12.7.1.0 12.7.1.0 Docs
MoPub Live 12.7.1 1.2.21 Docs
Tapdaq Live 7.8.1 7.8.1 Docs

3. Advertisers

Advertiser partners that do not monetise with Tapjoy will not need to integrate or update to the latest Tapjoy SDK version. However, the following changes must be implemented to ensure app installs can be measured in the absence of IDFA availability;

A. Tracking Conversion Values

Please ensure you have designed and implemented your strategy for verifying installs or tracking user conversion value via SKAdNetwork.

This is a required update, and will ensure that your Tapjoy campaigns have installs attributed against them correctly. It will also enable Tapjoy to track and pass user conversion values to your MMP partners where necessary.

B. Campaign ID Structure

Within SKAdNetwork, advertisers have a limit of 100 campaign IDs for each application, per network. Please contact your Tapjoy account manager to discuss how your existing campaigns can be migrated to accommodate this limitation on SKAdNetwork.

4. FAQ

In recent weeks we have been working closely with all our partners to ensure alignment on the changes associated with iOS 14. You can find answers to the most frequently asked questions from our advertiser and publisher partners on our blog.