1. Functional Overview

The direct offer function can be used to deliver direct offers ad.

Currently, TopOn supports a variety of ad formats, including: rewarded video, interstitial video, interstitial image, native, splash, and banner .

We recommend that you choose different features to place ads based on your needs:

Function	Recommended usage scenarios
Cross Promotion	Promote your own apps without precise display budget control. Generally, cross-promotion is used as a backup when there is no filler on third-party networks.
Direct Offer	Promote direct offers ad and control the display budget of ad

2. Operation Instructions

2.1 Enabling direct offer permissions

(1) Contact TopOn to enable direct offer permissions (currently only available to whitelisted users)

(2) To use direct offer, you need to update TopOn SDK >= v5.7.92

2.2 Configure direct offer

The ad level rules for direct offer are as follows: Campaign > Ad Set > Creative

Campaign : corresponds to an Android app, iOS app, or web page
Ad set : Multiple ad sets can be created under one campaign. Each ad set can be placed in multiple TopOn placements.
Creative : Each ad set can create a set of creative

2.3 View direct offer reports

You can view detailed direct offer data in Full Report > Direct Offer Report

3. Detailed steps and instructions

3.1 Configure campaigns

(1) Go to Advanced > Direct Offer to enter the configuration page

(2) You can create and manage campaigns within campaigns

(3) When adding an campaign, the campaign types supported are: Android App, iOS App, and Web Page

(4) If the campaign type you add is Android and your product group is not available on Google Play , and you are promoting your product group in mainland China, we recommend that you add the four elements of APK ads required by the Ministry of Industry and Information Technology.

① App version : the version number of your application

② App Permissions URL : URL of the permissions document that your application needs to apply for

③ Privacy Agreement URL : The link address of the privacy agreement document of your application

④ Developer Name : Your name

(5) The display effect is as follows:

3.2 Configure ad set

(1) You can create and manage ad sets in Ad set

(2) When creating an ad set, you need to complete the following steps:

① Select campaign

You need to select the campaign source. Currently supported options include: existed campaign, new campaign

② Ad Set-Basic

Complete the following configuration in Ad set-Basic:

The configuration instructions are as follows:

Field	Scope	Description	Note
Start Date	Required	The start date of the ad set	Selectable start date time zone
End Date	Required	End date of the ad set	The ad schedule will automatically end when the end date is reached
eCPM settlement price	Required	The revenue data in the report will be calculated using the eCPM settlement price	The currency of the eCPM settlement price is consistent with the account currency
Budget for impression in total	Optional	The limitation of the total impression for this Ad Set. It can be set by day or throughout the promotion period	If you reduce the total impression budget when the ad set is serving, the control of the budget might not be accurate.Please modify it with caution.
Budget for click in total	Optional	The limitation of the total click for this Ad Set. It can be set by day or throughout the promotion period	If you reduce the total click budget when the ad set is serving, the control of the budget might not be accurate.Please make modifications with caution.
Budget for impression per device	Optional	The limitation of the impression number per device for this Ad Set. Can only be set throughout the promotion period	If you reduce the budget for impression per device when the ad set is serving, the control of the budget might not be accurate, so please make modifications with caution.
Budget for click per devie	Optional	The limitation of the click number per device for this Ad Set. Can only be set throughout the promotion period	If you reduce the budget for click per device when the ad set is serving, the control of the budget might not be accurate, so please modify it with caution.

③ Ad Set-Third-party Detection link

In Ad Set - Third-party Detection Link, complete the following configuration:

The configuration instructions are as follows:

Field	Scope	Description	Note
Click URL	Required	Direct offer click jump link	Supports placeholder replacement. Click to jump to address configuration instructions
Click Monitor URL	Optional	Direct offer click monitoring link	Support placeholder replacement
Impression Monitor URL	Optional	Direct offer display monitoring link	Support placeholder replacement
DeepLink URL	Optional	Jump to the specified page of the installed app	Support placeholder replacement
Open Type	Required	Jump mode support: App Market : Open via Google Play or App Stores Browser : Open with browser WebView : Open via built-in WebView APK Download : Download APK Ads	APK download is only valid for TopOn Android domestic version

④ Ad Set-User Targeting

In Ad Set - User Targeting , complete the following configurations:

The configuration instructions are as follows:

Field	Scope	Description	Example
Schedule Time	Optional	Select the time range for direct offer by week and hour	-
Promotion Area	Required	The delivery areas are divided into Mainland China and non-Mainland China. If global investment is required, please add two direct delivery ads in different delivery areas	-
Network Type	Optional	You can specify WiFi, 4G, 3G, 2G	-
App Version	Optional	You can specify the application version	2.10.11
SDK Version	Optional	You can specify the TopOn SDK version	5.7.92
OS version	Optional	You can specify the system version	14.5.0

⑤ Creative Group Management

Ad sets support different creative types:

Creative Type	Support Ad Types
Video+Image	Rewarded Video、Interstitial Video、Interstitial Picture、Splash、Banner、Native
Image + Text	Interstitial Picture, Splash, Banner, Native
Image(Splash/Interstitial)	Interstitial, Splash
Image(Banner)	Banner

● Creative type = Video+Image

You need to complete the configuration of the following material content:

