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 você 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 value deve ser um número. Esse campo é obrigatório para otimização baseada em valor (VBO)

• num_item: use para especificar a quantidade de itens ao iniciar a finalização da compra.

• content_name: nome da página, produto. O tipo value deve ser uma string.

• content_category: a categoria da página/produto. O tipo value deve ser uma string.

• currency: código ISO 4127. A próxima seção contém uma lista das moedas atualmente aceitas. O tipo value 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 value 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.

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.