Configurer OneSignal
OneSignal est un partenaire d'analyses intégré dans Adjust. Notre intégration permet à OneSignal de recevoir des données mesurées dans Adjust via des callbacks automatisés. Utilisez ces données avec les outils des partenaires concernant les analyses et les insights.
Dans cet article, découvrez comment configurer la mesure avec OneSignal pour votre application. Cela inclut l'activation de l'intégration et de choisir les données que Adjust peut partager avec OneSignal.
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 OneSignal. 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
OneSignal App ID
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant OneSignal.
Sélectionner OneSignal et votre application dans Campaign Lab
- Sous Campaign Lab , sélectionnez Partenaires .
- Sélectionnez Nouveau partenaire > OneSignal . 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 OneSignal.
- Sélectionnez Suivant .
Activer le partage des données
Activez le partage des données pour activer l'intégration avec OneSignal. Pour activer le partage des données :
- Indiquez vos OneSignal App ID.
Lorsque vous avez activé le partage des données avec OneSignal, Adjust envoie automatiquement à OneSignal les données suivantes par défaut :
- installation
- Session
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 OneSignal :
- installation
- Session
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec OneSignal à travers les callbacks. OneSignal peut utiliser ces informations afin d'optimiser les performances.
Pour envoyer des données supplémentaires, vous pouvez vérifier et personnaliser ce qui suit :
Sessions
Adjust n'envoie pas automatiquement les callbacks de session en raison de leur volume élevé. Avec le partage des sessions, OneSignal recevra l'ensemble des données de session de votre application.
Revenus in-app (issus des achats in-app)
Le transfert des revenus in-app permet à OneSignal 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 OneSignal peut recevoir. Les données des événements non mappés ne sont pas partagées avec OneSignal.
Mapper les événements individuels
Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec OneSignal. 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 à OneSignal.
Sélectionnez Mapper l'événement .
Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec OneSignal.
Dans la section Événement partenaire , il est nécessaire de choisir l’événement OneSignal 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à, OneSignal recevra les données des événements in-app pour chacun de vos événements liés.
Mapper tous les événements
Si OneSignal 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à, OneSignal recevra les données des événements in-app pour chacun des événements associés.
Activer OneSignal pour votre application
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
Sélectionnez Activer le partenaire pour activer OneSignal pour votre application. Les partenaires d'analyses ne fonctionnent pas avec les liens pour les campagnes. Après activation, notre intégration envoie les données d'attribution et d'événements in-app à travers des callbacks automatisés.
Instructions de configuration spécifiques aux partenaires
Vous devez implémenter des Push Tokens dans votre SDK Adjust afin que les requêtes soient correctement suivies dans le dashboard OneSignal.
Pour plus d'informations, consultez les guides du SDK Adjust : Android, iOS
Liste de tous les paramètres transférés à OneSignal
OneSignal 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) |
{country} | Code pays à deux caractères de l'appareil |
{currency} | Code de devise ISO 4217 d'origine envoyé depuis le SDK Adjust |
{event_name} | Nom d’événement, tel que défini dans le Dashboard |
{idfa||gps_adid} | L'IDFA, ou le GPS ADID si l'IDFA est vide |
{ip_address} | Adresse IP de l'appareil |
{language} | Code de langue à deux caractères de l'appareil |
{last_time_spent} | Durée, en secondes, de la dernière session de l'utilisateur |
{os_version} | Numéro de version du système d'exploitation |
{push_token} | Token de notification push, c.-à-d. token d'enregistrement (Android), token d'appareil (iOS) |
{revenue_float} | Revenus, tels qu'envoyés depuis le SDK Adjust, en unités de devise entières |
{session_count} | Nombre de sessions enregistrées par le SDK Adjust actuel |
{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é |
{installed_at} | Horodatage de l'installation (c.-à-d. première ouverture de l'app) |
{last_session_time} | Dernier horodatage de session |
{network_name} | Nom du réseau, tel que pris à partir du tracker |