Content	Scope	Description	Example
Title	Required	No more than 50 characters	MyGame
Description	Required	No more than 50 characters	Let's Play MyGame
CTA	Required	The Chinese word should not exceed 5 characters, and the English word should not exceed 20 characters.	Install Now
ICON Image	Required	Recommended size: square image within 200x200, size no more than 200KB, format: png, jpg, jpeg	-
Video Link	Required	The video file size should not exceed 10MB, format: MP4 (must be a downloadable MP4 file), duration: 15~30 seconds. Special note : The link address cannot contain any Chinese characters, and the MP4 file name can only use English letters, numbers and underscores.	https://cdn.abc.com/abc.mp4
EndCard Image	Required	EndCard image displayed after the video is finished playing. Recommended sizes for vertical images: 1080x1920, 720x1280, 768x1024; recommended sizes for horizontal images: 1920x1080, 1280x720, 1024x768, size no larger than 1MB, format: png, jpg, jpeg	https://cdn.abc.com/abc.png
Show Brand Logo	Optional	Brand Logo	https://mores.toponad.net/image/default/ad_cn.png

Note: Please use https protocol for the link address of the material

● Creative type = Image + Text

You need to complete the configuration of the following material content:

Content	Scope	Description	Example
Title	Required	No more than 50 characters	MyGame
Description	Required	No more than 50 characters	Let's Play MyGame
CTA	Required	The Chinese word should not exceed 5 characters, and the English word should not exceed 20 characters.	Install Now
ICON Image	Required	Recommended size: square image within 200x200, size no more than 200KB, format: png, jpg, jpeg	-
Image	Required	Recommended sizes for vertical images: 1080x1920, 720x1280, 768x1024; recommended sizes for horizontal images: 1920x1080, 1280x720, 1024x768. The size should not exceed 1MB. Format: png, jpg, jpeg	-
Show Brand Logo	Optional	Brand Logo	https://mores.toponad.net/image/default/ad_cn.png

Note: Please use https protocol for the link address of the material

● Creative type = Image(Splash/Interstitial)

You need to complete the configuration of the following material content:

Content	Scope	Description	Example
CTA	Required	The Chinese word should not exceed 5 characters, and the English word should not exceed 20 characters.	Install Now
Image	Required	Recommended sizes for vertical images: 1080x1920, 720x1280, 768x1024; recommended sizes for horizontal images: 1920x1080, 1280x720, 1024x768. Size should not exceed 1MB. Format: png, jpg, jpeg	-
Show Brand Logo	Optional	Brand Logo	https://mores.toponad.net/image/default/ad_cn.png

Note: Please use https protocol for the link address of the material

● Creative type = Image (Banner)

① Fill in at least one of the four image materials: Banner (320x50), Medium Rectangle (320x90), Large Banner (300x250), Leader Board(728x90)

② Please use https protocol for the link address of the material

3.3 Ad set on TopOn placement

(1) You need to add a direct offer ad source for the TopOn placement that delivers direct offer in the mediation.

(2) eCPM settlement price and price description: The eCPM settlement price set when adding an ad set is independent of the price set by the mediation.

Price Type	Description
eCPM settlement price	Configured in the ad set , the revenue of the report data will be calculated based on the eCPM settlement price, which is often used for settlement with direct offer advertisers
Price	Configured in the ad source to determine the order of direct ad sources in WaterFall

3.4 Advanced Features

(1) Set the filter delivery package name

You can set a list of excluded package names for direct offer. The products corresponding to the excluded package names will no longer be promoted.

Android

API	parameter	illustrate
setExcludePackageList	(List packageList)	packageList : List of excluded application packages

iOS

Sample code:

[[ATAPI sharedInstance] setExludeAppleIdArray:@[@"id529479190"]];

4. Description of relevant data

4.1 Rewarded Video

Rewarded videos support the following ad source configuration items:

Ad source configuration items	Option Description	Note
Video Mute	Default non-mute	-
The video can be closed early	By default, it cannot be closed early	It is recommended to adjust the video closing time in advance according to the implementation requirements

Rewarded Video effect Image:

4.2 Interstitial Ads

Interstitial supports the following ad source configuration items:

Ad source configuration items	Option Description
Video Mute	Default non-mute
The video can be closed early	Default 5 seconds
placement type	Interstitial image (default) Interstitial Video
full-screen	Full screen display (default) Half screen display

Half-screen display effect diagram:

Full screen display effect diagram:

4.3 Splash Ads

The following ad source configuration items are supported for opening the screen:

Configuration items	Field
Screen orientation	Default vertical screen
Countdown time	Default 5 seconds
Skipable	The default countdown can be skipped

The opening screen will display different styles according to the creative types of direct offer:

style	Creative Type
Stitching style	Video + Image or Image + Text
Full screen image	Image (splash/interstitial)

Splash display effect Image:

4.4 Banner

Banner supports the following ad source configuration items:

Configuration items	Field	Note
Close button	Default Display	-
Ad source size	Banner (320x50) Large Banner (320x90) Medium Rectangle Banner (300x250) Home page banner (728x90)	When the creative type of the ad set = Image (Banner) , please make sure that the ad source size you selected has been configured with the corresponding image in the creative of the ad set, otherwise this ad set cannot be used normally.

Banner effect Image:

4.5 Native

The following ad source configuration items are natively supported:

Configuration items	Field	Note
Close button	Default Display	-
Native Types	Self-rendering (default) Template Rendering	You need to choose based on the code processing logic of the native ad access If your integration code only handles template rendering, please do not select self-rendering

Native template rendering effect diagram: