Events courants
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)
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
Oui
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
user
Oui
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).
path
string
Non
/products/mothers
Partie chemin de l’URL de la page : location.pathname depuis l’API DOM.
Exemple
cact('trigger','page_view', {
page_type: 'product_list',
page_name: 'Best sellers',
user: {
id: '12356',
email:'[email protected]',
consent_categories: [1,3]
}
});val event = TCPageViewEvent("product_list")
event.pageName = "Best sellers"
serverside.execute(event)TCPageViewEvent event = new TCPageViewEvent("product_list")
event.pageName = "Best sellers";
serverside.execute(event);TCPageViewEvent *event = [[TCPageViewEvent alloc] init];
event.pageType = @"product_list";
event.pageName = @"Best sellers";
[TCS execute: event];
//ou vous pourriez également l’utiliser dans un constructeur, comme suit :
TCPageViewEvent *event = [[TCPageViewEvent alloc] initWithType: @"type"];let event = TCPageViewEvent(type: "product list")
event?.pageName = "Best sellers"
serverside?.execute(event)var event = TCPageViewEvent();
event.pageName = "event_page_name";
event.pageType = "event_page_type";
serverside.execute(event);{
"event_name": "page_view",
"page_type": "product_list",
"page_name": "Best sellers"
}login
Envoyez cet événement pour signifier qu’un utilisateur s’est connecté.
Paramètres
method
string
Non
La méthode utilisée pour se connecter.
user
Oui
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
cact('trigger', 'login', {
method: 'LinkedIn',
user: {
id: '12356',
email:'[email protected]',
consent_categories: [1,3]
}
});val event = TCLoginEvent()
event.method = "LinkedIn"
serverside.execute(event)TCLoginEvent event = new TCLoginEvent();
event.method = "LinkedIn";
serverside.execute(event);TCLoginEvent *event = [[TCLoginEvent alloc] init];
event.method = @"LinkedIn";
[TCS execute: event];let event = TCLoginEvent()
event.method = "linkedin"
serverside?.execute(event)var event = TCLoginEvent();
event.method = "LinkedIn";
serverside.execute(event);{
"event_name": "login",
"method": "LinkedIn"
}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
search_term
string
Oui
t-shirts
Le terme qui a été recherché.
user
Oui
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
cact('trigger','search', {
search_term: 't-shirts',
user: {
id: '12356',
email:'[email protected]',
consent_categories: [1,3]
}
});val event = TCSearchEvent("t-shirts")
serverside.execute(event)TCSearchEvent event = new TCSearchEvent("t-shirts");
serverside.execute(event);TCSearchEvent *event = [[TCSearchEvent alloc] init];
event.searchTerm = @"t-shirts";
[TCS execute: event];let event = TCSearchEvent(searchTerm: "t-shirts")
serverside.execute(event)var event = TCSearchEvent();
event.searchTerm = "t-shirts";
serverside.execute(event);{
"event_name": "search",
"search_term": "t-shirts"
}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
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
Oui
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
cact('trigger','select_content', {
content_type: 'product',
item_id: 'I_12345',
user: {
id: '12356',
email:'[email protected]',
consent_categories: [1,3]
}
});val event = TCSelectContentEvent()
event.contentType = "product"
serverside.execute(event)TCSelectContentEvent event = new TCSelectContentEvent();
event.contentType = "product";
serverside.execute(event);TCSelectContentEvent *event = [[TCSelectContentEvent alloc] init];
event.contentType = @"product";
event.itemID = @"I_12345";
[TCS execute: event];let event = TCSelectContentEvent()
event.contentType = "product"
event.itemID = "I_12345"
serverside?.execute(event)var event = TCSelectContentEvent();
event.contentType = "product";
event.itemId = "I_12345";
serverside.execute(event);{
"event_name": "select_content",
"content_type": "product",
"item_id": "I_12345"
}sign_up
Cet événement indique qu'un utilisateur s'est inscrit pour un compte.
Paramètres (obligatoires et recommandés)
method
string
Non
La méthode utilisée pour l'inscription.
user
Oui
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
cact('trigger','sign_up', {
method: 'email',
user: {
id: '12356',
email:'[email protected]',
consent_categories: [1,3]
}
});val event = TCSignUpEvent()
event.method = "email"
serverside.execute(event)TCSignUpEvent event = new TCSignUpEvent();
event.method = "email";
serverside.execute(event);TCSignUpEvent *event = [[TCSignUpEvent alloc] init];
event.method = @"email";
[TCS execute: event];let event = TCSignUpEvent()
event.method = "email"
serverside?.execute(event)var event = TCSignUpEvent();
event.method = "email";
serverside.execute(event);{
"event_name": "sign_up",
"method": "email"
}- 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)
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 (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*
+33612345678
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
fpour Femmempour 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
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('+33612345678')
phone_sha256: '42d573cfc315801d4cd8eddd5416b416a0bf298b9b9e12d6b07442c91db42bd8', // sha256('+33612345678')
}
}ℹ️ 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
Mis à jour
Ce contenu vous a-t-il été utile ?