Интеграция Adapty Attribution с TikTok for Business позволяет отслеживать и оптимизировать эффективность рекламных кампаний в TikTok.

Шаг 1. Подключите аккаунт TikTok

1. Перейдите в Integrations > TikTok Ads в левом сайдбаре и нажмите Continue with TikTok.

2. Войдите в аккаунт TikTok и нажмите Continue.

3. Ознакомьтесь с запрашиваемыми разрешениями и нажмите Save.

После этого все ваши рекламные аккаунты будут добавлены в Adapty UA. Можно переходить к добавлению кампаний.

Шаг 2. Добавьте кампании

Одна кампания может охватывать App Store, Google Play и ваш веб-воронку одновременно. Соединение обеспечивают два элемента:

• Ссылка для отслеживания: Используется в объявлении. Когда пользователь нажимает на рекламу, Adapty фиксирует клик, перенаправляет пользователя на целевую страницу и впоследствии связывает установку и покупки с этим объявлением. Для каждого назначения создаётся отдельная ссылка.
• Пиксель: Выбирается в кампании из пикселей в вашем аккаунте TikTok. Передаёт данные о конверсиях обратно в TikTok, чтобы TikTok мог оптимизировать кампанию на основе реальных покупок. Один пиксель может обслуживать все три назначения, или для каждого назначения можно использовать отдельный пиксель.

Чтобы добавить кампанию TikTok for Business в Adapty Attribution и отслеживать результаты ваших TikTok-объявлений в Adapty:

1. Перейдите на вкладку Web Campaigns и нажмите Create configuration.

   

2. На вкладке General раскройте раздел iOS и/или Android и вставьте URL-адреса приложений из App Store и/или Google Play.

   

3. Скопируйте значение поля Click link. Затем при создании объявления в TikTok Ads Manager вставьте это значение в поле Destination URL. Это позволит Adapty связывать установки и покупки с объявлениями в TikTok. См. Добавление рекламного контента.

   

4. (Опционально) Чтобы отправлять события конверсии обратно в TikTok, можно также связать пиксели TikTok с кампаниями в Adapty Attribution. Для этого выберите один из существующих пикселей в выпадающем списке Pixel. После выбора пикселя нажмите Send test event, чтобы проверить соединение.

   Раздел Web funnel работает так же. Покупки в веб-воронке происходят за пределами вашего приложения, поэтому TikTok узнаёт о них только через пиксель, выбранный здесь. В этом же разделе вы найдёте фрагмент кода для установки пикселя в воронке и параметры для разметки URL ваших объявлений.

Разный пиксель для каждого назначения позволяет разделить покупки iOS, Android и web для оптимизации и отчётности; один и тот же пиксель везде — объединяет их. В списке Web Campaigns этот выбор отображается для каждой конфигурации в столбцах Pixel (iOS), Pixel (Android) и Pixel (Web) — в виде названия и ID пикселя. Если раздел без пикселя, там стоит прочерк; если один пиксель выбран во всех трёх разделах, он отображается три раза.

Шаг 3. Настройте маппинг событий

Чтобы отправлять конверсионные события обратно в TikTok для оптимизации кампаний, настройте маппинг событий в разделе Events mapping. Это позволит Adapty автоматически отправлять события подписки, когда пользователи совершают действия в вашем приложении.

В разделе Events mapping включите события, которые хотите отслеживать в TikTok Ads Manager. Для каждого включённого события выберите соответствующее событие TikTok из выпадающего списка или задайте своё. По умолчанию Adapty сопоставляет события Adapty со стандартными событиями TikTok.

Нажмите Save, чтобы применить настройки маппинга событий.

Дополнительная настройка

Дополнительные параметры

Поле Additional parameter позволяет добавлять пользовательские данные для анализа за пределами Adapty. Это полезно, когда нужно передать конкретные данные о кампании или пользователе во внешние инструменты аналитики или партнёрам по атрибуции.

В поле Additional parameter введите любые пользовательские данные, которые хотите включить в отслеживание атрибуции. Дополнительный параметр будет передаваться во всех данных атрибуции, отправляемых в TikTok, и может использоваться для углублённого анализа и оптимизации кампаний.

Например, если вы запускаете несколько вариаций одной кампании, можно добавить variant=A или variant=B, чтобы различать разные креативные подходы.

Настройки

Вкладка Settings управляет тем, как Adapty сопоставляет установку с кликом по вашей рекламе в TikTok. Настройки применяются только к данной конфигурации кампании.

Adapty использует два типа сопоставления:

• Детерминированное сопоставление работает только на Android. Google Play передаёт в ваше приложение ID нажатого клика через Play Install Referrer, поэтому Adapty связывает установку именно с этим кликом. На iOS аналога нет, поэтому iOS-установки никогда не сопоставляются детерминированно.
• Вероятностное сопоставление работает на iOS и Android. Adapty сравнивает установку с кликами с того же диапазона IP-адресов и той же операционной системы, а затем выбирает клик с наилучшим совпадением по времени с момента клика, языку устройства и стране. Если клик был сделан более чем за 6 часов до установки, дополнительно должны совпадать модель устройства и версия ОС. Adapty не использует IDFA и Google Advertising ID, поэтому вероятностное сопоставление охватывает всех iOS-пользователей, в том числе тех, кто отклонил запрос отслеживания в диалоге App Tracking Transparency.

