Passer au contenu principal
L’intégration Amplitude Event Streaming envoie automatiquement des événements à votre compte Amplitude chaque fois que des visiteurs sont exposés à une expérience Kameleoon. Cette intégration permet d’enrichir l’analytique dans Amplitude en fournissant des informations sur l’exposition aux expériences afin de mieux comprendre le comportement et l’engagement des utilisateurs.
Cette intégration utilise le dispatcher d’événements de Kameleoon pour envoyer des événements côté serveur à votre compte Amplitude par lots via le point de terminaison /import de l’API HTTP Amplitude.

Bénéfices clés

  • Insights comportementaux précis : L’intégration envoie des événements spécifiques aux outils tiers pour les visiteurs exposés à des web experiments et à des feature flags sur des projets basés sur SDK, tels que des applications. Ce suivi détaillé permet d’avoir une vue plus claire de la façon dont les différentes variations influencent les actions des utilisateurs. Par exemple, vous pouvez observer quelle variation génère le plus de clics, de conversions ou d’autres résultats souhaités, ce qui vous aide à déterminer l’approche la plus efficace.
  • Prise de décision en temps réel : L’intégration fournit des données en temps réel, ce qui permet une prise de décision à la volée. Avec des insights à jour sur les expériences en cours, vous pouvez rapidement ajuster vos stratégies si une variation ne fonctionne pas comme prévu.
  • Mise en place sans effort : Activez les intégrations tierces directement depuis l’application Kameleoon, sans avoir besoin de code personnalisé ni de modifications du SDK.

Considérations

  • Délai de livraison des événements : Les serveurs Kameleoon dispatchent les événements avec un délai minimum de 30 minutes.

Prérequis

Pour configurer cette intégration, vous avez besoin des informations suivantes :
  • Clé API Amplitude : La clé API unique de l’un de vos projets Amplitude (comme documenté ici)
  • Résidence du serveur : Indiquez si votre compte Amplitude est configuré pour la région d’hébergement standard ou l’hébergement UE.
  • Plan Amplitude : Sélectionnez le type de plan client que vous avez souscrit auprès d’Amplitude.
Le SDK Kameleoon doit également être installé sur votre projet côté serveur.

Configuration

Cette intégration peut être activée pour Web Experimentation et Feature Experimentation.

Pour les web experiments

Activez l’intégration depuis la page Intégrations.
Ajoutez l’intégration lors de la finalisation de votre web experiment.

Pour les feature experiments

Configurez l’intégration dans l’environnement du feature flag, dans la section intégrations. Activez-la pour les environnements où vous souhaitez qu’elle soit active.
Une fois l’intégration activée et votre expérience en ligne, Kameleoon enverra automatiquement les événements d’expérience à Amplitude chaque fois qu’un visiteur y est exposé. Chaque événement inclut des détails clés, tels que :
  • Le code visiteur Kameleoon (envoyé à la fois comme propriété personnalisée et comme valeur par défaut du champ device_id)
  • L’horodatage de l’exposition
  • L’identifiant d’expérience Kameleoon
  • L’identifiant de variation Kameleoon

Exemple de payload d’événement

Kameleoon envoie des événements à Amplitude au format suivant :
{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "rjfloel55ug9fg" // also Kameleoon visitor code
    "time": 1730194985000
}
Par défaut, user_id contiendra le code visiteur Kameleoon du visiteur. Si vous avez configuré la réconciliation d’historique cross-device de Kameleoon, l’identifiant placé dans la donnée personnalisée de réconciliation cross-device sera utilisé à la place du code visiteur.

Personnalisation du payload pour user_id, device_id et session_id

Par défaut, Kameleoon envoie des payloads où les utilisateurs sont identifiés par le champ device_id, qui contient le code visiteur Kameleoon. Cependant, vous pouvez personnaliser le contenu de ces payloads en créant et en renseignant des données personnalisées dans Kameleoon. Vous pouvez définir l’une ou toutes les données personnalisées suivantes :
  • Identification cross-device (user_id) :
    • Si vous créez une donnée personnalisée et activez l’option « utiliser pour l’identification cross-device », sa valeur — lorsqu’elle est présente lors d’une visite — sera envoyée dans le champ user_id d’Amplitude. Cette donnée personnalisée est idéale pour les identifiants de type « connecté » associés à vos utilisateurs.
  • Identifiant d’appareil (device_id) :
    • Si vous créez une donnée personnalisée appelée amplitude_device_id, sa valeur — lorsqu’elle est présente — remplacera le code visiteur Kameleoon dans le champ device_id du payload. Cette donnée personnalisée est recommandée pour les identifiants « anonymes » liés aux appareils des utilisateurs. Que cette donnée personnalisée soit définie ou non, le code visiteur Kameleoon d’origine reste inclus dans vos payloads sous la propriété personnalisée KAMELEOON_VISITOR_CODE.
  • Identifiant de session (session_id) :
    • Si vous créez une donnée personnalisée appelée amplitude_session_id, sa valeur — lorsqu’elle est présente — sera envoyée dans le champ session_id d’Amplitude. Nous recommandons de définir cette valeur pour qu’elle corresponde à l’ID de session Amplitude.

Exemple de payload d’événement

{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "dfkslj47h9"
    "user_id": "xf54dd2thdd5",
    "session_id": 1396381378123
    "time": 1730194985000
}
Veuillez noter que toute donnée personnalisée spécifique à votre activité, généralement incluse dans vos événements Amplitude, ne sera pas présente dans les événements envoyés par Kameleoon depuis le serveur. Si vous avez besoin d’enrichir le payload avec des données qui ne sont pas suivies nativement par Kameleoon et que vous disposez d’un compte Kameleoon, vous pouvez soumettre une demande de fonctionnalité