Stape
Búsqueda

Twitter conversion API tag para sGTM

Actualizado
26 ago 2022
Publicado
20 ago 2022
También disponible

La API de conversión de Twitter le permite enviar información desde su 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 la deduplicación. Para hacer coincidir los usuarios de los eventos con los perfiles de Twitter, se utilizan los datos de los clientes: correo electrónico y twclid.

En esta guía, hablaré de cómo funciona la API de conversión de Twitter y de cómo configurar la etiqueta CAPI de Twitter en sGTM. 

Cómo funciona la API de conversión de Twitter

Autentificación

Añadir sólo el ID de píxel de Twitter o el token de la API no es suficiente para identificar su CAPI de Twitter. Twitter requiere una autenticación adicional. Este tipo de autenticación es imposible de implementar a través de sGTM. Por eso, por ahora, la etiqueta CAPI de Twitter sólo funciona con el stape. Siéntase libre de modificar la plantilla de la etiqueta e implementar la autenticación por usted mismo si es necesario.

Parece que el nuevo CAPI de Twitter no está listo para el prime time todavía, y requerirá 5 veces más trabajo que la implementación del CAPI "estándar" si ya está familiarizado con las APIs de FB o TikTok. También hay algunas otras complicaciones cuando se utiliza su plataforma que hace las cosas difíciles por encima de todo.

Necesitará una cuenta de desarrollador, solicitar acceso a Twitter CAPI y generar varios tokens de acceso. Más adelante explicaré todos estos pasos en una entrada del blog.

Deduplicación de eventos

Twitter admite la deduplicación de eventos. Si combina el seguimiento de la web y del servidor, debe enviar una clave de deduplicación con los eventos de la web y del 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 para el servidor, debe utilizar el gestor de eventos de Twitter para crear un nuevo evento y seleccionar la instalación con la API de conversión en el tercer paso.

twitter conversion API event

Parámetros del usuario CAPI de Twitter

A diferencia de otras plataformas, Twitter sólo acepta el correo electrónico del usuario y el 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.

Pruebas del Twitter CAPI

Lamentablemente, 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" debería mostrar el seguimiento sobre el Seguimiento de Conversiones en el Ads Manager en un plazo de 12 a 24 horas.

Parámetros de la etiqueta Twitter CAPI

twitter conversion API tag for sGTM

Stape Container API Key - encuéntralo en la configuración del contenedor sGTM en su cuenta stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - puede encontrarlo en su cuenta de Twitter dev después de haber creado una aplicación de Twitter. Más adelante le mostraré cómo generarlas.

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

Event ID - Al crear un evento de la API de conversión en el gestor de eventos de Twitter, lo encontrará.

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

Server Event Data Override - seleccione para 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 del usuario: correo electrónico o twclid.

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

Lo que necesita para configurar Twitter CAPI

Stape container API key

La autenticación de la API de conversión de Twitter es un proceso complicado; por ahora, la autenticación Twitter CAPI no puede ser totalmente funcional en sGTM. Por ello, gestionamos la autenticación internamente. Esto significa que la etiqueta Twitter CAPI requiere el alojamiento de Stape. Si en el futuro es posible utilizar sólo sGTM para la autenticación, actualizaremos esta etiqueta para que soporte cualquier alojamiento. Puede encontrar la clave API del contenedor sGTM dentro de la configuración del contenedor. 

stape container API key

Consumer Key y Consumer Secret.

Estas dos claves sólo se pueden generar si tiene una cuenta de desarrollador de Twitter. Para recibir una cuenta de desarrollador de Twitter, tiene que solicitarla y esperar entre 1 y 3 días hasta que se apruebe su solicitud.

Al presentar la solicitud, tiene que pedir el Acceso Esencial. Asegúrese de utilizar la cuenta de Twitter correcta para solicitar las cuentas de dev, ya que es imposible cambiar de cuenta posteriormente.

Cree una App utilizando la sección de Proyecto y App cuando reciba una cuenta dev. Una vez hecho esto, se generarán la clave y el secreto del consumidor.

twitter capi api keys 

Twitter ads CAPI acceso.

Para configurar CAPI, es necesario obtener el acceso a la API de anuncios. Incluya el ID de la aplicación correcto en la aplicación Ads API. Seleccione Conversion API en la Aplicación Ads API en "¿Cómo utilizará la Ads API?"

OAuth Token y OAuth Token Secret.

Puede encontrar estos dos en su anuncio dentro de la cuenta de Twitter dev.

Cómo configurar la etiqueta CAPI de Twitter en sGTM

!

Las etiquetas CAPI de Twitter sólo funcionan si se utilizan servidores de Stape para los contenedores sGTM

2. Envíe los datos a sGTM. Puede utilizar GA4, Webhooks o Data Tag/Data Client.

3. Descargue la etiqueta de la API de conversión de Twitter desde GitHub. Abre la sección de plantillas de sGTM -> haga clic en los tres puntos de la esquina superior derecha -> haga clic en importar -> suba la etiqueta que ha descargado recientemente de GitHub y haga clic en Guardar. 

import twitter CAPI tag

4. Cree una nueva etiqueta y seleccione Twitter Tag. Añada la clave API del contenedor Stape. Para ello, abra la configuración del contenedor sGTM y copie la clave API del contenedor.

contaniner API key stape

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

6. Añada el ID del píxel de Twitter y el ID del evento. Puede encontrar estos valores en el gestor de eventos de Twitter.

7. Añada los datos del evento y del usuario que quiera enviar a Twitter. Y configura un trigger. 

twitter CAPI tag

8. Lamentablemente, no hay forma de probar Twitter CAPI en tiempo real. Después de la configuración, utilice el gestor de eventos de Twitter para ver si los eventos de Twitter CAPI fueron enviados.

Conclusión:

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 APIs de conversión de FB o TikTok: puede enviar eventos personalizados o estándar y utilizar el seguimiento web+servidor o servidor solamente. Para emparejar a los usuarios, Twitter pide que se envíen los datos del usuario, pero por ahora, sólo admiten el correo electrónico del usuario y el twclid.

Hay dos inconvenientes principales de Twitter CAPI: el proceso de autenticación y la ausencia de una herramienta de pruebas en tiempo real. Debido al proceso de verificación, la etiqueta de Twitter sólo funciona con los 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.

Espero que esta guía le ayude a familiarizarle con Twitter CAPI y a configurar Twitter CAPI en sGTM. Para obtener información más detallada sobre Twitter CAPI, consulte la documentación oficial. Si necesita ayuda para configurar Twitter CAPI, póngase en contacto con nosotros.

Etiquetado con:sGTM tag

Aloje su servidor GTM en Stape¡ahora mismo!