Перейти к основному содержимому
осторожно
Android SDK 3.0.2 устарела. Stable версия - здесь.
Версия: 3.0.2

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

Release version: 3.0.2 | Release date: 17.01.2023

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

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

к сведению

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

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

  • Руководство по интеграции Appodeal, чтобы получить доступ к Монетизации и Аналитике.
  • Подключитесь к Adjust или AppsFlyer, чтобы разблокировать Функции Атрибуции.
  • Подключитесь к Meta (ранее известной как facebook-core) для User Acquisition.
  • Подключитесь к Firebase для Analytics + remote config для продуктовых A/B тестов and настроек.

Если вы планируете проводить UA-кампании, хотите анализировать показатели в нашем инструменте бизнес-аналитики Appodeal без использования MMP, или хотите использовать удаленный конфиг для тестов и настроек, то ваш вариант - The Appodeal SDK Full Package.

подсказка

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

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

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

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

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

Demo App

Импорт SDK​

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

Пожалуйста, укажите типы рекламы, используемые в вашем приложении, и рекламные сети, которые вы хотите включить.

Отключение рекламных сетей

Поскольку вы выбрали опцию Appodeal SDK Full Package, убедитесь, что вы не исключили сервисы из сборки.

Мы рекомендуем использовать стандартную конфигурацию Gradle, так как отключение некоторых рекомендуемых адаптеров может негативно сказаться на доходе.

Рекламные сети​

Сервисы​

Сгенирированный код​

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

settings.gradle
// Example project-level settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ... other project repositories
        
    }
}

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

build.gradle
// Example app-level build.gradle (excerpt)
android {
    // ... other options
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

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

Настройка проекта​

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

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

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

  1. Добавьте файл Network Security Configuration в ваш AndroidManifest.xml :
AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest>
    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config">
    </application>
</manifest>
  1. В файл network_security_config.xml добавьте base-config и установите cleartextTrafficPermitted в значение true :
network_security_config.xml
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
</network-security-config>

Настройка Admob Meta-data​

примечание

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

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

XML
<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 account

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

Инициализация SDK​

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

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
        }
    })
}

  • 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.

Настройка типов объявлений​

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

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

Реализация Interstitial

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

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

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

Реализация Banner

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

Реализация MREC

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

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

Подготовка к публикации приложения​

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

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

осторожно

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

  • Удалите разрешение на определение местоположения в своем приложении, добавив следующий код в AndroidManifest.xml а так же тег.
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 - это текстовый файл, который предоставляет издателям возможность объявлять своих авторизованных цифровых продавцов. Созданный IAB, он является расширением оригинального стандарта ads.txt, который использовался для той же цели в веб-рекламе. Он помогает рекламным сетям и DSP легко проверить, действительно ли рекламная сеть или биржа, у которой они покупают ваш трафик, имеет право продавать его.

Добавление файла app-ads.txt повышает уровень доверия между рекламодателями, партнерами по спросу и издателями. Если у издателей нет собственного сайта, на котором они могли бы разместить файл add app-ads.txt, спрос на деманд премиум-класса может оказаться для них недоступным.

  1. Добавьте URL-адрес сайта разработчика в свои приложения Google Play или Amazon.
  2. Загрузите файл app-ads.txt Appodeal с этой страницы.
  3. Загрузите файл app-ads.txt в корневой каталог вашего сайта разработчика (он должен выглядеть следующим образом: example.com/app-ads.txt).