TikTok Audience Network Integration Guide

This guide instructs you step-by-step on how to set TikTok Audience Network live on the ironSource mediation platform.

Before You Start

  • TikTok Audience Network serves ads to users in China and Japan only.

Step 1. Create an TikTok Audience Network Account

  1. To access TikTok’s Audience Network ad inventory through ironSource‘s mediation platform, you must create an account with TikTok Audience Network. You can do so here.

Step 2. Create an Application in TikTok Audience Network

Next, you must add the app in your TikTok Audience Network account.

Add Your App

  1. Log into your TikTok Audience Network account. On your dashboard, hover the ‘Traffic management and click ‘Apps’
    01-tiktok-apps
  2. Add your app manually or simply select an existing app to monetize.
    02-tiktok-add-app

Step 3. Activate TikTok Audience Network in Your ironSource Network Setup Module

Serving TikTok’s Audience Network ads through the ironSource mediation platform has never been this easy. Sign in to your TikTok Audience Network account when setting up TikTok Audience Network on the ironSource SDK Networks setup page and insert all the necessary parameters to run TikTok Audience Network Interstitials and Rewarded Videos!

Account Settings

1App Settings

1

 

There are parameters from your TikTok Audience Network account which needs to be entered into your ironSource network setup module in order for TikTok Audience Network to connect properly with ironSource:

User ID
The unique ID assigned to your user on
 TikTok’s Audience Network dashboard.
Secure Key
Key generated by TikTok Audience Network for reporting API purposes
Application ID
The unique ID assigned to your app on
 TikTok’s Audience Network dashboard.
Placement ID
The unique ID assigned to the ad you have created on TikTok’s Audience Network dashboard.


Once you obtain this information, you must configure TikTok’s Audience Network Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of TikTok’s Audience Network ad inventory and reporting data on the ironSource mediation platform.

User ID

Once you logged in to your TikTok Audience Network account, you can find your User ID on the top-right corner of the dashboard
07-tiktok-find-app-id

Secure Key

To retrieve your TikTok Audience Network Secure key, please contact the TikTok Audience Network team.

Application ID

Once you have created an application in the TikTok’s Audience Network dashboard (as described in step 2), You can find your Application ID under ‘Apps‘ (hover the ‘Traffic management and click ‘Apps’).
01-tiktok-apps
Obtain your Application ID value from the dashboard and place it in the ironSource Network Setup Module in the “App ID” field. 
07-tiktok-find-app-id

Placement ID

Once you have created an application in the TikTok’s Audience Network dashboard, you will need to include ads. Hover over ‘Traffic management and click ‘Ad placements.
Add your Placement manually or simply select an existing placement to get its Placement ID.
03-tiktok-add-placementSelect your ad format (either Interstitial and Rewarded Video)

04-tiktok-add-placement-typeComplete all the required details, including choosing the dedicated application this ad is meant for.

Once you are done, obtain your Placement ID value from the ‘Ad placementsdashboard and place it in the ironSource Network Setup Module.
05-tiktok-find-placement-report

Step 4. Add the TikTok Audience Network Adapter to Your Build

ironSource supports both Cocoapods and Manual download mechanisms.

Cocoapods

To integrate the TikTok SDK with Cocoapods, enter the following line in your podfile and you’re good to go!

pod 'IronSourceTikTokAdapter','4.1.2.0'

Manual Download

  1. Download the TikTok Adapter
    Add the TikTok Adapter to your build. You can find the latest TikTok Adapter here.
    Important! The TikTok Adapter also contains the TikTok SDK. You DON’T need to add the TikTok SDK directly.
  2. Add the TikTok frameworks to your Project
    After you download the Adapter, drop the Adapter framework into your Xcode Project, i.e. drop ISTikTokAdapter.framework into your Xcode project.
  3. Open Target  Build Settings  Architectures and confirm that your Xcode Project uses Base SDK version 6.0 or greater and that it does not use armv6 architecture.
  4. Linker Flags:
    Add two separate linker flags to Target  Build Settings  Linking  Other Linker Flags:
    ObjC

Verify Your Ad Network Integration

The ironSource SDK provides an easy way to verify that your mediation integration was completed successfully. To verify your ironSource and additional ad setworks’ integration, follow this document.

Done!
You are now all set to deliver TikTok Audience Network within your application!