Starting from version v3.4.0.0, Pangle iOS SDK is divided into CSJ iOS SDK
and Pangle iOS SDK
, here is the details for separated ios sdks. The most important thing is that CSJ iOS SDK
only could be used for China Mainland traffic and Pangle iOS SDK
only could be used for Non China Mainland traffic.MoPub would only certify Pangle iOS SDK
since v3.4.0.0. This guide is intended for publishers who still want to integrate CSJ iOS SDK
via MoPub mediation. [Not custom event]
Developers should have already imported Pangle iOS SDK
and Pangle Adapters
through MoPub integration tool. For example, as code below:
Broadly speaking, there are 3 steps to integrate CSJ iOS SDK
via MoPub.
Open your project's Podfile and add the line pod 'Ads-Global' , '3.4.2.8' :subspecs => ['Domestic']
to your app's target:
Note: you must import the same sdk version for CSJ SDK and Pangle SDK, for example, if you have imported v3.9.0.8 Pangle SDK from MoPub Integration Tool, you also need to import the same version of CSJ SDK.
Download CSJ iOS SDK
from the Pangle platform, unzip the file and find the BUCNAuxiliary.framework
, then only import this framework into your iOS project.
Note: you must import the same sdk version for CSJ SDK and Pangle SDK, for example, if you have imported v3.9.0.8 Pangle SDK from MoPub Integration Tool, you also need to import the same version of CSJ SDK. If you can't find the same version of CSJ SDK in your account, please contact your account manager or email us(pangle_support@bytedance.com).
This step should be done by developers. We would suggest to locate users with the following ways:
Note: If developers have built a china version for their apps(this version only be used in China mainland), for those apps, step 2 is not needed and could hardcode BUAdSDKTerritory_CN at step 3.
Once the user is located, call setTerritory
method to pass the region to Pangle SDK according to the user location.
Important: This step must be done before initializing MoPub SDK