Начало работы с событиями в приложении (iOS)

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

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

Вам понадобится:

• аккаунт разработчика Facebook;
• рекламный аккаунт Facebook;
• бизнес-аккаунт Facebook (если у вас его нет, создайте новый);
• приложение Facebook.

Шаг 1. Настройка приложения Facebook

Если у вас ещё нет приложения, перейдите на Панель приложений, нажмите Мои приложения и создайте новое. Откройте Настройки > Основное, чтобы просмотреть панель подробной информации о приложении, в которой можно найти ID приложения, его секрет и другие данные.

Прокрутите до конца страницы и нажмите Добавить платформу. Выберите iOS, добавьте сведения о своем приложении и сохраните изменения.

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

• Домены приложения — URL приложения в магазине Apple App Store.
• URL политики конфиденциальности — ссылка на страницу с политикой конфиденциальности. Это обязательно для перевода приложения в рабочий режим.
• URL пользовательского соглашения — ссылка на пользовательское соглашение.
• Платформа — прокрутите страницу с настройками вниз и добавьте платформу iOS.

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

Шаг 2. Связывание рекламного и бизнес-аккаунта

Чтобы показывать рекламу и измерять количество установок приложения с помощью Ads Manager, свяжите с приложением хотя бы один рекламный аккаунт и бизнес-аккаунт.

1. На панели приложений нажмите Настройки > Дополнительно.
2. В поле Идентификаторы авторизованных рекламных аккаунтов добавьте ID рекламных аккаунтов. Их можно получить в Ads Manager.
3. На панели Рекламные аккаунты нажмите Начать и подключите приложение к компании, следуя инструкциям.

Шаг 3. Настройка среды разработки

В описанной ниже процедуре используется Swift Package Manager для настройки среды разработки в Xcode.

1. Откройте Xcode и нажмите File > Add Packages... (Файл > Добавить пакеты...).
2. В открывшемся поле поиска введите URL репозитория: https://github.com/facebook/facebook-ios-sdk.
3. В разделе Dependency Rule (Правило зависимости) выберите Up to Next Major Version (До следующей главной версии) и введите последнюю версию. Самая актуальная версия указана на сайте https://github.com/facebook/facebook-ios-sdk/releases/
4. Выберите библиотеки, которые планируете использовать, и целевые объекты, к которым хотите добавить эти библиотеки.
5. Нажмите Add Package (Добавить пакет) для завершения настройки.

Шаг 4. Регистрация и настройка приложения для работы с Facebook

Добавьте идентификатор пакета и включите для приложения единый вход.

Шаг 5. Настройка проекта

Шаг 6. Подключение делегата приложения и делегата сцены

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Шаг 7. Добавление событий в приложении

Отслеживать события в приложении можно тремя способами:

• автоматическая регистрация событий — события установки и запуска приложения, а также покупок в нем автоматически регистрируются с помощью Facebook SDK;
• Инструмент для бескодовых событий в приложении. Позволяет добавить стандартные события, не добавляя код в приложение.
• Ручная регистрация событий. Добавьте в приложение код, чтобы отслеживать стандартные и специально настроенные события.

Автоматическая регистрация событий

Получение согласия от устройства

Начиная с iOS 14.5 необходимо устанавливать флажок isAdvertiserTrackingEnabled и регистрировать каждый раз, когда вы предоставляете устройству разрешение отправлять данные на Facebook.

Если устройство предоставит согласие, установите Settings.shared.isAdvertiserTrackingEnabled = true.

Если устройство не позволяет вам отслеживать события, установите Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Регистрация событий вручную

Чтобы регистрировать специально настроенное событие, просто передайте его название как AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Параметры событий

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

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

Параметры передаются через словарь, в котором содержится имя параметра в виде AppEvents.ParameterName, а значение должно представлять собой String или номер (Int, Double и т. д.).

Шаг 8. Тестирование событий

Помощник по рекламе приложений поможет вам убедиться, что приложение отправляет события на Facebook.

1. Откройте Помощник по рекламе приложений.
2. Выберите приложение в меню Выберите приложение и нажмите Отправить.
3. Прокрутите страницу вниз и выберите Тестировать событие.
4. Запустите приложение и отправьте событие. Оно должно появиться на странице.

Дополнительная информация

• Рекомендации (разнообразные примеры приложений, которые иллюстрируют обработку событий в приложении).
• Часто задаваемые вопросы.
• Курс Meta Blueprint: Настройка SDK и событий в приложении для iOS
• Курс Meta Blueprint: Использование событий в приложении для таргетинга, оптимизации рекламы и измерения результатов

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

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