Чтобы активировать интеграцию с TikTok Web Ads:

1. В AppsFlyer в боковом меню откройте Сотрудничество > Партнерские интеграции > Partner Marketplace.
2. Найдите TikTok Web (или tiktokweb_int) и выберите его. Вы будете перенаправлены на страницу настройки.
3. На вкладке Интеграция включите переключатель Активировать партнера. Переключатель должен оставаться в положении активирован всё время, пока вы работаете с партнером.
4. Отключите опцию Расширенная конфиденциальность (если вы настраиваете интеграцию приложения iOS).
5. Обмен данными с расширенным сопоставлением: Включите, чтобы передавать в TikTok поля расширенного сопоставления, такие как хешированный email, хешированный номер телефона, хешированное имя и хешированную фамилию, если эти поля включены в данные о событии, отправляемые в AppsFlyer. Более подробную информацию см. здесь: Обмен данными с расширенным сопоставлением.
6. Идентификатор пикселя: Введите идентификатор пикселя. Вы можете сгенерировать его или получить в TikTok Ads Manager, следуя инструкциям, приведенным ЗДЕСЬ.
7. Токен доступа: Введите токен доступа. Чтобы сгенерировать или получить его, следуйте этим инструкциям

8. Ограничение использования персональных данных пользователей в рекламе TikTok (CCPA): Включите этот переключатель, чтобы обеспечить соблюдение законов о защите данных.

    Примечание:

   Соблюдение требований CCPA ограничивает объем данных, поступающих от пользователей рекламы TikTok, проживающих в Калифорнии или других чувствительных штатах США.

AppsFlyer поддерживает атрибуцию по просмотрам для веб-кампаний TikTok с использованием посадочной страницы с поддержкой Smart Script или Smart Banner. Это позволяет выполнять атрибуцию на основе вероятностного моделирования для установок приложений, вызванные показом рекламы, даже когда пользователи не нажимают на рекламу напрямую.

Когда пользователь нажимает на рекламное объявление TikTok Web и попадает на посадочную страницу с поддержкой Smart Script или Smart Banner, AppsFlyer может атрибутировать последующую установку приложения. Если доступно, параметр ttclid будет включён в постбэк к TikTok для повышения точности атрибуции.

Активация атрибуции по просмотрам через TikTok Web:

1. В AppsFlyer, из боковой панели, откройте Активные интеграции > TikTok web ads.
2. На вкладке Интеграция прокрутите до раздела Атрибуция установки.
3. Включите Атрибуцию установок по просмотрам.
4. [необязательно] Включите Равный приоритет кроссплатформенной атрибуции и задайте для него окно ретроспективы. Более подробно см. Включите равный приоритет для кроссплатформенных показов.
5. Откройте вкладку Ссылка атрибуции.
6. Прокрутите к разделу Атрибуция по просмотрам и установите окно атрибуции по просмотрам (до 24 часов).
7. Нажмите Сохранить интеграцию для применения ваших настроек.

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

Для настройки постбэков по внутренним событиям приложения выполните следующие действия:

1. Активируйте Постбэки по внутренним событиям приложения.
2. При необходимости задайте окно постбэков по событиям в приложении (подробнее о настройке окна постбэков по событиям в приложении в целом читайте в этой статье).
3. НажмитеДобавить событие, чтобы добавить событие в список.
4. При необходимости задайте Iокно постбэка события в приложении. AppsFlyer получает название события либо из SDK, интегрированного в ваше приложение, либо из межсерверных событий.
5. В столбце mapped to partner event column, выберите в раскрывающемся списке наиболее подходящее предопределенное партнерское событие.
6. В столбце For Users From выберите This Partner Only , чтобы постбэки событий в приложении отправлялись исключительно по событиям, выполненным пользователями, пришедшими от этого партнера.

7. В столбце including выберите, будут ли события отправляться со значениями дохода. См.  Данные для включения в постбэки.

    Примечание:

   • Если вы настраиваете событие покупки, в столбце «Включая» установите значение «Значения и выручка». Выбор любого другого варианта приведет к сбою в отправке постбэка.
   • В настоящее время для включения дохода может быть настроено только событие покупки.
