---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://ads.yandex.com/helpcenter/en/support/faq/sdk-errors.md
- https://ads.yandex.com/helpcenter/ru/support/faq/sdk-errors.md
- https://ads.yandex.com/helpcenter/zh/support/faq/sdk-errors.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt
# Решение проблем при интеграции SDK
{% cut "Как определить, что интеграция проведена правильно?" %}
Проверить корректность интеграции можно одним из способов:
* загрузить рекламу с помощью демоблоков и проверить, что реклама реагирует на клик;
* использовать встроенный в SDK анализатор или нативный инструмент Console;
* для нативной рекламы также можно включить индикатор некорректной интеграции и проверить, что не отображается красный индикатор.
Подробнее о тестировании интеграции читайте в разделе Yandex Mobile Ads SDK:
- [Android](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md)
- [iOS](https://ads.yandex.com/helpcenter/ru/dev/ios/quick-start.md)
- [Unity](https://ads.yandex.com/helpcenter/ru/dev/unity/quick-start.md)
- [Flutter](https://ads.yandex.com/helpcenter/ru/dev/flutter/quick-start.md)
- [React Native](https://ads.yandex.com/helpcenter/ru/dev/react-native/quick-start.md)
{% endcut %}
{% cut "Кнопка имплементации выдает неправильное подключение SDK" %}
Рекомендуется проверить:
- корректность добавления [зависимостей](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md);
- корректность [инициализации](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md#инициализируйте-yandex-mobile-ads-sdk-init) библиотеки.
Также можно воспользоваться [режимом отладки интеграции](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md#проверка-интеграции-sdk).
{% endcut %}
{% cut "Возможные ошибки интеграции" %}
Интеграция может быть некорректной по причинам:
1. Не подключен или некорректно подключен адаптер. Ознакомьтесь с инструкциями по подключению к сторонним платформам медиации:
* [Android](https://ads.yandex.com/helpcenter/ru/dev/android/third-party-mediation.md)
* [iOS](https://ads.yandex.com/helpcenter/ru/dev/ios/third-party-mediation.md)
* [Unity](https://ads.yandex.com/helpcenter/ru/dev/unity/third-party-mediation.md)
2. Не интегрирован Unity плагин для приложений на Unity. Ознакомьтесь с [инструкцией по интеграции плагина](https://ads.yandex.com/helpcenter/ru/dev/unity/quick-start.md).
3. Некорректно указан ID блока в интерфейсе Рекламной сети Яндекса и кабинете сторонней медиации. Проверьте, что во всех кабинетах указаны одинаковые ID блока.
4. Указаны разные пороги в интерфейсе Рекламной сети Яндекса и кабинете сторонней медиации. Проверьте, что во всех кабинетах указаны одинаковые пороги.
{% endcut %}
{% cut "При интеграции с Unity появляется ошибка `resource android:attr/lStar not found`" %}
Чтобы исправить ошибку, можно понизить Target API Level до версии 30. Подробнее в [инструкции](https://ads.yandex.com/helpcenter/ru/dev/unity/quick-start.md#настройка-для-конкретной-платформы).
Однако рекомендуется обновление до Target API Level версии 31, так как у Google есть ограничения на выпуск обновлений для приложений с устаревшей версией Target API Level. Подробнее в [статье](https://developer.android.com/google/play/requirements/target-sdk).
{% endcut %}
{% cut "При интеграции с React Native (Android) появляется ошибка `Could not find any matches for com.facebook.react:react-android`" %}
Чтобы исправить ошибку, в файле `android/build.gradle` приложения в блоке `allprojects` добавьте следующее:
```groovy
allprojects {
repositories {
// ...
}
// this fixes an issue with react-native dependencies resolution
configurations.all {
resolutionStrategy.dependencySubstitution {
substitute module("com.facebook.react:react-android") using module("com.facebook.react:react-native:+")
}
}
}
```
{% endcut %}
{% cut "Возникает `Fatal Error` по нахождению пути классов" %}
Вероятно, при сборке ProGuard производит манипуляции и перестановки. Такая ошибка возникает, если включена настройка `-keepclasseswithmembernames` в файле конфигурации `proguard config`. Необходимо закомментировать код или удалить строку.
{% endcut %}
{% cut "При сборке появляется ошибка невозможности подключения к ресурсу" %}
Ошибка может возникать, если некорректно указан ресурс в `Podfile`. Подробнее в [инструкции](https://ads.yandex.com/helpcenter/ru/dev/ios/quick-start.md).
Если ошибка повторяется, обратитесь в службу поддержки.
#### Написать в службу поддержки {#support-connect-to-resource}
{% endcut %}
{% cut "Сообщение `Provided block ID doesn't exist`" %}
После запроса за рекламой появляется сообщение `Provided block ID doesn't exist`, несмотря на то, что в интерфейсе Рекламной сети Яндекса созданы блоки.
Проверьте корректность указанного блока из интерфейса Рекламной сети Яндекса в запросе в приложении.
{% endcut %}
{% cut "Почему возникает ошибка `NoAdsAvailable`?" %}
Данная ошибка означает, что система не смогла подобрать рекламу. Она может возникать при тестировании из-за того, что для новых непроклеенных устройств нужно время, чтобы наша система собрала информацию по устройству и [Крипта](https://yandex.ru/company/technologies/crypta) ее подцепила. После этого процесса начинается подбор рекламы. Из-за чего еще может возникать данная ошибка:
1. На рекламном блоке выставлен слишком высокий порог CPM.
1. Рекламный блок находится в архиве.
1. Медиация, которую вы используете, не поддерживает показы рекламы в РФ.
1. BundleID приложения в интерфейсе Рекламной сети Яндекса отличается от BundleID, для которого запрашивается реклама.
Если ошибка повторяется, обратитесь в службу поддержки.
#### Написать в службу поддержки {#support-no-ads-available}
{% endcut %}
{% cut "Не приходит ответ на запрос получения рекламы, и возникает ошибка `Banner Rendering Failed with Timeout`" %}
Такая ошибка может возникать, если долго обрабатывается запрос. Обратитесь в службу поддержки и предоставьте в своем запросе лог ошибок.
#### Написать в службу поддержки {#support-banner-rendering-failed}
{% endcut %}
{% cut "Не грузится баннер после запроса за рекламой" %}
Рекомендуется проверить корректность передаваемого AdUnitID, параметры запроса и размеры баннера. Примеры кода:
* [Android](https://ads.yandex.com/helpcenter/ru/dev/android/adaptive-inline-banner.md)
* [iOS](https://github.com/yandexmobile/yandex-ads-sdk-ios/blob/master/Examples/YandexMobileAdsExample/YandexMobileAdsExample/Yandex/Banner/BannerViewController.swift)
{% endcut %}
{% cut "Почему возникает отключение видимости баннера после успешной загрузки?" %}
Возможно, вы применяете настройку `android:visibility="gone"` для параметров видимости. Выставьте программно или вручную `android:visibility="visible"`.
{% endcut %}
{% cut "Можно ли ограничить длину видеороликов в Rewarded video?" %}
Да, такая возможность есть. Обратитесь в службу поддержки или к вашему персональному менеджеру.
#### Написать в службу поддержки {#support-limit-length-of-video}
{% endcut %}
{% cut "Как правильно оформить нативный рекламный блок?" %}
Подробности в [статье](https://yandex.ru/adv/news/kak-pravilno-oformit-nativnyy-reklamnyy-blok-v-prilozheniyakh-4-soveta-dlya-izdateley).
{% endcut %}
{% cut "Можно ли обрезать картинку в нативной рекламе?" %}
Основное изображение можно обрезать не более чем на 25% и только относительно центра изображения. Иконку нельзя увеличить или обрезать, но можно уменьшить без изменения пропорций. Подробные правила описаны в разделе [Нативная реклама](https://ads.yandex.com/helpcenter/ru/monetization/ad-unit/native.md).
{% endcut %}
{% cut "Как включить видеорекламу и медийную рекламу в нативные блоки?" %}
По умолчанию в нативных рекламных блоках показываются только комбинаторные объявления. Для включения видеорекламы и/или медийной рекламы в ваших нативных блоках обратитесь в службу поддержки или к вашему персональному менеджеру.
{% note info %}
Перед включением вам необходимо начать передавать размеры в запросе. Подробности в инструкциях:
* [Android](https://ads.yandex.com/helpcenter/ru/dev/android/native.md)
* [iOS](https://ads.yandex.com/helpcenter/ru/dev/ios/native.md)
{% endnote %}
#### Написать в службу поддержки {#support-media-in-native}
{% endcut %}
{% cut "Почему может быть низкий Fill Rate?" %}
Причиной низкой заполняемости рекламного блока может быть наличие порога CPM, блокировка тематик и брендов, технические проблемы. Чтобы повысить Fill Rate, необходимо выявить и устранить проблему.
Подробнее о повышении эффективности рекламы читайте в [Справке](https://yandex.ru/support2/partner/efficiency/fill-rate.html#low-fill-rate).
{% endcut %}
{% cut "Как записать сессию сниффера (Сharles)?" %}
Charles — прокси-сервер, который работает на вашем компьютере и позволяет записывать HTTP- и HTTPS-трафик подключенных устройств. Запись сессии позволит службе поддержки быстро диагностировать проблему, связанную с загрузкой или показом рекламы, поскольку содержит данные запрашиваемого блока, параметры рекламного места, информацию о баннерах, которые были показаны, и техническую информацию об устройстве.
#### Установить Charles {#install-charles}
1. Установите Charles на компьютере с [официального сайта](https://www.charlesproxy.com/download/).
1. Если при первом запуске приложение предложило автоматически настроить параметры сети, нажмите **Grant Privileges**.
1. Приложение бесплатное в течение 30 дней. Если у вас есть ключ, в меню Charles выберите **Help** → **Register Charles** и зарегистрируйте приложение.
Подробные инструкции по использованию приложения приведены в [документации Charles](https://www.charlesproxy.com/documentation/getting-started/).
#### Настроить прокси {#configure-proxy}
Чтобы приложение на компьютере могло записывать трафик мобильного устройства:
1. В меню Charles выберите **Proxy** → **SSL Proxying Settings**.
1. Включите опцию **Enable SSL Proxying**.
1. Нажмите кнопку **Add** под **Include Location** и укажите звездочку в поле **Host**. Сохраните изменения.
1. В меню Charles выберите **Help** → **SSL Proxying** → **Install Root Certificate on a Mobile Device or Remote Browser**. Charles отобразит IP-адрес и порт прокси-сервера, то есть IP-адрес вашего компьютера и используемый по умолчанию порт 8888.
1. Перезапустите Charles.
1. Подключите мобильное устройство к той же сети Wi-Fi, что и компьютер. Перейдите в настройки этой сети, выберите настроить прокси вручную и укажите IP-адрес и порт прокси-сервера.
#### Установить сертификат {#install-certificate}
Чтобы записывать HTTPS-трафик, установите на мобильном устройстве корневой SSL-сертификат Charles. Более подробная информация приведена в [документации Charles](https://www.charlesproxy.com/documentation/using-charles/ssl-certificates/).
{% list tabs %}
- Android
1. В системном браузере скачайте сертификат по ссылке [http://chls.pro/ssl](http://chls.pro/ssl).
{% note info %}
Если скачать сертификат не удается, возможно, файрвол на компьютере блокирует входящие соединения. В настройках файрвола разрешите приложению Charles принимать входящие соединения и повторите попытку.
{% endnote %}
1. Если установка сертификата не началась автоматически, в настройках устройства найдите раздел установки сертификатов и установите сертификат Charles. Выберите тип использования «для VPN и приложений». Если потребуется установить PIN, укажите любой.
1. Для Android версии 10 и выше настройте конфигурацию приложения (APK), которое запрашивает рекламу:
- В каталоге `res/xml` создайте файл `network_security_config.xml` с текстом:
```xml
```
- В файл AndroidManifest.xml добавьте атрибут для секции `application`:
```xml
...
...
```
- iOS
1. В браузере Safari скачайте сертификат по ссылке [http://chls.pro/ssl](http://chls.pro/ssl).
{% note info %}
Если скачать сертификат не удается, возможно, файрвол на компьютере блокирует входящие соединения. В настройках файрвола разрешите приложению Charles принимать входящие соединения и повторите попытку.
{% endnote %}
1. Если установка сертификата не началась автоматически, в настройках устройства перейдите в раздел **Профиль**, выберите сертификат Charles и установите его.
1. В настройках устройства перейдите в раздел **Основные** → **Об этом устройстве** → **Доверие сертификатам** и включите доверие для сертификата Charles.
{% endlist %}
#### Записать сессию {#record-session}
Чтобы начать и остановить запись трафика, используйте кнопку  /  на панели инструментов Charles. Когда идет запись, кнопка выглядит так: .
Обновите экран приложения, на котором запрашивается реклама. Убедитесь, что в сессии появился URL для загрузки рекламы — `mobile.yandexadexchange.net/v4/ad` или `yandex.<домен>/ads/v4/ad`. В меню Charles выберите **File** → **Save Session As...** и сохраните файл с расширением `.chls`.
{% note tip %}
После завершения отладки удалите сертификат на устройстве и выключите использование прокси-сервера.
{% endnote %}
{% endcut %}
[Обратиться в службу поддержки](../contact){.button}