1. Functional Overview
The direct offer function can be used to deliver direct offers ad.
Currently, Taku 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 Taku to enable direct offer permissions (currently only available to whitelisted users)
(2) To use direct offer, you need to update Taku 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 Taku 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 Taku 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 | - |
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 Taku 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 | |
---|---|
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 |
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 |
Optional | Brand Logo | https://mores.Takuad.com/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.Takuad.com/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.Takuad.com/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 Taku placement
(1) You need to add a direct offer ad source for the Taku 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: