Documentation Skalin

Collecte de l'identité des utilisateurs

Une fois par session au minimum, il faut transmettre des informations d'identification de l'utilisateur connecté. Pour ce faire, il y a deux données utilisateurs pouvant être utilisées :

  • l'email de l'utilisateur connecté
  • votre identifiant interne utilisateur s'il a été communiqué dans la propriété refId des contacts

Note

Identifiant interne utilisateur correspond à la propriété refId (champ Contact ID de l'interface d'édition du contact)

# Utilisation de l'email utilisateur

Le code ci-dessous permet de collecter un évènement d'identification utilisateur :

curl -G --location \
--request POST 'https://collect.skalin.io/hit' \
--data-urlencode 'rec=1' \
--data-urlencode 'action=ui' \
--data-urlencode 'client_id={{ClientId}}' \
--data-urlencode 'customer_id={{CustomerId}}' \
--data-urlencode 'event_id={{EventId}}' \
--data-urlencode 'visitor_id={{VisitorId}}' \
--data-urlencode 'visit_id={{VisitId}}' \
--data-urlencode 'localtime={{LocalTime}}' \
--data-urlencode 'identity={"email":"{{UserEmail}}"}' \
--data-urlencode 'url={{Url}}' \
--data-urlencode 'cip={{Cip}}'

Avec NodeJS et la librairie axios (opens new window)

axios({
  method: 'POST',
  url: 'https://collect.skalin.io/hit',
  headers: {
    'Cache-Control': 'no-cache'
  },
  params: {
    rec: 1,
    action: 'ui',
    client_id: '{{ClientId}}',
    customer_id: '{{CustomerId}}',
    event_id: '{{EventId}}',
    visitor_id: '{{VisitorId}}',
    visit_id: '{{VisitId}}',
    localtime: '{{LocalTime}}',
    identity: {"email":"{{UserEmail}}"},
    url: '{{Url}}',
    ts: '{{ts}}',
    cip: '{{Cip}}'
  }
});
ClientId

votre identifiant client qui vous a été fourni par Skalin ou est disponible dans la section Paramétrage > Général

CustomerId (facultatif) identifiant du client ou nom de domaine du client (le CustomerId n’est utile que si un même contact peut de connecter à plusieurs entités avec le même identifiant)
EventId (facultatif car auto-généré) identifiant unique de l'événement de 16 caractères. Permet de gérer la dé-duplication (Le dernier transmit sera conservé).
VisitorId identifiant unique du contact / visiteur. uid de 16 caractères
VisitId identifiant unique de la visite ou de la session. uid de 16 caractères (permet de calculer le nombre de visites. Si VisitId n’est pas rempli ou différent à chaque appel, chaque appel sera comptabilisé comme une nouvelle visite).
LocalTime (facultatif) heure:minutes:secondes dans la timezone de l’utilisateur (`08:00:05`)
UserEmail Email de l'utilisateur connecté déjà référencé dans Skalin
Url (facultatif) Url de la fonctionnalité sur votre plateforme
Cip (facultatif) Ip de l'utilisateur
ts (facultatif) timespan de l'évènement au format YYYY-MM-DDTHH:mm:ss (Si non défini, le timespan est initialisé avec l'heure du serveur)

# Utilisation de votre identifiant utilisateur

Le code ci-dessous permet de collecter un évènement d'identification utilisateur :

curl -G --location \
--request POST 'https://collect.skalin.io/hit' \
--data-urlencode 'rec=1' \
--data-urlencode 'action=ui' \
--data-urlencode 'client_id={{ClientId}}' \
--data-urlencode 'customer_id={{CustomerId}}' \
--data-urlencode 'event_id={{EventId}}' \
--data-urlencode 'visitor_id={{VisitorId}}' \
--data-urlencode 'visit_id={{VisitId}}' \
--data-urlencode 'localtime={{LocalTime}}' \
--data-urlencode 'identity={"id":"{{UserId}}"}' \
--data-urlencode 'url={{Url}}' \
--data-urlencode 'cip={{Cip}}'

Avec NodeJS et la librairie axios (opens new window)

axios({
  method: 'POST',
  url: 'https://collect.skalin.io/hit',
  headers: {
    'Cache-Control': 'no-cache'
  },
  params: {
    rec: 1,
    action: 'ui',
    client_id: '{{ClientId}}',
    customer_id: '{{CustomerId}}',
    event_id: '{{EventId}}',
    visitor_id: '{{VisitorId}}',
    visit_id: '{{VisitId}}',
    localtime: '{{LocalTime}}',
    identity: {"id":"{{UserId}}"},
    url: '{{Url}}',
    cip: '{{Cip}}'
  }
});
ClientId

votre identifiant client qui vous a été fourni par Skalin ou est disponible dans la section Paramétrage > Général

CustomerId (facultatif) identifiant du client ou nom de domaine du client (le CustomerId n’est utile que si un même contact peut de connecter à plusieurs entités avec le même identifiant)
EventId (facultatif car auto-généré) identifiant unique de l'événement de 16 caractères. Permet de gérer la dé-duplication (Le dernier transmit sera conservé).
VisitorId identifiant unique du contact / visiteur. uid de 16 caractères
VisitId identifiant unique de la visite ou de la session. uid de 16 caractères (permet de calculer le nombre de visites. Si VisitId n’est pas rempli ou différent à chaque appel, chaque appel sera comptabilisé comme une nouvelle visite).
LocalTime (facultatif) heure:minutes:secondes dans la timezone de l’utilisateur (`08:00:05`)
UserId Votre identifiant utilisateur déjà référencé dans Skalin
Url (facultatif) Url de la fonctionnalité sur votre plateforme
Cip (facultatif) Ip de l'utilisateur

← Collecte des fonctionnalités utilisées →