Ads View control

Official Content
This documentation is valid for:

Shows Ads (Advertising) on your applications in any place. This control is available in the Toolbox and supports several providers. 

Ads View control - Toolbox

Considerations

For Android generator, you must set the Ads Provider property(GeneXus 16 upgrade 10 and lower) at the Main object level.

Design-time properties

Specific properties associated with this control can be found under the Control Info group. 

Ads Provider property(GeneXus 16 upgrade 10 and lower)

AdMob group

These properties apply when Ads Provider property has AdMob value.

Property Description
Ad Unit Id property  It is the identifier of the ad that this control will display on the screen. This ad must be a Banner.
Refer to HowTo: Get AdMob Unit Id for advertising in Smart Devices

GoogleMobileAds group

These properties apply when Ads Provider property has GoogleMobileAds value.

Property Description
Ad Unit Id property  It is the identifier of the ad that this control will display on the screen. This ad must be a Banner.
Refer to Google Ad Manager - Get Started

Run-time properties

AdUnitId

Changes the Ad Unit Id design-time property at run-time. Its value must be character-based. Available when Ads Provider property has AdMob value.

image_2018328113413_1_png
 

Methods

RequestAd

It forces the request for a new Ad in a specific time.
Return value  None
Parameters   None
 

Usage example

First, turn on the property Enable Ad on the SD Main object.
Then drag (at least) one Ads View control from the toolbox inside the layout of a Panel object

SD Ads View control - Layout

After that, you must set its properties properly depending on the provider.
In this case, because the provider is AdMob, the identifier of the ad (occasionally more than one and different from each other).

SD Ads View control - Properties

In this case, include also a fixed ad on the bottom of the screen. You can do it by setting its properties on the Panel.

Finally, run your application and wait until your ads are displayed.

SD Ads View control - Runtime

Note how our controls on the edges of the screen are displayed and there is a fixed advertisement on the bottom.

Notes

  • With the mechanism described here, you can include an ad in the place that you want. In the mechanism described in the Ads (Advertising) article, the default behavior is that every Panel contains an ad unless Show Ads property is disabled for those Panels that you don't want to show an ad.
  • You can include multiple Ads View controls on the same Panel. Also, it can include Show Ads and Ads Position properties (at the Panel level) to display them in a fixed position.

Scope

Objects Panel objectWork With object 
Platform  Smart Devices (iOS,Android)

Availability

GoogleMobileAds is available as of GeneXus 16 upgrade 7 for the Android Platform.