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

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

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

BannerComponent.cs

    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

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

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

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));
}

Параметр

Описание

age

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

gender

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

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

location

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

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

contextQuery

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

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

contextTags

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

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