---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ads.yandex.com/helpcenter/en/dev/android7/target.md
  - https://ads.yandex.com/helpcenter/ru/dev/android7/target.md
  - href: ru/dev/android7/target.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt

<!--
Используется в Boost: boost/ru/ad-monetization/dev/android
-->

# Таргетирование рекламы

API SDK позволяет добавить дополнительную информацию о пользователе. Контекстные данные в запросе могут значительно улучшить качество рекламы, что приведет к увеличению дохода.

## Настройка таргетирования {#setup}

Информацию о пользователе можно передать в рекламном запросе: 

- для баннера ([inline](https://ads.yandex.com/helpcenter/ru/dev/android7/adaptive-inline-banner.md) и [sticky](https://ads.yandex.com/helpcenter/ru/dev/android7/adaptive-sticky-banner.md)) — `AdRequest`;
- для [межстраничной рекламы](https://ads.yandex.com/helpcenter/ru/dev/android7/interstitial.md), [рекламы с вознаграждением](https://ads.yandex.com/helpcenter/ru/dev/android7/rewarded.md) и [рекламы при открытии приложения](https://ads.yandex.com/helpcenter/ru/dev/android7/app-open-ad.md) — `AdRequestConfiguration`;
- для [нативной рекламы](https://ads.yandex.com/helpcenter/ru/dev/android7/native.md) — `NativeAdRequestConfiguration`;
- для [рекламной ленты](https://ads.yandex.com/helpcenter/ru/dev/android7/feed-ad.md) — `FeedAdRequestConfiguration`.

Вы можете заполнить такую информацию о пользователе:

#|
|| **Параметр** | **Описание** || 
|| `age` | Возраст пользователя: число в формате строки (`"14"`, `"18"` и т. п.). || 
|| `gender` | Пол пользователя: `male`, `female`. 

Можно использовать объект `Gender` для получения корректной строки. || 
|| `location` | Локация пользователя, известная в вашем приложении. 

Перед установкой параметра нужно получить согласие пользователя на использование локации и выставить в SDK `MobileAds.setLocationConsent(true)`. ||
|| `contextQuery` | Поисковый запрос пользователя в приложении. 

Например, пользователь искал автомобиль, параметр будет выглядеть так: `"Купить легковой автомобиль с пробегом в Москве"`. ||
|| `contextTags` | Ключевые слова со страницы, которую смотрел пользователь. Это может быть заголовок, часть контента, теги и т. п. 

Для страницы с поиском автомобиля параметр может выглядеть так: `"Купить легковой автомобиль"`, `"автомобиль с пробегом"`, `"в Москве"`. ||
|#


## Примеры таргетирования (Kotlin) {#examples-kotlin}

#### Адаптивные inline- и sticky-баннеры

```kotlin
val adRequest = AdRequest.Builder()
            .setAge("25")
            .setGender(Gender.MALE)
            .setLocation(Location("provider"))
            .setContextQuery("Купить легковой автомобиль с пробегом в Москве")
            .setContextTags(listOf("Купить легковой автомобиль", "автомобиль с пробегом", "в Москве"))
            .build()
loadAd(adRequest)
```

##### Межстраничная реклама, реклама с вознаграждением и реклама при открытии приложения

```kotlin
val adRequestConfiguration = AdRequestConfiguration.Builder("demo-interstitial-yandex")
            .setAge("25")
            .setGender(Gender.MALE)
            .setLocation(Location("provider"))
            .setContextQuery("Купить легковой автомобиль с пробегом в Москве")
            .setContextTags(listOf("Купить легковой автомобиль", "автомобиль с пробегом", "в Москве"))
            .build()
loadAd(adRequestConfiguration)
```

#### Нативная реклама

```kotlin
val nativeAdRequestConfiguration = NativeAdRequestConfiguration.Builder("demo-native-yandex")
            .setAge("25")
            .setGender(Gender.MALE)
            .setLocation(Location("provider"))
            .setContextQuery("Купить легковой автомобиль с пробегом в Москве")
            .setContextTags(listOf("Купить легковой автомобиль", "автомобиль с пробегом", "в Москве"))
            .build()
nativeAdLoader?.loadAd(nativeAdRequestConfiguration)
```

#### Рекламная лента

```kotlin
val feedAdRequestConfiguration = FeedAdRequestConfiguration.Builder("demo-feed-yandex")
            .setAge("25")
            .setGender(Gender.MALE)
            .setLocation(Location("provider"))
            .setContextQuery("Купить легковой автомобиль с пробегом в Москве")
            .setContextTags(listOf("Купить легковой автомобиль", "автомобиль с пробегом", "в Москве"))
            .build()
val feedAd = FeedAd.Builder(context, feedAdRequestConfiguration, feedAdAppearance).build()
feedAd.loadListener = feedAdLoadListener
```
