Eventos in-app enriquecidos: descripción general

Los eventos in-app que deseas enviar requieren que tu desarrollador implemente el código cuando corresponda en tu aplicación. Los nombres de eventos y los parámetros de eventos se clasifican de la siguiente manera:

• Predefinidos: se trata de nombres de eventos y parámetros de eventos que se utilizan habitualmente entre diferentes aplicaciones. Recomendamos usar nombres de eventos y parámetros de eventos predefinidos tanto como sea posible por los siguientes motivos:
  • El nombre predefinido permite la asignación automática de eventos a los partners. 
  • Si AppsFlyer decide cambiar el nombre de cualquier evento o parámetro de evento, tu implementación será compatible con las versiones anteriores.
• Personalizados: estos son nombres de eventos y parámetros que tú defines para situaciones específicas de los usuarios que ocurren en tu aplicación. Puedes usar cualquier nombre de evento personalizado o cadena de nombre de parámetro, pero ten en cuenta que los eventos personalizados necesitan mantenimiento por parte de tu desarrollador. Consulta los Consejos y Limitaciones.

Cada vez que envías eventos in-app como una compra o una reserva de vuelo, los envías con sus ingresos asociados. El único parámetro que tiene ingresos en los eventos in-app esaf_revenue

• Registro de ingresos en el SDK
• Registro de ingresos en Unity

También puedes registrar ingresos negativos en caso de que un usuario cancele una compra o si emites un reembolso. Para registrar ingresos negativos, lo único que tienes que hacer es agregar el signo menos (-) al valor de ingresos que pasas a af_revenue

af_revenue es el único parámetro que acumula los ingresos de tus usuarios. Utilízalo siempre con eventos in-app que representen la generación real de ingresos en tu lógica de negocio.

af_revenue también puede tener valores de ingresos negativos si necesitas registrar eventos como transacciones canceladas o reembolsos.

El valor de ingresos debe contener solo números (y un punto decimal, si es necesario):

• No incluyas ningún otro carácter ni formatees el valor de ingresos de ninguna otra manera. Esto significa que no debes usar comas, signos de divisa (por ejemplo $), caracteres especiales o texto.
• AppsFlyer proporciona el valor de ingresos con una precisión de hasta cinco posiciones decimales.
• El rango de este valor debe ser de -10 000 a 10 000 en dólares o el monto equivalente en la divisa original. Los valores fuera de este rango se incluyen en los reportes de raw data, pero no en los reportes agregados.
• Ejemplo: 1234.56
• Cuando los ingresos se envían como una cadena, el valor dentro de las comillas debe ser válido. Por ejemplo: "1234.56".

Nota:

• AppsFlyer muestra los ingresos exactos, tal como se reciben del SDK. No incluyen los cálculos de IVA o comisiones de la tienda de aplicaciones, etc., a menos que hubieran sido incluidos por el desarrollador del lado del SDK antes de ser enviados a AppsFlyer.

af_currency representa la divisa utilizada en af_revenue (o af_price). Si falta af_currency en los parámetros del evento, AppsFlyer lo envía con el valor predeterminado "USD".

Puedes utilizar af_price como un parámetro monetario que no se cuenta como ingreso (como en un evento de "Agregar al carrito"). Este parámetro se refiere al precio del artículo individual. El monto total de todas las compras aparece bajo el parámetro af_revenue.

Divisa de ingresos

Es importante entender cómo AppsFlyer maneja la configuración de la divisa y la conversión de la misma.

AppsFlyer maneja la diferencia entre la divisa configurada en la aplicación y la divisa de los eventos in-app utilizando la conversión de divisa.

El diagrama anterior muestra el siguiente proceso:

1. Los eventos in-app se envían: una divisa diferente para cada evento
2. AppsFlyer normaliza todas las divisas a USD
3. AppsFlyer procesa los datos de ingresos
4. Los datos de ingresos en el panel de control se muestran en la divisa configurada en la aplicación
5. AppsFlyer rellena los datos de ingresos en los reportes de raw data tanto en la divisa configurada en el evento como en la aplicación

AppsFlyer utiliza los Tipos de cambio abiertos para la conversión de divisas. El tipo de cambio se actualiza cada hora. Cada vez que AppsFlyer realiza una conversión de divisas, utiliza el tipo de cambio de la última actualización horaria.

Conversión de divisas

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"EUR");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

Visualización de la moneda

La divisa se establece en la configuración de la aplicación. La divisa que establezcas en la configuración de la aplicación es la que aparece en el panel de control. Independientemente de la divisa con la que se envíen los eventos in-app, los ingresos en el panel de control siempre aparecen en la divisa que se haya establecido en la configuración de la aplicación.

Una vez que determines los eventos in-app que deseas medir, usa nuestro generador de eventos in-app para definir los eventos y los parámetros de la siguiente manera:

