Événements communs

page_view

La page_view vous permet d’enregistrer chaque fois qu’un utilisateur voit une page de votre site web, ainsi que toute propriété optionnelle concernant la page.

Paramètres (obligatoires et recommandés)

Nom	Type	Obligatoire	Valeur d’exemple	Description
page_type	string	Oui	product_list	Catégorie de page. Types prédéfinis recommandés : home landing product_list product content_list content search funnel success funnel_confirmation account cart legal (par ex. Privacy Policy) Équivalent à tc_vars.env_template
page_name	string	Non	Suggestion pour la Fête des Mères	Nom de la page.
user	Object<User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).
type (obsolète)	string	Non	product_list	Catégorie de page.

Paramètres ajoutés automatiquement par l’API cact pour les sources web

Nom	Type	Obligatoire	Valeur d’exemple	Description
user	Object <User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).
title	string	Non	Products - MySite.com	Titre de la page :document.title depuis l’API DOM
url	string	Non	http://www.mysite.com	URL complète de la page. Équivalent àlocation.href depuis l’API DOM.
path	string	Non	/products/mothers	Partie chemin de l’URL de la page : location.pathname depuis l’API DOM.
referrer	string	Non	http://www.example.com	URL complète de la page précédente : document.referrer depuis l’API DOM.

Exemple

JavaScript

cact('trigger','page_view', {
  page_type: 'product_list',
  page_name: 'Best sellers',
  user: {
    id: '12356',
    email:'[email protected]',
    consent_categories: [1,3]
  }
});

Kotlin (Android)

Java (Android)

Objective-C (iOS)

Swift (iOS)

Dart (Flutter)

json

login

Envoyez cet événement pour signifier qu’un utilisateur s’est connecté.

Paramètres

Nom	Type	Obligatoire	Exemple	Description
method	string	Non	LinkedIn	La méthode utilisée pour se connecter.
user	Object<User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).

Exemple

JavaScript

cact('trigger', 'login', {
  method: 'LinkedIn',
  user: {
    id: '12356',
    email:'[email protected]',
    consent_categories: [1,3]
  }
});

Kotlin (Android)

Java (Android)

Objective-C (iOS)

Swift (iOS)

Dart (Flutter)

json

search

Utilisez cet événement pour contextualiser les opérations de recherche. Cet événement peut vous aider à identifier le contenu le plus populaire dans votre application.

Paramètres

Nom	Type	Obligatoire	Valeur d’exemple	Description
search_term	string	Oui	t-shirts	Le terme qui a été recherché.
user	Object<User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).

Exemple

JavaScript

cact('trigger','search', {
  search_term: 't-shirts',
  user: {
    id: '12356',
    email:'[email protected]',
    consent_categories: [1,3]
  }
});

Kotlin (Android)

Java (Android)

Objective-C (iOS)

Swift (iOS)

Dart (Flutter)

json

select_content

Cet événement signifie qu'un utilisateur a sélectionné du contenu d'un certain type. Cet événement peut vous aider à identifier le contenu et les catégories de contenu populaires dans votre application ou à cliquer sur une promotion interne.

Paramètres

Nom	Type	Obligatoire	Valeur d’exemple	Description
content_type	string	Non	product	Le type de contenu sélectionné.
item_id	string	Non	I_12345	Un identifiant pour l'article qui a été sélectionné.
user	Object<User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).

Exemple

JavaScript

cact('trigger','select_content', {
  content_type: 'product',
  item_id: 'I_12345',
  user: {
    id: '12356',
    email:'[email protected]',
    consent_categories: [1,3]
  }
});

Kotlin (Android)

Java (Android)

Objective-C (iOS)

Swift (iOS)

Dart (Flutter)

json

sign_up

Cet événement indique qu'un utilisateur s'est inscrit pour un compte.

Paramètres (obligatoires et recommandés)

Nom	Type	Obligatoire	Exemple	Description
method	string	Non	Facebook	La méthode utilisée pour l'inscription.
user	Object<User>	Oui	{ id: '12345', email: '[email protected]', consent_categories: [1,3] }	consent_categories est la liste des consentements de l’utilisateur. Elle est remplie automatiquement depuis les sources web si vous utilisez Commanders Act CMP. Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, notamment la clé de réconciliation (id, email).

Exemple

