Загрузка офлайн-событий в Events Manager для API событий
Офлайн-конверсии помогают измерить, как рекламные объявления TikTok преобразуются в действия клиентов офлайн, в том числе покупки в магазинах, подписки и покупки, оформляемые офлайн. Выполните эти действия, чтобы загрузить данные об офлайн-событиях в TikTok.
Примечание. Если у вас нет ресурсов для внедрения API или использования партнерской интеграции, вы можете вручную загрузить офлайн-события через Events Manager в TikTok.
Перед началом работы
Создайте файл в формате CSV (разделитель ― запятая) с данными офлайн-событий. Предоставьте как можно больше информации, чтобы отчетность была точной. По возможности включите корректные отметки времени, идентификаторы заказов и номера товаров, чтобы мы могли исключить дублирующиеся события.
Первая строка CSV-файла содержит стандартный заголовок, который должен включать имена столбцов, соответствующие офлайн-событиям (см. следующую страницу).
Мы поддерживаем только PII с привязкой к электронной почте или телефону.
Максимальный размер файла: 50 МБ.
Следуйте формату офлайн-событий, приведенному в примере.
Пример:
Структура офлайн-данных в файле
Заголовок столбца | Обязательно | Описание | Пример значения столбца |
event_type | Да | Поддерживаемые типы офлайн-событий | Должно присутствовать одно из следующих значений: |
|
|
| Покупка (для покупки в магазине, покупки в консоли) |
|
|
| Обратная связь (для событий в кол-центре, событий в чате) |
|
|
| Подписка (для подписки в магазине, подписки с помощью консоли) |
|
|
| Лид (для лидов без идентификатора лида TikTok) |
|
|
| Добавление платежной информации |
|
|
| Добавление в корзину |
|
|
| Добавление в список желаний |
|
|
| Завершение регистрации |
|
|
| Загрузка |
|
|
| Начало оформления заказа |
|
|
| Поиск |
|
|
| Просмотр контента |
Да, если нет телефона | Адрес электронной почты (простой текст или с хэшированием SHA-256) | ||
phone | Да, если нет адреса электронной почты | Номер телефона (простой текст или с хэшированием SHA-256) | +12133734253 (или) 12133734253 |
timestamp | Да | Соответствует дате или времени транзакции. | 2022-10-22T19:11:01.152Z (формат отметки времени ISO-8601) |
price | Необязательно | Общая сумма, потраченная в транзакции | 10 |
currency | Необязательно | Валюта, в которой была оплачена транзакция (например, «USD» или «CAD»). | USD |
transaction_category | Необязательно | Поля для отслеживания транзакции по целям конверсии | В магазине |
order_id | Необязательно | Уникальный идентификатор, соответствующий заказу, к которому относится конкретная строковая позиция | abc123 |
quantity | Необязательно | Количество купленных товаров. Как правило, это значение 1 для данных о транзакции на уровне корзины. | 1 |
product_id | Необязательно | Буквенно-цифровое значение, обозначающее уникальную позицию в заказе, например SKU или UPC | 123456 |
product_category | Необязательно | Категория товара верхнего уровня | Мебель |
store_id | Необязательно | Код, присвоенный физическому магазину | 3456 |
Загрузка данных об офлайн-событиях в TikTok
Войдите в аккаунт на Рекламной платформе TikTok.
Нажмите Инструменты.
Выберите События.
Выберите Подключить источник данных.
Выберите Офлайн.
Введите название набора офлайн-событий.
Нажмите Создать.
Выберите Загрузить события.
Следуйте формату файла офлайн-событий. Примечание. Первая строка файла должна включать действительные заголовки столбцов. Мы поддерживаем только PII с привязкой к электронной почте или телефону. Поддерживается только формат файла .csv. Максимальный размер файла — 10 МБ.
Нажмите Загрузить, чтобы загрузить файл CSV.
Сообщения об ошибках загрузки файлов
Неправильное расширение файла (отличающееся от CSV).
Слишком большой размер файла (больше 10 МБ).
Недопустимые символы в файле.
Не заполнены обязательные поля.
Неточные отметки времени.
Ошибки форматирования данных.
Проверьте результаты загрузки. Примечание. Результаты могут появиться через несколько часов.