8. [Необязательно] Нажмите на значок Добавить условие, чтобы задать условия для события.
9. Нажмите Сохранить интеграцию.
10. [Необязательно] После сохранения интеграции, оставаясь на странице конфигурации, вы можете интегрировать с этим партнером другие свои приложения:
    1. В верхнем левом углу нажмите на название приложения под названием партнера, чтобы открыть список приложений.
    2. Выберите другое приложение из раскрывающегося списка.
    3. Повторите шаги по интеграции для выбранного приложения.

Вы можете выбрать любое предопределенное in-app событие, отправленное из AppsFlyer, в качестве цели кампании, или выбрать «Download», если вы хотите оптимизировать кампанию под установки мобильного приложения.

1. В разделе  «Назначение» в поле «URL-адрес веб-сайта»введите URL, который будет целевым адресом вашего объявления. URL-адрес должен соответствовать одному из следующих значений:
   • Целевая веб-страница: Использование целевой страницы рекомендуется в следующих случаях:
     • У вас есть приложение на нескольких платформах.
     • Вы хотите использовать целевую страницу для предоставления дополнительной информации о рекламируемом продукте.

     • Вы хотите использовать целевую страницу для сбора дополнительных данных.

       Для всех этих сценариев использования создайте целевую страницу с поддержкой Smart Script или Smart Banner-enabled landing page.

   • Ссылки атрибуции AF: Использование ссылок атрибуции AF (OneLink, одноплатформенных или кроссплатформенных ссылок) рекомендуется в тех случаях, когда вы хотите, чтобы пользователь был перенаправлен непосредственно в магазин для загрузки приложения без предварительного посещения целевой страницы.
2. Нажмите Создать параметр URL, чтобы добавить параметры URL к URL (будь то URL-адрес целевой страницы или ссылка атрибуции AF).
3. В разделе Настраиваемые параметры нажмите Добавить параметр.

4. Сопоставьте параметры AppsFlyer с соответствующими значениями в TikTok. Параметры, которые вы будете сопоставлять, зависят от того, ведет ли целевой URL-адрес на целевую страницу, атрибуционную ссылку или в магазин для ПК или консоли.

   Целевая страница или атрибуционная ссылка

   Если в качестве целевого URL-адреса используется целевая страница, атрибуционная ссылка OneLink или одноплатформенная атрибуционная ссылка, сопоставьте следующие параметры AF с их эквивалентами в TikTok:

   Параметр AF	Сопоставленное значение TikTok
   pid	tiktokweb_int
   c*	__campaign_name__
   af_c_id	__campaign_id__
   af_adset	__aid_name__
   af_adset_id	__aid__
   af_ad	__cid_name__
   af_ad_id	__cid__

   * Чтобы упростить анализ кампании, указывайте тип кампании -- веб или мобайл -- в префиксе или суффиксе названия кампании (например, название-кампании_web).

   Пример итогового URL должен быть таким:

   https://app.appsflyer.com/{app_id}?pid=tiktokweb_int&c=__campaign_name__&af_c_id=__campaign_id__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__&af_r={https://Add-your-store-url.com}

   Если APK вашего приложения НЕ размещен в Google Play Store, добавьте параметр af_r и сопоставьте с ним URL-адрес магазина, например, https://Add-your-store-url.com

   Магазин для ПК или консоли

   Если ваш целевой URL-адрес — магазин приложений для ПК или консоли, создайте ссылку, следуя инструкциям в таблице ниже. Дополнительную информацию см. здесь: Прямые ссылки атрибуции для CTV, ПК и консолей

   Компонент ссылки	Значение
   Базовый URL-адрес	engagements.appsflyer.com/v1.0/c2s/click/app/
   Обязательные параметры пути	▪ platformExample: steam ▪ app_idExample: 123456
   Обязательные параметры запроса	af_media_source af_campaign_id ▪ af_r
   Другие параметры	См. все параметры
   Структура URL-адреса	https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}

   Сопоставьте следующие параметры AppsFlyer с их эквивалентами в TikTok:

   Параметр AF	Сопоставленное значение TikTok
   media_source (медиа-источник)	tiktokweb_int
   af_campaign *	__campaign_name__
   af_campaign_id	__campaign_id__
   af_adset	__aid_name__
   af_adset_id	__aid__
   af_ad	__cid_name__
   af_ad_id	__cid__

   * Чтобы упростить анализ кампании, указывайте тип кампании -- веб или мобайл -- в префиксе или суффиксе названия кампании (например, название-кампании_web).

   Пример кроссплатформенного URL:

   https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=tiktokweb_int&af_campaign_id=__campaign_id__&af_campaign=__campaign_name__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

    Примечание:

   TikTok автоматически добавляет ttclid={{ttclid}} к целевому URL-адресу, когда пользователь кликает по рекламе

