Configuración de Firefly
Firefly es una red de publicidad integrada con Adjust. Nuestra integración permite que Firefly reciba los datos de atribución y eventos in-app por medio de callbacks automatizados.
En este artículo, puedes obtener información sobre cómo configurar la medición con Firefly para tu aplicación. Esto incluye la activación de la integración, la creación de un link de campaña y la elección de los datos que Adjust puede enviar a Firefly.
Antes de comenzar
Requisitos
- Permisos de administrador, editor o editor personalizado en Adjust.
- Versión 4.0.0 o posterior del SDK de Adjust para asignar los parámetros de SDK a los parámetros de Firefly. Sigue las guías disponibles en los siguientes links para utilizar esta función.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciales
Firefly Account Id
- Si necesitas ayuda para encontrar tus credenciales, comunícate con tu representante de Firefly.
Selecciona Firefly y la aplicación en Campaign Lab
- En la sección Campaign Lab, selecciona Socios.
- Selecciona Nuevo socio > Firefly. Selecciona Siguiente para pasar a la siguiente pantalla.
- En la pantalla Selección de aplicación, elige la aplicación para la que desees crear el link y habilita la integración a fin de enviar los datos a Firefly.
- Selecciona Siguiente.
Habilitar el uso compartido de datos
Habilita el uso compartido de datos para activar la integración con Firefly. Sigue estos pasos para habilitar el uso compartido de datos:
- Escribe tus Firefly Account Id.
Cuando habilites el envío de datos a Firefly, nuestro sistema enviará automáticamente los siguientes datos a Firefly de forma predeterminada:
- Instalación
- Desinstalación
- Reinstalar
- Reatribución
- Evento
- instalación rechazada
- reatribución rechazada
Configura tus opciones de envío de datos
Si trabajas con una aplicación multiplataforma que tiene habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Separar las opciones de uso compartido de datos a nivel de plataforma seleccionando Utilizar configuración específica para la plataforma.
- Utilizar las mismas opciones de uso compartido de datos para varias plataformas seleccionando Usar configuración global.
En el apartado ¿Qué se enviará de forma predeterminada?, revisa las actividades que nuestro sistema enviará a Firefly de forma predeterminada.
- Instalación
- Desinstalación
- Reinstalar
- Reatribución
- Evento
- instalación rechazada
- reatribución rechazada
Enviar datos adicionales
Elige la cantidad y el tipo de datos que desees compartir con Firefly por medio de callbacks. Firefly puede utilizar esta información para optimizar rendimiento.
- En el apartado ¿Qué fuentes de datos deseas compartir?, elige la fuente de atribución de los datos que desees compartir con Firefly:
- Datos de todas las fuentes de atribución
- Únicamente los datos atribuidos a Firefly
Desinstalaciones o reinstalaciones
El envío de las desinstalaciones o reinstalaciones permite que Firefly reciba los datos de desinstalaciones y/o reinstalaciones de tu aplicación medidos por Adjust.
Para las aplicaciones de iOS, es posible que se registre un número reducido de desinstalaciones o reinstalaciones. Para obtener más información, consulta el artículo sobre medición de desinstalaciones y reinstalaciones.
Mapear eventos
Asigna los eventos que desees compartir a los valores que Firefly pueda recibir. Los datos de los eventos que no estén mapeados no se compartirán con Firefly.
Cómo mapear los eventos individuales
Si tienes una aplicación multiplataforma, puedes compartir diferentes eventos por plataforma con Firefly. Esto te permite hacer lo siguiente:
- Configurar eventos individuales para administrar las estrategias de tus campañas en cada plataforma.
- Personalizar el uso compartido de datos por plataforma.
En la sección Mapear eventos, sigue estos pasos para elegir los eventos in-app que desees enviar directamente a Firefly.
Selecciona Mapear evento.
En la lista de eventos de Adjust, elige el evento de Adjust que desees compartir con Firefly.
En la opción Evento de socio, debes seleccionar el evento de Firefly que corresponda con el evento de Adjust.
En el caso de las aplicaciones de una sola plataforma y las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para una sola plataforma, únicamente debes mapear los eventos para esa plataforma. En el caso de las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Selecciona Utilizar mapeo específico para la plataforma si deseas mapear eventos independientes a nivel de plataforma, o si no deseas mapear ningún evento para determinadas plataformas.
- Selecciona Utilizar mapeo global si deseas mapear los mismos eventos para todas las plataformas.
En la lista de eventos de socio, elige o escribe el nombre del evento personalizado al que desees asignar el evento de Adjust.
Selecciona Aplicar .
Al hacer esto, Firefly recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapear todos los eventos
Si Firefly admite el mapeo automático de todos los eventos, en la opción Mapear eventos selecciona Mapear todos los eventos. Esto te permite ahorrar tiempo al no tener que mapear los eventos de forma individual.
Cuando hagas esto, Firefly recibirá los datos de eventos in-app de todos tus eventos vinculados.
Configura tu link y tus ajustes
Tienes la opción de configurar lo siguiente:
Cómo crear tu link y compartirlo con Firefly
En la sección Revisión de la configuración, puedes revisar tus opciones. También puedes regresar y hacer cambios en los siguientes elementos:
- La aplicación que seleccionaste
- Opciones de uso compartido de datos
- Parámetros de estructura de links
- Destinos de los usuarios
- Configuración de la atribución
Selecciona Crear link para crear tu URL de clic, URL de impresión, código QR y token del link. Cuando creas un link, también se habilita el envío de datos y la integración con Firefly.
Después de crear el link, compártelo con Firefly para que se coloque en las campañas.
Lista de todos los parámetros reenviados a Firefly
Firefly requiere que Adjust envíe los siguientes parámetros (data points) con tus callbacks:
| Placeholder | Información |
{adid} | ID del dispositivo de Adjust (todas las plataformas) |
{city} | Ciudad del dispositivo |
{cost_amount} | Costo del engagement del usuario (disponible únicamente para el tracking del gasto publicitario) |
{cost_currency} | Código ISO 4217 de la moneda de los datos de costo (disponible únicamente para el tracking del gasto publicitario) |
{cost_type} | Modelo de precios de la campaña (disponible únicamente para el tracking del gasto publicitario) |
{country_subdivision} | Subdivisión del país del dispositivo, p. ej., estado |
{country} | Código de país de dos caracteres del dispositivo |
{device_name} | Número de modelo del dispositivo |
{device_type} | Tipo de dispositivo |
{fire_adid} | Identificador de publicidad de Fire OS |
{gps_adid} | ID de publicidad de Google Play Store |
{idfa||android_id} | IDFA, o ID de Android, si el IDFA está vacío |
{idfv} | ID de iOS en mayúsculas para los proveedores |
{ip_address} | Dirección IP del dispositivo |
{language} | Código de idioma de dos caracteres del dispositivo |
{os_name} | Sistema operativo del dispositivo |
{os_version} | Número de versión del sistema operativo |
{postal_code} | Código postal del dispositivo de la dirección IP |
{region} | Código de región del dispositivo |
{user_agent} | Agente de usuario sin procesar entrante |
{win_udid} | ID de dispositivo único de Windows Phone |
{activity_kind} | Tipo de actividad del usuario |
{app_id} | ID de la tienda de aplicaciones o de Google Play Store |
{app_name} | Nombre de la aplicación |
{app_version} | Número de versión de la aplicación (Android), número de versión del paquete (iOS) |
{campaign_name} | Nombre de la campaña como aparece en el tracker |
{created_at} | Marca de tiempo de la actividad |
{device_manufacturer} | Nombre del fabricante del dispositivo |
{installed_at} | Marca de tiempo de la instalación (es decir, la primera vez que se abre la aplicación) |
{tracker_name} | Nombre del tracker actual |