Passer au contenu principal
Comme exploré précédemment, la DATA API de Kameleoon permet aux utilisateurs de récupérer et d’écrire des données sur les serveurs Kameleoon. Trois endpoints clés facilitent cela : Visit, Product Recommendation et Map. Dans certaines situations, des événements de conversion d’objectif survenus hors ligne, tels que des transactions en magasin ou par téléphone, doivent être envoyés à Kameleoon. L’endpoint Visit, décrit dans ce tutoriel, publie des données hors ligne pour des visiteurs individuels. Contrairement à l’endpoint MAP, qui offre une plus grande flexibilité dans la structure des données soumises, l’endpoint Visit ne permet que la soumission de points de données prédéfinis. Ceux-ci incluent les conversions, les événements et les événements de page vue, ainsi que plusieurs autres types de données. Ces informations aident à filtrer et analyser efficacement les résultats d’une expérience. Cet article traite des opérations suivantes :
  • Envoi de conversions d’objectifs hors ligne via l’endpoint POST/visit/events.
  • Vérification de la transmission des données d’objectifs hors ligne via l’endpoint GET/visit/visitor.
Pour transmettre des données de conversion hors ligne au serveur Kameleoon, envoyez une requête POST correctement formatée avec le siteCode et le visitorCode : 
https://eu-data.kameleoon.io/visit/events?siteCode=example_sitecode&visitorCode=example_visitor_code
Le domaine des scripts Kameleoon peut varier selon le projet. En fonction de la date de création, les projets sont hébergés sur kameleoon.eu ou kameleoon.io. Utilisez le domaine affiché dans les paramètres du projet dans l’application Kameleoon. Pour l’Amérique du Nord, utilisez na-data.kameleoon.io ou na-data.kameleoon.eu.
  • siteCode : un ID unique associé au projet d’expérience. Les instructions pour récupérer ce code sont disponibles à ce lien.
  • visitorCode : une chaîne unique attribuée à chaque utilisateur naviguant sur l’application. Elle assigne les utilisateurs aux expériences et variations tout en suivant leurs données pour le reporting. Pour Kameleoon Web Experimentation, le code visiteur est généré aléatoirement et attribué à chaque utilisateur. Pour Kameleoon Feature Experimentation, le Web SDK génère le code visiteur, ou un ID personnalisé peut être utilisé, en particulier pour les sites web nécessitant une connexion.
Les projets utilisant la réconciliation cross-device de Kameleoon peuvent utiliser le paramètre mappingIdentifier à la place du visitorCode. Lisez plus ici.
Cet endpoint prend en charge les conversions en masse pour plusieurs visitorCode. Pour ce faire, incluez chaque événement dans le corps de la requête.
Les paramètres requis pour le corps de la requête lors de l’envoi de données d’objectif incluent :
  • nonce : une chaîne aléatoire de 16 caractères hexadécimaux unique à chaque événement.
  • eventType : une chaîne spécifiant le type d’événement. Utilisez CONVERSION pour cet exemple.
  • goalID : l’ID unique de l’objectif. Cet article explique comment accéder aux objectifs et les gérer.
  • revenue : un paramètre flottant optionnel indiquant le revenu généré lors de la conversion.
Ces informations se traduisent par la requête cURL suivante : 
curl -X POST 'https://eu-data.kameleoon.io/visit/events?siteCode=f17c21u1ag&visitorCode=245fc&json=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \
-d '[{"nonce":"a2bb4d22083348ef","eventType":"CONVERSION","goalId":36151,"revenue":23.50}]'
Comme une requête réussie ne fournit pas de réponse objet, la section suivante montre comment vérifier le succès à l’aide de l’endpoint GET/visit/visitor.

​
Vérification des données de conversion d’objectif hors ligne

Utilisez l’endpoint GET pour vérifier le résultat de la requête POST. L’URL de la requête doit inclure :
  • siteCode : voir la section précédente pour les instructions sur la récupération de ce code.
  • visitorCode : le même code visiteur utilisé dans la section précédente.
  • maxNumberPreviousVisits : un entier représentant le nombre maximum de visites précédentes à renvoyer.
  • currentVisit : définissez sur true pour vous concentrer sur la visite en cours ; la valeur par défaut est false. (Remarque : ceci n’est disponible que pour Kameleoon Feature Experimentation.)
  • conversion : définissez sur true pour récupérer les événements de conversion pour l’utilisateur spécifié et les objectifs configurés dans le compte Kameleoon.
Si Feature Experimentation n’est pas actif, attendez que Kameleoon traite la visite, généralement après 30 minutes d’inactivité. Les données de conversion apparaissent alors dans la dernière visite précédente calculée.
Cela se traduit par la requête cURL suivante : 
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&maxNumberPreviousVisits=5&currentVisit=true&conversion=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \
Une requête GET réussie renvoie une réponse contenant les données envoyées dans la requête précédente, confirmant que la requête POST a réussi : 
{
  "previousVisits": [
    {
      "siteCode": "f17c21u1ag",
      "visitorCode": "245fc",
      "timeStarted": 1740447713028,
      "conversionEvents": [
        {
          "itp": false,
          "time": 1740447713028,
          "data": {
            "goalId": 361517,
            "revenue": 23.50,
            "negative": false,
            "metadata": {}
          }
        }
      ]
    }
  ]
}

​
Informations supplémentaires

Dans la plupart des cas, les conversions pour un objectif et un visiteur spécifiés sont utilisées dans les rapports d’expérience. Kameleoon associe les conversions aux expériences en fonction de plusieurs règles :
  • Conversions pendant des visites actives : si une conversion se produit alors que le visiteur est actif et ciblé par une expérience, Kameleoon associe la conversion à l’expérience pour cette visite.
  • Conversions après la fin des visites : si un visiteur a été précédemment inclus dans une expérience mais effectue ensuite un achat via un autre canal (par exemple, par téléphone ou en magasin), Kameleoon attribue cette conversion à l’expérience si elle se produit dans la fenêtre d’attribution définie (par défaut : sept jours). Kameleoon crée une nouvelle visite associée à la conversion dans ce scénario.
L’analyse des données au niveau du visiteur offre une vue complète des conversions, y compris celles survenant lors de visites non ciblées, à condition qu’une expérience ait précédemment ciblé le visiteur. Voir ce lien pour plus d’informations sur la façon dont Kameleoon compte les conversions.