1. Selecciona un nombre de evento que sea más adecuado para el escenario que deseas atribuir.
2. Selecciona los parámetros de eventos que deseas asociar con el evento. Elige parámetros que proporcionarán contexto adicional al evento y enriquecerán los datos.
3. Descarga el archivo completo del generador de eventos in-app y luego compártelo con tu desarrollador.

La siguiente tabla brinda enlaces a artículos que incluyen ejemplos y flujos de los eventos in-app típicos que sugerimos registrar por vertical.

Vertical comercial	Título del artículo
	Eventos de aplicación recomendados para gaming
	Eventos de aplicación recomendados para el comercio electrónico
	Eventos de aplicación recomendados para entretenimiento
	Eventos de aplicación recomendados para finanzas y banca
	Eventos de aplicación recomendados para préstamos P2P
	Eventos de aplicación recomendados para educación en línea
	Eventos de aplicación recomendados para transporte privado
	Eventos de aplicación recomendados para reservas de vuelos
	Eventos de aplicación recomendados para reservas de hoteles
	Eventos de aplicación recomendados para el cuidado de la salud
	Eventos de aplicación recomendados para las telecomunicaciones
	Eventos de aplicación recomendados para billetera electrónica
	Eventos de apuestas deportivas recomendados

Los eventos in-app se atribuyen a la fuente de medios responsable de la instalación durante toda la vida útil del usuario. Los datos de eventos se muestran como valor de vida útil (LTV) o como datos de actividad. 

Puedes ver los datos de tus eventos in-app en estas ubicaciones:

• Página de información general del panel de control: muestra el rendimiento de adquisición de usuarios (UA) de LTV en tiempo real. Nota: Esto incluye los ingresos divididos entre los usuarios orgánicos y no orgánicos reportados a través de eventos in-app, y los ingresos de retargeting que se atribuyeron dos veces.
• Página de eventos: muestra el valor de vida útil (LTV) del rendimiento de los eventos in-app en todas las fuentes de medios.
• Página de actividad: muestra las actividades in-app para el rango de fechas seleccionado.
• Reporte de raw data de eventos in-app: muestra datos de actividad, es decir, una lista cronológica de las acciones realizadas por toda tu base de usuarios. Este reporte incluye valores de parámetros de eventos, por ejemplo:

  {
    "af_level":"10",
    "af_score":"3387",
    "arena":"7",
    "char_type":"paladin"
  }

  Ten en cuenta que los reportes de raw data son una función premium.

Ten en cuenta lo siguiente al definir los nombres y parámetros de eventos en la aplicación:

• Para garantizar la coherencia de los datos en los reportes de raw data, te recomendamos definir y usar los mismos nombres y estructuras de eventos in-app en todas las plataformas.
• Utiliza un número mínimo de eventos para facilitar la comparación de la calidad de los usuarios procedentes de diferentes fuentes.
• Es importante que asegures la privacidad de tus usuarios. No completes los valores de eventos in-app con datos restringidos que puedan identificarlos directamente. Por ejemplo, dirección de correo electrónico, nombre, número de identidad y, en algunos lugares, código postal. Para obtener más información sobre los datos restringidos, consulta la Política de privacidad de los servicios.
• Ten en cuenta que AppsFlyer recopila la dirección IP de los dispositivos durante los engagements. En algunas jurisdicciones o escenarios de uso, la dirección IP se puede considerar como información de identificación personal (PII). Usamos la dirección IP para obtener la ubicación geográfica amplia (ciudad, nivel de distrito) del dispositivo, pero no la dirección específica. Si es necesario, puedes seleccionar enmascarar las direcciones IP para que no aparezcan en los reportes de raw data. 
• Los eventos in-app son la única fuente de datos sobre ingresos en AppsFlyer. Puedes adjuntar un valor de ingresos específico a cada evento y verlo en el panel de control de tu aplicación. Aprender más sobre los parámetros de monetización.

  

Ten en cuenta lo siguiente al definir los nombres y parámetros de eventos en la aplicación:

• Recomendamos usar solo caracteres alfanuméricos en minúscula (a-z y 0-9) para los nombres de tus eventos in-app. Los nombres de eventos distinguen entre mayúsculas y minúsculas. Esto significa que af_purchase y af_PURCHASE son dos eventos diferentes en el raw data. Sin embargo, en los reportes de estadísticas agregadas (por ejemplo, General o Eventos) se pueden mostrar como un solo evento.
• Hay un límite de cardinalidad de 300 eventos únicos por día. Aprender más
• Los usuarios únicos solo se contabilizan para los primeros 100 eventos después de instalar la aplicación.
• Los nombres de eventos no pueden comenzar con estos caracteres: " = + - 
• Los valores de eventos no deben contener el carácter +, excepto en URL codificadas o codificadas según ASCII.
• Los nombres de eventos no pueden contener espacios vacíos. Puedes usar espacios subrayados (guiones bajos) antes o después del nombre del evento.
• Los valores de los eventos no deben superar los 2000 caracteres, ya que podrían acortarse en los reportes de raw data. 
• Si incluyes la URL de referencia como un valor de evento, debe estar codificada como URL.
• Anuncios de Meta tiene algunas limitaciones con respecto a los nombres y parámetros de los eventos. Puedes leer acerca de estas limitaciones aquí.

