Conversões do X, enviadas a partir do seu servidor
O ROASaurus envia compras, adições ao carrinho, checkouts e visualizações de página para o endpoint de conversões da X Ads API. Não há pixel do navegador para o X no ROASaurus: ele recebe apenas eventos de servidor.
| O X (Twitter) em resumo | |
|---|---|
| Conexão | Conversões web da X Ads API, assinadas com OAuth 1.0a |
| Eventos | Purchase (obrigatório), add to cart, checkout initiated, page view, cada um como um ID de evento do Events Manager |
| Identificadores | twclid, e-mail com hash, telefone com hash (E.164); IP e user agent apenas junto com um desses |
| Credenciais | ID do pixel, chave e segredo da API, token de acesso e segredo |
| Pixel do navegador | Não, apenas eventos de servidor |
| Sincronização do investimento em anúncios | Sim: investimento, impressões e cliques das campanhas por dia, depois que você conecta a conta de anúncios em Setup › Ad spend |
O que o ROASaurus envia ao X
O X não tem nomes de evento padrão. Cada tipo de evento é um ID de evento que você cria no X Events Manager, como tw-o1abc-o1def, e cola no ROASaurus. O ID do evento de compra é obrigatório. Adição ao carrinho, checkout iniciado e visualização de página são opcionais; um tipo de evento sem ID não é enviado. As visualizações de produto não são enviadas ao X.
Cada conversão lista identificadores: o ID de clique twclid, o e-mail com hash SHA-256 e o telefone no formato E.164, com hash. O endereço IP e o user agent só são adicionados junto com um desses, porque o X só os conta em combinação. O ROASaurus também envia um ID de conversão, valor, moeda, número de itens e os produtos. Uma conversão sem twclid, e-mail ou telefone é ignorada.
O ROASaurus só considera um envio como concluído quando o X informa pelo menos uma conversão processada.
Como conectar
- Obtenha um app de desenvolvedor do X com acesso à Ads API.
- Gere tokens de usuário OAuth 1.0a para um usuário com acesso de Ad Manager à conta de anúncios: você precisa da chave e do segredo da API, além do token de acesso e do segredo.
- No X Events Manager, crie um evento para cada tipo que você quer e copie os IDs de evento.
- No ROASaurus, vá em Tracking & platforms, clique em Add pixel no card do X e informe o ID do pixel, os IDs de evento e as quatro chaves.
Limites
- Sem pixel do navegador: o X recebe apenas eventos de servidor.
- O investimento das campanhas do X é sincronizado depois que você conecta a conta de anúncios em Setup › Ad spend.
- Um twclid sozinho não cria um ponto de contato de atribuição. Marque os seus anúncios do X com parâmetros UTM para que as visitas apareçam na atribuição por origem e campanha.
Relacionados
Perguntas respondidas
Por que o X precisa de quatro chaves?
A X Ads API exige OAuth 1.0a para integrações personalizadas. Cada requisição é assinada com a chave e o segredo de API do seu app e com o token de acesso e o segredo de um usuário que pode gerenciar a conta de anúncios.
O ROASaurus carrega o pixel do X?
Não. O X recebe apenas eventos de servidor. As conversões são associadas pelo ID de clique twclid ou pelo e-mail ou telefone com hash do comprador.
Quais eventos do X posso enviar?
Purchase, add to cart, checkout initiated e page view. Crie cada um no X Events Manager e cole o ID do evento. Apenas o purchase é obrigatório.
Cada venda, rastreada até o anúncio que a gerou
Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.
Comece seu teste grátis →