Menu

Scenario AD scene

1. Introduction to advertising scenes

Developers usually use different advertising slots to distinguish the data of different advertising scenarios. This can effectively distinguish the display and revenue data in each scenario, but it will also increase operating costs (requiring more maintenance). Ad source configuration for each ad slot).

TopOn platform supports the creation of multiple advertising scenes under advertising slots, which can effectively distinguish display and click data in different advertising scenes, and can also reduce user configuration The cost of advertising space.

2. Advertising scene access process description

  1. If one advertising slot corresponds to multiple advertising scenes, you can create advertising scenes in the TopOn developer backend
  2. Add to reach the advertising scene accurately in the App (call the TopOn SDK's entryAdScenario() method and pass in Advertising scene ID). After adding the reach ad scene code, TopOn will display the code in Comprehensive Report and Funnel analysis report provides the following core indicators to provide more complete analysis data for your advertising monetization:
  • Reaching the advertising scene
  • Ad Ready rate when reaching the advertising scene
  • Ad trigger rate
    1. When displaying an ad, call Show() method and pass in Advertising scene ID

    3. The calling time to reach the advertising scene

    You can call TopOn SDK in the app to add according to different advertising types and the advertising logic of your own app. Reach ad scenecode

    3.1 Rewarded video example

    You can call it at the following timing Reaching the advertising scene

    Advertising scene Calling time
    In the game, you can get extra physical rewards by watching motivational videos. As shown in Figure 1 belowCalled when the user reaches the extra stamina reward interface
    When browsing the product details page, there is an advertisement on the page to get xx coinsCalled when entering the product details page
    After the prize is drawn, when the tip for winning the prize pops up, many A scene of watching an advertisement and drawing another lotteryCalled when the Tip interface for winning prizes pops up

    3.2 Interstitial screen example

    You can call reach the advertising scene

    Advertising sceneCalling time
    Advertising scenes displayed after users check in dailyCalled when the daily check-in interface pops up
    Cleaning tool App, ads will pop up after cleaning files is called at the end of cleaning

    3.3 Screen opening example

    You can call Reaching the advertising scene

    3.4 native example

    You can call reach the advertising scene

    Advertising sceneCalling time
    Display an open-screen ad after displaying the company's logo pageCall the scene API when displaying the logo page
    No front logo Page display, open screen ads will be displayed when it is turned onCan be called after the application is launched
    Advertising sceneCalling time
    User in daily Add advertising scenes for display in the free view at the bottom of the check-in boxCalled when the daily check-in interface pops up
    The list of product lists in the App is inserted into the information flow advertisement Called when entering the product list interface

    3.5 Banner Example

    If the banner ad preloads the ad in advance before reaching the ad slot, it will be called when it reaches the interface where the ad slot is located

    4. Create advertising scenes and obtain advertising scene IDs

    If you need to use multiple advertising scenes to distinguish data, you can create advertising scenes in the background and obtain the advertising scenes.

    1、Application->Select the corresponding application->View ad slot list->Scene management

    2、Click to add advertising scene

    • Each advertising slot has a Default scene, and the default advertising scene ID=1. When calling the advertising scene method, the advertising scene ID is not uploaded, and the data will be returned to the default scene.
    • The advertising scene ID can be customized (supported by TopOn SDK v6.2.48 and above), which facilitates development students to distinguish advertising scenes when accessing; if you do not fill in the advertising scene ID, the advertising scene ID will be automatically generated.
    • Rewarded video ads can add incentive information (incentive name and incentive quantity) in the advertising scene, and the incentive information will be called back to the developer. For details, please refer to iOS-Callback Information Description and Android-Callback Information Description


    3、View the scene list and obtain the advertising scene ID, providing it for development students to access and use.

    5. Access code example for advertising scenario

    5.1 Android

    Ad TypeExample
    Rewarded VideoLearn more
    InterstitialLearn more
    SplashLearn more
    NativeLearn more
    BannerLearn more

    5.2 iOS

    Ad TypeExample
    Rewarded VideoLearn more
    InterstitialLearn more
    SplashLearn more
    NativeLearn more
    BannerLearn more

    5.3 Precautions

    1. If the incoming advertising scene ID is wrong or is not the advertising scene ID under the current advertising slot, TopOn will count this part of the data to the Default scene.

    2. If the advertising scene ID is not passed in to the entryAdScenario() and Show() methods, TopOn will count this part of the data to the Default default scene.

    3. If the paused advertising scene ID is passed in to the entryAdScenario() and Show() methods, TopOn will count this part of the data to the Default default scene.

    4. Different versions of TopOn SDK support advertising scenarios such as:

    TopOn SDK versionAd types that support advertising scenarios
    >=5.4.7Rewarded Video, Interstitial
    >=5.7.9 (5.7.09)Rewarded Video, Interstitial, Native, Banner,Splash

    Support TopOn background custom advertising scene ID version: >= v6.2.48

    6. View advertising scene data

    6.1 Advertising scene data report

    You can view the data of each advertising scenario for a specific ad slot in Ad Scenarios and Reports

    6.2 Funnel Analysis Report

    You can Funnel Analysis Report View funnel analytics data for your app


    Previous
    Advanced Features
    Next
    Segment
    Last modified: 2025-05-30Powered by