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 includes full support for SKAdNetwork, and Apple’s new AppTrackingTransparency framework.

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 below (these are also available in both JSON and XML formats):

Network Key
Tapjoy ecpz2srf59.skadnetwork
Liftoff 7ug5zh24hu.skadnetwork
Moloco 9t245vhmpl.skadnetwork
CrossInstall prcb7njmu6.skadnetwork
LoopMe 5lm9lj6jb7.skadnetwork
Unicorn 578prtvx9j.skadnetwork
Bytedance 22mmun2rn5.skadnetwork
The Trade Desk uw77j35x4d.skadnetwork
Beeswax.io c6k4g5qg8m.skadnetwork
Criteo hs6bdukanm.skadnetwork
Jampp yclnxrl5pm.skadnetwork
Centro 3sh42y64q3.skadnetwork
EngageBDR cj5566h2ga.skadnetwork
Sift Media klf5c3l5u5.skadnetwork
RTB Marketing and Tech Services 8s468mfl3y.skadnetwork
Remerge 2u9pt9hc89.skadnetwork
Media Smart 7rz58n8ntl.skadnetwork
Smadex ppxm28t8ap.skadnetwork

Example of Info.plist contents:

<key>SKAdNetworkItems</key>
  <array>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>ecpz2srf59.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>7ug5zh24hu.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>9t245vhmpl.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>prcb7njmu6.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>5lm9lj6jb7.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>578prtvx9j.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>22mmun2rn5.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>uw77j35x4d.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>c6k4g5qg8m.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>hs6bdukanm.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>yclnxrl5pm.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>3sh42y64q3.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>cj5566h2ga.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>klf5c3l5u5.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>8s468mfl3y.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>2u9pt9hc89.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>7rz58n8ntl.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>ppxm28t8ap.skadnetwork</string>
    </dict>
  </array>

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
Appodeal TBC TBC TBC 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 2020/11/19 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.