Configurer Chartboost

Chartboost est un réseau publicitaire intégré avec Adjust. Notre intégration permet à Chartboost 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 Chartboost 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 Chartboost.

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 Chartboost. 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

APP ID et APP SIGNATURE

• Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant Chartboost.

Sélectionner Chartboost et votre application dans Campaign Lab

1. Sous Campaign Lab, sélectionnez Partenaires.
2. Sélectionnez Nouveau partenaire > Chartboost. Sélectionnez Suivant pour passer à l'écran suivant.
3. 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 Chartboost.
4. Sélectionnez Suivant.

Activer le partage des données

Activez le partage des données pour activer l'intégration avec Chartboost. Pour activer le partage des données :

1. Indiquez vos APP ID et APP SIGNATURE.

Lorsque vous avez activé le partage des données avec Chartboost, Adjust envoie automatiquement à Chartboost les données suivantes par défaut :

• installation
• Session
• réattribution
• événement
• installation 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 :

1. 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.
2. 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 Chartboost.

• installation
• Session
• réattribution
• événement
• installation refusée

Envoyer des données supplémentaires

Choisissez la quantité et le type de données que vous souhaitez partager avec Chartboost à travers les callbacks. Chartboost peut utiliser ces informations afin d'optimiser les performances.

1. Sous Quelles sources de données souhaitez-vous partager ?, choisissez la source d'attribution des données que vous souhaitez partager avec Chartboost :

• Données issues de toutes les sources d'attribution
• Uniquement les données attribuées à Chartboost

Sessions

Adjust n'envoie pas automatiquement les callbacks de session en raison de leur volume élevé. Avec le partage des sessions, Chartboost 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 à Chartboost 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 Chartboost peut recevoir. Les données des événements non mappés ne sont pas partagées avec Chartboost.

Mapper les événements individuels

Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec Chartboost. 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 à Chartboost.

1. Sélectionnez Mapper l'événement .

2. Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec Chartboost.

3. Dans la section Événement partenaire , il est nécessaire de choisir l’événement Chartboost correspondant à l’événement Adjust.

   1. 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.

   2. Dans la liste Événement partenaire, choisissez ou saisissez un nom d'événement personnalisé auquel vous souhaitez mapper l'événement Adjust.

4. Sélectionnez Appliquer.

À partir de là, Chartboost recevra les données des événements in-app pour chacun de vos événements liés.

Mapper tous les événements

Si Chartboost 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à, Chartboost 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 Chartboost.

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 à Chartboost. Chartboost 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 Chartboost, procédez comme suit :

1. 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.

2. Sous Définir vos options de partage des données , sélectionnez Paramètres .

3. 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 :

   1. Sélectionnez Mapper le paramètre .
   2. Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
   3. Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.

Configurer votre lien et vos paramètres

Vous pouvez définir les éléments suivants :

• Structure de lien
• Destinations utilisateur
• Paramètres d'attribution

Créer votre lien et le partager avec Chartboost

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 Chartboost.

Lorsque vous avez créé votre lien, partagez-le avec Chartboost pour placement en campagnes.

Instructions de configuration spécifiques aux partenaires

Chartboost est un réseau de performances centré sur les jeux. Adjust intègre Chartboost de deux façons :

• Callbacks de session, d'installation, de réattribution et d'installation refusée : Adjust reportera toutes les sessions utilisateur ainsi que les installations, les installations refusées et les réattributions attribuées à Chartboost. Ces callbacks sont utilisés pour le tracking S2S dans le réseau Chartboost.
• Callbacks d'événement (ou post-installation ) : Adjust reportera les achats in-app à Chartboost pour que les développeurs puissent visualiser les données et ensuite optimiser leurs campagnes Chartboost.

Pour activer le module Chartboost, vous devez ajouter l'ID d'app et la signature d'app Chartboost de votre jeu (vous les trouverez ici). Pour commencer à envoyer des callbacks de session, activez le Transfert de sessions. Notez que le transfert de sessions doit être actif pour optimiser les performances des campagnes sur le réseau Chartboost. Pour activer les callbacks d'événement, saisissez Event Label pour chaque événement Purchase que vous souhaitez que Chartboost reçoive. Activez le bouton du module pour activer le Transfert des revenus.

Paramètres prédéfinis

Chartboost 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 Chartboost. Vous obtiendrez davantage d'informations sur l'association de paramètres de partenaires dans le fichier readme SDK spécifique au(x) SDK que vous utilisez. Voici une liste des paramètres définis acceptés par Chartboost :

Clé de paramètre> valeur

purchase> Il s'agit du nom d'événement. Saisissez « purchase » et laissez TOUS les autres champs vides.

Synchroniser les clics Chartboost

La configuration des callbacks de clic dans l'UI Chartboost n'utilise pas de macros ; il vous faut configurer une liste de paramètres dans votre dashboard Chartboost. La capture d'écran ci-dessous est extraite d'iOS. Vous pouvez consulter la configuration des callbacks de clic dans la documentation Chartboost.

Liste de tous les paramètres transférés à Chartboost

Chartboost demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :