Эта страница переведена с помощью Cloud Translation API.

Начните использовать AdMob в своем проекте iOS

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

Если вы еще этого не сделали, узнайте обо всех преимуществах совместного использования AdMob , Firebase и Google Analytics .

Прежде чем начать

Если у вас еще нет проекта Firebase и приложения Firebase, следуйте руководству по началу работы с Firebase: Добавьте Firebase в свой проект iOS .
Убедитесь, что Google Analytics включен в вашем проекте Firebase:
- Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
- Если у вас есть существующий проект Firebase, в котором не включен Google Analytics , вы можете включить Google Analytics на вкладке «Интеграции» вашего аккаунта. > Настройки проекта .
Примечание. Добавление Firebase SDK для Google Analytics в ваше приложение не является обязательным, но настоятельно рекомендуется. Узнайте больше о преимуществах добавления Firebase SDK для Google Analytics .

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

Зарегистрируйте свое приложение как приложение AdMob .
1. Войдите или зарегистрируйте учетную запись AdMob .
2. Зарегистрируйте свое приложение в AdMob . На этом этапе создается приложение AdMob с уникальным идентификатором приложения AdMob , который понадобится вам далее в этом руководстве.
Вам будет предложено добавить Mobile Ads SDK в ваше приложение. Подробные инструкции по выполнению этой задачи вы найдете далее в этом руководстве.
Свяжите свое приложение AdMob с приложением Firebase.
Этот шаг не является обязательным, но настоятельно рекомендуется. Узнайте больше о преимуществах включения пользовательских показателей и связи вашего приложения AdMob с Firebase.
Выполните следующие два шага на панели приложений вашего аккаунта AdMob :
1. Включите пользовательские метрики , чтобы AdMob мог обрабатывать и отображать тщательно подобранные аналитические данные в вашем аккаунте AdMob . Это также необходимая настройка для связи вашего приложения AdMob с Firebase.
2. Свяжите свое приложение AdMob с существующим проектом Firebase и приложением Firebase.
  Убедитесь, что вы вводите тот же идентификатор пакета, который вы указали для своего приложения Firebase. Найдите идентификатор пакета вашего приложения Firebase на карточке «Ваши приложения» вашего > Настройки проекта .

Шаг 2. Добавьте идентификатор приложения AdMob в файл `Info.plist`

В файл Info.plist вашего приложения добавьте ключ GADApplicationIdentifier со строковым значением вашего идентификатора приложения AdMob .

Вы можете внести это изменение программно:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Или отредактируйте его в редакторе списка свойств:

Редактор списка свойств

Шаг 3. Добавьте и инициализируйте Mobile Ads SDK

Добавьте зависимость для Google Mobile Ads SDK в подфайл вашего проекта:
```
pod 'Google-Mobile-Ads-SDK'
```
Прежде чем загружать рекламу, вызовите метод startWithCompletionHandler: в GADMobileAds.sharedInstance .
Этот вызов инициализирует SDK и вызывает обработчик завершения после завершения инициализации (или после 30-секундного таймаута). Вызывайте этот метод только один раз и как можно раньше, в идеале при запуске приложения, но после инициализации Firebase.
Внимание! Объявления могут быть предварительно загружены с помощью Mobile Ads SDK или SDK партнеров-посредников при вызове startWithCompletionHandler: . Если вам необходимо предпринять какие-либо действия перед загрузкой рекламы, убедитесь, что вы сделали это до инициализации Mobile Ads SDK. Вот несколько примеров действий, которые могут потребоваться перед инициализацией:
- Получить согласие от пользователей в Европейской экономической зоне (ЕЭЗ).
- Установите любые флаги, специфичные для запроса (например, tagForChildDirectedTreatment или tag_for_under_age_of_consent ).
Подробную информацию можно найти в документации AdMob .
Вот пример вызова метода startWithCompletionHandler: в вашем AppDelegate :
Быстрый
```
import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}
```
Цель-C
```
@import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end
```

Шаг 4. Просмотр пользовательских показателей и аналитических данных

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

На карточке пользовательских показателей вашего аккаунта AdMob ( главная страница или панель приложений ) вы можете просмотреть специально подобранные пользовательские метрики , полученные на основе собранных аналитических данных, например среднюю продолжительность сеанса, ARPU и удержание.
На панели инструментов Analytics консоли Firebase вы можете просмотреть агрегированную статистику и сводку ключевых показателей . Если вы добавите Firebase SDK для Google Analytics , вы также сможете отмечать конверсии для рекламных кампаний и создавать собственные аудитории в консоли Firebase .

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

Шаг 5. (Необязательно) Используйте дополнительные функции Google Analytics и Firebase.

Воспользуйтесь дополнительными возможностями и функциями для улучшения монетизации приложений и вовлечения пользователей:

Добавьте и используйте Firebase SDK для Google Analytics
- Внедрите пользовательскую регистрацию событий в своем приложении.
- Отмечайте конверсии для специальных рекламных кампаний .
- Включите данные о событии ecommerce_purchase в расчет дохода для показателей ARPU и ARPPU .
Чтобы узнать больше, посетите руководство по использованию Google Analytics и Firebase с приложениями AdMob .
Используйте другие продукты Firebase в своем приложении
После добавления Firebase SDK для Google Analytics используйте другие продукты Firebase для оптимизации рекламы в своем приложении.
- Remote Config позволяет вам бесплатно изменить поведение и внешний вид вашего приложения без публикации обновления приложения для неограниченного количества активных пользователей в день.
- A/B Testing дает вам возможность протестировать изменения в пользовательском интерфейсе, функциях или кампаниях по вовлечению вашего приложения, чтобы узнать, влияют ли они на ваши ключевые показатели (такие как доход и удержание), прежде чем широко внедрять изменения.

Оптимизируйте монетизацию рекламы для своего приложения
Опробуйте различные форматы и конфигурации рекламы с небольшой группой пользователей, а затем принимайте основанные на данных решения о реализации рекламы для всех ваших пользователей. Чтобы узнать больше, ознакомьтесь со следующими уроками:
- Протестируйте внедрение нового формата рекламы ( обзор | реализация ).
- Оптимизация частоты показа объявлений ( обзор | реализация ).

Шаг 6. Выберите формат рекламы для использования в вашем приложении.

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

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

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

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

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

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

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

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

Родной

Настраиваемые объявления, соответствующие внешнему виду вашего приложения.

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

Внедрите нативную расширенную рекламу

Награжден

Реклама, которая вознаграждает пользователей за просмотр коротких видеороликов и взаимодействие с игровой рекламой и опросами.

Реклама с вознаграждением (или «на основе вознаграждения») может помочь монетизировать пользователей бесплатной игры.

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

Внедрение рекламы с вознаграждением (новые API)