1. URL-адрес рекламы TikTok включает  pid=tiktokweb_int параметр. Когда пользователь нажимает на рекламу, к URL-адресу автоматически добавляется ttclid параметр.
2. Пользователь перенаправляется на целевой URL-адрес — целевую страницу, содержащую Smart Script.
3. Когда целевая страница загружается, Smart Script отправляет в AppsFlyer показ с входящими параметрами URL. Показ позволит выполнить атрибуцию просмотров с целевой веб-страницы. Подробнее об атрибуции по показам и просмотрам читайте здесь.
4. Smart Script генерирует исходящие URL-адреса для кнопок CTA на странице на основе параметров входящего URL-адреса, включая параметр ttclid параметр. Кнопки могут вести к:
   • Google Play и App Store через ссылку атрибуции OneLink.
   • Магазины на нескольких платформах (например, CTV, Epic и Steam). В этом сценарии Smart Script создаёт отдельную атрибуционную ссылку для каждой платформы, ведущую в магазин соответствующей платформы.
   • Загрузка файла APK на устройство пользователя.
5. Когда пользователь нажимает кнопку CTA, клик срабатывает и регистрируется в AppsFlyer.
6. Пользователь перенаправляется в магазин и скачивает приложение.
7. Когда пользователь открывает приложение, в AppsFlyer регистрируется событие установки.
8. AppsFlyer атрибутирует установку на основе вероятностного моделирования или, если доступен реферер установки , детерминированно.
9. Генерируется постбэк, содержащий параметры ttclid и другие параметры события, и отправляется в TikTok через Events API. TikTok использует параметр ttclid для идентификации конкретного клика, а другие параметры помогают оптимизировать кампанию.

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

1. Настройте шаблон атрибуционных ссылок OneLink для кампании. Для получения дополнительной информации см. раздел Как создавать шаблоны OneLink.

2. Создайте Smart Script. Для получения дополнительной информации см. раздел Как создать OneLink Smart Script.

    Примечание:

   Приведенные ниже инструкции посвящены конкретным шагам, которые необходимы для настройки кампании TikTok Ads с помощью Smart Script. Подробное руководство по настройке кампаний Smart Script см. в статье Как создать OneLink Smart Script раздел Настройка OneLink Smart Script V2 .

3. Убедитесь, что все необходимые параметры URL добавлены к входящему URL-адресу. Чтобы просмотреть параметры, добавленные к входящему URL-адресу, откройте TikTok Ads Manager и проверьте параметры URL-адреса, заданные при создании целевого URL-адреса. Для получения дополнительной информации см.  Set destination URL.
4. Сопоставьте параметры входящего URL-адреса, необходимые для кампании TikTok Ads, с параметрами исходящего URL-адреса, которые будут отправлены в AppsFlyer, когда пользователь нажмет кнопку CTA:
   • PID: Убедитесь, что Smart Script принимает значение параметра pid=tiktokweb_int из входящего URL-адреса и сопоставляет его с соответствующими параметрами в исходящем URL-адресе.

   • TTCLID: Параметр ttclid крайне важен для успешной отправки постбэков событий в приложении в TikTok. Параметр ttclid необходимо сопоставить вручную в разделе URL parameter mapping на странице Smart Script :

     1. Выберите Пользовательский параметр в разделе Сопоставление для.
     2. Введите ttclid в полях Outgoing URL parameter и Incoming URL parameters.

      Примечание:

     Для отображения в отчетах о сырых данных AppsFlyer входящий параметр ttclid также должен быть сопоставлен (в дополнение к исходящему параметру ttclid ) с одним из исходящих параметров af_sub[1-5] .

Чтобы настроить кампании TikTok Ads при помощи Smart Script для кроссплатформенных целевых страниц, выполните следующие действия:

1. Настройте шаблон атрибуционных ссылок OneLink для кампании. Для получения дополнительной информации см. раздел Как создавать шаблоны OneLink.
   • Активируйте шаблон OneLink для кроссплатформенной атрибуции, см. здесь.
