TikTok Pixel
Dispara um evento do TikTok Pixel quando a página é aberta — invisível para o visitante, com parâmetros próprios e o ID do Pixel vindo das Integrações do funil
O elemento TikTok Pixel, da categoria Integração, envia um evento para o Events Manager do TikTok quando a página em que ele está é aberta. Ele não injeta código: usa o pixel que o próprio funil já instala. Para colar código de terceiros, o elemento certo é o Script.
O ID do Pixel não fica no elemento
O ID vem das Configurações do funil, em Integrações, no tipo TikTok Pixel: ID do Pixel (15 a 25 caracteres alfanuméricos, encontrado no Events Manager, em Settings) e Access Token (opcional), que liga o envio server-side pela Events API. Sem essa integração cadastrada — e sem publicar o funil de novo depois de cadastrá-la — o disparo é engolido em silêncio, sem erro nenhum na tela. É a causa nº 1 de "não funciona".
O que você preenche
Na aba Conteúdo, Evento escolhe o que enviar — os 18 eventos padrão do TikTok: SubmitForm (padrão), AddPaymentInfo, AddToCart, AddToWishlist, ApplicationApproval, CompleteRegistration, Contact, CustomizeProduct, Download, FindLocation, InitiateCheckout, Purchase, Schedule, Search, StartTrial, SubmitApplication, Subscribe, ViewContent — ou Personalizado, que revela Nome do evento personalizado — até 50 caracteres, começando com letra e usando só letras, números, _ e -. Sem evento — ou Personalizado sem nome — nada dispara e o elemento fica âmbar no canvas.
Em Parâmetros, cada item tem Chave e Valor; o valor aceita variáveis {{var}} do funil, como as capturadas por um campo Texto. Chave vazia é ignorada e, em chave repetida, a última vence. As chaves value e quantity são enviadas como número quando o valor resolvido é numérico; as demais, como texto. O TikTok reconhece o dicionário oficial de parâmetros — value, currency, content_type, content_ids, quantity, description e search_string; chaves fora dele podem ser ignoradas em silêncio — consulte a documentação do TikTok antes de usar outros parâmetros.
Pageview não é um evento deste elemento: ele é disparado automaticamente pelo script base do pixel no carregamento e nas navegações seguintes. Este elemento existe para eventos além do Pageview.
Access Token, Events API e Advanced Matching
Com o Access Token preenchido na integração, cada disparo também vai por baixo dos panos para a Events API (server-side), usando o mesmo event_id do evento do navegador — o TikTok deduplica os dois automaticamente. Isso recupera conversões que bloqueadores de anúncio e navegadores restritivos apagariam do lado do cliente. Gere o token em Events Manager → seu pixel → Settings → Generate Access Token.
Se o funil tiver uma variável chamada email/e-mail/e_mail ou phone/telefone/celular/whatsapp (o nome, não o rótulo do campo), o valor capturado é hasheado (SHA-256) e enviado automaticamente nas duas pernas — sem nenhuma configuração extra no elemento. É o Advanced Matching do TikTok, e melhora o match de conversões.
No editor e no funil publicado
No editor você vê um retângulo tracejado com o ícone do elemento e o nome do evento; ali nada dispara. No funil publicado o elemento é invisível para o visitante e dispara na montagem da página, uma vez por sessão — voltar para a página não redispara, diferente do GTM, que re-dispara a cada montagem da página. Por isso não existem Delay nem Exibição condicional aqui: a aba Configurações traz só o Nome do elemento.
No modo Testar o evento não sai: nada chega ao Events Manager. E evento do TikTok não é evento do XQuiz — este elemento não aparece em Leads nem em Analytics.
Para conferir se está chegando, use a aba Test Events do Events Manager enquanto navega no funil publicado (não vale a pré-visualização), ou a extensão TikTok Pixel Helper no navegador.