Integração com plataforma de anúncios

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ãoConversões web da X Ads API, assinadas com OAuth 1.0a
EventosPurchase (obrigatório), add to cart, checkout initiated, page view, cada um como um ID de evento do Events Manager
Identificadorestwclid, e-mail com hash, telefone com hash (E.164); IP e user agent apenas junto com um desses
CredenciaisID do pixel, chave e segredo da API, token de acesso e segredo
Pixel do navegadorNão, apenas eventos de servidor
Sincronização do investimento em anúnciosSim: 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

  1. Obtenha um app de desenvolvedor do X com acesso à Ads API.
  2. 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.
  3. No X Events Manager, crie um evento para cada tipo que você quer e copie os IDs de evento.
  4. 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 frequentes

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 →