Twitter conversion API tag para sGTM

La Twitter Conversion API te permite enviar información desde tu servidor directamente a los servidores de Twitter, que puede utilizarse para medir el éxito de la campaña.

Con Twitter CAPI, el seguimiento es más seguro y preciso. Al igual que Facebook, Twitter permite y recomienda utilizar un método híbrido de seguimiento, web+servidor. Al combinar el seguimiento web y de servidor, se requiere deduplicación. Para hacer coincidir los usuarios de los eventos con los perfiles de Twitter, se utilizan los datos del cliente: correo electrónico y twclid.

En esta guía se explicará cómo funciona la API de Twitter conversion API y cómo configurar la etiqueta CAPI de Twitter en sGTM.

Necesitas algo más que un ID de píxel de Twitter o un token de API para identificar tu Twitter CAPI. Twitter requiere una autenticación adicional, que es imposible implementar a través de sGTM. Por eso, por ahora, la etiqueta Twitter CAPI sólo funciona con el stape. Si es necesario, puedes modificar la plantilla de la etiqueta e implementar la autenticación tú mismo.

El nuevo Twitter CAPI no está listo para el prime time todavía y requerirá 5 veces más trabajo que la implementación CAPI «estándar» si ya estás familiarizado con las APIs de FB o TikTok. Además, hay algunas otras complicaciones al utilizar su plataforma que dificultan las cosas.

Necesitarás una cuenta dev, solicitar acceso a Twitter CAPI y generar varios tokens de acceso. Desarrollaremos todos estos pasos más adelante en una entrada del blog.

Para acceder a la Ads API, póngase en contacto con un representante de Twitter.

Aplicaciones Ads API existentes

Si tienes una aplicación Ads API activa, puedes utilizarla y sus tokens de acceso para la API de conversión.

Access Tokens

• Personal Tokens: Genérelos para su cuenta de Twitter en el portal para desarrolladores.
• Other Users' Tokens: Utiliza un flujo OAuth de 3 pasos:

- Una línea de comandos con autorización web (twurl)

- Una línea de comandos con autorización basada en PIN

- Flujo web personalizado

Los tokens para la Conversion API deben ser de usuarios con acceso AD_MANAGER o ACCOUNT_ADMIN, que puede comprobar a través del endpoint authenticated_user_access.

Nota: Puede compartir tokens con usuarios sin acceso AD_MANAGER o ACCOUNT_ADMIN.

La Twitter Conversion API authentication» es un proceso complicado; por ahora, la autenticación CAPI de Twitter no puede ser completamente funcional en sGTM. Por eso gestionamos la autenticación internamente. Esto significa que la etiqueta Twitter CAPI requiere alojamiento en Stape. Si sólo podemos utilizar sGTM para la autenticación, actualizaremos esta etiqueta para que admita cualquier alojamiento. Puedes encontrar la clave API del contenedor sGTM dentro de los ajustes del contenedor.

Estas dos claves sólo pueden generarse si tienes una cuenta de desarrollador de Twitter. Para recibir una cuenta de desarrollador de Twitter, debes solicitarla y esperar entre 1 y 3 días a que se apruebe tu solicitud.

Cuando realices la solicitud, deberás pedir Acceso Esencial. Asegúrate de utilizar la cuenta de Twitter correcta para solicitar las cuentas de desarrollador, ya que es imposible cambiar de cuenta más adelante.

Cree una aplicación utilizando la sección Proyecto y aplicación cuando reciba una cuenta de desarrollo. Una vez hecho esto, se generará una clave de usuario y un secreto de usuario.

Puedes encontrar estos dos en tu anuncio en tu cuenta dev de Twitter.

1. Cree y configure un servidor contenedor de Google Tag Manager.

Importante: La etiqueta Twitter CAPI sólo funciona si utilizas el alojamiento Stape para contenedores sGTM.

2. Envíe los datos desde la web al servidor GTM. Puede configurar GA4 del lado del servidor, Webhooks, o Data Tag/Data Client.

