Подключение Yandex Mobile Ads Flutter плагина
Это архивная версия документации. Актуальная документация по всем платформам находится здесь.
О плагине
Flutter — популярная кросс-платформенная технология разработки мобильных приложений. С ее помощью разработчики могут писать единый код, который можно применить для разных операционных систем — и для Android, и для iOS.
Теперь монетизировать Android- и iOS-приложения, созданные с помощью Flutter, будет проще. Всем партнерам Рекламной сети Яндекса доступен плагин, с которым можно легко добавить в приложение монетизацию от Яндекса.
Плагин поддерживает загрузку и отображение рекламы:
- баннерная реклама;
- полноэкранная реклама;
- Технические требования
-
- Flutter 2.5.0 и выше.
Android 4.1 и выше.
Видеореклама подбирается на устройства с версией Android 5.0 и выше.
iOS 12.0 и выше.
Для корректной работы iOS 14 и выше обратите внимание на дополнительные шаги.
Последняя версия Xcode с включенными инструментами командной строки.
Регистрация аккаунта в Рекламной сети.
Добавление плагина в проект
Чтобы интегрировать Mobile Ads SDK в приложение Flutter, используйте Yandex Mobile Ads Flutter плагин.
Установите плагин Yandex Mobile Ads Flutter в свой проект. Из корня проекта вызовите команду:
flutter pub add yandex_mobileads
После добавления плагина в файле pubspec.yaml
появится строка с зависимостью:
dependencies:
yandex_mobileads: ^X.X.X
X.X.X
— номер актуальной версии плагина.
Настройка для конкретной платформы
В
app/build.gradle
Android-модуля вашего приложения добавьте:dependencies { // ... implementation 'com.yandex.android:mobileads-mediation:5.10.0.0' }
В
build.gradle
Android-модуля вашего приложения добавьте:// IronSource maven { url 'https://android-sdk.is.com/' } // Pangle maven { url 'https://artifact.bytedance.com/repository/pangle' } // Tapjoy maven { url "https://sdk.tapjoy.com/" } // Mintegral maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
В Yandex Mobile Ads SDK уже добавлено разрешение
com.google.android.gms.permission.AD_ID
. Оно позволяет использовать AD_ID для подбора релевантной рекламы. При необходимости вы можете удалить разрешение.Подробнее о разрешении и рекламном идентификатореРекламный идентификатор – уникальный идентификатор сервисов Google Play для показа рекламы пользователям, которые согласны видеть персонализированные объявления. Пользователь может отключить персонализацию рекламы или сбросить идентификатор в настройках. В таком случае рекламные сети не смогут использовать его для подбора релевантной рекламы.
Как удалить разрешение
Если какие-то политики, например, Google Play’s Families Policy, не позволяют использовать рекламный идентификатор, удалите разрешение из файла AndroidManifest.xml.
<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
В
Podlist
iOS-модуля вашего приложения добавьте:pod 'YandexMobileAdsMediation', '5.9.0'
Mobile Ads SDK поддерживает трекинг установок приложений с помощью фреймворка SKAdNetwork. Трекинг установок работает для всех устройств, даже если доступ к IDFA отсутствует.
Чтобы включить функциональность, добавьте идентификаторы поддерживаемых рекламных сетей в файл Info.plist iOS-модуля приложения.
<key>SKAdNetworkItems</key> <array> <dict> <!-- Yandex Ads --> <key>SKAdNetworkIdentifier</key> <string>zq492l623r.skadnetwork</string> </dict> <dict> <!-- AdMob --> <key>SKAdNetworkIdentifier</key> <string>cstr6suwn9.skadnetwork</string> </dict> <dict> <!-- MyTarget --> <key>SKAdNetworkIdentifier</key> <string>n9x2a789qt.skadnetwork</string> </dict> <dict> <!-- MyTarget --> <key>SKAdNetworkIdentifier</key> <string>r26jy69rpl.skadnetwork</string> </dict> <dict> <!-- Start.io --> <key>SKAdNetworkIdentifier</key> <string>5l3tpt7t6e.skadnetwork</string> </dict> <dict> <!-- UnityAds --> <key>SKAdNetworkIdentifier</key> <string>4dzt52r2t5.skadnetwork</string> </dict> <dict> <!-- IronSource --> <key>SKAdNetworkIdentifier</key> <string>su67r6k2v3.skadnetwork</string> </dict> <dict> <!-- Applovin --> <key>SKAdNetworkIdentifier</key> <string>ludvb6z3bs.skadnetwork</string> </dict> <dict> <!-- Mintegral --> <key>SKAdNetworkIdentifier</key> <string>KBD757YWX3.skadnetwork</string> </dict> </array>
Для дополнительной информации ознакомьтесь с разделом Configuring a Source App документации Apple.
Инициализация библиотеки
В initState виджета вашего приложения добавьте строку: MobileAds.initialize();
.
Ознакомьтесь с примерами использования SDK.