2. Убедитесь, что все необходимые параметры URL добавлены к входящему URL-адресу. Чтобы просмотреть параметры, добавленные к входящему URL-адресу, откройте TikTok Ads Manager и проверьте параметры URL-адреса, заданные при создании целевого URL-адреса. Для получения дополнительной информации см. раздел Настройка целевого URL-адреса.
3. Определите для каждого входящего параметра исходящий параметр, которому он будет сопоставлен. Например, входящий параметр af_site_id во входящем URL будет сопоставлен параметр  af_site_id в исходящем URL.
4. Определите значение по умолчанию для обязательных исходящих параметров, которые не могут быть пустыми.
5. Отправьте своему разработчику следующую информацию:
   • Сопоставление входящих и исходящих параметров. Разработчик создаст скрипт, который сгенерирует исходящий прямой URL-адрес на основе сопоставления входящих и исходящих параметров.
   • Значения параметров по умолчанию. Скрипт заполнит параметры исходящего URL-адреса значениями по умолчанию, если отсутствуют соответствующие значения параметров входящего URL-адреса.
   • Если вы используете ссылку атрибуции OneLink, отправьте домен и идентификатор шаблона своему разработчику. Разработчик использует их для создания исходящего URL-адреса OneLink. Например: yourbrand.onelink.me/A1b2 или пример брендированного домена: click.yourbrand.com/A1b2
   • Отправьте вашему разработчику следующие ссылки Dev Hub:
     • Инструкции и примеры кода для создания исходящих прямых URL-адресов для немобильных платформ.
     • Демо и инструкция по созданию кроссплатформенной целевой страницы.

• Напомните разработчику включить входящий параметр ttclid в исходящий URL-адрес.

   Примечание:

  Для отображения в отчетах о сырых данных AppsFlyer входящий параметр ttclid также должен быть сопоставлен (в дополнение к исходящему параметру ttclid ) с одним из исходящих параметров af_sub[1-5] .

1. URL-адрес рекламы TikTok включает  pid=tiktokweb_int параметр. Когда пользователь нажимает на рекламу, an ttclid параметр автоматически добавляется к URL-адресу, по которому выполнен переход.
2. Пользователь перенаправляется на целевой URL-адрес — целевую страницу, содержащую Smart Banner.
3. При загрузке целевой страницы Smart Banner отправляет в AppsFlyer событие показа, которое включает параметры входящего URL-адреса. Этот показ позволяет выполнить атрибуцию по просмотрам для целевой страницы. Подробнее об атрибуции по показам и просмотрам читайте здесь.
4. Smart Banner генерирует исходящий URL-адрес для кнопки CTA на баннере. Исходящий URL-адрес основан на параметрах входящего URL-адреса, включая ttclid параметр. Smart Banner может генерировать только ссылки на основе OneLink.
5. Когда пользователь нажимает кнопку CTA на смарт-баннере, в AppsFlyer регистрируется клик.
6. Пользователь перенаправляется в магазин и скачивает приложение.
7. Когда пользователь открывает приложение, в AppsFlyer регистрируется событие установки.
8. AppsFlyer атрибутирует установку на основе вероятностного моделирования или детерминированно, если доступна реферальная ссылка.
9. Генерируется и отправляется в TikTok через Events API постбэк, содержащий ttclid параметры и другие параметры события. TikTok использует ttclid параметр для идентификации конкретного клика, а другие параметры помогают оптимизировать кампанию.

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

1. Настройте шаблон атрибуционных ссылок OneLink для кампании. Для получения дополнительной информации см. раздел Как создавать шаблоны OneLink.

2. Создайте Smart Banner

    Примечание:

   Приведенные ниже инструкции посвящены конкретным шагам, которые необходимы для настройки кампании TikTok Ads с помощью смарт-баннеров. Подробное руководство по настройке кампаний при помощи смарт-баннеров приведено в разделе «Настройка» статьи Смарт-баннеры: mobile web-to-app (для маркетологов).

3. Настройте параметры смарт-баннера для кампаний TikTok Ads:
   • Убедитесь, что к входящему URL-адресу добавлены все соответствующие параметры URL. Самое важное: pid=tiktokweb_int и ttclid должны быть доступны во входящем URL-адресе, чтобы Smart Banner мог их собрать. Эти два параметра необходимы для атрибуции и отправки постбэков в TikTok Ads. Чтобы проверить параметры, добавленные к входящему URL-адресу, откройте TikTok Ads Manager и проверьте параметры URL, заданные при создании целевого URL. См. Настройка целевого URL.