3. Descarga la etiqueta API de conversión de Twitter desde Template Gallery.

4. Crea una nueva etiqueta y selecciona Twitter Tag. Para añadir la Clave API del contenedor Stape, abre la configuración del contenedor sGTM y copia la Clave API del contenedor.

5. Añade Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret. He descrito cómo generar estos valores aquí.

6. Añade Twitter pixel ID y Event ID. Puedes encontrar estos valores en el Gestor de Eventos de Tweeter.

7. Añade los Server Event Data Override y User data que quieras enviar a Twitter, y configura un trigger.

Parámetros de la etiqueta CAPI de Twitter:

Stape Container API Key - encuéntrala en la configuración del contenedor sGTM en tu cuenta Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - lo puedes encontrar en tu cuenta de Twitter dev después de haber creado una aplicación de Twitter. Más adelante te mostraremos cómo generarlos.

Pixel ID - es el ID de la etiqueta universal de sitios web (UWT) de tu cuenta de publicidad de Twitter. Para encontrarlo, vaya al gestor de eventos de Twitter.

Event ID - Lo encontrará al crear un evento de API de conversión en el gestor de eventos de Twitter.

Use HttpOnly cookies - Impide que JavaScript acceda a la cookie si está activada.

Server Event Data Override - seleccione anular uno de los parámetros estándar del servidor: tiempo de conversión, número de elementos, moneda, valor, ID de conversión, descripción y contenido.

User Data - añada datos de usuario: email o twclid.

Logs Settings - seleccione si desea utilizar los registros de Stape.

9. Prueba de eventosCuando su evento haya recibido correctamente eventos de conversión en un plazo de 12 a 24 horas, el estado de la «Etiqueta web de evento único» debería mostrar SEGUIMIENTO en la página Seguimiento de conversiones del Administrador de anuncios. Esto no afectará a las campañas en curso que envían conversiones a través de la API de conversión.

Twitter admite la deduplicación de eventos. Combinar el seguimiento web y de servidor requiere enviar una clave de deduplicación con los eventos web y de servidor. Utilice conversion_id para enviar la clave de deduplicación. La deduplicación sólo se produce si los eventos se han recibido en un plazo de 48 horas.

Para crear un evento sólo de servidor, utilice el gestor de eventos de Twitter para crear un nuevo evento y seleccione Instalar con API de conversión en el tercer paso.

A diferencia de otras plataformas, Twitter sólo acepta el correo electrónico del usuario y twclid. Cuando se envía un correo electrónico, debe ser hash con SHA256. Twitter etiqueta automáticamente el correo electrónico del usuario con hash.

Desafortunadamente, no hay forma de probar los eventos del servidor de Twitter en tiempo real. Si el seguimiento está configurado correctamente, debería ver el estado de la «Etiqueta web de evento único» mostrar el seguimiento en el Seguimiento de conversiones en el Administrador de anuncios en un plazo de 12 a 24 horas.

Twitter CAPI puede ser una gran adición a su pila de seguimiento del lado del servidor. Aunque el proceso de autorización para Twitter CAPI es increíblemente complicado por ahora, el resto de la lógica funciona de forma muy similar a las API de conversión de FB o TikTok: Puedes enviar eventos personalizados o estándar y utilizar seguimiento web+servidor o sólo servidor. Twitter pide los datos del usuario para que coincida con los usuarios, pero por ahora, sólo admiten el correo electrónico del usuario y twclid.

Twitter CAPI tiene dos inconvenientes principales: el proceso de autenticación y la falta de una herramienta de pruebas en tiempo real. Debido al proceso de verificación, la etiqueta de Twitter sólo funciona con servidores de stape para sGTM. Si Twitter simplifica el proceso de autenticación, el equipo de stape actualizará la etiqueta para que funcione con GCP.

Esta guía te ayudará a familiarizarte con Twitter CAPI y a configurarlo en sGTM. Para obtener información más detallada sobre Twitter CAPI, consulta la documentación oficial.