Ligar o TikTok Pixel e a Events API ao cPixel

Como ligo o TikTok ao cPixel?

Abra o TikTok Events Manager a partir da conta do Ads Manager da sua loja, copie o Pixel ID em Datasets overview, depois abra as Settings do conjunto de dados, Data connection, e desça abaixo das duas opções TikTok Pixel até Events API para gerar um token de acesso. Cole ambos no cPixel; sem o token, o cPixel não envia nada ao TikTok.

Cole-os no cPixel

1. No cPixel, abra Destinos e clique no ícone do TikTok em Ligar uma plataforma. Configurar TikTok abre em Cole os seus IDs.
2. Cole o Pixel ID em Código do pixel e o token em Token de acesso da Events API, que é obrigatório: o pixel do TikTok não pode correr na sandbox de web pixel do Shopify. Dê um nome à conta em Dê um nome a esta conta (opcional) se quiser, depois clique em Continuar.
3. Em Escolha as opções, mantenha Enviar eventos a partir dos nossos servidores marcado; Enviar eventos a partir do navegador acrescenta a tag da loja do TikTok, que precisa do app embed do cPixel. Mantenha Não — o cPixel trata do TikTok (recomendado) a menos que a aplicação TikTok do Shopify envie para este pixel: apesar do seu nome, Sim — mantenha-a, e o cPixel deixa de enviar para o TikTok do lado do servidor para os envios do navegador e do servidor do cPixel para ele.
4. Clique em Guardar e continuar. Testar confirma que TikTok está ligado.

Nota: Código de evento de teste (opcional) serve apenas Testar ligação, que envia um evento de teste real para o separador Test Events do seu pixel (copie o código, que começa por TEST, dali), e a verificação noturna do cPixel de uma conta inativa há 7 dias. Seja o que for que a ajuda do campo diga, os eventos reais nunca o levam.

Onde encontro o meu ID do TikTok Pixel?

No TikTok Events Manager, impresso sob o nome de cada conjunto de dados: 20 letras e dígitos. Use os menus do TikTok: um endereço do Events Manager escrito à mão termina muitas vezes em “Page not found”.

1. Inicie sessão no TikTok Ads Manager. Em Select an account, escolha a conta Ads Manager desta loja, não o Business Center que a possui.

   

2. Abra o ícone de grelha no canto superior esquerdo e escolha Events Manager.

   

3. Na página inicial do Events Manager, Datasets overview mostra o Pixel ID sob o nome de cada conjunto de dados.

   

4. Data sources no menu à esquerda lista cada conjunto de dados com o seu Pixel ID e hora de criação.

   

Como obtenho um token de acesso da Events API?

Gere-o nas definições do seu conjunto de dados, no bloco Events API abaixo das opções TikTok Pixel. Guia do próprio TikTok: Get started with Events API.

1. Clique no seu conjunto de dados, depois abra Settings → Data connection.
2. Desça abaixo de Partner integration e das duas opções TikTok Pixel, Option 1: With Event Builder e Option 2: With custom code, até Events API.
3. Clique em Generate access token e copie o token longo para o cPixel.

Porque não encontro a secção Events API?

Normalmente está mais abaixo do que parece: continue a descer. Se realmente não estiver lá, não tem os direitos para gerir o pixel.

As duas opções de TikTok Pixel preenchem o ecrã, por isso a página parece acabar cedo. Sem nenhum bloco lá no fundo, não tem o acesso Admin ou Operator exigido pelo TikTok à conta de anúncios; se um Business Center possuir o pixel, peça ao seu administrador para o partilhar consigo com permissão para o gerir.

O que envia o cPixel ao TikTok?

Os servidores do cPixel enviam tudo através da Events API: Pageview, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, e CompletePayment, a compra construída a partir da encomenda do Shopify. Com o app embed ativado, a tag da loja do TikTok também envia cada Pageview a partir do navegador, sob o ID de evento da cópia do servidor.

CompletePayment é o antigo nome do TikTok para Purchase; o TikTok ainda o aceita e reporta Purchase (TikTok).

Os eventos do servidor levam e-mail e telefone com hash quando conhecidos, IDs de cliente e de dispositivo do Shopify com hash, o cookie _ttp e o ID de clique ttclid do TikTok, e endereço IP e agente de utilizador. Ambas as vias precisam de consentimento de marketing. Um bloqueador de anúncios que impeça o próprio pedido do cPixel a partir do navegador impede os eventos de navegação; as compras vêm da encomenda do Shopify.

O TikTok mantém o primeiro evento com o mesmo pixel, evento e ID de evento, descarta repetições durante 48 horas, e tenta fundir um que chegue dentro de 5 minutos (TikTok).

Importante: A aplicação TikTok do Shopify também envia para o seu pixel, acrescentando a Events API nos seus níveis Enhanced e Maximum de partilha de dados (TikTok). Os seus IDs de evento diferem dos do cPixel, por isso mantenha um emissor por pixel.

Como verifico que funcionou?

Observe cada envio e a resposta do TikTok no Direto do cPixel, depois verifique no TikTok Events Manager.

1. No cPixel, abra Direto, clique em Iniciar sessão e navegue na sua loja noutro separador. Abra uma linha Servidor: Aceite significa que o TikTok devolveu o código 0, o seu código de sucesso (TikTok).
2. Faça uma encomenda real para ver a compra; as encomendas de teste são ignoradas por predefinição.
3. No Events Manager, abra o Overview do seu pixel: os eventos do cPixel mostram o método de ligação Server, e as visualizações de página Server & Browser com a tag da loja ativada (TikTok). As contagens podem levar até 10 minutos a atualizar, e o processamento até 2 horas (TikTok).

Destinos marca a conta como Verificado depois do seu primeiro envio do servidor bem-sucedido. Test Events mostra apenas o evento de Testar ligação, nunca tráfego real.

E se não funcionar?

Se o TikTok não estiver a receber os eventos do cPixel, verifique Início e depois a linha do TikTok em Direto, que mostra o código e a mensagem do TikTok.

Remover, em Gerir TikTok, para os envios para essa conta e apaga o seu token.

Relacionados

• Configurar o pixel do TikTok e a Events API no Shopify
• Veja cada envio no Direto
• Um emissor por pixel
• Como o cPixel conta cada compra uma vez