开始

Интеграция Google Mobile Ads SDK в приложение - это первый шаг к показу рекламы и получению дохода. После интеграции SDK вы можете выбрать формат рекламы (например, нативное видео или видео с вознаграждением) и выполнить действия по его внедрению.

Прежде чем вы начнете

Чтобы подготовить приложение, выполните действия, описанные в следующих разделах.

Требования к приложению

  • Используйте Android Studio 3.2 или выше
  • Убедитесь, что в файле сборки вашего приложения используются следующие значения:

    • minSdkVersion из 16 или выше
    • compileSdkVersion из 28 или выше

Настройте приложение в своем аккаунте AdMob.

Зарегистрируйте свое приложение как приложение AdMob, выполнив следующие действия:

  1. Войдите или зарегистрироваться для учетной записи AdMob.

  2. Зарегистрируйте свое приложение с AdMob . Этот шаг создает приложение AdMob с уникальным AdMob App ID , который необходим позже в этом руководстве.

Настройте свое приложение

  1. В вашем проектном уровне build.gradle файла, включают в себя хранилище Maven Google, и Maven центрального хранилища в обоих вашей buildscript и allprojects разделах:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Добавьте зависимости для Google Mobile Ads SDK для приложений уровня вашего модуля Gradle файла, как правило , app/build.gradle :

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:20.5.0'
    }
    
  3. Добавить AdMob идентификатор приложения ( идентифицированного вAdMobUI ) для вашего приложения AndroidManifest.xml файла. Для этого добавьте <meta-data> тег с android:name="com.google.android.gms.ads.APPLICATION_ID" . Вы можете найти свой идентификатор приложения в AdMob UI. Для android:value , вставить свой собственный AdMob идентификатор приложения, в кавычки.

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

    В реальном приложении, использовать фактический AdMob идентификатор приложения, а не один , перечисленных выше. Если вы просто хотите поэкспериментировать с SDK в приложении Hello World, вы можете использовать образец идентификатора приложения, показанный выше.

    Следует также отметить , что отказ добавить <meta-data> тег , как показано выше , приводит к аварии с сообщением:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (Необязательно) Declare AD_ID разрешение для предыдущих версий для работы с Android S.

    Если ваше приложение использует Google Mobile Ads SDK версии 20.4.0 или выше, вы можете пропустить этот шаг , так как SDK автоматически объявляет com.google.android.gms.AD_ID разрешение и имеет возможность получить доступ рекламный идентификатор , когда он доступен.

    Для приложений, использующих Google Mobile Ads SDK версии 20.3.0 или ниже и ориентируется Android S, вы должны добавить com.google.android.gms.AD_ID разрешения в AndroidManifest.xml файл для того , чтобы предназначаться для Android S:

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
            <-- For Android S devices & GMA SDK version 20.3.0 or lower -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
        </application>
    </manifest>
    

    Чтобы узнать больше о com.google.android.gms.AD_ID декларации разрешения, в том числе , как отключить его, пожалуйста , обратитесь к этой консоли статье Play .

Инициализировать Google Mobile Ads SDK

Перед загрузкой объявлений, есть приложение Проинициализирует Google Mobile Ads SDK, вызвав MobileAds.initialize() , который инициализирует SDK и перезванивает пополнение слушатель раз завершения инициализации (или после 30-секундной задержки). Это нужно сделать только один раз, в идеале при запуске приложения.

Объявления могут быть предварительно загружены в Google Mobile Ads SDK или SDKs посредничество партнеров при вызове MobileAds.initialize() . Если вам необходимо получить согласие от пользователей Европейской экономической зоны (ЕЭЗ), устанавливать какие - либо запрос специфических флагов (например, tagForChildDirectedTreatment или tag_for_under_age_of_consent ), или в противном случае принять меры до загрузки объявлений, убедитесь , что вы сделать это перед инициализацией Google Mobile Ads SDK .

Вот пример того , как назвать initialize() метод в деятельности:

Пример MainActivity (отрывок)

Джава

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });
    }
}

Котлин

import com.google.android.gms.ads.MobileAds

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}
    }
}

Если вы используете посредничество, дождитесь вызова обработчика завершения перед загрузкой объявлений, так как это обеспечит инициализацию всех адаптеров-посредников.

Выберите формат рекламы

SDK Google Mobile Ads импортирован, и вы готовы разместить рекламу.AdMob предлагает ряд различных форматов объявлений, так что вы можете выбрать тот , который наилучшим образом соответствует пользовательскому интерфейсу вашего приложения.

Прямоугольные объявления, которые появляются вверху или внизу экрана устройства. Баннеры остаются на экране, пока пользователи взаимодействуют с приложением, и могут автоматически обновляться через определенный период времени. Если вы новичок в мобильной рекламе, это отличное место для начала.

Реализуйте рекламные баннеры

Межстраничное

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

Реализуйте межстраничные объявления

Родные

Настраиваемая реклама, которая соответствует внешнему виду вашего приложения. Вы сами решаете, как и где они размещаются, чтобы макет больше соответствовал дизайну вашего приложения.

Реализуйте нативные объявления

Награжден

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

Реализуйте рекламу с вознаграждением

Дополнительные ресурсы

Хранилище Google Mobile Ads на GitHub показывает , как использовать различные форматы объявлений , которые этот API предложения.