Como Configurar a API de Conversões do Twitter/X Ads (CAPI)

Por que a API de Conversões do Twitter/X Ads é Vital

Anunciar no Twitter (agora X) tornou-se extremamente competitivo. Os pixels de navegador tradicionais sofrem com baixa atribuição devido a controles de privacidade, limitações de rastreamento e ad blockers. Se o algoritmo do X não receber feedback de conversão limpo e rápido, ele não conseguirá otimizar a distribuição de seus anúncios, resultando em um Custo por Aquisição (CPA) elevado.

Ao integrar a API de Conversões do Twitter/X Ads (CAPI) com o PostbackFlow, os eventos são enviados diretamente de servidor para servidor para a plataforma do X. Isso aumenta a taxa de correspondência e fornece os dados que o algoritmo precisa para otimizar suas campanhas.

---

Passo 1: Obter o ID do Pixel e o Token de Acesso do Twitter/X

Para autenticar as solicitações server-side, o X Ads exige um Pixel ID e um Token de Acesso CAPI.

1. Faça login na sua conta do Twitter/X Ads Manager.
2. No menu Tools, selecione Events Manager.
3. Localize o seu Pixel ID (ex: tw-xxxxx) e copie-o.
4. Vá para a seção de configurações da CAPI no menu do Events Manager.
5. Gere o seu Access Token (Token de Acesso da API).
6. Copie o token e armazene-o com segurança.

---

Passo 2: Configurar o Twitter/X Ads no PostbackFlow

Em seguida, insira as credenciais no painel do PostbackFlow.

1. Faça login no Console do PostbackFlow e vá em Ad Platforms (/settings.php).
2. Procure o card do Twitter/X Ads e clique em Configure.
3. Preencha as credenciais requeridas:
* Pixel ID: O ID copiado no Passo 1.
* Access Token: O token gerado no Passo 1.
4. Clique em Save e ative a chave da plataforma para Active.

---

Passo 3: Mapeamento de Eventos e Parâmetros de Correspondência

O PostbackFlow mapeia automaticamente seus eventos de postback de afiliados para eventos padrão do Twitter/X:

purchase ou sale ➔ Mapeia para Purchase do Twitter/X

lead ou signup ➔ Mapeia para Signup do Twitter/X

add_to_cart ➔ Mapeia para AddToCart do Twitter/X

Parâmetros de correspondência de usuário

O X Ads utiliza identificadores para atribuir as conversões aos usuários corretos. Se o seu postback enviar dados do usuário (como e-mail ou telefone), o PostbackFlow aplica criptografia SHA-256 antes de enviar para o X CAPI para proteger a privacidade. Além disso, se o identificador de cliques do Twitter (twclid) estiver presente no clique original, ele será incluído automaticamente.

---

Otimizando Campanhas no X Ads

Depois que o Twitter/X CAPI começar a receber eventos de conversão:

Monitore os volumes recebidos no X Events Manager.

Permita que sua campanha acumule pelo menos 15+ conversões no histórico recente.

Mude o objetivo de otimização da campanha para *Conversões* em vez de cliques no link, permitindo que o algoritmo do X encontre compradores reais.