Skip to main content

Ad Scene

I.Function Introduction​

The Ad Scene feature helps developers understand data such as ad display, click, and ad Ready rate when arriving at the ad scene in the ad scene dimension.

II. Use Cases​

  1. If you want to analyze whether the ad display is maximized through the TradPlus funnel analysis report, you need to accurately call the "enter ad scene" method. After the call is completed, the TradPlus background will automatically count two important indicators:
  • User's ad scene arrival rate, i.e. number of users arriving at the ad scene / number of users starting the application
  • Ad Ready rate when arriving at the ad scene
  1. If an ad position contains several ad scenes, and the developer wants to understand the data (such as display, click, etc.) of the ad scene in the dimension, he needs to create the ad scene in the background-> Application Management-> Ad Scene interface, and pass in the corresponding ad scene ID each time the ad is displayed.

III. Best Practices​

1. "Enter Ad Scene" Method​

Generally, the "enter ad scene" method is called when the application needs an ad:

  • Android: entryAdScenario ("sceneId")
  • iOS: entryAdScenario: @"Your ad scene ID"

If you need to differentiate data between different ad scenes, you need to generate an ad scene ID in the background-> Application Management-> Ad Scene interface; if you do not need to differentiate data between different ad scenes, the ad scene ID can be directly passed in as an empty string.

The call time for different ad types is as follows:​

Rewarded Video​

Developers choose the corresponding call time according to the application's handling of the ad viewing button:

Ad button handlingCall time
The application will gray out or hide the ad button when judging that there is no adCall when the user arrives at the page where the ad button is located (see figure below)
The application will not gray out or hide the ad button, and the user can always click the ad buttonCall when the user clicks the ad button

Interstitial​

Call the "enter ad scene" method when the ad trigger conditions are met, such as:

  • If the ad scene is an interstitial ad popping up after the cleaning is finished, call it when the cleaning is finished;
  • If the ad scene is an interstitial ad popping up after a game is over, call it when the game is over.

Native​

Call when the user arrives at the page where the ad position is located.

If the application loads the ad before the user arrives at the ad position, call when the user arrives at the page where the ad position is located; If the application only loads the ad when the user arrives at the ad position, no need to call the "enter ad scene" method.

Splash​

No need to call.

2. Displaying Ads Call​

If you need to differentiate the display data between different ad scenes, you need to pass in the sceneID when calling the showad interface. The SceneID is generated in the background-> Application Management-> Ad Scene interface.

IV. Call Steps​

1. Scene ID Generation Method​

  • If you need to differentiate data between different ad scenes, you need to generate an ad scene ID in the background-> Application Management-> Ad Scene interface;

  • If you do not need to differentiate data between different ad scenes, the ad scene ID can be directly passed in as an empty string.

2. Scene ID Call​

Generally, the "enter ad scene" method is called when the application needs an ad, and the specific API reference is introduced for each specific type

PlatformCode call
AndroidentryAdScenario("sceneId")
iOSentryAdScenario:@"Your ad scene ID"

3. Displaying Ads Call​

  • If you need to differentiate the display data between different ad scenes, you need to pass in the sceneID when calling the showaAd interface.
  • Native banner and banner need to be passed in when loading (when enabling automatic display)