Configurer KARTE
KARTE est un partenaire d'analyses intégré dans Adjust. Notre intégration permet à KARTE 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 KARTE pour votre application. Cela inclut l'activation de l'intégration et de choisir les données que Adjust peut partager avec KARTE.
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 KARTE. 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
API KEY
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant KARTE.
Sélectionner KARTE et votre application dans Campaign Lab
- Sous Campaign Lab , sélectionnez Partenaires .
- Sélectionnez Nouveau partenaire > KARTE . 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 KARTE.
- Sélectionnez Suivant .
Activer le partage des données
Activez le partage des données pour activer l'intégration avec KARTE. Pour activer le partage des données :
- Indiquez vos API KEY.
Lorsque vous avez activé le partage des données avec KARTE, Adjust envoie automatiquement à KARTE les données suivantes par défaut :
- installation
- Réinstallation
- réinstallation réattribution
- réattribution
- é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 KARTE :
- installation
- Réinstallation
- réinstallation réattribution
- réattribution
- événement
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec KARTE à travers les callbacks. KARTE 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 :
Désinstallations et réinstallations
Le partage des désinstallations ou des réinstallations permet à KARTE 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 à KARTE 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 KARTE peut recevoir. Les données des événements non mappés ne sont pas partagées avec KARTE.
Mapper les événements individuels
Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec KARTE. 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 à KARTE.
Sélectionnez Mapper l'événement .
Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec KARTE.
Dans la section Événement partenaire , il est nécessaire de choisir l’événement KARTE 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à, KARTE recevra les données des événements in-app pour chacun de vos événements liés.
Mapper tous les événements
Si KARTE 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à, KARTE 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 KARTE.
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 à KARTE. KARTE 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 KARTE, 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.
Activer KARTE 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 KARTE 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
Paramètres prédéfinis
Karte vous permet d'envoyer un ensemble de paramètres prédéfinis. Si vous joignez certains de ces paramètres à un événement dans votre SDK Adjust, ils seront transférés vers Karte. 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 Karte :
Clé de paramètre> valeur
- visitor_id> obligatoire pour envoyer des callbacks à Karte.
Pour envoyer des callbacks d'événement à Karte, vous devez implémenter visitor_id comme paramètre de partenaire d'événement et de session dans le SDK Adjust. Dans le dashboard Adjust, l'option Transfert de paramètres doit être activée.
Pour plus de détails, consultez également la page de support de Karte Support (JP).
Liste de tous les paramètres transférés à KARTE
KARTE 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) |
{android_id} | ID Android (Android uniquement) |
{api_level} | Niveau API (Android uniquement) |
{city} | Ville de l'appareil |
{click_attribution_window} | Paramètres de fenêtre d'attribution pour le matching de l'appareil (heures) |
{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 |
{currency} | Code de devise ISO 4217 d'origine envoyé depuis le SDK Adjust |
{deeplink} | URL de deeplink ajoutée à une URL de clic |
{device_name} | Numéro de modèle d'appareil |
{device_type} | Type d'appareil |
{environment} | Paramètre d'environnement actuel du SDK Adjust |
{fire_adid} | ID publicitaire Fire OS |
{gps_adid_md5} | Hash MD5 hex en minuscules de l'ID publicitaire du Google Play Store |
{gps_adid} | ID publicitaire Google Play Store |
{idfa} | ID pour les annonceurs (iOS uniquement) |
{idfv} | ID iOS en majuscules pour les fournisseurs |
{impression_attribution_window} | Paramètres de fenêtre d'attribution pour le matching des impressions (heures) |
{inactive_user_definition} | Période d'inactivité pour la réattribution (heures) |
{ip_address} | Adresse IP de l'appareil |
{isp} | Fournisseur de service Internet 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 |
{lifetime_session_count} | Nombre de sessions enregistrées sur toute la durée de vie utilisateur |
{match_type} | Méthode d'attribution |
{nonce} | Chaîne alphanumérique aléatoire en minuscules (unique par callback) |
{os_name} | Système d'exploitation de l'appareil |
{os_version} | Numéro de version du système d'exploitation |
{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 |
{postal_code} | Code postal de l'adresse IP de l'appareil |
{random_user_id} | ID utilisateur aléatoire (par appareil) |
{random} | Numéro aléatoire (unique par callback) |
{reattribution_attribution_window} | Paramètres de fenêtre d'attribution pour la réattribution (heures) |
{reftag} | Tag de référence d'appareil aléatoire |
{reporting_cost} | Coût de l'engagement utilisateur converti dans la devise de reporting de votre application et tel que rapporté dans le Dashboard Adjust (uniquement disponible pour le tracking des dépenses publicitaires) |
{reporting_currency} | Code de devise ISO 4217 de reporting dans le dashboard |
{reporting_revenue} | Revenus tels que rapportés dans le dashboard Adjust en unités de devise entières |
{revenue_float} | Revenus, tels qu'envoyés depuis le SDK Adjust, en unités de devise entières |
{revenue} | Revenus, tels qu'envoyés depuis le SDK Adjust, en centimes |
{session_count} | Nombre de sessions enregistrées par le SDK Adjust actuel |
{time_spent} | Durée, en secondes, de la session actuelle de l'utilisateur |
{timezone} | Fuseau horaire de l'appareil |
{tracking_enabled} | 1 si le tracking est activé, 0 dans le cas contraire |
{tracking_limited} | 1 si le tracking est limité, 0 dans le cas contraire |
{user_agent} | Agent utilisateur brut entrant |
{activity_kind} | Type d'activité utilisateur. |
{adgroup_name} | Nom du ad group, tel que pris à partir du tracker |
{app_id} | ID Store App ou Google Play Store |
{app_name_dashboard} | Nom de l'application dans le dashboard Adjust |
{app_version_raw} | Numéro de version d'application (Android), build-version-number pour le bundle (iOS) |
{app_version_short} | Numéro de version d'application (Android), release-version-number pour le bundle (iOS) |
{app_version} | Numéro de version d'application (Android), build-version-number pour le bundle (iOS) |
{attribution_updated_at} | Horodatage d'attribution mis à jour |
{campaign_name} | Nom de la campagne, tel que pris à partir du tracker |
{click_time} | Horodatage de clic attribué |
{connection_type} | Type de connexion à Internet |
{conversion_duration} | Délai, en secondes, entre le clic et l'installation ou la réattribution |
{created_at} | Horodatage de l'activité |
{creative_name} | Nom du créatif, tel que pris à partir du tracker |
{engagement_time} | Horodatage de l'engagement |
{impression_based} | 1 si engagement basé sur des impressions, 0 dans le cas contraire |
{impression_time} | Horodatage d'impression attribuée |
{install_begin_time} | Horodatage du début du téléchargement de l'app (Android et Google Play Store uniquement) |
{install_finish_time} | Horodatage de fin de téléchargement de l'application |
{installed_at} | Horodatage de l'installation (c.-à-d. première ouverture de l'app) |
{is_organic} | 1 si trafic organique, 0 si non organique |
{last_session_time} | Dernier horodatage de session |
{network_name} | Nom du réseau, tel que pris à partir du tracker |
{reattributed_at} | Horodatage de réattribution |
{referral_time} | Horodatage d'arrivée de l'utilisateur sur la page Play Store (Android et Google Play Store uniquement) |
{reinstalled_at} | Horodatage de réinstallation |
{store} | Store cible du clic |
{time_to_reinstall} | Délai écoulé, en secondes, entre la dernière désinstallation d'app et la réinstallation suivante |
{time_to_uninstall} | Délai écoulé, en secondes, entre l'installation de l'app (ou la dernière réinstallation) et la désinstallation suivante |
{tracker_name} | Nom du tracker actuel |
{uninstalled_at} | Horodatage de désinstallation (estimation basée sur la dernière heure de session) |
{google_ads_creative_id} | ID créatif Google Ads |