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

# 广告定位

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

## 设置定位

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

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

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

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

您可以使用 `kYMAGenderFemale` 和 `kYMAGenderMale` 常量获取有效字符串。 ||
|| `location` | 由您的应用检测到的用户位置。||
|| `contextQuery` | 用户在应用中的搜索查询。

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

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

## 定位示例 (Swift) {#examples-swift}

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

```swift
let adRequest = MutableAdRequest()
adRequest.age = 20
adRequest.gender = kYMAGenderMale
adRequest.location = CLLocation(latitude: 1, longitude: 2)
adRequest.contextQuery = "在北京购买二手车"
adRequest.contextTags = ["购买汽车", "二手车", "在北京"]
adView.loadAd(with: adRequest)
```

##### 插屏广告、激励广告和开屏广告

```swift
let adRequest = MutableAdRequestConfiguration(adUnitID: "your_block_id")
adRequest.age = 20
adRequest.gender = kYMAGenderMale
adRequest.location = CLLocation(latitude: 1, longitude: 2)
adRequest.contextQuery = "在北京购买二手车"
adRequest.contextTags = ["购买汽车", "二手车", "在北京"]
interstitialAdLoader.loadAd(with: adRequest)
```

#### 原生广告

```swift
let adRequest = MutableNativeAdRequestConfiguration(adUnitID: "your_block_id")
adRequest.age = 20
adRequest.gender = kYMAGenderMale
adRequest.location = CLLocation(latitude: 1, longitude: 2)
adRequest.contextQuery = "在北京购买二手车"
adRequest.contextTags = ["购买汽车", "二手车", "在北京"]
adLoader.loadAd(with: adRequest)
```