Javascript

cact('trigger','sign_up', {
  method: 'email',
  user: {
    id: '12356',
    email:'[email protected]',
    consent_categories: [1,3]
  }
});

Kotlin (Android)

Java (Android)

iOS

Swift

Flutter

json

- SCHÉMAS COURANTS -

Utilisateur

Lorsque vous envoyez un événement, il doit contenir suffisamment d'informations pour identifier quel utilisateur l'a émis. Nous pouvons relier les événements entre eux en utilisant des cookies. Mais les partenaires de destination exigent des identifiants précis pour prendre des actions.

id et email sont généralement les paramètres les plus utiles. Bien que certains partenaires de destination utilisent également firstname, lastname, birthdate, city, ...

Vous n'aurez pas toujours tous ces paramètres. Mais il est recommandé de les envoyer dès que possible pendant la navigation de l'utilisateur.

Paramètres (obligatoires et recommandés)

Nom	Type	Obligatoire	Valeur d’exemple	Description
id	string	Non*	845454	Identifiant principal de l'utilisateur (ex. id CRM) (*) requis pour de nombreuses destinations et le traitement interne.
email	string	Oui*	[email protected]	Email (valeur en clair) (*) requis pour de nombreuses destinations et le traitement interne. Non requis si email_sha256 est fourni
email_md5	string	Non*	8eb1b52... (taille 32)	Email, haché en utilisant algorithme MD5. Non requis si email est fourni (voir ci-dessous)
email_sha256	string	Non*	836f82d... (taille 64)	Email, haché en utilisant algorithme SHA-256. Non requis si email est fourni (voir ci-dessous)
phone	string	Non*	[phone]	Numéro de téléphone, E.164 format (*) requis pour certaines destinations.
firstname	string	Non	John	Prénom
lastname	string	Non	Doe	Nom
gender	string	Non	m	Genre f pour Femme m pour Homme
birthdate	string	Non	1970-01-01	Date de naissance, YYYY-MM-DD format
city	string	Non	Boston	Ville
state	string	Non	Massachusetts	État
zipcode	string	Non	02108	Code postal
country	string	Non	USA	Code pays, ISO 3166-1 2-lettres ou 3-lettres formats
consent_categories	Array	Oui	[1,2,3]	Catégories de consentement de l'utilisateur. Nécessaire pour autoriser le partage de données avec les partenaires de destination. Il est automatiquement rempli depuis les sources web si vous utilisez Commanders Act CMP.

À propos du hachage

Dans certains cas, vous ne pourrez pas envoyer un paramètre en clair valeur. Il est soit indisponible soit restreint.

Ainsi il peut être possible d'envoyer les valeurs hachées. Nous acceptons actuellement 2 algorithmes : md5 et sha256.

Chaque user.<property> peut être envoyé au format haché avec le suffixe d'algorithme : _md5 ou _sha256 (underscore suivi du nom de l'algorithme en minuscules)

Exemple :

{
  user: {
    email_md5: '8eb1b522f60d11fa897de1dc6351b7e8',                                      // md5('[email protected]')
    email_sha256: '836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f',   // sha256('[email protected]')
    phone_md5: '60dd761f55cb17f0532c9fb1679e8ddd',                                      // md5('[phone]')
    phone_sha256: '42d573cfc315801d4cd8eddd5416b416a0bf298b9b9e12d6b07442c91db42bd8',   // sha256('[phone]')
  }
}

ℹ️ nous ne supportons que l'encodage hexadécimal (base16) &#xNAN;(c.-à-d. : valeurs hachées. les valeurs sont portées par des chaînes avec des caractères [0-9a-f]) D'autres encodages ne sont pas encore pris en charge

Pas besoin d'envoyer les deux en clair et valeurs hachées. valeurs :

• si vous envoyez en clair valeur, les valeurs hachées. valeurs ne sont pas nécessaires &#xNAN;Nous pouvons générer valeurs hachées. valeurs côté serveur en utilisant en clair value

• si vous n'envoyez pas en clair valeur, alors vous devez remplir autant de valeurs hachées. valeurs que possible &#xNAN;Les partenaires exigent différents algorithmes de hachage et sans en clair valeur, nous ne pouvons générer aucun hachage. C'est pourquoi nous avons besoin de l'exact valeurs hachées. value