Интеграция SDK событий в приложении TikTok

Перед началом работы

Чтобы использовать SDK событий в приложении TikTok для Android и iOS, вам потребуются рекламный аккаунт TikTok и идентификатор приложения в TikTok. Вы можете использовать существующее приложение, если оно у вас есть, или создать новое приложение.

Примечание. SDK событий в приложении TikTok теперь поддерживает гибридную настройку с партнером по мобильным измерениям (MMP) в одном аккаунте. Вы можете создать новый рекламный аккаунт TikTok для интеграции SDK или использовать для этого существующий аккаунт MMP.

Интеграция SDK событий в приложении TikTok

Шаг 1. Создайте новое или используйте существующее приложение и создайте идентификатор приложения в TikTok и секретный ключ приложения

Вариант 1. Добавление SDK в приложение, подключенное к MMP (гибридная настройка)

1. Войдите в аккаунт на Рекламной платформе TikTok.

2. Перейдите на вкладку Инструменты, затем выберите Менеджер событий.

3. Выберите Источники данных, затем выберите приложение, для которого требуется добавить подключение SDK.

   
   
   

4. Перейдите на вкладку Настройки и нажмите Выбрать партнера в разделе «SDK событий в приложении от TikTok».

   
   
   

5. Следуйте инструкциям, чтобы добавить SDK в аккаунт. Сгенерируйте Идентификатор приложения в TikTok и Секретный ключ приложения.

   

Вариант 2. Добавление SDK во вновь созданное приложение

1. Войдите в аккаунт на Рекламной платформе TikTok.

2. Перейдите на вкладку Инструменты, затем выберите Менеджер событий.

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

   
   
   

4. Выберите TikTok SDK, чтобы подключить приложение.

   
   
   

5. Предоставьте сведения о приложении. Следуйте инструкциям, чтобы сгенерировать Идентификатор приложения в TikTok и Секретный ключ приложения.

   
   
   

Шаг 2. Следуйте инструкциям в руководстве Центра TikTok для разработчиков, чтобы интегрировать SDK событий в приложении TikTok

1. Чтобы инициализировать SDK, необходимо иметь идентификатор приложения, идентификатор приложения в TikTok и секретный ключ приложения, созданные на шаге 1.

   1. Демо идентификатора приложения и идентификатора приложения в TikTok:

      
      
      

   2. Демо секретного ключа приложения:

      
      
      

2. Загрузите SDK в GitHub. В настоящее время поддерживаются Native iOS SDK, Native Android SDK и Unity SDK.

Шаг 3. Передайте события через SDK

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

2. Ниже представлены события, которые добавляются в журнал автоматически. Примечание. Автоматически добавляемые в журнал события можно отключить. Подробнее см. в документации по SDK событий в приложении для разработчиков.

   1. Запуск приложения: запуск приложения.

   2. Установка приложения: первый запуск приложения.

   3. Возврат пользователя на второй день: повторное открытие приложения на следующий день после дня первого открытия.

   4. Покупка: произведенная оплата расходуемого или нерасходуемого товара либо подписки.

      1. Перед включением функции автоматического добавления в журнал событий покупки убедитесь, что она соответствует вашим бизнес-потребностям. Подробнее об автоматическом добавлении в журнал событий покупки на устройствах с iOS и автоматическом добавлении в журнал событий покупки на устройствах с Android.

Особое примечание для автоматического добавления в журнал событий покупки: SDK может автоматически фиксировать транзакции, совершенные с помощью StoreKit (iOS) или Google Play Billing (Android). Если вам необходимо передавать дополнительные свойства и параметры либо вы не используете нативный платежный шлюз Apple или Google, рекомендуем использовать передачу событий покупки вручную.

Шаг 4. [iOS] Измерьте события SKAdNetwork

В среде SKAdNetwork рекомендуется использовать только один SDK для передачи значений конверсии. Если вы используете MMP или другой SDK для обновления значений конверсии в SKAdNetwork, обязательно добавьте disableSKAdNetworkSupport() в конфигурацию, чтобы избежать конфликтов при обновлении.

Определите, требуется ли включать измерение SKAdNetwork в TikTok SDK:

Если у вас есть MMP:

• Если SDK MMP обновляет значение конверсии и вы планируете использовать схему SKAdNetwork MMP, отключите поддержку SKAdNetwork в TikTok SDK и не загружайте схему в Менеджер событий TikTok. (Ваш MMP остается единственным источником достоверных данных для обновлений значений конверсии и схемы.)

Если у вас НЕТ MMP:

Убедитесь, что только один SDK в вашем приложении обновляет значение конверсии SKAdNetwork.

• Если значение конверсии обновляется другим SDK (не MMP), отключите поддержку SKAdNetwork в TikTok SDK, но загрузите схему в Менеджер событий TikTok. (TikTok будет использовать вашу схему, но не будет выполнять дублирующие обновления значений конверсии.)

• Если за обновление значения конверсии отвечает TikTok SDK, включите поддержку SKAdNetwork в TikTok SDK и загрузите схему в Менеджер событий TikTok. (TikTok становится основным обработчиком обновлений значений конверсии для SKAdNetwork.)

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

Шаг 5. Проверьте обратную передачу в реальном времени в режиме отладки

Начиная с версии SDK 1.5.0, пользователи могут проверить интеграцию SDK перед выпуском двумя способами:

• (рекомендуется) режим тестирования событий на базе токенов: полностью выполняется в Менеджере событий TikTok и не требует изменений в коде;

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

  • Режим отладки: ВКЛ.

    

    Режим отладки: ВЫКЛ.

    

Шаг 6. Опубликуйте в App Store (iOS) / Google Play (Android) новую версию приложения с TikTok SDK

События SDK будут отображаться на вкладке Отчетность в Менеджере событий, как только TikTok начнет получать ваши сигналы от SDK в реальном времени. Сигналы, отправленные в режиме тестирования, здесь не отображаются.

Шаг 7. Запустите свою кампанию с SDK от TikTok

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