---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ads.yandex.com/helpcenter/en/easy/integration/unity/advanced-settings/targeting.md
  - https://ads.yandex.com/helpcenter/ru/easy/integration/unity/advanced-settings/targeting.md
  - https://ads.yandex.com/helpcenter/zh/easy/integration/unity/advanced-settings/targeting.md
  - href: ru/easy/integration/unity/advanced-settings/targeting.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

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

Таргетирование необходимо для использования точных настроек по подбору более подходящей рекламы. Пример использования таргетирования:

Для всех форматов рекламы используйте `AdRequest` с необязательным `AdTargeting`.

{% list tabs %}

- Баннер

    BannerComponent.cs

    ```C#
        private void Start()
        {
        if (!string.IsNullOrEmpty(currentAdUnitId))
        {
            ConfigureBanner();

            double lat = 60.0, lon = 30.0;

            // Собираем объект Location
            Location location = new Location.Builder()
                .SetLatitude(lat)
                .SetLongitude(lon)
                .Build();

            AdTargeting targeting = new AdTargeting(
                age: "25",
                gender: Gender.MALE,
                contextTags: new List<string>() { "games", "unity", "test" },
                contextQuery: "user_search_query",
                location: location
            );

            AdRequest adRequest = new AdRequest(currentAdUnitId, targeting: targeting);

            banner.LoadAd(adRequest);
        }
        else
        {
            Debug.LogError("Banner configuration failed. Ad Unit ID is missing.");
        }
        }
    ```

-  Межстраничная реклама

    InterstitialAdComponent.cs
    ```C#
    private void ConfigureAd()
    {
        double lat = 60.0, lon = 30.0;

        // Собираем объект Location
        Location location = new Location.Builder()
            .SetLatitude(lat)
            .SetLongitude(lon)
            .Build();

        AdTargeting targeting = new AdTargeting(
            age: "25",
            gender: Gender.MALE,
            contextTags: new List<string>() { "games", "unity", "test" },
            contextQuery: "user_search_query",
            location: location
        );

        AdRequest adRequest = new AdRequest(CurrentAdUnitId, targeting: targeting);
        interstitialAdLoader.LoadAd(
            adRequest: adRequest,
            onLoaded: interstitial => { /* wire interstitial events and show */ },
            onFailed: args => Debug.LogError(args.Message));
    }
    ```

- Реклама с вознаграждением

    RewardAdComponent.cs
    ```C#
    private void ConfigureAd()
    {
        double lat = 60.0, lon = 30.0;

        // Собираем объект Location
        Location location = new Location.Builder()
            .SetLatitude(lat)
            .SetLongitude(lon)
            .Build();

        AdTargeting targeting = new AdTargeting(
            age: "25",
            gender: Gender.MALE,
            contextTags: new List<string>() { "games", "unity", "test" },
            contextQuery: "user_search_query",
            location: location
        );

        AdRequest adRequest = new AdRequest(CurrentAdUnitId, targeting: targeting);
        rewardedAdLoader.LoadAd(
            adRequest: adRequest,
            onLoaded: rewardedAd => { /* wire rewarded events and show */ },
            onFailed: args => Debug.LogError(args.Message));
    }
    ```

- Реклама при открытии приложения

    AppOpenAdComponent.cs
    ```C#
    private void ConfigureAd()
    {
        double lat = 60.0, lon = 30.0;

        // Собираем объект Location
        Location location = new Location.Builder()
            .SetLatitude(lat)
            .SetLongitude(lon)
            .Build();

        AdTargeting targeting = new AdTargeting(
            age: "25",
            gender: Gender.MALE,
            contextTags: new List<string>() { "games", "unity", "test" },
            contextQuery: "user_search_query",
            location: location
        );

        AdRequest adRequest = new AdRequest(CurrentAdUnitId, targeting: targeting);
        appOpenAdLoader.LoadAd(
            adRequest: adRequest,
            onLoaded: appOpenAd => { /* wire app open events and show */ },
            onFailed: args => OnAdFailedToLoad?.Invoke(args.Message));
    }
    ```

{% endlist %}


#|
||

**Параметр**

|

**Описание**

||
||

`age`

|

Возраст пользователя: число в формате строки («14», «18» и пр.).

||
||

`gender`

|

Пол пользователя: «male», «female».

Можно использовать объект `Gender` для получения корректной строки.

||
||

`location`

|

Локация пользователя, известная в вашем приложении.

Для использования нужно получить согласие пользователя на использование локации и выставить в SDK `YandexAds.SetLocationTracking(true)`.

||
||

`contextQuery`

|

Поисковый запрос пользователя в приложении.

Например, пользователь искал автомобиль. Параметр будет выглядеть так: «Купить легковой автомобиль с пробегом в Москве».

||
||

`contextTags`

|

Ключевые слова со страницы, которую смотрел пользователь. Это может быть заголовок, часть контента, теги и пр.

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

||
|#