Visão geral da extensão de API de eventos da Web do TikTok
A API de eventos do TikTok é uma interface segura da API do Edge Network Server que permite compartilhar informações com o TikTok diretamente sobre as ações do usuário em seus sites. Você pode aproveitar as regras de encaminhamento de eventos para enviar dados de Adobe Experience Platform Edge Network para TikTok usando a extensão de API de Eventos da Web TikTok.
TikTok pré-requisitos prerequisites
Para configurar a API de eventos da Web do TikTok para usar a API de eventos do TikTok, é necessário gerar um código de pixel e token de acesso TikTok.
Você deve ter um TikTok válido para a conta comercial para criar um pixel de TikTok usando a configuração do parceiro. Vá para a TikTok página de registro comercial para se registrar e criar uma conta, caso ainda não tenha uma.
Você precisa estar conectado à sua conta comercial para configurar o Pixel do TikTok usando a configuração de parceiro. Para fazer isso, siga as etapas abaixo:
- Navegue até a guia Assets e selecione Evento.
- Em Eventos da Web, selecione Gerenciar.
- Selecione Configurar Eventos Da Web.
- Selecione Instalação do Parceiro como seu método de conexão.
Consulte o guia Introdução ao Pixel para obter mais informações sobre como configurar o pixel TikTok.
Você pode gerar um token de acesso depois que o pixel for criado com êxito. Para fazer isso, navegue até Pixel e selecione a guia Configurações. Em API de Eventos, selecione Gerar Token de Acesso.
Consulte o TikTok guia de introdução para obter mais informações sobre como configurar o código de pixel e o token de acesso.
Instalar e configurar a extensão de API de eventos Web do TikTok install
Para instalar a extensão, selecione Extensões na navegação à esquerda. Na guia Catálogo, selecione a Extensão de API de Eventos da Web do TikTok e selecione Instalar.
Na próxima tela, insira os seguintes valores de configuração que você gerou anteriormente do TikTok Ads Manager:
- Código de pixel
- Token de acesso
Quando terminar, selecione Salvar.
Tela de configuração
Configurar uma regra de encaminhamento de eventos config-rule
Depois que todos os seus elementos de dados estiverem configurados, você poderá começar a criar regras de encaminhamento de eventos que determinam quando e como seus eventos serão enviados para TikTok.
Crie uma nova regra na propriedade de encaminhamento de eventos. Em Ações, adicione uma nova ação e defina a extensão como Extensão da API de Eventos da Web do TikTok. Para enviar eventos Edge Network para TikTok, defina o Tipo de Ação como Enviar Evento de API de Eventos da Web do TikTok.
Após a seleção, controles adicionais aparecem para configurar ainda mais o evento, conforme descrito abaixo. Depois de concluído, selecione Manter alterações para salvar a regra.
Parâmetros e Eventos da Web
Os eventos e parâmetros da Web contêm informações gerais sobre o evento. Os eventos padrão têm suporte nas ferramentas de integração do TikTok e podem ser usados para relatórios, otimização de conversões e criação de públicos.
yyyy-MM-dd'T'HH:mm:ss:SSSZ. Este campo é obrigatório.
Parâmetros de Contexto do Usuário
Os parâmetros de contexto de usuário contêm informações de cliente que são usadas para corresponder eventos de visitante da Web com TikTok usuários. A inclusão de vários tipos de dados correspondentes permite aumentar a precisão dos modelos de direcionamento e otimização.
_ttp, se os cookies estiverem habilitados. O valor _ttp pode ser extraído e usado para este campo.ttclid que é adicionado à URL da página de aterrissagem sempre que um anúncio é selecionado em TikTok.
Parâmetros de Propriedades
Use os parâmetros de propriedades para configurar outras propriedades compatíveis.
product ou product_group deve ser atribuído à propriedade de objeto content_type, dependendo de como você configurará seu feed de dados ao configurar seu catálogo de produtos.
Desduplicação de eventos deduplication
O pixel TikTok precisará ser configurado para desduplicação se você usar o SDK de TikTok pixels e a extensão de API de eventos da Web TikTok para enviar os mesmos eventos para TikTok.
A desduplicação não é necessária se tipos de evento distintos estiverem sendo enviados do cliente e do servidor sem qualquer sobreposição. Para garantir que seus relatórios não sejam afetados negativamente, verifique se qualquer evento compartilhado pelo SDK de TikTok pixels e pela extensão de API de eventos da Web do TikTok foi desduplicado.
Ao enviar eventos compartilhados, verifique se todos os eventos incluem uma ID de pixel, uma ID de evento e um nome. Os eventos duplicados que chegarem dentro de cinco minutos um do outro serão mesclados. Se o campo de dados estiver ausente do primeiro evento, ele será combinado com o evento subsequente. Qualquer evento duplicado recebido em 48 horas será removido.
Consulte a documentação TikTok em Eliminação de Duplicação de Eventos para obter mais detalhes sobre esse processo.
Próximas etapas
Este guia aborda como enviar dados de eventos do lado do servidor para o TikTok usando a extensão de API de eventos da Web do TikTok. Para obter mais informações sobre os recursos de encaminhamento de eventos do Adobe Experience Platform, consulte a visão geral do encaminhamento de eventos.