Начать, начать

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

    • minSdkVersion 19 или выше
    • compileSdkVersion 28 или выше

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

  1. В файле build.gradle на уровне проекта включите репозиторий Google Maven и центральный репозиторий 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:21.3.0'
    }
    
  3. Добавьте идентификатор приложения Ad Manager ( указанный в пользовательском интерфейсеAd Manager ) в файл AndroidManifest.xml вашего приложения. Для этого добавьте <meta-data> с android:name="com.google.android.gms.ads.APPLICATION_ID" . Идентификатор вашего приложения можно найти в пользовательском интерфейсе Ad Manager . Для android:value введите свой собственный идентификатор приложения Ad Manager , заключенный в кавычки.

    <manifest>
        <application>
            <!-- Sample Ad Manager 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>
    

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

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

    The Google Mobile Ads SDK was initialized incorrectly.
    

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

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

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

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
            <-- For apps targeting Android 13 or higher & 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.permission.AD_ID , в том числе о том, как его отключить, обратитесь к этой статье Play Console .

Инициализируйте Google Mobile Ads SDK

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

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

Вот пример того, как вызвать метод initialize() в Activity:

Пример 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) {}
    }
}

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

Выберите формат объявления

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

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

Внедрить баннерную рекламу

межстраничный

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

Внедрить межстраничную рекламу

Родной

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

Google Ad Manager предлагает два способа реализации нативных объявлений: нативные стили и индивидуальная обработка.

Нативные стили были разработаны, чтобы максимально упростить внедрение нативной рекламы, и это отличный выбор, если вы новичок в этом формате. Custom Rendering был разработан, чтобы максимально увеличить вашу свободу при создании презентаций.

Внедрите нативную рекламу Внедрение нативных стилей

Вознагражден

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

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

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

В репозитории Google Mobile Ads на GitHub показано, как использовать различные форматы рекламы, предлагаемые этим API.