Informações sobre os parâmetros
Os parâmetros são propriedades que podem ser combinadas com qualquer evento para afetar a performance da campanha. Alguns parâmetros são obrigatórios, enquanto outros são altamente recomendados para melhorar a performance.
Saiba mais sobre a documentação do desenvolvedor para implementar parâmetros.
Parâmetros disponíveis:
content_type: o valor deve ser definido como “product” ou “product_group”. Se você usar sku_id como “content_ids” ou “contend_id”, use “product”. Se usar item_group_id como “content_ids” ou “content_id”, use “product_group”. Esse campo é obrigatório para os Video Shopping Ads (VSA).
contents: uma lista de objetos de conteúdo que representam produtos relevantes em um evento web com informações sobre o produto. O valor deve ser uma matriz de objetos. Esse campo é obrigatório para os Video Shopping Ads (VSA).
content_ids: ID exclusiva ou matriz de várias IDs de produto ou de conteúdo, por exemplo, ['987','654']. Você deve incluir o “s” em “content_ids”, independentemente de enviar uma só ID ou uma matriz de IDs. É recomendável usar sku_id ou item_group_id que corresponda ao sku_id/item_group_id que você configurou no catálogo, se disponível. Esse campo é obrigatório para os Video Shopping Ads (VSA).
delivery_category: você pode indicar o método de entrega para compras on-line usando o parâmetro delivery_category. Esse parâmetro ajuda a rastrear compras por método de entrega, como entrega sem contato, retirada na loja ou entrega em domicílio.
price e value: “price” é o preço de um item e “value” é o valor total do pedido. Por exemplo, se você tiver dois itens com cada um vendido por US$10, o parâmetro “price” passará 10, enquanto o parâmetro “value” passará 20. O tipo de valor deve ser um número. Esse campo é obrigatório para otimização baseada em valor (VBO).
quantity: use para especificar a quantidade de itens ao finalizar a compra.
content_name: nome da página, produto. O tipo de valor deve ser uma string.
content_category: a categoria da página/produto. O tipo de valor deve ser uma string.
currency: código ISO 4127. A próxima seção contém uma lista das moedas atualmente aceitas. O tipo de valor deve ser enum(string). Esse campo é obrigatório para ROAS.
search_string: a string inserida pelo usuário para pesquisa, usada com o evento Pesquisa.
description: uma descrição de string do item ou da página.
status: status de um pedido, item ou serviço. O tipo de valor deve ser uma string.
Observação: Dependendo do seu uso de “status”, a API de eventos pode ser necessária para compartilhar alterações de status com o TikTok.
attribution_share: um parâmetro numérico opcional que representa a parte do crédito de conversão atribuída ao TikTok no seu modelo de atribuição interno. Esse valor é atribuído pelo anunciante para cada evento de conversão. Intervalo típico: 0,0 a 1,0.
customer_type: um parâmetro de string opcional que indica se o evento de conversão está associado a um cliente novo ou recorrente. Valores compatíveis: “new” ou “returning”.
Moedas atualmente aceitas pelo 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
Defina os valores dinâmicos que aprovam os valores dinâmicos relacionados a eventos ao TikTok. Peça para o desenvolvedor do website configurar valores dinâmicos ou use a ferramenta Criador de Eventos de autoatendimento do TikTok. O código dinâmico determinará automaticamente os valores corretos do seu evento, como preço de compra, em vez de usar um valor definido. Você também pode usar nosso guia técnico para configurar valores dinâmicos com código.
Por exemplo, se um visitante chegar ao seu website e adicionar um vestido ao carrinho, o valor estático ou definido será parecido com isto:
Para tornar esses valores dinâmicos, substitua os valores definidos pelo código, que passará os valores corretos, como "dress" ou "8", automaticamente.
