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

A primera vista: 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
AppsFlyer Device ID and Dev Key Revenue and Price

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 en Nuevo
  2. Nombra la variable como "AppsFlyer Dev Key" y haz clic en Configuración de la Variable
  3. Elige Parámetro del Evento
  4. Selecciona Parámetro Personalizado
  5. En el campo Parámetro del Evento , introduce "dev_key" y guarda
  6. Repite el proceso para el ID de AppsFlyer también; nombra la variable como "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 discute en la Sección Envío de Eventos.

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 al activador del evento "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.