Ad Scenario

On the App - Ad Scene page, you can create and edit ad scenes. Before creating an ad scene, you must first create an app and at least one Ad Placement.

On the Ad Scene page, you can:

• Add ad scenes
• View ad scene data

1. Ad Scene Introduction

(1) View SDK loading and impression ad conversion data to improve revenue

By using the ad scene feature, you can view the data of each ad loading and impression flow in the SDK on the Funnel Analysis Report, determine whether ad settings are reasonable, analyze optimization opportunities for each flow conversion, and improve conversion to boost revenue.

(2) Reduce Ad Placement configuration costs

Developers usually use different Ad Placements to distinguish data for different ad scenarios. This effectively differentiates impression and revenue data under each scenario, but also increases operational costs (needing to maintain Ad Source configurations for multiple Ad Placements).

The Taku platform supports creating multiple ad scenes under a single Ad Placement, effectively differentiating impression and click data under different ad scenarios, reducing the cost of configuring Ad Placements.

2. Ad Scene Integration Process

(1) When the current Ad Placement corresponds to only one ad scene:

After adding the ad scene arrival code, Taku will provide the following core metrics in the Comprehensive Report and Funnel Analysis Report, offering more complete analysis data for your ad monetization:

When the SDK reaches the ad scene, call Taku SDK's entryAdScenario() method. You may skip passing the ad scene ID, and the data will be classified under the default ad scene.

(2) When the current Ad Placement corresponds to multiple ad scenes and you need to differentiate impression and click data across different ad scenes:

1. Create ad scenes in the Taku backend and optionally customize the ad scene ID.
2. Accurately add the ad scene arrival code in the app (call Taku SDK's entryAdScenario() method and pass the respective ad scene IDs).
3. Pass the scenarioId in the show method when displaying the ad.

3. Timing for Calling Ad Scene Arrival

Based on different ad types and your app's ad logic, you can call Taku SDK to add the ad scene arrival code within the app.

3.1 Rewarded Video

Refer to the following examples for calling the ad scene arrival method:

App Type	Ad Name	Ad Flow	Timing of Ad Scene Arrival Call
Game	Rewarded Video Claim Reward	Enter Game -> Click Stamina/Currency entry -> Pop up "Watch Ad to Get Reward" popup -> Click button to watch Rewarded Video	Pop up "Watch Ad to Get Reward" popup
App	Watch Video to Clean Junk	Enter App -> Enter Clean Junk feature -> Scan junk -> Click Clean Now -> Pop up "Watch Ad to Clean Junk" popup -> Click button to watch Rewarded Video	Pop up "Watch Ad to Clean Junk" popup

Game Rewarded Video Claim Reward:

App Watch Video to Clean Junk:

3.2 Interstitial (Full Screen / Half Screen)

Refer to the following examples for calling the ad scene arrival method:

App Type	Ad Name	Ad Flow	Timing of Ad Scene Arrival Call
Game	Level Complete Interstitial	Enter Game -> Enter Level -> Level Complete popup -> Click Next Level / Return to Level page button -> Interstitial appears -> Enter next level / Level page	Level Complete popup
App	Cleanup End Interstitial	Enter App -> Enter Clean Junk feature -> Scan junk -> Click Clean Now -> Cleaning animation -> Full screen Interstitial appears -> Cleanup result page	Cleaning animation
App	Page Switch Interstitial	Enter App -> Homepage -> Click other features on homepage tab -> Arrive at other feature page -> Interstitial popup appears	Arrive at other feature page

App Page Switch Interstitial:

3.3 Native / Feed

Refer to the following examples for calling the ad scene arrival method:

App Type	Ad Name	Ad Flow	Timing of Ad Scene Arrival Call
Game/App	Check-In Popup Native Ad	Enter Game/App -> Check-in popup appears -> Display Native Ad below check-in popup	Check-in popup appears
App	Page Native Ad	Enter App -> Enter feature page / long list page -> Native Ad embedded in page	Enter feature page / long list page

3.4 Banner

Refer to the following examples for calling the ad scene arrival method:

App Type	Ad Name	Ad Flow	Timing of Ad Scene Arrival Call
Game/App	Banner Below Popup	Enter Game/App -> Message popup / Feature popup appears -> Display Banner below popup	Message popup / Feature popup appears
Game/App	Fixed Banner	Enter Game/App -> Enter level page / novel reading page etc. -> Display fixed Banner at bottom of page	Enter level page / novel reading page etc.

Banner ads support both preloaded and non-preloaded modes, and the ad scene can be called on the above pages. If Banner auto-refreshes, the ad scene arrival data will be less than the impression data.

3.5 Splash

Refer to the following examples for calling the ad scene arrival method:

App Type	Ad Name	Ad Flow	Timing of Ad Scene Arrival Call
Game/App	Splash Ad	Enter Game/App -> Display company logo page -> Display Splash Ad	Display company logo page; if there is no logo page and the app launches directly, you can call the ad scene upon entering the Game/App, or skip calling the ad scene

4. Creating Ad Scenes and Obtaining Ad Scene IDs

If you need to use multiple ad scenes to differentiate data, you can create ad scenes in the backend and obtain the ad scene IDs.

(1) App -> Select the corresponding app -> View Ad Placement list -> Scene Management

(2) Click Add Ad Scene

1. Each Ad Placement has a Default scene. The default ad scene ID is "", and when calling the ad scene arrival method without passing an ad scene ID, the data will be classified under the default scene.
2. You can customize the ad scene ID (supported by Taku SDK v6.2.48 and above), making it easier for developers to differentiate ad scenes during integration; if no ad scene ID is filled in, one will be auto-generated.
3. For Rewarded Video ads, you can add reward information (reward name and reward amount) in the ad scene. The reward information will be called back to the developer. For details, refer to iOS - Callback Information and Android - Callback Information.

(3) View the scene list and obtain the ad scene ID to provide to the development team for integration.

5. Ad Scene Integration Code Samples

5.1 Taku Android SDK Code Samples

Ad Type	Sample Code
Rewarded Video	View
Interstitial	View
Splash	View
Native	View
Banner	View

5.2 Taku iOS SDK Code Samples

Ad Type	Sample Code
Rewarded Video	View
Interstitial	View
Splash	View
Native	View
Banner	View

5.3 Notes

(1) If the passed ad scene ID is incorrect or does not belong to the current Ad Placement, Taku will count that data under the Default scene.

(2) If no ad scene ID is passed in the entryAdScenario() or Show() methods, Taku will count that data under the Default scene.

(3) If a paused ad scene ID is passed in the entryAdScenario() or Show() methods, Taku will count that data under the Default scene.

(4) Taku SDK version support for ad scenes by ad type:

Taku SDK Version	Ad Types Supporting Ad Scenes
>=5.4.7	Rewarded Video, Interstitial
>=5.7.9 (5.7.09)	Rewarded Video, Interstitial, Native, Banner, Splash

Taku backend custom ad scene ID supported version: >= v6.2.48

6. Viewing Ad Scene Data

6.1 Ad Scene Data Reports

You can view data for each ad scene of a specific Ad Placement in Ad Scene and Reports.

6.2 Funnel Analysis Report

You can view the app's funnel analysis data in the Funnel Analysis Report.