Skip to main content

iOS

Basic Configuration#

  • Xcode 12 or later
  • iOS 9.0 or higher

    Note: Since iOS 9, iOS applications must use App Transport Security (ATS), which is a data transmission security feature that enforces the use of encrypted connections. Before proceeding, please refer to the ATS requirements in the app transport security to configure your info.plist to ensure that your ads are not affected by ATS.

1. Cocoapod Integration#

Go to TradPlusSDK Download Platform and choose the third-party ad platforms you need according to your requirements. After generating the access code, you can get the pod configuration information you need with one click

Configure pod in the exported Xcode project

Or refer to the following article to configure SDK with pod in the Unity project: How to Configure SDK with Pod in Unity Project

2. Manual Integration#

1. Go to TradPlusSDK Download Platform and choose the third-party ad platforms you need according to your requirements. After generating the access code, download the zip package containing TPSDK and third-party sources.

2. Add the unpacked TradPlusFrameworks directory to the Xcode project for configuration

For detailed steps, please refer to iOS Xcode project integration process

3. Precautions#

1. Add IDFA and SKAdNetwork list after integration is complete#

Relevant settings and integration can be referred to: iOS14.5+

2. Baidu Access Issues#

If the Baidu SDK's bundle resource package is added to UnityFramework, Baidu will not be able to display local image resources such as close buttons when displaying ads.

You need to add the Baidu SDK bundle resource package to the Unity-iPhone project.

3. Facebook Requirements#

You need to download Facebook and successfully log in to display ads, including test ads. The official ad requires the IDFA to be fully spoken.

4. Admob Requirements#

The uniqueness identifier of the product must be written in the client of Admob, otherwise it will cause the application to crash.

Add GADApplicationIdentifier configuration in Info.plist, and replace it with the appid in Admob backend when the application is released.

<key> GADApplicationIdentifier </ key>
<string> ca-app-pub-3940256099942544~1458002511 </ string>

Others#

  • Please download and unzip the SDK on a Mac, otherwise some file formats may be corrupted.

  • Do not configure third-party channel ad slots with the same configuration on different ad slots of the same application in TradPlus, which can cause various problems such as callback confusion.

  • Generally, changes to the background ad configuration take effect after 30 seconds, and the SDK's local configuration cache invalidation time is one hour. If you need to obtain the updated configuration as soon as possible, developers need to delete and reinstall the app or speed up the system time by 1 hour.

  • When building and testing your app, be sure to use test ads, not actual ads. Otherwise, your account may be suspended.

  • Developers can use TP’s test mode to verify that the integration is correct. For details, please refer to: How to Use Test Mode

  • The return information when the ad is loaded successfully, displayed, or closed can be found in: Callback Information Explanation

  • Error Code Explanation