Ad targeting

You can use the Yandex Mobile Ads SDK API to add extra user information. Adding context data to the request can significantly enhance the quality of advertising and increase your revenue.

Set up targeting

Pass user information using AdTargeting when you create an AdRequest.

You can provide the following information about the user:

Parameter

Description

age

User age: a number in string format ("14", "18", and so on).

gender

User gender: MALE, FEMALE.

You can use the Gender object to get a valid string.

location

The user's location as detected by your app.

To use the location, you must obtain the user's consent to your app using their location and set YandexAds.setLocationTracking(true) in the SDK.

contextQuery

The user's search query in the app.

For instance, if the user searched for a car, the parameter might look like "Buy a used car in Moscow".

contextTags

Keywords from the page the user was viewing. These could be the page's title, parts of its content, tags, and other elements.

For a page with a car search, this parameter might look like "Buy a car", "used car", "in Moscow".

Targeting examples (Kotlin)

val targeting = AdTargeting.Builder()
    .setAge("25")
    .setGender(Gender.MALE)
    .setLocation(Location("provider"))
    .setContextQuery("Buy a used car in Moscow")
    .setContextTags(listOf("Buy a car", "used car", "in Moscow"))
    .build()

val adRequest = AdRequest.Builder("RM-XXXXX-YY")
    .setTargeting(targeting)
    .build()