Подключение 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.