Informações sobre eventos personalizados no TikTok Ads Manager

Última atualização: fevereiro de 2026

Eventos personalizados no TikTok são ações definidas pelo usuário que vão além da lista predefinida de eventos padrão da plataforma. Esses eventos podem ser gerenciados por meio de vários métodos, como o Criador de eventos no Gerenciador de Eventos, diretamente pela API de eventos web ou no lado do parceiro de mensuração mobile (MMP) para anunciantes de apps. Os eventos personalizados são fundamentais para a geração de relatórios detalhados e a criação de audiências, embora não sejam aplicáveis à otimização de campanhas.

Benefícios

Os eventos personalizados permitem que você adapte a coleta de dados a ações específicas que sejam mais relevantes para as suas metas de marketing.

  • Flexibilidade no rastreamento de eventos: personalize quais ações específicas do usuário devem ser rastreadas além dos eventos padrão.

  • Melhor segmentação de audiência: use eventos personalizados para criar segmentos de audiência mais precisos.

  • Relatórios detalhados: veja os eventos personalizados na coluna de relatório “Tipo de evento” no Gerenciador de eventos e no TikTok Ads Manager.


Antes de começar

Antes de configurar eventos personalizados, considere os seguintes requisitos:

  • Use nomes de eventos personalizados que estejam em conformidade com os termos e as políticas do TikTok.

  • Não use nomes de eventos personalizados que sugiram informações sensíveis ou atividades ilícitas dos usuários.

  • Use um nome de evento personalizado que seja diferente dos eventos padrão predefinidos do TikTok:

Requisitos

Detalhes

Limite de caracteres

O nome do evento personalizado não deve exceder 50 caracteres.

Formato

São aceitos somente caracteres alfanuméricos, traços e travessões.

Conflito de nomes

Evite usar os nomes dos eventos reservados no seu evento personalizado. Consulte a lista completa de nomes de eventos reservados abaixo.

Regra especial

O nome do evento personalizado deve começar com uma letra e não pode terminar com um espaço.


Eventos reservados

Eventos reservados são nomes de eventos específicos que o TikTok mapeia automaticamente para um evento padrão existente. Como esse mapeamento é automático, você não deve usar esses nomes para os seus eventos personalizados, pois isso impedirá que você veja os dados com o nome personalizado desejado.


Consulte nossa lista completa de eventos reservados.


Caso de uso com exemplo de código

Uma loja de comércio eletrônico pode definir eventos personalizados para rastrear outras ações importantes além dos eventos padrão, por exemplo, LeaveReview quando um comprador envia um feedback ou ShipOrder quando o processamento do pedido começa. Esses eventos podem melhorar a geração de relatórios e capacitar a criação da audiência com base no comportamento do usuário.


Instale o event_code com um nome de evento personalizado. Por exemplo, ttq.track('custom_event_name'). Os parâmetros que você pode incluir abaixo do evento são os mesmos fornecidos para eventos padrão.

// Single product example: LeaveReview ttq.track('LeaveReview', { content_id: '301', content_type: 'product', content_name: 'dress', quantity: 1, price: 8.00, // per-item price value: 8.00, // total value for this event (align with your business logic) currency: 'USD' }); // Multiple products example: ShipOrder ttq.track('ShipOrder', { contents: [ { content_id: '301', content_type: 'product', content_name: 'dress', quantity: 1, price: 8.00 }, { content_id: '401', content_type: 'product', content_name: 'hat', quantity: 1, price: 1.20 } ], value: 9.20, // total of all items currency: 'USD' });


Saiba como instalar o Pixel usando um código com nossa documentação para desenvolvedores.

Próximas etapas

Agora que você conhece os eventos personalizados, saiba como configurar eventos e parâmetros no TikTok Ads Manager.