How can we help?

Uso de Firebase y Google Tag Manager con AppsFlyer: Configuración de Google Tag Manager

  • Actualización

Instrucciones para configurar el envío de eventos reportados a través de Firebase SDK a AppsFlyer en Google Tag Manager.

Configuración de Google Tag Manager

Esta sección describe la configuración necesaria en la interfaz de usuario de Google Tag Manager (GTM). Todos los pasos descritos en esta sección son necesarios para que GTM envíe eventos a AppsFlyer. Sigue los pasos en el orden listado.

Los siguientes pasos son para Google Tag Manager en aplicaciones móviles. Si la interfaz de usuario que ves en tu Google Tag Manager es diferente a las capturas de pantalla en los distintos pasos, verifica lo siguiente:

  1. Tu contenedor de Google Tag Manager está configurado para aplicaciones móviles.
  2. El contenedor es la versión v5. Para más información, haz clic aquí.

Nota:

Los pasos descritos en esta sección se refieren a un evento de compra, pero son relevantes para cualquier evento que quieras enviar.

1. Crear variables de los parámetros del evento

Las variables de los parámetros del evento permiten a Google Tag Manager obtener datos del evento. Cuando se envía el evento, se pasan las variables AppsFlyer ID y Dev Key junto con él. Google Tag Manager luego evalúa su valor y así las obtiene. Los datos del evento tienen dos funciones:

  1. Proporcionar a Google Tag Manager el AppsFlyer ID y Dev Key
  2. Proporcionar a Google Tag Manager el nombre del evento y los parámetros del evento
ID de dispositivo y clave de desarrollo de AppsFlyer

Siempre que Google Tag Manager envía un evento a AppsFlyer, debe enviarlo con el AppsFlyer ID y Dev Key. La Dev Key permite a Google Tag Manager comunicarte con los servidores de AppsFlyer. El AppsFlyer ID le indica a AppsFlyer a qué usuario debe atribuir el evento.

  1. En Google Tag Manager, haz clic en Variables y luego haz clic en New
  2. Asigna a la variable el nombre "AppsFlyer Dev Key" y haz clic en Configuración de la variable
  3. Selecciona Parámetro del evento
  4. Selecciona Parámetro personalizado
  5. En el campo Parámetro del evento , introduce "dev_key" y guarda
  6. Repite también el proceso para el ID de AppsFlyer: asigna a la variable el nombre "AppsFlyer Device ID" e introduce "af_id" en el campo Parámetro del evento

Ejemplo

A continuación se muestra una captura de pantalla de la interfaz de usuario de GTM. Muestra la configuración final del parámetro del evento:

event_parameter_variable_dev_key.png

Importante:

Para iOS, debe configurarse un Parámetro del Evento adicional. Sigue el mismo flujo mencionado anteriormente. Crea una variable y nómbrala "Apple App ID". En el campo Parámetro del Evento, introduce "apple_app_id" y guarda.

El siguiente paso es crear y configurar las variables AppsFlyer ID y Dev Key dentro de la app. Este paso se explica en la sección Envío de eventos.

Ingresos y precio

La mayoría de los eventos dentro de la app requieren parámetros de valor de evento. En este caso, son los parámetros af_revenue y af_price, pero puedes enviar cualquier parámetro de evento. Ahora que el evento está configurado en la app, se necesitan crear las variables de ingresos y precio en Google Tag Manager. Estas variables se usan después en la etiqueta del evento de compra.

  1. En Google Tag Manager, crea dos variables de Parámetro del Evento para af_revenue y af_price.
  2. Para "af_revenue", nombra la variable "Ingresos" y configura la Clave del Parámetro del Evento como "af_revenue".
  3. Para "af_price", nombra la variable "Precio" y configura la Clave del Parámetro del Evento como "af_price".

Ejemplo

A continuación se muestra una captura de pantalla de la interfaz de usuario de GTM. Muestra la configuración final del parámetro del evento:

event_parameter_variable_revenue.png

Nota:

El ejemplo aquí muestra cómo crear variables de parámetro del evento para los parámetros de evento de Ingresos y Precio. Puedes crear variables de parámetro del evento para cualquier tipo de parámetro del evento, de acuerdo con el evento que se envíe.

2. Crear un disparador para el evento de compra

Para que Google Tag Manager sepa si el evento debe enviarse a AppsFlyer, se debe configurar un activador para el evento.

  1. En Google Tag Manager, haz clic en Triggers y luego en New
  2. Nombra el activador como "Purchase" y haz clic en Trigger Configuration
  3. Elige Custom
  4. Elige Some Events
  5. En las condiciones, configura el activador para que se dispare cuando Event Name sea igual a "af_purchase"
  6. Haz clic en Save

Ejemplo

A continuación se muestra una captura de pantalla de la interfaz de usuario de GTM. Muestra la configuración final del activador:

trigger_purchase_event.png
3. Creación de una etiqueta para el evento de compra

Ahora que las variables necesarias y el activador del evento están configurados, puedes crear la etiqueta del evento de compra.

  1. En Google Tag Manager, haz clic en Tags y luego en New
  2. Nombra la etiqueta como "Purchase" y haz clic en Tag Configuration
  3. Elige AppsFlyer
  4. En el campo Application ID , configura la variable incorporada App ID

    Importante:

    Para iOS, configura la variable personalizada "apple_app_id" en el campo Application ID .

  5. En el campo Dev Key , elige la variable "AppsFlyer Dev Key"
  6. En el campo AppsFlyer Device ID , elige la variable "AppsFlyer Device ID"
  7. En el campo Event Name, configura la variable incorporada Event Name
  8. En el campo Event Currency , establece el código de tu moneda, por ejemplo, USD
  9. Haz clic dos veces en Add Event Value
  10. Configura lo siguiente:
    Key: af_revenue, Value: elige la Variable de Parámetro del Evento "Revenue"
    Key: af_price, Value: elige la Variable de Parámetro del Evento "Price"
  11. En la sección Triggering , configura el Firing Trigger como el activador de eventos "Purchase"
  12. Haz clic en Save

Ejemplo

A continuación se muestra una captura de pantalla de la interfaz de usuario de GTM. Muestra la configuración final de la etiqueta:

purchase_tag.png
4. Publicación del contenedor del administrador de etiquetas
Después de cada cambio en Google Tag Manager (agregar etiquetas, etc.), debes descargar el contenedor y añadirlo a la carpeta raíz de tu aplicación:
  • Android - app/src/main/assets/containers
  • iOS - carpeta raíz/container
Construye e instala la aplicación en un dispositivo de prueba y revisa el registro de depuración para ver que el evento se desencadena y se envía.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: