Руководство по интеграции

Версия Релиза	Дата Релиза
3.3.3	17.09.2024

Следуйте этому руководству, чтобы получить максимальную отдачу от Appodeal.

Appodeal SDK даёт вам доступ к 70+ рекламным источникам и заставляет их конкурировать друг с другом на аукционе в реальном времени, максимизируя ваши доходы от рекламы. Функционал Appodeal SDK также включает In-app Bidding, автоматическую оптимизацию UA, сегментацию пользователей & A/B тестирование, перекрестное продвижение, прямые сделки, мгновенные выплаты и многое другое.

Способы Интеграции

Appodeal SDK предоставляет два способа интеграции. Из предложенных ниже вариантов выберите тот, который больше соответствует вашим потребностям:

Appodeal SDK Full Package

The Appodeal SDK Full Package - - Appodeal SDK предоставляет вам инструменты для развития ваших мобильных приложений и игр. В дополнение к монетизации вы можете воспользоваться сервисами продвижения пользователей UA (User Acquisition) и аналитики в приложении.
Вот список сервисов, которые включает Appodeal SDK Full Package:

• Начните с Appodeal, чтобы получить доступ к Монетизации и Аналитике.

• Подключитесь к Adjust или AppsFlyer, чтобы разблокировать функции Атрибуции.

• Подключитесь к Meta (ранее известная как facebook-core) для User Acquisition.

• Подключитесь к Firebase для Аналитики + remote config для продуктовых A/B тестов и настроек.

Если вы планируете проводить кампании UA, хотите анализировать свои показатели в нашем инструменте бизнес-аналитики Appodeal без использования MMP или хотите использовать remote config для тестов и настроек, ваш вариант — полный пакет.

Appodeal SDK Mediation Only

The Appodeal SDK Mediation only - Если вы не планируете проводить кампании по привлечению пользователей (UA) и не хотите использовать расширенную аналитику Appodeal, мы создали облегченную версию нашего SDK только с функцией медиации. В процессе интеграции от вас не потребуется устанавливать никаких дополнительных сервисов, кроме медиации. Это может ускорить процесс интеграции, и вы всегда сможете перейти на Full Package, когда будете готовы.

---

подсказка

Пожалуйста, следуйте данному руководству по интеграции шаг за шагом и выбирете свой вариант интеграции по мере необходимости.

В следующем документе показано, как интегрировать Appodeal в ваш Android проект с нужными вам сетями через gradle build, а также настройка всех рекламных форматов.

Минимальные требования:

Android API level 21 (Android OS 5.0) или выше.

В качестве эталонного проекта можно использовать наше демо приложения

Demo App

Шаг 1. Импорт SDK

Настроить Build.gradle

Appodeal SDK Full Package

Конфигурация рекламных сетей и типов рекламы

Мы предоставляем удобный и интерактивный способ управления build.gradle dependencies в зависимости от выбранных типов рекламы, сетей и сервисов. Чтобы настроить ваш build.gradle, пожалуйста, посетите страницу Настройка Медиационных Сетей.

Ниже представлен базовый и рекомендуемый код для build.gradle:

Appodeal SDK Mediation Only

Конфигурация рекламных сетей и типов рекламы

Мы предоставляем удобный и интерактивный способ управления build.gradle dependencies в зависимости от выбранных типов рекламы, сетей и сервисов. Чтобы настроить ваш build.gradle, пожалуйста, посетите страницу Настройка Медиационных Сетей.

Ниже представлен базовый и рекомендуемый код для build.gradle:

1. Вставьте следующий код в settings.gradle на уровень корня проекта

settings.gradle

2. Insert following code into your app-level build.gradle

После этого сохраните файл и выполните Gradle sync.

Шаг 2. Настройка проекта

Конфигурация сетевой безопасности

Android 9.0 (API 28) по умолчанию блокирует трафик с открытым текстом (не-HTTPS), что может препятствовать корректному отображению рекламы. Подробнее об этом здесь.

Чтобы предотвратить блокировку системой android http-трафика, выполните следующие действия:

1. Добавьте файл Network Security Configuration в ваш AndroidManifest.xml :

<?xml version="1.0" encoding="utf-8"?>
<manifest>
    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config">
    </application>
</manifest>

2. В файл network_security_config.xml добавьте base-config и установите cleartextTrafficPermitted в значение true :

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

Настройка AdMob Meta-data

примечание

Только если вы используете адаптер AdMob.

Важно

Admob Bidding теперь доступен с Appodeal SDK 3.2.0.

Не забудьте установить нашу новую версию Admob Sync инструмента по ссылке и выполнить синхронизацию.

Можете прочитать подробнее про Admob Sync в нашей инструкции.

