Cómo configurar las referencias de usuarios

Cuando un usuario refiere a un amigo para que descargue y se registre en tu aplicación, puedes enviarle una recompensa in-app personalizada.

La configuración de referencias de usuarios incluye los siguientes pasos:

1. Crea un link personalizado para tu programa de referencias. Luego, deberás colocar este link detrás del componente de invitación en tu aplicación.
2. Anexa un parámetro label. El parámetro "label" servirá para enviar un ID de referencia único. Deberás agregar las instrucciones para que tu aplicación llene el parámetro "label" con el ID de referencia antes de enviar la URL del link al usuario invitado.
3. Configura el envío de los ID de referencia a tus sistemas. Configura un callback de atribución o callbacks de servidor para recibir el ID de referencia cuando un nuevo usuario descargue y abra la aplicación mediante un link de referencia. Luego, tu sistema deberá aplicar la recompensa para el usuario con base en el ID de referencia recibido.

Antes de comenzar

Esto es lo que debes hacer antes de configurar las referencias de usuarios:

• Si tu aplicación es para iOS, asegúrate de que el modelado probabilístico esté habilitado. Esto te permite asegurarte de que las referencias funcionen en un entorno web móvil.
• Revisa que tu sistema esté configurado para entregar las recompensas a los usuarios al generar y aplicar códigos de referencia. Y asegúrate de revisar lo siguiente:
  • Tu servidor debe poder generar un ID referencia cuando un usuario toque el botón para compartir la invitación.
  • Tu servidor debe poder sustituir el placeholder label con el ID de referencia.
  • Tu servidor debe poder procesar el valor del placeholder label del callback de Adjust para aplicar una recompensa a la cuenta del referente, la cuenta del referido o ambas.

1. Crea un link personalizado para tu programa de referencias

1. Sigue las instrucciones descritas en la guía de configuración de links personalizados.
2. Considera la opción de habilitar el modelado probabilístico en la configuración de atribución, lo que garantizará la precisión de la atribución en diferentes ubicaciones.

2. Anexa un parámetro "label" al link

Adjust utiliza el parámetro label para recibir los datos personalizados que no están relacionados con los datos de atribución. En el caso de las referencias de usuarios, puedes utilizarlo para etiquetar a los usuarios de tu aplicación con un ID único.

Asegúrate de anexar un parámetro label a tu link personalizado junto con tus demás parámetros. Puedes utilizar un link de marca para mejorar la experiencia de los usuarios.

https://example.go.link?adj_t=abc123&adj_label={user_id}

Si utilizas callbacks de servidor para enviar el ID de referencia a Adjust, puedes utilizar un parámetro de callback dinámico.

3. Configura el envío de los ID de referencia a tus sistemas

Cuando el usuario invitado descarga y abre la aplicación, se presenta uno de los siguientes escenarios:

• Callback de atribución: el SDK de Adjust recibe un callback de atribución que contiene el parámetro label con un ID de referencia que tu aplicación puede recopilar.
• Callback de instalación: Adjust envía a tu servidor un callback de instalación que contiene un ID de referencia mediante el parámetro label o mediante un parámetro de callback dinámico.

Luego, tu sistema debe aplicar la recompensa para el usuario con base en el ID de referencia recibido.

Callback de atribución (recomendado)

Los callbacks de atribución te permiten recibir un parámetro label que contiene un ID de referencia único dentro de tu aplicación inmediatamente después de que el usuario instala la aplicación mediante un link de referencia y se le atribuye al link de referencia personalizado. Para hacer la configuración correspondiente en tu aplicación, sigue los pasos descritos en la guía de callbacks de atribución:

• iOS
• Android
• Unity
• React Native
• Flutter

Callback instantáneo

Los callbacks de instalación de servidor te permiten recibir un callback con un código de referencia en tu servidor de BI. Consulta la guía de configuración de callbacks de servidor para obtener más información.

Sigue estos pasos para configurar callbacks de instalación:

1. Accede a la configuración de callbacks de servidor desde la tarjeta de tu aplicación o desde la pestaña Administración de datos de la sección de configuración de tu aplicación.

   • (Solo para los usuarios con permisos de administrador, editor o editor personalizado) Para configurar un callback de servidor desde la tarjeta de la aplicación, dirígete a la sección AppView y selecciona Todas las aplicaciones. Busca tu aplicación y selecciona Callbacks de servidor.
   • Para configurar un callback de servidor desde la pestaña Administración de datos de la sección de configuración de tu aplicación, dirígete a la sección AppView y selecciona Todas las aplicaciones. Selecciona tu aplicación y luego selecciona la pestaña Administración de datos.

2. En la sección Callbacks de servidor , selecciona Agregar callback > Configuración guiada.

3. En la lista Activadores de callbacks, selecciona la actividad “install”.

4. En el campo Endpoint del servidor , escribe la URL de un endpoint en el que puedas recibir tus datos.

5. (Opcional) Selecciona Agregar una condición para agregar una condición combinada con placeholders y valores. El callback únicamente se activará si se cumple la condición.

6. Selecciona Agregar un placeholder en la sección Placeholders, y elige {install} en la lista para incluir dinámicamente los datos del código de referencia del usuario en tu callback. Puedes agregar varios placeholders.

7. Selecciona Crear URL de callback para generar la URL de callback codificado.

Este es un ejemplo de la URL de callback con el parámetro "label" anexado y los placeholders recomendados:

https://myendpoint.test/?label={label}&adid={adid}&tracker_name={tracker_name}&gps_adid={gps_adid}&idfa={idfa}&idfv={idfv}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}

Elaboración de informes

Adjust Datascape te permite elaborar informes agregados para tu link de referencia. El valor del parámetro label no aparece en ninguna parte de Datascape, y únicamente está disponible mediante un callback de atribución o en tu exportación de datos sin procesar (raw data).

Guía de testeo

Sigue estos pasos para testear tu configuración de referencias de usuarios:

1. Coloca el link personalizado generado, con el parámetro label anexado, detrás del componente de invitación en tu aplicación.
2. Selecciona el componente de invitación y copia el link. Asegúrate de que el parámetro label tenga un código de referencia.
3. Pega el link en un servicio de mensajería o en cualquier otro entorno que el usuario pueda utilizar para compartir el link.
4. Sigue los pasos descritos en la sección "Antes de comenzar" de la guía de la Consola de testeo para preparar un dispositivo de testeo.
5. Selecciona el link.
6. Sigue estas instrucciones para revisar los datos del dispositivo en la Consola de testeo.
7. Verifica que hayas recibido el parámetro label en tus callbacks de atribución o mediante el callback de servidor en tu sistema de BI.
8. Entrega la recompensa correspondiente al código de referencia que hayas recibido.