Configurer les référents d'utilisateur

Lorsqu'un utilisateur recommande à un ami de télécharger votre app et de s'y inscrire, vous pouvez lui envoyer une récompense in-app personnalisée.

La configuration des parrainages s'effectue en deux étapes :

1. Créez une lien personnalisé pour votre programme de parrainage. Ce lien devra ensuite être placé derrière le composant d'invitation dans votre application.
2. Ajoutez un paramètre label. Un paramètre label servira à transmettre un ID de parrainage unique. Faites en sorte que votre application renseigne le paramètre label avec l'ID de parrainage avant d'envoyer l'URL de lien à l'utilisateur invité.
3. Configurez la transmission des ID de parrainage à vos systèmes. Configurez un callback d'attribution ou des callbacks de serveur pour recevoir l'ID de parrainage lorsqu'un nouvel utilisateur télécharge et ouvre l'application via le lien de parrainage. Votre système devra alors appliquer la récompense utilisateur sur la base de l'ID de parrainage reçu.

Avant de commencer

Voici ce que vous devez savoir avant de configurer les parrainages :

• Si votre application cible iOS, assurez-vous que la modélisation probabiliste est activée. Cela permet aux recommandations de fonctionner dans un environnement web mobile.
• Vérifiez que votre système est configuré pour fournir des récompenses in-app en générant et appliquant des codes de recommandation. Assurez-vous de vérifier ce qui suit :
  • Votre serveur peut générer un ID de référent lorsqu'un utilisateur appuie le bouton d'invitation.
  • Votre serveur peut renseigner l'espace réservé label avec l'ID de référent.
  • Votre serveur peut traiter la valeur de l'espace réservé label à partir du callback Adjust pour appliquer une récompense au compte à l'origine de la recommandation, au compte recommandé, ou aux deux.

1. Créer une lien personnalisé pour votre programme de parrainage

1. Suivez le Guide de configuration des liens personnalisés.
2. Pensez à activer la modélisation probabiliste dans les paramètres d'attribution, ce qui garantira la précision de l'attribution dans différents placements.

2. Ajouter un paramètre label au lien

Adjust utilise le paramètre label pour recevoir des données personnalisées sans relation avec les données d'attribution. Pour les recommandations d'utilisateurs, vous pouvez l'utiliser pour taguer vos utilisateurs d'app à l'aide d'ID uniques.

Assurez-vous d'ajouter un paramètre label à votre lien personnalisé avec que vos autres paramètres. Vous pouvez utiliser un lien de marque pour améliorer l'expérience utilisateur.

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

Si vous utilisez des callbacks de serveur pour partager votre ID de parrainage avec Adjust, vous pouvez utiliser un paramètre de callback dynamique.

3. Configurer la transmission des ID de parrainage à vos systèmes

Lorsque l'utilisateur invité télécharge et ouvre l'application, l'une des suivantes survient :

• Callback d'attribution : Le SDK Adjust reçoit un callback d'attribution contenant le paramètre label renseigné avec un ID de référent, que votre application peut collecter.
• Callback d'installation : Votre serveur reçoit un callback d'installation d'Adjust contenant un ID de référent, à l'aide du paramètre label ou d'un paramètre de callback dynamique.

Votre système doit alors appliquer la récompense utilisateur sur la base de l'ID de parrainage reçu.

Callback d'attribution (conseillé)

Les callbacks d'attribution vous permettent de recevoir un paramètre label qui contient un ID de parrainage unique avec votre application immédiatement après que l'utilisateur ait installé l'application via un lien de parrainage et ait été attribué au lien de parrainage personnalisé. Suivez le guide des callbacks d'attribution pour appliquer cette configuration dans votre application :

• iOS
• Android
• Unity
• React Native
• Flutter

callback d'installation

Les callbacks d'installation de serveur vous permettent de recevoir un callback avec un code de parrainage dans votre serveur BI. Consultez le Guide de configuration des callbacks de serveur pour plus d'informations.

Suivez lez étapes suivantes pour configurer des callbacks d'installation :

1. Accédez à la configuration des callbacks de serveur depuis la fiche de votre application ou dans l'onglet Gestion des données de la configuration de votre application.

   • (Autorisations Administrateur, Éditeur ou Éditeur personnalisé uniquement.) Pour configurer un callback de serveur à partir de la fiche de l'application, sous AppView , sélectionnez Toutes les apps . Trouvez votre application et sélectionnez Callbacks de serveur .
   • Pour configurer un callback de serveur à partir de l'onglet Gestion des données de la configuration de votre application, sous AppView , sélectionnez Toutes les apps . Sélectionnez votre application, puis l'onglet Gestion des données .

2. Sous Callbacks de serveur , sélectionnez Ajouter un callback > Configuration guidée .

3. Dans la liste Déclencheur de callback , sélectionnez l'activité “install”.

4. Dans le champ Endpoint de serveur , saisissez l'URL de endpoint où recevoir vos données.

5. (Facultatif) Sélectionnez Ajouter une condition pour ajouter une condition combinée à des espaces réservés et des valeurs. Le callback est ensuite déclenché uniquement si la condition est remplie.

6. Sélectionnez Ajouter un espace réservé dans la section Espaces réservés et choisissez {install} dans la liste pour inclure dynamiquement les données du code de parrainage dans votre callback. Vous pouvez ajouter plusieurs espaces réservés.

7. Sélectionnez Créer une URL de callback pour générer l'URL de callback codée.

Voici un exemple de l'URL de callback avec le paramètre label ajouté et les espaces réservés conseillés :

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}

Reporting

Adjust Datascape fournit un reporting agégré pour votre lien de parrainage. La valeur du paramètre label n'apparaît pas dans Datascape et elle est uniquement disponible via le callback d'attribution dans votre export de données brutes.

Guide des tests

Suivez les étapes suivantes pour tester votre configuration de parrainage :

1. Placez le lien personnalisé généré avec le paramètre label ajouté derrière le composant d'invitation dans votre application.
2. Sélectionnez le compostant d'invitation et copiez le lien. Assurez-vous que le paramètre label est renseigné avec un code de parrainage.
3. Collez le lien dans une messagerie ou tout autre environnement dans lequel votre utilisateur partagera le lien.
4. Préparez un appareil de test en suivant la section Avant de commencer dans la guide de la console de test.
5. Sélectionnez le lien.
6. Vérifiez les données d'appareil dans la console de test en suivant ces instructions.
7. Vérifiez que vous avez reçu le paramètre label dans vos callbacks d'attribution ou via le callback de serveur dans votre système BI.
8. Accordez la récompense en fonction du code de parrainage reçu.