Événements communs

page_view

Le page_view L'appel vous permet d'enregistrer chaque fois qu'un utilisateur consulte une page de votre site web, ainsi que toutes les propriétés optionnelles 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 (p. ex. Politique de confidentialité)

É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: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (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

Objet <User>

Oui

{ id: '12345', email: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (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

cact('trigger','page_view', {
  page_type: 'product_list',
  page_name: 'Meilleures ventes',
  user: {
    id: '12356',
    email:'toto@domain.fr',
    consent_categories: [1,3]
  }
});

val event = TCPageViewEvent("product_list")
event.pageName = "Meilleures ventes"
serverside.execute(event)

TCPageViewEvent event = new TCPageViewEvent("product_list")
event.pageName = "Meilleures ventes";
serverside.execute(event);

TCPageViewEvent *event = [[TCPageViewEvent alloc] init];
event.pageType = @"product_list";
event.pageName = @"Meilleures ventes";
[TCS execute: event];

//ou vous pouvez aussi l'utiliser dans un constructeur, comme suit :
TCPageViewEvent *event = [[TCPageViewEvent alloc] initWithType: @"type"];

let event = TCPageViewEvent(type: "product list")
	event?.pageName = "Meilleures ventes"
	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": "Meilleures ventes"   
}

Envoyez cet événement pour indiquer qu'un utilisateur s'est connecté.

Paramètres

Nom

Type

Obligatoire

Exemple

Description

method

string

Non

La méthode utilisée pour se connecter.

user

Object<User>

Oui

{ id: '12345', email: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (id, email).

Exemple

cact('trigger', 'login', {
  method: 'LinkedIn',
  user: {
    id: '12356',
    email:'toto@domain.fr',
    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

Nom

Type

Obligatoire

Valeur d'exemple

Description

search_term

string

Oui

t-shirts

Le terme recherché.

user

Object<User>

Oui

{ id: '12345', email: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (id, email).

Exemple

cact('trigger','search', {
  search_term: 't-shirts',
  user: {
    id: '12356',
    email:'toto@domain.fr',
    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 indique qu'un utilisateur a sélectionné un contenu d'un certain type. Cet événement peut vous aider à identifier le contenu populaire et les catégories de contenu 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 sélectionné.

user

Object<User>

Oui

{ id: '12345', email: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (id, email).

Exemple

cact('trigger','select_content', {
  content_type: 'product',
  item_id: 'I_12345',
  user: {
    id: '12356',
    email:'toto@domain.fr',
    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 a créé un compte.

Paramètres (requis et recommandé)

Nom

Type

Obligatoire

Exemple

Description

method

string

Non

Facebook

La méthode utilisée pour l'inscription.

user

Object<User>

Oui

{ id: '12345', email: 'toto@domain.fr',

consent_categories: [1,3]

}

consent_categories est la liste des consentements de l’utilisateur. Elle est automatiquement remplie à partir des sources web si vous utilisez Commanders Act CMP.

Vous devez également ajouter toutes les propriétés de l’utilisateur dans cet objet user, en particulier la clé de rapprochement (id, email).

Exemple

cact('trigger','sign_up', {
  method: 'email',
  user: {
    id: '12356',
    email:'toto@domain.fr',
    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 COMMUNS -

Utilisateur

Lorsque vous envoyez un événement, il doit contenir suffisamment d'informations pour identifier l'utilisateur qui l'a émis. Nous pouvons relier les événements entre eux à l'aide de cookies. Mais les partenaires de destination ont besoin d'identifiants précis pour agir.

id et email sont généralement les paramètres les plus utiles. Cependant, certains partenaires de destination utilisent aussi 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 (requis et recommandé)

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 pour le traitement interne.

email

string

Oui*

john.doe@example.com

E-mail (valeur brute)

(*) requis pour de nombreuses destinations et pour le traitement interne. Non requis si email_sha256 est fourni

email_md5

string

Non*

8eb1b52... (taille 32)

E-mail, haché à l'aide de l'algorithme MD5. Non requis si email est fourni (voir ci-dessous)

email_sha256

string

Non*

836f82d... (taille 64)

E-mail, haché à l'aide de l'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 de famille

gender

string

Non

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

Tableau

Oui

[1,2,3]

Catégories de consentement de l'utilisateur. Nécessaires pour autoriser le data sharing avec les partenaires de destination. Il est automatiquement renseigné à partir des 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. Elle est soit indisponible, soit restreinte.

Il peut donc être possible d'envoyer la hachée valeurs. Nous acceptons actuellement 2 algorithmes : md5 et sha256.

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

Exemple :

{
  user: {
    email_md5: '8eb1b522f60d11fa897de1dc6351b7e8',                                      // md5('john.doe@example.com')
    email_sha256: '836f82db99121b3481011f16b49dfa5fbc714a0d1b1b9f784a1ebbbf5b39577f',   // sha256('john.doe@example.com')
    phone_md5: '60dd761f55cb17f0532c9fb1679e8ddd',                                      // md5('+33612345678')
    phone_sha256: '42d573cfc315801d4cd8eddd5416b416a0bf298b9b9e12d6b07442c91db42bd8',   // sha256('+33612345678')
  }
}

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

Inutile d'envoyer les deux en clair et hachée valeurs :

si vous envoyez en clair valeur, les hachée valeurs ne sont pas nécessaires &#xNAN;Nous pouvons générer hachée des valeurs côté serveur à l'aide de en clair valeur
si vous n'envoyez pas en clair valeur, vous devriez alors renseigner autant de hachée valeurs que possible &#xNAN;Les partenaires requièrent 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 la valeur exacte hachée valeur

PrécédentRéférence des événements

SuivantÉvénements e-commerce

Mis à jour il y a 2 ans

Ce contenu vous a-t-il été utile ?