Nous mettons à jour notre documentation continuellement, mais certaines publications peuvent ne pas encore être disponibles dans votre langue. Pour accéder aux informations les plus récentes, utilisez la version en anglais.

Configurer l'intégration Segment indépendante

Segment est un partenaire de Adjust Analytics. Dans le cadre de la configuration d'intégration indépendante, le SDK Adjust et le SDK Segment fonctionnent indépendamment l'un de l'autre. Avec cette solution, il vous sera plus facile d'implémenter des fonctionnalités supplémentaires du SDK Adjust telles que les deeplinks.

Mode de fonctionnement

Voici comment l'activité utilisateur est enregistrée lorsque le SDK Adjust et le SDK Segment fonctionnent de façon indépendante :

  1. L'application lance directement le SDK Adjust.
  2. Le SDK Adjust enregistre automatiquement les installations, les sessions et les réattributions.
  3. Le SDK Segment enregistre les événements et le serveur Segment les envoie au serveur Adjust en tant qu'événements S2S en Cloud Mode.
  4. Le serveur Adjust envoie un callback d'installation au serveur Segment. Segment enregistre le callback d'installation en tant qu'événement track appelé Install Attributed.

Configurer l'intégration

Pour configurer la solution de SDK Adjust indépendant avec Segment, suivez les étapes suivantes.

1. Configurez les SDK Adjust et Segment

Pour plus d'instructions sur la configuration du SDK Adjust et du SDK Segment, consultez les guides de développement relatifs à votre plateforme :

📖 iOS / Android

2. Activez Segment dans Adjust

Pour configurer Segment dans Adjust, suivez ces instructions.

Consultez la documentation Segment pour déterminer la WRITE KEY.

Segment recevra des callbacks pour les activités d'installation.

3. Créez des destinations Adjust et ajoutez des app tokens dans Segment

Pour ajouter Adjust comme destination dans le dashboard Segment, procédez comme suit.

  1. Sélectionnez Destinations > Add Destination .
  2. Recherchez Adjust.
  3. Ajoutez Adjust comme destination de votre source.

Pour ajouter vos app tokens Adjust à la destination Adjust, suivez les étapes suivantes.

  1. Sélectionnez Destinations et choisissez votre destination Adjust.
  2. Sélectionnez App Token et saisissez votre app token dans AppView.
  3. Cliquez sur Enregistrer .

Référez-vous au tableau ci-dessous pour savoir comment relier la/les destination(s) Adjust à votre/vos source(s), en fonction de la configuration de votre application dans Adjust.

SDK Segment utiliséConfiguration de l'app dans AdjustDestination Adjust dans le dashboard Segment
SDK Segment Android et SDK Segment iOSApplication multiplateforme (même app token pour les apps iOS et Android) 
  1. Ajoutez une destination Adjust à la source iOS et une destination Adjust à la source Android. 
  2. Configurez les deux destinations avec le même token Adjust.
SDK Segment Android et/ou SDK Segment iOSApplications iOS et/ou Android avec différents app tokens
  1. Ajoutez une destination Adjust à chaque source, si applicable.
  2. Configurez chaque destination avec son token Adjust correspondant.
SDK Segment React NativeApplication multiplateforme (même app token pour les apps iOS et Android)
  1. Ajoutez une destination Adjust à la source React Native.
  2. Configurez la destination avec l'app token.
SDK Segment React NativeApplications iOS et Android avec différents app tokens 
  1. Ajoutez une destination Adjust pour iOS ainsi qu'une destination Adjust pour Android à la source React Native.
  2. Configurez chaque destination avec son app token correspondant.

4. Créez des tokens d'évènement dans Adjust

À présent, consultez vos évènements dans le dashboard Segment et déterminez ceux que vous souhaitez lier à Adjust.

Pour chaque appel track de Segment que vous souhaitez associer à Adjust, créez un token d'événement Adjust correspondant et copiez le token d'événement.

Avertissement:

Cette solution ne prend pas en charge les paramètres partenaires. Toutefois les paramètres partenaires de session sont requis pour transmettre certaines valeurs au SDK Adjust. Consultez la documentation de développement adaptée à votre plateforme :


📖 iOS / Android

Si vous devez envoyer des évènements avec des paramètres personnalisés sur vos réseaux, par exemple afin de prendre en charge le reciblage dynamique, configurez ces événements séparément dans le SDK Segment et dans le SDK Adjust. Dans le dashboard Segment, ne liez pas ces événements à la destination Adjust.

5. Saisissez des tokens d'évènement Adjust dans Segment

  1. Dans le dashboard Segment, sélectionnez Destinations et choisissez votre destination Adjust.
  2. Sélectionnez Map Your Events to Custom Adjust Event Tokens et saisissez les tokens d'événement que vous avez copiés depuis le dashboard Adjust.
    Chaque nom d'événement track de Segment doit présenter une relation 1:1 avec un token d'événement Adjust. N'associez pas les appels track de Segment à différents noms du même token d'événement Adjust.
  3. Cliquez sur Enregistrer .

6. Configurez des paramètres supplémentaires dans Segment

  1. Dans le dashboard Segment, sélectionnez Destinations et choisissez votre destination Adjust.

  2. Trouvez le paramètre Track Attribution Data et activez-le .

  3. Trouvez le paramètre Send Event Creation Time et choisissez l'option adéquate :

    • ACTIVÉ : Segment transmet la date de création created_at_unix aux événements S2S. Cependant, Segment ne garantit pas que les événements soient transmis dans l'ordre chronologique des paramètres created_at_unix ; certains événements seront donc probablement rejetés par le serveur Adjust.
    • DÉSACTIVÉ : Segment ne transmet pas de paramètre created_at aux événements S2S. Le serveur Adjust ne rejette pas d'événement pour des raisons chronologiques. À la place, il définit en interne un horodatage created_at similaire à l'horodatage received_at. Cela signifie que l'horodatage created_at peut être différent du moment où l'appareil a réellement déclenché l'événement dans le SDK Segment.

  4. Les paramètres Adjust se situent en haut de l'écran. Activez l'option pour mettre en place la destination.

Lorsque vous êtes prêt à lancer l'intégration en production, trouvez le paramètre Send to Production Environment on Adjust et activez-le .

A screenshot from the Segment dashboard of how to configure your Adjust settings.

Paramètres transférés à Segment

Voici la liste des paramètres transmis par les callbacks de Adjust à Segment :

Espace réservéInformations
[anonymous_id]La valeur « anonymous_id » de Segment
{adgroup_name}Nom de l'adgroup, tel que récupéré à partir du lien
{campaign_name}Nom de la campagne, tel que récupéré à partir du lien
{creative_name}Nom du créatif, tel que récupéré à partir du lien
{network_name}Nom du réseau, tel que récupéré à partir du lien
{tracker_name}Nom actuel du lien