How to set up a secure data connection with TikTok through Blotout

TikTok for Business offers many tools that let you share the actions people take on your website with TikTok. When you share these events with TikTok, you can better optimize your campaigns and measure ad performance.

This article describes how to setup a secure data connection through Blotout. Blotout supports the TikTok Pixel and Events API.

For more information on these connection tools, please review the following resources:

• About TikTok Pixel

• About TikTok Events API

Начало работы

Вам не нужно отдельно настраивать пиксель TikTok, так как Blotout автоматически загрузит его за вас.

В TikTok предусмотрено семь полей:

• Pixel ID (Идентификатор пикселя) (обязательное поле) — идентификатор пикселя, по которому TikTok будет атрибутировать передаваемые данные;

• Advertiser ID (Идентификатор рекламодателя) (обязательное поле) — идентификатор рекламодателя, необходимый для синхронизации аудиторий;

• oAuth (обязательное поле) — токен, который предоставляет EdgeTag разрешение на доступ к API TikTok;

• Browser pixel (Пиксель в браузере) (необязательное поле) — если вы включите эту опцию, пиксель TikTok будет автоматически добавлен в браузер и одно и то же событие будет передаваться по двум каналам — из браузера и с сервера. При этом важно, чтобы при передаче одного и того же события по двум каналам использовался одинаковый идентификатор — это позволит TikTok исключать дублирование событий. Если вы не включите эту опцию, имеющиеся пиксели могут передавать дублирующиеся события, из-за чего число событий «Покупка» будет завышаться;

• Offline Event Set ID (Идентификатор набора офлайн-событий) (необязательное поле) — идентификатор набора, который будет использоваться для офлайн-конверсий;

• Purchase Event (Событие «Покупка») (необязательное поле) — позволяет выбрать, как событие покупки будет отображаться в отчетности в TikTok: как CompletePayment или как PlaceAnOrder;

• Event test code (Код тестирования события) (необязательное поле) — сюда можно ввести тестовый код из Менеджера событий для используемого пикселя и проверить, корректно ли передаются события и другие данные. Перед началом реальной работы с EdgeTag этот тестовый код обязательно нужно удалить, иначе события не будут регистрироваться;

• LDU (Ограничение использования данных) (необязательное поле) — включение этой опции может повлиять на размер аудиторий и эффективность кампаний в следующих штатах США: Калифорния, Колорадо, Коннектикут, Юта, Вирджиния, Айова, Миннесота, Теннесси, Мэриленд, Делавэр, Флорида, Монтана, Небраска, Нью-Гэмпшир, Нью-Джерси, Орегон, Техас, Индиана и Кентукки (так как данные, подпадающие под ограничение использования, не участвуют в оптимизации). Эта функция позволяет компаниям точнее управлять тем, как их данные о событиях используются в системах TikTok. Дополнительные сведения см. в статье Ограниченное использование данных.

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

Перейдите на Рекламную платформу TikTok, наведите курсор на «Инструменты» и выберите Менеджер событий, чтобы открыть этот инструмент.

• В правой части экрана, в области обзора наборов данных, нажмите на нужный пиксель.

• Скопируйте его идентификатор и вставьте в соответствующее поле в Blotout.

Идентификатор рекламодателя

На Рекламной платформе TikTok нажмите раскрывающееся меню аккаунта в правой части верхней панели. Скопируйте идентификатор рекламного аккаунта, который планируется использовать с Blotout.

Идентификатор набора офлайн-событий

Как и в случае с идентификатором пикселя, перейдите в раздел событий, но выберите не «События на сайте», а «Офлайн-события», после чего скопируйте идентификатор нужного набора офлайн-событий.

Настройка для браузера

Если вы установили наш пакет SDK с помощью npm, вам необходимо дополнительно установить пакет @blotoutio/providers-tiktok-sdk, чтобы обеспечить корректную работу провайдера.

После установки добавьте его в вызов функции init.

Пример

# Code Snippet

import { init } from '@blotoutio/edgetag-sdk-js'

import tiktok from '@blotoutio/providers-tiktok-sdk'

init({

edgeURL: 'https://d.mysite.com',

disableConsentCheck: true,

providers: [tiktok]

})

События

Ниже приведены стандартные события, которые рекомендует использовать TikTok.

Полный список стандартных событий можно найти в нашем руководстве.

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

Определения типов

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

Примеры

// Browser example

edgetag('tag', 'AddToCart', { value: 10.0, currency: 'USD' })

// Node example

import { tag } from '@blotoutio/edgetag-sdk-js'

tag('AddToCart', { value: 10.0, currency: 'USD' })