На Android Adapty сначала пытается выполнить детерминированное сопоставление, а при неудаче переходит к вероятностному.

Чтобы задать, в течение какого времени после клика установка может быть связана с ним, на вкладке Settings в разделе New user attribution введите значение окна в часах:

• Deterministic Matching Window: по умолчанию 168 часов (7 дней), допустимый диапазон — от 1 до 720 часов.
• Probabilistic Matching Window: по умолчанию 6 часов, допустимый диапазон — от 1 до 24 часов. Чем больше окно, тем больше установок будет сопоставлено, но тем выше вероятность ошибок. Для кампаний с большим количеством кликов рекомендуется уменьшить его до 1–2 часов.

Чтобы отключить детерминированное или вероятностное совпадение для данной конфигурации, переключите соответствующий переключатель в её окне и сохраните. Изменение вступит в силу в течение 5 минут.

Выручка, передаваемая в TikTok

TikTok использует сумму каждого события для расчёта ROAS и оптимизации на основе ценности. Чтобы выбрать, какую выручку Adapty будет передавать в TikTok в качестве этого значения, в выпадающем списке Revenue sent to TikTok выберите тип выручки и нажмите Save. Чтобы сравнить ROAS в TikTok с ROAS в Adapty, выберите тот тип, который вы отображаете в аналитике Adapty.

Тип выручки	Значение покупки в App Store или Google Play
Gross revenue (по умолчанию)	Полная цена, которую заплатил пользователь, до вычета комиссии стора и налогов.
Proceeds after store commission	Цена за вычетом комиссии App Store или Google Play. Налоги по-прежнему включены.
Proceeds after store commission and taxes	Цена за вычетом комиссии стора и налогов.

О том, как Adapty рассчитывает комиссию и налоги, читайте в разделе Комиссии и налоги.

Применение типа в других случаях:

• Веб-покупки: Для покупок через Stripe и Paddle оба типа выручки отправляют одно и то же значение, как в аналитике атрибуции Adapty: цена за вычетом 4,5% для Stripe и полная цена для Paddle. Adapty не вычитает налоги из веб-покупок.
• Возвраты: TikTok получает события возврата без значения, независимо от типа.
• Триальные события: Процент переопределения дохода применяется к цене подписки выбранного типа.
• Покупки без суммы выбранного типа: Adapty отправляет в TikTok валовую выручку от покупки.

Новый тип выручки вступает в силу в течение 5 минут после сохранения и применяется только к новым событиям. Adapty не переотправляет уже отправленные события, а событие пробного периода, которое Adapty уже удерживает для Qualified trial, отправляется с типом, который был выбран в момент начала удержания.

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

Переопределение выручки

Если вы отслеживаете события триала и хотите, чтобы TikTok приписывал им выручку, используйте раздел Revenue override. Он появляется, когда включено событие Trial started. Переопределение применяется только к Trial started — Trial converted и Subscription started всегда передают фактическую выручку.

Для каждого целевого события пробного периода укажите процент от цены подписки, который будет передаваться как доход. Adapty берёт указанный процент от цены в формате, выбранном в разделе Revenue sent to TikTok. Например, при 30% и Gross revenue Adapty передаёт 30% от цены подписки в качестве значения конверсии для событий пробного периода.

Чтобы добавить переопределение:

1. Включите Trial started в разделе Events mapping.
2. В Revenue override нажмите Add event.
3. Выберите целевое событие и введите процент дохода (0–100).
4. Нажмите Save.

Квалифицированный триал

Триал считается квалифицированным, если он не был отменён в течение заданного количества часов. Используйте раздел Qualified trial, чтобы задержать события триала до их квалификации — тогда TikTok будет получать только те триалы, которые пользователи сохранили.

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

Чтобы удерживать событие пробного периода до его квалификации:

1. Включите Trial started в разделе Events mapping.
2. В Qualified trial нажмите Add event.
3. Выберите целевое событие и укажите количество часов ожидания — от 1 до 24.
4. Нажмите Save.

Adapty отправляет событие qualified с оригинальным временем начала триала, поэтому TikTok фиксирует его на день, когда триал начался.

Revenue override и Qualified trial работают независимо, и вы можете применить оба параметра к одному и тому же событию триала. Revenue override изменяет значение, которое получает TikTok; Qualified trial определяет, когда TikTok его получает. При использовании обоих параметров Adapty удерживает событие до тех пор, пока триал не квалифицируется, а затем отправляет его с переопределённым значением дохода. Ни один из вариантов не является предпочтительным — тестируйте то, что лучше работает для ваших кампаний.

Отправлять события от всех пользователей

По умолчанию Adapty отправляет события только тех пользователей, которых атрибутирует к данной конфигурации. Опция Send events from all users отправляет события всех пользователей вашего приложения — включая органических пользователей, пользователей из других рекламных сетей и пользователей из других конфигураций TikTok. TikTok самостоятельно решает, какие из этих конверсий засчитывать своей рекламе. Эта опция не влияет на атрибуцию в Adapty.

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

Если вы всё же решите включить эту опцию, в настройках кампании выберите Send events from all users и нажмите Save.