Puedes enviar valores de ingresos con cualquier nombre de parámetro y evento. Sin embargo, para registrar los ingresos (incluidos los ingresos negativos) en el raw data y los datos agregados de AppsFlyer, DEBES usar el parámetro af_revenue. Utilízalo siempre con los eventos in-app que representan una generación real de ingresos en tu lógica de negocios.

af_currency representa la divisa utilizada en af_revenue (o af_price). Si falta af_currency en los parámetros del evento, AppsFlyer lo envía con el valor predeterminado "USD".

Para más información acerca del parámetro af_revenue, consulta la guía de atribución de ingresos.

Los eventos in-app se atribuyen a la fuente de medios original de la instalación de la aplicación.

Tras la instalación de una aplicación (primer inicio de aplicación), AppsFlyer utiliza varios métodos de atribución para determinar la atribución de la instalación. Al mismo tiempo, el SDK de AppsFlyer crea un nuevo ID de AppsFlyer único, que está asociado con los detalles de atribución.

Cada evento in-app resultante realizado por el mismo dispositivo en la aplicación tiene este ID. Esto permite a AppsFlyer atribuir el evento a la fuente de medios original. Los anunciantes pueden usarlo para seguir la trayectoria completa del usuario en su aplicación.

Los eventos de usuarios recientemente reorientados pueden tener doble atribución.

AppsFlyer atribuye los eventos de instalaciones atribuidas como orgánicas cuando:

• Pasan más de 24 meses desde la fecha de instalación
• Los términos de la fuente de medios dictan eliminar los datos de nivel de usuario
• El usuario elimina los datos almacenados de la aplicación en el dispositivo, forzando la creación de un nuevo ID de AppsFlyer.

Si un usuario inicia un evento cuando no tiene conexión a Internet, AppsFlyer igualmente podrá registrarlo. Así es como funciona:

1. El SDK envía los eventos a los servidores de AppsFlyer y espera una respuesta satisfactoria.
2. Si el SDK no recibe una respuesta satisfactoria, el evento se almacena en el caché.
3. Una vez recibida la respuesta satisfactoria, el evento almacenado se vuelve a enviar al servidor.
4. Si hay varios eventos en el caché, se envían al servidor uno tras otro.

Los eventos in-app complejos permiten enviar varios eventos en una misma llamada a la API.

Son útiles cuando quieres ver agrupadas varias acciones de usuario que estén estrechamente relacionadas, p. ej. agregar varios productos al carrito en una sola sesión.
Ejemplo:

{
  "af_revenue":"50.87",
  "af_currency":"USD",
  "af_receipt_id":"57601333",
  "product":[ 
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1164_8186",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"1177_8185",
	 "af_price":"8.97",
	 "af_quantity":"1"
   },
   { 
	 "af_content_id":"0153_9077",
	 "af_price":"14.99",
	 "af_quantity":"1"
   }
  ]
}

Puedes agregar múltiples artículos a una sola transacción. En lugar de utilizar valores únicos por parámetro de evento, puedes usar múltiples artículos para describir la transacción, separados por comas. El formato debe ser una cadena JSON.

"{\"af_content_id\": [\"123\",\"988\",\"399\"], \"af_quantity\": [\"2\",\"1\",\"1\"], \"af_price\": [\"25\",\"50\",\"10\"], \"af_revenue\": \"110\", \"af_currency\": \"USD\"}"

Tenemos un mecanismo de desduplicación de eventos in-app. El mismo controla todos los eventos in-app para verificar si en los 10 segundos previos se ha registrado algún otro evento in-app idéntico proveniente del mismo appsflyer_id. De ser así, el mecanismo directamente elimina el duplicado.

Dos eventos se consideran idénticos si los campos que se detallan a continuación coinciden en ambos:

• Nombre del evento
• Valor del evento
• ID de aplicación
• ID de AppsFlyer

AppsFlyer retiene datos a nivel usuario (raw data) durante 24 meses, excepto cuando la ley indique, exija o permita lo contrario. Algunas SRN o partners requieren proveedores de atribución, incluido AppsFlyer, para eliminar los datos relacionados con las SRN/partners a nivel usuario antes de que el período de 24 meses caduque.

Después de la eliminación, los eventos relacionados con los usuarios eliminados se muestran como orgánicos. Los datos agregados anteriores no se modifican. Para obtener más información, consulta Obligaciones respecto a la eliminación y retención de datos.

• El SDK de Android y el SDK de iOS agregan automáticamente el parámetro OS (sistema operativo).
• Para la API S2S, a partir del 1 de julio de 2021, debes enviar el parámetro del SO (sistema operativo) para las aplicaciones de iOS. Si no envías este parámetro, se considera que los datos proceden de un usuario de iOS 14.5 y esto afecta la forma en que se pone a disposición el raw data.