Configurer Epsilon
Epsilon est un réseau publicitaire intégré avec Adjust. Notre intégration permet à Epsilon de recevoir les données d'événement in-app et d'attribution via des callbacks automatisés.
Dans cet article, découvrez comment configurer la mesure avec Epsilon pour votre application. Cela inclut l'activation de l'intégration, de créer un lien de campagne et de choisir les données que Adjust peut partager avec Epsilon.
Avant de commencer
Prérequis
- Autorisations Administrateur, Éditeur ou Éditeur personnalisé dans Adjust.
- Adjust SDK v4.0.0+ pour mapper les paramètres du SDK avec les paramètres Epsilon. Suivez les guides ci-dessous pour utiliser cette fonctionnalité :
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Identifiants
Company ID et Company Magic
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant Epsilon.
Sélectionner Epsilon et votre application dans Campaign Lab
- Sous Campaign Lab, sélectionnez Partenaires.
- Sélectionnez Nouveau partenaire > Epsilon. Sélectionnez Suivant pour passer à l'écran suivant.
- Dans l'écran Sélection d'app, choisissez l'application pour laquelle vous souhaitez créer le lien, puis activez l'intégration pour partager des données avec Epsilon.
- Sélectionnez Suivant.
Activer le partage des données
Activez le partage des données pour activer l'intégration avec Epsilon. Pour activer le partage des données :
- Indiquez vos Company ID et Company Magic.
Lorsque vous avez activé le partage des données avec Epsilon, Adjust envoie automatiquement à Epsilon les données suivantes par défaut :
- installation
- Session
- Réinstallation
- événement
Configurez vos options de partage de données
Si vous utilisez une application multiplateforme dont le partage des données est activé pour plusieurs plateformes, vous pouvez :
- Séparer les options de partage des données au niveau de chaque plateforme en sélectionnant Utiliser les paramètres spécifiques à la plateforme.
- Définir les mêmes paramètres de partage des données pour plusieurs plateformes en sélectionnant Utiliser les paramètres globaux.
Maintenant, sous Quelles sont les données partagées par défaut ?, vérifiez les activités partagées par défaut par Adjust avec Epsilon.
- installation
- Session
- Réinstallation
- événement
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec Epsilon à travers les callbacks. Epsilon peut utiliser ces informations afin d'optimiser les performances.
- Sous Quelles sources de données souhaitez-vous partager ?, choisissez la source d'attribution des données que vous souhaitez partager avec Epsilon :
- Données issues de toutes les sources d'attribution
- Uniquement les données attribuées à Epsilon
Sessions
Adjust n'envoie pas automatiquement les callbacks de session en raison de leur volume élevé. Avec le partage des sessions, Epsilon recevra l'ensemble des données de session de votre application.
Désinstallations et réinstallations
Le partage des désinstallations ou des réinstallations permet à Epsilon de recevoir les données de désinstallation et/ou de réinstallation de votre application mesurées par Adjust.
Pour les applications iOS, vous obtiendrez certainement une faible valeur de désinstallations et/ou de réinstallations. Pour plus d'informations, consultez Mesure des désinstallations et des réinstallations.
Revenus in-app (issus des achats in-app)
Le transfert des revenus in-app permet à Epsilon de recevoir les quantités de revenus avec vos données d'événements de revenus. Vous devez mapper les événements qui génèrent des revenus pour partager ces données.
Mapper les événements
Mappez les événements que vous souhaitez partager avec les valeurs que Epsilon peut recevoir. Les données des événements non mappés ne sont pas partagées avec Epsilon.
Mapper les événements individuels
Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec Epsilon. Cela vous permet de :
- Configurer des événements individuels afin de piloter les stratégies de campagne pour chaque plateforme.
- Personnaliser le partage des données par plateforme.
Sous Mapper les événements , procédez comme suit pour choisir les événements in-app à envoyer directement à Epsilon.
Sélectionnez Mapper l'événement .
Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec Epsilon.
Dans la section Événement partenaire , il est nécessaire de choisir l’événement Epsilon correspondant à l’événement Adjust.
Pour les applications monoplateformes et les applications multiplateformes avec partage de données activé pour une seule plateforme, vous mappez les événements uniquement à cette plateforme. Pour les applications multiplateformes dont le partage des données est activé pour plusieurs plateformes, vous pouvez :
- Choisissez l’option Utiliser le mappage spécifique à la plateforme pour mapper des événements distincts à chaque plateforme ou pour ne pas mapper d’événements à certaines plateformes.
- Choisissez l’option Utiliser le mappage global pour mapper les mêmes événements à l’ensemble des plateformes.
Dans la liste Événement partenaire, choisissez ou saisissez un nom d'événement personnalisé auquel vous souhaitez mapper l'événement Adjust.
Sélectionnez Appliquer.
À partir de là, Epsilon recevra les données des événements in-app pour chacun de vos événements liés.
Mapper tous les événements
Si Epsilon prend automatiquement en charge le mappage de tous les événements, dans la section Mapper les événements , sélectionnez l’option Mapper tous les événements . Cette manipulation permet de gagner du temps lors du mappage des événements individuels.
À partir de là, Epsilon recevra les données des événements in-app pour chacun des événements associés.
Mapper les paramètres
Vous devez généralement mapper les paramètres pour partager des données personnalisées avec Epsilon.
Les paramètres de partenaire (disponibles à partir de la version 4.0 du SDK Adjust) permettent à Adjust de collecter des points de données personnalisés à partir de votre application et de les transmettre directement à Epsilon. Epsilon reçoit alors le détail des événements personnalisés pour chacun de vos événements liés.
Avant d'ajouter de nouveaux paramètres de partenaire au SDK Adjust, assurez-vous qu'aucun autre paramètre de partenaire prédéfini ne satisfait déjà vos exigences.
Pour partager les paramètres de partenaire avec Epsilon, procédez comme suit :
Configurez les paramètres partenaires dans le SDK Adjust.
- Effectuez la vérification avant de commencer pour tous les liens de la plateforme de développement du SDK.
Sous Définir vos options de partage des données , sélectionnez Paramètres .
Sous Mapper les paramètres , vous pouvez spécifiez la façon dont vous souhaitez envoyer les paramètres partenaires définis dans le SDK au réseau :
- Sélectionnez Mapper le paramètre .
- Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
- Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.
Si vous configurez les paramètres partenaires dans le SDK Adjust sans configurer le partage des paramètres dans le dashboard, Adjust transfère les paramètres tels qu'ils sont nommés dans le SDK Adjust.
Configurer votre lien et vos paramètres
Vous pouvez définir les éléments suivants :
Créer votre lien et le partager avec Epsilon
Dans l'écran Vérification de la configuration , vérifiez vos choix. Vous pouvez revenir en arrière et modifier les éléments suivants :
- L'application sélectionnée.
- Options de partage des données
- Les paramètres de structure de lien.
- Destinations utilisateur
- Paramètres d'attribution
Sélectionnez Créer un lien pour créer votre URL de clic, URL d'impression, code QR et token de lien. La création d'un lien active également le partage des données et l'intégration avec Epsilon.
Lorsque vous avez créé votre lien, partagez-le avec Epsilon pour placement en campagnes.
Instructions de configuration spécifiques aux partenaires
Epsilon vous permet d'envoyer un ensemble de paramètres prédéfinis. Si vous joignez certains de ces paramètres à un événement ou une session dans votre SDK Adjust, ils seront transférés vers Epsilon. Vous obtiendrez davantage d'informations sur l'association de paramètres de partenaire dans le fichier readme SDK spécifique au(x) SDK que vous utilisez. Voici une liste des paramètres définis acceptés par Epsilon :
Clé de paramètre> valeur
dtm_fid*> identifiant de formulaire
dtm_promo_id*> valeur qui identifie le type de page
dtm_email_hash> hachage SHA-256 de l'adresse email du client. Supprimez les espaces de début/fin et convertissez l'adresse email en minuscules avant le hachage
dtm_mobile_hash> hachage SHA-256 du téléphone portable du client au format : code pays + code de région sans espace de début + numéro de l'abonné. Supprimez tous les éventuels caractères spéciaux.
dtm_user_id> identifiant unique. Ne peut pas être PII ou l'adresse email hachée
dtmc_tcf_string**> chaîne de consentement RGPD
dtmc_department***> nom de département de la vue actuelle
dtmc_category***> nom de catégorie de la vue actuelle
dtmc_sub_category***> nom de sous-catégorie de la vue actuelle
dtmc_product_id****> ID de produit de la vue actuelle
dtmc_brand****> marque du fabricant
dtmc_upc_code****> code UPC du fabricant
dtmc_mpn***> numéro de pièce de modèle du fabricant
dtmc_transaction_id*****> identifiant unique du système client pour chaque conversion
dtmc_items> un ensemble de tous les éléments dans la conversion. Chaque élément doit inclure ce qui suit :
- product_id : SKU de l'élément
- item_amount : coût d'une unité de l'élément
- item_quantity : nombre d'éléments de SKU dans la transaction
- item_discount : valeur de la remise sur la quantité d'origine
dtmc_conv_type> différence entre les type d'achats en ligne : livraison, retrait...
dtmc_location> pour les conversions de type retrait, indiquez l'emplacement du point de retrait
** obligatoire*
*** obligatoire dans les zones où les restrictions du RGPD s'appliquent*
**** conditionnel - requis si connu, comprenant les événements de produits*
**** Conditionnel - uniquement requis sur les événements d'affichage de produits
*** obligatoire sur les transactions*
Liste de tous les paramètres transférés à Epsilon
Epsilon demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :
Espace réservé | Informations |
{currency} | Code de devise ISO 4217 d'origine envoyé depuis le SDK Adjust |
{deeplink} | URL de deeplink ajoutée à une URL de clic |
{gps_adid} | ID publicitaire Google Play Store |
{idfa} | ID pour les annonceurs (iOS uniquement) |
{ip_address} | Adresse IP de l'appareil |
{partner_parameters} | Paramètres de partenaire personnalisés collectés par le SDK Adjust ou la requête S2S, puis transmis à des fournisseurs tiers via des postbacks |
{random} | Numéro aléatoire (unique par callback) |
{revenue_float} | Revenus, tels qu'envoyés depuis le SDK Adjust, en unités de devise entières |
{user_agent} | Agent utilisateur brut entrant |