Integração com plataforma de anúncios

Conversões do X, enviadas a partir do seu servidor

A ROASaurus envia compras, adições ao carrinho, checkouts e visualizações de página para o endpoint de conversões da X Ads API. Na ROASaurus não existe pixel do navegador para o X: só recebe eventos de servidor.

O X (Twitter) num relance
LigaçãoConversões web da X Ads API, assinadas com OAuth 1.0a
EventosCompra (obrigatória), adição ao carrinho, início de checkout, visualização de página, cada um como um ID de evento do Events Manager
Identificadorestwclid, email com hash, telefone com hash (E.164); IP e user agent só com um destes
CredenciaisID do pixel, chave e segredo da API, token de acesso e segredo
Pixel do navegadorNão, apenas eventos de servidor
Sincronização do investimentoSim: investimento, impressões e cliques das campanhas por dia, depois de ligar a conta de anúncios em Setup › Ad spend

O que a ROASaurus envia ao X

O X não tem nomes de evento padrão. Cada tipo de evento é um ID de evento que cria no X Events Manager, como tw-o1abc-o1def, e cola na ROASaurus. O ID do evento de compra é obrigatório. A adição ao carrinho, o início de checkout e a 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 email com hash SHA-256 e o telefone em formato E.164, com hash. O endereço IP e o user agent só são acrescentados junto de um destes, porque o X só os conta em combinação. A ROASaurus envia também um ID de conversão, o valor, a moeda, o número de artigos e os produtos. Uma conversão sem twclid, email nem telefone é ignorada.

A ROASaurus só considera uma entrega como enviada quando o X comunica pelo menos uma conversão processada.

Como ligar

  1. Obtenha uma app de programador do X com acesso à Ads API.
  2. Gere tokens de utilizador OAuth 1.0a para um utilizador com acesso de Ad Manager à conta de anúncios: precisa da chave e do segredo da API, mais do token de acesso e do segredo.
  3. No X Events Manager, crie um evento por cada tipo que quiser e copie os IDs de evento.
  4. Na ROASaurus, vá a Tracking & platforms, clique em Add pixel no cartão do X e introduza o ID do pixel, os IDs de evento e as quatro chaves.

Limites

  • Sem pixel do navegador: o X só recebe eventos de servidor.
  • O investimento das campanhas do X é sincronizado depois de ligar a conta de anúncios em Setup › Ad spend.
  • Um twclid isolado não cria um ponto de contacto 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.

Relacionado

FAQ

Perguntas e respostas

Porque é que o X precisa de quatro chaves?

A X Ads API exige OAuth 1.0a para integrações personalizadas. Cada pedido é assinado com a chave e o segredo da API da sua app e com o token de acesso e o segredo de um utilizador que possa gerir a conta de anúncios.

A ROASaurus carrega o pixel do X?

Não. O X só recebe eventos de servidor. As conversões são associadas pelo ID de clique twclid ou pelo email ou telefone com hash do comprador.

Que eventos do X posso enviar?

Compra, adição ao carrinho, início de checkout e visualização de página. Crie cada um no X Events Manager e cole o respetivo ID de evento. Só a compra é obrigatória.

Cada venda, associada ao anúncio que a gerou

Tracking server-side, lucro e valor vitalício do cliente numa só app. Teste gratuito de 14 dias, sem cartão de crédito.

Comece o seu teste gratuito →