---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com/support/partner/en/web/units/tag-features.md
- https://yandex.com/support/partner/ru/web/units/tag-features.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/partner/en/llms.txt
# Ad unit code features
You can enable additional functions and change certain settings by directly editing the code of the ad unit.
The `Ya.Context.AdvManager.render` function is responsible for invoking the ad in the code.
{% note alert %}
- If you do not have sufficient experience working with ad tags, we don't recommend making changes to the ad unit tag. Changes to any variables or functions other than those described on this page might lead to errors in Yandex Advertising Network ad units and cause you to lose revenue.
- You can't use the unit code as an alternative code in other advertising systems.
{% endnote %}
## Statistical cross-sections {#statId}
You can also specify sample IDs in the unit code and collect separate statistics for each sample. The sample ID is stored in a separate variable:
Variable name | Description | Data type
----- | ----- | -----
`statId` | Sample ID | A number between 1 and 1,000,000,000
Enter the sample ID in the ad tag to be placed on the site. For example:
```javascript
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
statId: 34567, // CROSS SECTION ID
});
```
For the unit `R-A-123456-1` from the example, the sample ID is `34567`. It can also be specified in other units. This will allow you to view group statistics for these units. By placing the `R-A-123456-1` unit on other pages, you can specify a different sample ID to view statistics separately for each placement.
## Limiting banner height {#max-height}
By default, [Adaptive](https://yandex.com/support/partner/en/web/units/formats/main.md#adaptive) combinatorial ads automatically occupy 100% of the parent container. You can adjust the unit height using the `height` and `max-height` parameters.
Recommended values for the maximum unit height:
- Minimum of 70 and maximum of 90 vh for the mobile version.
- Minimum of 40 and maximum of 60 vh for the desktop version when placed on side panels.
Example of a code for an ad unit with a maximum height:
```html
```
## Setting up a theme {#theme}
You can set a theme (light or dark) in the Yandex Advertising Network interface when creating or editing a unit. You can also manage the unit theme via the ad tag using the `darkTheme` parameter:
- `darkTheme: false`: Light theme is used.
- `darkTheme: true`: Dark theme is used. Dark theme units have a different background and color scheme for their text, border, buttons, and other elements.
When adding the `darkTheme` parameter, the theme settings specified in the interface are ignored.
Managing the unit theme through the code is convenient for dynamic theme sites. For example, you can use JavaScript to set different `darkTheme` parameter values: depending on the time of day or the site or browser theme chosen by the user.
Example of a code for an ad unit with a dark theme:
```javascript
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
darkTheme: true
});
```
{% cut "Example of a Top Ad unit with a dark theme" %}
{% endcut %}
## Placing a Floor Ad or Top Ad simultaneously with a Feed {#feed}
You can't display a [Feed](https://yandex.com/support/partner/en/web/units/types/feed.md), a [Floor Ad](https://yandex.com/support/partner/en/web/units/types/floor-ad.md), and a [Top Ad](https://yandex.com/support/partner/en/web/units/types/top-ad.md) on the same screen. Configure the `observer` callback function to delete your Floor Ad or Top Ad unit when the Feed becomes visible.
**Example of an ad code with the “observer” function**
```javascript
```
## Callback functions in the ad tag {#rtb-code-tuning-callback}
You can add the following callback functions to the ad code:
#### onClose
: To find out at what point the ad was closed, add the `onClose` callback function when placing the unit. This function is available for fullscreen, Top Ad, and Floor Ad units.
You can set which action to call after the banner is closed based on your business logic. For example, this action may be to call another ad unit. To do this, enter the code with the action in `onClose`.
{% cut "Example tag for calling an ad with the onClose function" %}
```javascript
```
{% endcut %}
{% cut "Example of an ad code for the second ad unit" %}
```javascript
```
{% endcut %}
## Experiments on ads with Varioqub {#varioqub}
You can conduct experiments on ads placed on your site using Varioqub. This tool allows you to create an experiment with multiple options, changing the elements and layout of the site and comparing different ad units and their settings. As a result of your experiment, you get statistics for indicators that help determine the most effective option in terms of monetization and user metrics. For more information, see [Varioqub experiments](https://yandex.com/support/varioqub/ads.html) in the Help section.
## Page context collection for ad targeting {#page-context}
Only text content visible to the user is analyzed for context. This feature can't be used to collect users' personal data. Ad tags don't analyze hidden fields, input forms, passwords, payment details, or information that isn't visible to the user on the page.
Collected context is used only for contextual ad targeting, such as to identify page categories, key topics, or the overall content subject.
#### Recommendation {#page-context-recommendations}
We recommend turning off page context collection if your ad placements are located on pages that may display private or sensitive data that you prefer not to use for targeting purposes.
This includes pages such as personal accounts, private messages, orders, support tickets, and pages that display medical, financial, or other sensitive information.
#### Turn off context collection {#page-context-disable}
You can turn off page context collection using the `disableGrab` parameter in your ad tag:
```js
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
disableGrab: true
});
```
Even with this feature turned off, your ad unit will still work normally, but the page text will no longer be analyzed or used for contextual ad targeting.
## Contact support
If you didn't find the information you were looking for, check the FAQs or contact us.
{% cut "I inserted code but the ads are not being displayed" %}
There are several reasons why problems displaying ads may occur:
- **The ad tag has recently been installed.** The [Yandex Advertising Network robot](https://yandex.com/support/partner/en/technologies/robot.md) requires some time to index the page and link it to ads.
- **The ad code is installed incorrectly.** Make sure that your JavaScript code for calling ad units has been installed correctly. Don't change the tag when copying it. When copying the tag, your text editor might truncate or wrap long strings, which might cause the JavaScript code to run incorrectly.
- **Tag invalid for the site.** Make sure that the installed ad unit code was created for this site and not for one of your other sites.
- **Site is blocked from indexing.** The site must be accessible for indexing by the [Yandex Advertising Network robot](https://yandex.com/support/partner/en/technologies/robot.md), `YandexDirect`. If indexing a site or its individual pages is banned (for example, in the `robots.txt` file), the robot can't index the content of the pages or select relevant ads for them.
- **Text is wrapped in the `