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

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

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

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

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

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

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

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

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

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

Swift Package Manager

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

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

CocoaPods

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

Откройте файл Podfile вашего проекта и добавьте следующую строку в конфигурацию сборки target объекта вашего приложения:
```
pod 'Google-Mobile-Ads-SDK'
```
В терминале выполните следующую команду:
```
pod install --repo-update
```

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

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

Скачайте Google Mobile Ads SDK .
Распакуйте пакет googlemobileadssdkios.zip .
В свой проект Xcode добавьте следующие фреймворки:
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
В общих настройках целевого приложения перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .
Убедитесь, что для файлов GoogleMobileAds.xcframework и UserMessagingPlatform.xcframework установлен режим «Встроить и подписать» .
В настройках сборки вашего проекта выполните следующие действия:
- Добавьте путь /usr/lib/swift в список путей поиска Runpath .
- Добавьте флаг компоновщика -ObjC в раздел «Другие флаги компоновщика» .

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

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

Ключ GADApplicationIdentifier со строковым значением, представляющим собой идентификатор вашего приложения Ad Manager , найденный в пользовательском интерфейсе Ad Manager , в формате ca-app-pub-################~########## .
Ключ SKAdNetworkItems . Этот ключ содержит значения SKAdNetworkIdentifier для Google cstr6suwn9.skadnetwork и некоторых сторонних покупателей .

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

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager 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 на идентификатор вашего приложения Ad Manager. При тестировании используйте пример идентификатора приложения, показанный в предыдущем примере.

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

Инициализация 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()ViewController.swift

SwiftUI

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

Objective-C

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

When initializing, Google Mobile Ads SDK might preload ads or initialize third party SDKs when calling the startWithCompletionHandler: method. If you need to obtain consent from users in the European Economic Area (EEA), the United Kingdom (UK), or Switzerland, set request-specific flags. If you need to set request-specific flags, make sure you set the flags before initializing Google Mobile Ads SDK . For details, see Targeting .

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

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

Менеджер рекламы предлагает следующие форматы объявлений:

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

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