В этом руководстве показано, как интегрировать адаптер-посредник с вашим приложением Flutter.
Предпосылки
Прежде чем интегрировать посредничество для формата рекламы, вам необходимо интегрировать этот формат рекламы в свое приложение:
- Рекламные баннеры
- Промежуточная реклама
- Нативная реклама
- Вознагражденные объявления
- Вознагражденные промежуточные объявления
Впервые знакомитесь с медиацией? Прочитайте Введение в медиацию .
Инициализируйте SDK мобильной рекламы
Краткое руководство по началу работы показывает, как инициализировать Mobile Ads SDK . Во время этого вызова инициализации также инициализируются адаптеры-посредники. Важно дождаться завершения инициализации, прежде чем загружать рекламу, чтобы обеспечить полное участие каждой рекламной сети в первом запросе рекламы.
В следующем примере кода показано, как можно проверить статус инициализации каждого адаптера перед выполнением запроса на рекламу.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
Обновите настройки Gradle (только для Android)
Добавьте следующие строки в файл settings.gradle
, чтобы вы могли использовать API-интерфейсы Android плагина:
def flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
Добавить зависимости для партнерских сетей
Адаптеры-медиаторы и их зависимости необходимо добавить в ваши проекты Android и iOS. Их можно добавить, обновив файл build.gradle
уровня приложения на Android и Podfile
на iOS. У Google есть адаптеры с открытым исходным кодом на GitHub как для Android , так и для iOS .
Подробные инструкции по добавлению адаптера в ваше приложение см. в документации Android и iOS для каждой партнерской сети.
Проверьте, какой класс сетевого адаптера загрузил рекламу
Следующий пример кода демонстрирует, как регистрировать имя класса рекламной сети для баннерной рекламы:
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
Используйте баннерную рекламу с посредничеством
Обязательно отключите обновление во всех сторонних источниках рекламы для рекламных блоков баннеров, используемых в медиации. Это предотвращает двойное обновление, поскольку Ad Manager также запускает обновление на основе частоты обновления вашего рекламного блока баннера.
Используйте нативную рекламу с посредничеством
Ниже приведены некоторые рекомендации, которые следует учитывать при внедрении собственного посредничества.
- Политика представления нативной рекламы
- У каждой рекламной сети есть свои правила. При использовании медиации важно помнить, что ваше приложение все равно должно соблюдать правила медиируемой сети, которая предоставила рекламу.
Законы США о конфиденциальности и GDPR
Если вам необходимо соблюдать законы о конфиденциальности в США или Общий регламент по защите данных (GDPR) , следуйте инструкциям в настройках правил штата США или настройках GDPR , чтобы добавить своих партнеров-посредников в список рекламных партнеров US Privacy & messaging или GDPR Менеджера рекламы. Невыполнение этого требования может привести к тому, что партнеры не смогут показывать рекламу в вашем приложении.
Узнайте больше о включении ограниченной обработки данных (RDP) и получении согласия GDPR с помощью SDK Google User Messaging Platform (UMP) .