Configurer des callbacks de serveur

Vous pouvez configurer des callbacks de serveur pour recevoir des ID publicitaires, des détails d'attribution, des données d'application et, plus directement sur vos serveurs, des données brutes en temps réel.

Avant de commencer

Voici ce que vous devez savoir avant de commencer.

Prérequis

• Autorisations Administrateur, Éditeur ou Éditeur personnalisé.
• Vous devez disposer de votre propre solution BI ou entrepôt de données pour recevoir les requêtes de callback. Confirmez que votre serveur peut recevoir l'ensemble de vos paramètres et stocker toutes les données entrantes. Le nombre d'utilisateurs de votre application influe sur la vitesse requise pour vos serveurs. Si vous suivez des événements à occurrence unique, comme des inscriptions, vous recevrez un callback pour chaque utilisateur converti. Les callbacks des événements de conversion n'ont généralement pas un très fort impact sur la bande passante des serveurs.
• Pour vous assurer de recevoir uniquement des données d'Adjust, autorisez les adresses IP de nos serveurs.

Types de callback

Vous pouvez configurer des callbacks pour les déclencheurs suivants :

Callbacks globaux

Un callback global est un callback principal pour chaque activité mesurée par Adjust (par exemple, clics, installations, sessions, etc.). Il s'agit de la façon la plus rapide d'obtenir les mêmes points de données pour chaque activité mesurée par Adjust, car il n'existe qu'une seule URL (au lieu de plusieurs).

Callbacks d'activités simples

Un callback d'activité unique est un callback pour une activité spécifique (par exemple, clics). C'est une excellente option si vous avez uniquement besoin de données pour cette activité spécifique. Dans certains cas, le callback global peut générer un grand nombre de données, en particulier des impressions et des clics. Si vous souhaitez réduire la quantité de données qu'Adjust envoie à votre système BI, configurez des callbacks d'activité unique.

Plusieurs callbacks pour la même activité

Adjust peut envoyer un callback d'activité unique à autant de endpoints que vous le souhaitez. Séparez simplement chaque URL avec un caractère d'espacement ( ).

Configurer des callbacks de serveur

Vous pouvez créer des callbacks de serveur à l'aide de la configuration guidée ou de la configuration classique. Adjust vous conseille d'utiliser la configuration guidée pour créer des URL de callback.

Pour savoir quels espaces réservés utiliser pour un déclencheur, consultez notre guide des espaces réservés conseillés.

Configuration assistée

1. Accédez à la configuration des callbacks de serveur depuis la fiche de votre application ou dans l'onglet Gestion des données de la configuration de votre application.

   • (Autorisations Administrateur, Éditeur ou Éditeur personnalisé uniquement.) Pour configurer un callback de serveur à partir de la fiche de l'application, sous AppView , sélectionnez Toutes les apps . Trouvez votre application et sélectionnez Callbacks de serveur .
   • Pour configurer un callback de serveur à partir de l'onglet Gestion des données de la configuration de votre application, sous AppView , sélectionnez Toutes les apps . Sélectionnez votre application, puis l'onglet Gestion des données .

2. Sous Callbacks de serveur , sélectionnez Ajouter un callback > Configuration guidée .

3. Dans la liste Déclencheur de callback , sélectionnez l'activité ou l'événement devant déclencher le callback.

4. Dans le champ Endpoint de serveur , saisissez l'URL de endpoint où recevoir vos données.

5. (Facultatif) Sélectionnez Ajouter une condition pour ajouter une condition combinée à des espaces réservés et des valeurs. Ensuite, le callback se déclenche uniquement si la condition est remplie.

6. Dans le champ Méthode de requête , indiquez si la callback doit utiliser GET ou POST. La valeur par défaut est GET.

   • Lorsque vous sélectionnez POST, vous pouvez indiquer des paires clé-valeur dans le corps de la requête, au format key=value. Adjust encode le corps et l'envoie sous la forme d'un objet JSON plat.

7. Sélectionnez Ajouter un espace réservé pour inclure dynamiquement les données utilisateur ou d'engagement dans votre callback. Vous pouvez ajouter plusieurs espaces réservés à cette étape.

8. Sélectionnez Créer une URL de callback pour générer le callback codé.

Configuration classique

Lorsque vous utilisez la configuration classique, vous pouvez modifier directement le chaîne de callback dans son intégralité. Le système reconnaît les deux formats, GET et POST :

• <method>,<conditions>,<url>[,<body>]
• Les corps POST utilisent key1=value1&key2=value2 et Adjust les convertir en JSON plat.

Vous pouvez indiquer plusieurs callbacks, en les séparant par une espace. La méthode de requête par défaut est GET, sauf si vous spécifiez explicitement POST.

Gérer vos callbacks

Lorsque vous créez votre URL de callback, vous pouvez l'afficher sur la page d'aperçu Callbacks de serveur . Vous pouvez alors réaliser les actions suivantes sur votre callback :

• Sélectionnez (icône de copier) pour l'URL de callback.
• Sélectionnez (icône de duplication) pour dupliquer le callback et ouvrir la configuration classique.
• Sélectionnez (icône de suppression) pour supprimer le callback.
• Sélectionnez (icône d'édition) pour modifier l'URL de callback à l'aide de la configuration classique.