Configurer Firefly
Firefly est un réseau publicitaire intégré avec Adjust. Notre intégration permet à Firefly 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 Firefly 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 Firefly.
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 Firefly. 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
Firefly Account Id
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant Firefly.
Sélectionner Firefly et votre application dans Campaign Lab
- Sous Campaign Lab , sélectionnez Partenaires .
- Sélectionnez Nouveau partenaire > Firefly . 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 Firefly.
- Sélectionnez Suivant .
Activer le partage des données
Activez le partage des données pour activer l'intégration avec Firefly. Pour activer le partage des données :
- Indiquez vos Firefly Account Id.
Lorsque vous avez activé le partage des données avec Firefly, Adjust envoie automatiquement à Firefly les données suivantes par défaut :
- installation
- Désinstallation
- Réinstallation
- réattribution
- événement
- installation refusée
- réattribution refusée
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 Firefly.
- installation
- Désinstallation
- Réinstallation
- réattribution
- événement
- installation refusée
- réattribution refusée
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec Firefly à travers les callbacks. Firefly 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 Firefly :
- Données issues de toutes les sources d'attribution
- Uniquement les données attribuées à Firefly
Désinstallations et réinstallations
Le partage des désinstallations ou des réinstallations permet à Firefly 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.
Mapper les événements
Mappez les événements que vous souhaitez partager avec les valeurs que Firefly peut recevoir. Les données des événements non mappés ne sont pas partagées avec Firefly.
Mapper les événements individuels
Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec Firefly. 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 à Firefly.
Sélectionnez Mapper l'événement .
Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec Firefly.
Dans la section Événement partenaire , il est nécessaire de choisir l’événement Firefly 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à, Firefly recevra les données des événements in-app pour chacun de vos événements liés.
Mapper tous les événements
Si Firefly 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à, Firefly recevra les données des événements in-app pour chacun des événements associés.
Configurer votre lien et vos paramètres
Vous pouvez définir les éléments suivants :
Créer votre lien et le partager avec Firefly
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 Firefly.
Lorsque vous avez créé votre lien, partagez-le avec Firefly pour placement en campagnes.
Liste de tous les paramètres transférés à Firefly
Firefly demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :
Espace réservé | Informations |
{adid} | ID d'appareil Adjust (toutes plateformes) |
{city} | Ville de l'appareil |
{cost_amount} | Coût de l'engagement utilisateur (uniquement disponible pour le tracking des dépenses publicitaires) |
{cost_currency} | Code devise ISO 4217 des données de coût (uniquement disponible pour le tracking des dépenses publicitaires) |
{cost_type} | Modèle de tarification de la campagne (uniquement disponible pour le tracking des dépenses publicitaires) |
{country_subdivision} | Sous-division du pays de l'appareil, p. ex. département |
{country} | Code pays à deux caractères de l'appareil |
{device_name} | Numéro de modèle d'appareil |
{device_type} | Type d'appareil |
{fire_adid} | ID publicitaire Fire OS |
{gps_adid} | ID publicitaire Google Play Store |
{idfa||android_id} | L'IDFA, ou l'ID Android si l'IDFA est vide |
{idfv} | ID iOS en majuscules pour les fournisseurs |
{ip_address} | Adresse IP de l'appareil |
{language} | Code de langue à deux caractères de l'appareil |
{os_name} | Système d'exploitation de l'appareil |
{os_version} | Numéro de version du système d'exploitation |
{postal_code} | Code postal de l'adresse IP de l'appareil |
{region} | Code région de l'appareil |
{user_agent} | Agent utilisateur brut entrant |
{win_udid} | ID appareil unique Windows Phone |
{activity_kind} | Type d'activité utilisateur. |
{app_id} | ID Store App ou Google Play Store |
{app_name} | Nom de l'application |
{app_version} | Numéro de version d'application (Android), build-version-number pour le bundle (iOS) |
{campaign_name} | Nom de la campagne, tel que pris à partir du tracker |
{created_at} | Horodatage de l'activité |
{device_manufacturer} | Nom du fabricant de l'appareil |
{installed_at} | Horodatage de l'installation (c.-à-d. première ouverture de l'app) |
{tracker_name} | Nom du tracker actuel |