Добавьте AdMob app id в meta-data тег:

<manifest>
    <application>
        <!-- Add your AdMob App ID -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Вы можете найти AdMob app id в личном кабинете на странице AdMob:

Более подробную информацию о синхронизации с Admob смотрите в нашем руководстве по Admob.

Шаг 3. Инициализация SDK

Мы рекомендуем вызывать метод инициализации в вашей MainActivity - onCreate только один раз во всем приложении:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    Appodeal.initialize(activity, "APP_KEY", adTypes, object : ApdInitializationCallback {
        override fun onInitializationFinished(errors: List<ApdInitializationError>?) {
            // Appodeal initialization finished
        }
    })
}

Java

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Appodeal.initialize(activity, "APP_KEY", adTypes, new ApdInitializationCallback() {
        @Override
        public void onInitializationFinished(@Nullable List<ApdInitializationError> errors) {
            // Appodeal initialization finished
        }
    });
}

• activity - Activity вашего приложения.

• Замените APP_KEY на актуальный ключ вашего приложения. Вы можете найти ключ приложения в списке приложений в вашем личном кабинете.

• adTypes - Тип рекламы. Инициализируйте только те типы рекламы, которые вы хотите использовать в своем приложении, чтобы избежать запросов рекламы на неиспользуемые типы. Используйте приведенные ниже коды типов для установки предпочтительного формата объявлений:

  • Appodeal.INTERSTITIAL для полноэкранной рекламы;
  • Appodeal.REWARDED_VIDEO для видео с вознаграждением;
  • Appodeal.NATIVE для нативной рекламы;
  • Appodeal.BANNER для баннеров;
  • Appodeal.MREC для баннеров 300*250.

подсказка

Типы рекламы можно комбинировать с помощью оператора or. Например, Appodeal.INTERSTITIAL or Appodeal.REWARDED_VIDEO.

• callback - Callback инициализации Appodeal ApdInitializationCallback. Callback инициализации используется для определения результата инициализации Appodeal SDK. Вызывается после завершения инициализации Appodeal. Если инициализация прошла успешно, то errors будет null. В противном случае он содержит список errors.

Шаг 4. Настройка типов объявлений

Теперь Appodeal SDK интегрирован в ваш проект, и вы готовы к реализации рекламы. Appodeal предлагает несколько различных форматов рекламы, поэтому вы можете выбрать тот, который лучше всего соответствует пользовательскому опыту вашего приложения.

Привлекающая внимание полноэкранная реклама со статическим отображением объявления.

Реализация Interstitial

Объявления, инициированные пользователями, в которых пользователи могут получать вознаграждение в приложении в обмен на просмотр объявления.

Реализация Rewarded Ad

Традиционный рекламный формат, который разамещает небольшое рекламное объявление внизу или вверху экрана.

Реализация Banner

Объявления размером 300x250, которые отображаются внутри содержимого приложения.

Реализация MREC

Формат рекламы, который органично вписывается в контекст контента приложения.

Реализация Native Ad

Шаг 5. Следующие шаги

Добавить политику конфиденциальности

Обязательно добавьте в приложение в Google Play Политику конфиденциальности со ссылкой на Политику конфиденциальности Appodeal и Google Play Developer Distribution Agreement

осторожно

Политика Google: разрешения на определение местоположения могут запрашиваться только для обеспечения функций, имеющих отношение к основному функционалу приложения. Нельзя запрашивать доступ к данным о местоположении исключительно с целью рекламы или аналитики. Если вы не используете определение местоположения для основных функций своего приложения.

• Удалите разрешение на определение местоположения в своем приложении, добавив следующий код в AndroidManifest.xml а так же тег.

<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
    package="com.example.app">
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"
    tools:node="remove" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
    tools:node="remove" />
</manifest>

• Обновите приложение в Google Play. В процессе публикации убедитесь в отсутствии предупреждений о местоположении в Google Play Console.

Если местоположение используется для основных функций приложения, то:

• Заполните форму декларации разрешений на определение местоположения в Google Play Console. Подробнее о форме декларации можно прочитать здесь.

• Обновите приложение в Google Play. В процессе публикации убедитесь, что в Google Play Console нет предупреждений о местоположении.

к сведению

Некоторые сети и сторонние зависимости (связанные с зависимостями рекламной сети) могут включать в манифест свои собственные разрешения. Если вы хотите принудительно удалить такие разрешения, вы можете обратиться к этому руководству.

Добавление файла App-ads.txt

Файл app-ads.txt - это текстовый файл, который предоставляет издателям возможность объявлять своих авторизованных цифровых продавцов.

Вы можете найти более подробную информацию здесь