Liftoff(Vungle)

Currently TopOn supports LiftOff(Vungle) ad types as follows:

Vungle Ad Type	Header Bidding	TopOn SDK
Rewarded video	support	TopOn SDK v5.7.40 and above
Interstitial	support	TopOn SDK v5.7.40 and above
Banner/MREC	support	TopOn SDK v5.9.50 and above
Native	support	TopOn SDK v6.2.95 and above
Splash( App Open Ads)	support	TopOn SDK v6.1.60 and above
In-line	support	TopOn SDK v6.4.80 and above (Not supported on iOS yet, configured in Topon Banner placement)

 

Step1. Create Vungle Account

Login Vungle official website to apply for an account 

 

Step2. Create Vungle Applications and Placements

(1) Add Application 

If the app is not live in AppStore or Google play, select 'my app is not live yet' first, get the test ads for testing, and then modify the application status after the app live in.

(2) Add Placements

Create the corresponding Placement based on the application Ad scenario. 

Note: You can contact with Vungle's business team to set the required eCPM floor for each Vungle placement.

 

Step3. Configure Vungle's Report API

(1) Vungle will provide configuration information for pulling revenue data through the Report API, as follows:

Configuration Information	Description
API Key	Vungle's Reporting API key
Account ID	Vungle's Account ID, which is required when using Vungle's header bidding
Secret Token	If you need to enable the automatic creation function, you need to configure this Token.

① API Key： Reports→Reporting API key

② Account ID： My Account→Account ID

③ vungle：My Account→Overview→Secret Token

 

(2）Configure the Vungle Report API in TopOn

① API Key 

Navigate to TopOn→Network→ New Network（Vungle）→Edit（Report API = ON ）→ Fill in API Key

② If you need to enable the auto create function, you need to find the Secret Token in the Vungle backend.

The specific path is as follows:

 

Step4. Configure Vungle on TopOn

(1) The following two Vungle parameters need to be configured in the TopOn developer backend to display Vungle ads and Vungle data through TopOn:

Parameter name	Description
App ID	Vungle unique APP ID for each APP
Placement ID	Vungle unique Placement ID for each Placement

① App ID: Application→Select App→App ID

② Placement ID: Select App→Placement→Placement ID

 

(2) Configure Vungle parameters in TopOn

Add AD Source

Login TopOn→Network→Ad Source Setting（Vungle）→Add AD Source

① Fill in theAPP ID and Placement ID of the Vungle corresponding to TopOn's APP

② Set the eCPM price of the AD Source (eCPM price can be set independently for different Segment) 

Note: The AD Source will be sorted according to the eCPM price, please fill in the real eCPM price set by Vungle or the forcast eCPM via Vungle.

(3) Banner&MREC&In-line ad configuration instructions

① Create an Placement of the corresponding style in the Vungle backend and obtain the corresponding Placement Reference ID

② Add ad source: Log in to TopOn backend → Aggregation Management → Select banner placement→Add ad source → Select Vungle, and select the corresponding ad style and size type

 

Step5. Add Vungle adapter to your code

Refer to the TopOn SDK integration documentation

 

Step6. Vungle's head bidding instructions

1. Introduce

TopOn currently supports the header bidding of the Vungle, and Vungle's header bidding needs to be activated by Vungle. In order to ensure the normal use of Vungle's header bidding, you need to update TopOn SDK 5.7.40 and above.

Note: When using Vungle's header bidding, please synchronize the Placement reference ID that needs to open the header bidding to Vungle to apply for this permission

 

2. Ad Source configuration

You need to fill in Account ID for Vungle header bidding, and you need to complete Account ID on TopOn's Vungle network.

 

3. Network configuration

When configuring Vungle's ad source in the TopOn, you need to turn on the header bidding function.