О параметрах

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

Подробнее о документации для разработчиков по внедрению параметров.

Доступные параметры:

• content_type: для этого параметра необходимо выбрать значение product или product_group. Если в качестве content_ids или content_id вы используете sku_id, выберите значение product, а если item_group_id, то выберите product_group. Это поле является обязательным для видеорекламы с возможностью покупки.

• contents: список объектов контента, представляющих соответствующие товары в событии на веб-сайте с информацией о них. Значение этого параметра должно быть массивом объектов. Это поле является обязательным для видеорекламы с возможностью покупки.

• content_ids: уникальный идентификатор или массив нескольких идентификаторов товаров или контента, например ['987','654']. В параметре content_ids должна быть буква «s» независимо от того, отправляете ли вы один идентификатор или массив идентификаторов. Рекомендуется использовать sku_id или item_group_id, совпадающий с sku_id или item_group_id, заданным в вашем каталоге (при наличии). Это поле является обязательным для видеорекламы с возможностью покупки.

• delivery_category: параметр, позволяющий указать способ доставки онлайн-покупок. Он помогает отслеживать покупки по способу доставки — самовывоз, доставка до двери и т. д.

• price и value: параметр price обозначает цену одной единицы товара, а value ― общую стоимость заказа. Например, если у вас в корзине два товара стоимостью 10 долл. США, значение параметра price будет равно 10, а параметра value — 20. Для этого параметра необходимо задать числовое значение. Это поле необходимо для ROAS и оптимизации на основе ценности.

• num_item: позволяет указать количество единиц товара при оформлении заказа.

• content_name: название страницы или товара. Для этого параметра необходимо задать значение типа string.

• content_category: категория страницы или товара. Для этого параметра необходимо задать значение типа string.

• currency: кодировка ISO 4127. Список валют, поддерживаемых на данный момент, приведен в следующем разделе. Для этого параметра необходимо задать значение типа enum(string). Это обязательное поле для ROAS.

• search_string: введенная пользователем строка для поиска, используемая вместе с событием «Поиск».

• description: описание товара или страницы.

• status: статус заказа, товара или услуги. Для этого параметра необходимо задать значение типа string.

  • Примечание. В определенных случаях использования параметра status, чтобы отправлять в TikTok изменения статуса, может потребоваться API событий.

Валюты, которые на данный момент поддерживает TikTok: AED, ARS, AUD, BDT, BHD, BIF, BOB, BRL, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DZD, EGP, EUR, GBP, GTQ, HKD, HNL, HUF, IDR, ILS, INR, ISK, JPY, KES, KHR, KRW, KWD, KZT, MAD, MOP, MXN, MYR, NGN, NIO, NOK, NZD, OMR, PEN, PHP, PKR, PLN, PYG, QAR, RON, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, VES, VND, ZAR.

Можно задать динамические значения, которые передают в TikTok значения, связанные с динамическими событиями. Попросите разработчика вашего веб-сайта настроить динамические значения или настройте их самостоятельно с помощью инструмента TikTok «Конструктор событий». Этот динамический код будет автоматически определять правильные значения для конкретного события, например цену покупки, а не просто использовать заданное значение. Вы также можете воспользоваться нашим техническим руководством, чтобы настроить динамические значения с помощью кода.

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

Чтобы сделать эти значения динамическими, замените заданные значения кодом, который будет передавать правильные значения (например, «dress» или «8») автоматически.