---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ads.yandex.com/helpcenter/en/dev/android/target.md
  - https://ads.yandex.com/helpcenter/ru/dev/android/target.md
  - https://ads.yandex.com/helpcenter/zh/dev/android/target.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt

# 广告定位

您可以使用 Yandex Mobile Ads SDK API 添加额外的用户信息。向请求中添加上下文数据可显著提升广告质量进而增加收入。

## 设置定位 {#setup}

您可以在广告请求中传递用户信息：

- 针对横幅（[内联](https://ads.yandex.com/helpcenter/zh/dev/android/adaptive-inline-banner.md) 和 [粘性](https://ads.yandex.com/helpcenter/zh/dev/android/adaptive-sticky-banner.md)），请使用 `AdRequest` 类。
- 针对 [插屏广告](https://ads.yandex.com/helpcenter/zh/dev/android/interstitial.md)、[激励广告](https://ads.yandex.com/helpcenter/zh/dev/android/rewarded.md) 和 [开屏广告](https://ads.yandex.com/helpcenter/zh/dev/android/app-open-ad.md)，请使用 `AdRequestConfiguration` 类。
- 针对 [原生广告](https://ads.yandex.com/helpcenter/zh/dev/android/native.md)，请使用 `NativeAdRequestConfiguration` 类。
- 针对 [广告信息流](https://ads.yandex.com/helpcenter/zh/dev/android/feed-ad.md)，请使用 `AdRequest` 类。

您可以提供以下用户信息：

#|
|| **参数** | **描述** ||
|| `age` | 用户年龄：字符串格式的数字（例如`"14"`、`"18"`等）。 ||
|| `gender` | 用户性别：`male` 或 `female`。

您可以使用 `Gender` 对象获取有效字符串 ||
|| `location` | 由您的应用检测到的用户的位置。

要使用位置，您必须获得用户对您的应用使用其位置的同意，并在 SDK 中设置 `MobileAds.setLocationConsent(true)`。 ||
|| `contextQuery` | 用户在应用中的搜索查询。

例如，如果用户搜索汽车，则参数可能为`"在莫斯科购买二手车"`。||
|| `contextTags` | 用户正在查看的页面中的关键字。可能是页面的标题、页面的部分内容、标记及其他元素。

对于包含汽车搜索的页面，此参数可能为`"购买汽车"`、`"二手车"`、`"在莫斯科"`。||
|#

## 定位示例 (Kotlin) {#examples-kotlin}

#### 自适应内联和粘性横幅

```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 adRequest = AdRequest.Builder("demo-feed-yandex")
            .setAge("25")
            .setGender(Gender.MALE)
            .setLocation(Location("provider"))
            .setContextQuery("在北京购买二手车")
            .setContextTags(listOf("购买汽车", "二手车", "在北京"))
            .build()
val feedAd = FeedAd.Builder(context, adRequest, feedAdAppearance).build()
feedAd.loadListener = feedAdLoadListener
```