Настройка SDK для мобильной рекламы Google.

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

Для показа рекламы и получения дохода интегрируйте Google Mobile Ads SDK в ваше iOS-приложение. Для подготовки проекта необходимо импортировать и инициализировать Google Mobile Ads SDK перед запросом рекламы.

Если вы используете Firebase в своем iOS-приложении, ознакомьтесь с разделом «Начало работы с AdMob в вашем iOS-проекте» .

В этом руководстве описаны импорт и инициализация Google Mobile Ads SDK , а также выбор формата объявления.

Предварительные требования

Прежде чем продолжить, убедитесь, что у вас есть следующее:

  • Используйте Xcode версии 16.0 или выше.
  • Целевая платформа: iOS 13.0 или выше.

Импортируйте Google Mobile Ads SDK

Для импорта Google Mobile Ads SDK выполните одно из следующих действий:

Swift Package Manager

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

  1. Откройте Xcode.
  2. Перейдите в меню Файл > Добавить зависимости пакета... .
  3. Установите пакет Google Mobile Ads SDK Swift.

  4. В появившемся окне найдите репозиторий GitHub "Google Mobile Ads Swift Package":

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Выберите версию пакета Google Mobile Ads SDK Swift, которую вы хотите использовать. Для новых проектов мы рекомендуем использовать версию «До следующей основной версии» .

CocoaPods

Чтобы использовать CocoaPods , выполните следующие действия:

  1. Откройте файл Podfile вашего проекта и добавьте следующую строку в конфигурацию сборки target объекта вашего приложения:

    pod 'Google-Mobile-Ads-SDK'
  2. В терминале выполните следующую команду:

    pod install --repo-update

Ручная загрузка

Для ручной загрузки Google Mobile Ads SDK выполните следующие действия:

  1. Скачайте Google Mobile Ads SDK .
  2. Распакуйте архив googlemobileadssdkios.zip .
  3. В свой проект Xcode добавьте следующие фреймворки:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. В общих настройках целевого приложения перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

  5. Убедитесь, что для файлов GoogleMobileAds.xcframework и UserMessagingPlatform.xcframework установлен режим «Встроить и подписать» .

  6. В настройках сборки вашего проекта выполните следующие действия:

    • Добавьте путь /usr/lib/swift в список путей поиска Runpath .
    • Добавьте флаг компоновщика -ObjC в раздел «Другие флаги компоновщика» .

Обновите файл Info.plist.

В файл Info.plist вашего приложения добавьте следующие ключи:

Полный пример

<key>GADApplicationIdentifier</key>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Замените SAMPLE_APP_ID на идентификатор вашего приложения AdMob. При тестировании используйте пример идентификатора приложения, показанный в предыдущем примере.

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

Инициализация Google Mobile Ads SDK

Перед загрузкой рекламы инициализируйте Google Mobile Ads SDK , вызвав метод start() из свойства GADMobileAds.sharedInstance . Этот метод вызывает обработчик завершения после того, как Google Mobile Ads SDK и адаптеры медиации завершат обработку, или через 30 секунд.

В следующем примере инициализируется Google Mobile Ads SDK :

Быстрый

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];

При инициализации Google Mobile Ads SDK может предварительно загружать рекламу или инициализировать сторонние SDK при вызове метода startWithCompletionHandler: Если вам необходимо получить согласие пользователей из Европейской экономической зоны (ЕЭЗ), Великобритании или Швейцарии, установите флаги, специфичные для запроса. Если вам необходимо установить флаги, специфичные для запроса, убедитесь, что вы установили их до инициализации Google Mobile Ads SDK . Подробнее см. раздел «Таргетинг» .

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

После импорта Google Mobile Ads SDK вы можете выбрать формат объявления для показа.

AdMob предлагает следующие форматы рекламы:

Формат рекламы Описание Документация
Баннер Отображает прямоугольные рекламные объявления в определенной области макета вашего приложения. Это объявление автоматически обновляется через заданные интервалы. Пользователи видят эти объявления периодически, оставаясь на одном и том же экране. Настройте баннерную рекламу
Интерстициальный Отображает полностраничные рекламные объявления в вашем приложении. Размещайте это объявление в естественных местах и ​​при переходах в интерфейсе вашего приложения, например, после завершения уровня в игровой приставке. Межстраничная реклама
Родной Позволяет настраивать элементы оформления, такие как заголовки и призывы к действию, в ваших приложениях. При настройке рекламы вы создаете объявления, соответствующие визуальному дизайну вашего приложения. Загрузить нативную рекламу
Награжден Пользователи зарабатывают внутриигровые награды, такие как монеты или баллы, играя в игры, участвуя в опросах или просматривая видео. Вы можете устанавливать награды для рекламных блоков, а также указывать значения наград и предметы, которые получают ваши пользователи. Рекламные объявления с вознаграждением
Вознагражденный интерстициальный Позволяет предлагать вознаграждения, такие как монеты или дополнительные жизни, за рекламу, которая появляется во время переходов между приложениями. Рекламные объявления с вознаграждением
Приложение открыто Реклама появляется, когда пользователи открывают ваше приложение или возвращаются к нему. Она накладывается поверх экрана загрузки. Приложение открывает рекламу