Événements courants

page_view

Le page_view l’appel vous permet d’enregistrer chaque fois qu’un utilisateur voit une page de votre site web, ainsi que d’éventuelles propriétés facultatives 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 (e.g. 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: '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 (deprecated)

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

Produits - 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 du 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]
  }
});

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"];

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]
  }
});

search

Utilisez cet événement pour contextualiser les recherches. Cet événement peut vous aider à identifier le contenu le plus populaire de 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]
  }
});

select_content

Cet événement indique qu’un utilisateur a sélectionné du contenu d’un certain type. Cet événement peut vous aider à identifier le contenu populaire et les catégories de contenu de votre application, ou les clics 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]
  }
});

sign_up

Cet événement indique qu’un utilisateur a créé un compte.

Paramètres (obligatoire 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]
  }
});

- 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 e-mail sont généralement les paramètres les plus utiles. Bien que certains partenaires de destination utilisent également prénom, nom, date de naissance, ville, ...

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

e-mail

string

Yes*

john.doe@example.com

E-mail (valeur en clair)

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

email_md5

string

Non*

8eb1b52... (size 32)

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

email_sha256

string

Non*

836f82d... (size 64)

E-mail, haché à l’aide de l’algorithme SHA-256. Non requis si e-mail est fourni (voir ci-dessous)

téléphone

string

Non*

+33612345678

Numéro de téléphone, E.164 format (*) requis pour certaines destinations.

prénom

string

Non

John

Prénom

nom

string

Non

Doe

Nom

genre

string

Non

Sexe

f pour Femme
m pour Homme

date de naissance

string

Non

1970-01-01

Date de naissance, YYYY-MM-DD format

ville

string

Non

Boston

Ville

état

string

Non

Massachusetts

État

zipcode

string

Non

02108

Code postal

pays

string

Non

États-Unis

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 partage des données avec les partenaires de destination. Elles sont automatiquement renseignées à 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 les hachées 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 prenons uniquement en charge l’encodage hexadécimal (base16) &#xNAN;(c.-à-d. : hachées les valeurs sont transportées par des chaînes contenant les caractères [0-9a-f]) Les autres encodages ne sont pas encore pris en charge

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

si vous envoyez en clair valeur, les hachées valeurs ne sont pas nécessaires &#xNAN;Nous pouvons générer hachées des valeurs côté serveur à l’aide de en clair value
si vous n’envoyez pas en clair de valeur, alors vous devriez renseigner autant de 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 la valeur exacte hachées value

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 ?