Envoyer les données de profil

Les développeurs peuvent configurer deux façons pour les clients d’envoyer des attributs de profil d’acheteur à Einstein : le téléchargement par lot vers le serveur et le suivi des activités en temps réel. Vous pouvez utiliser l’une ou l’autre méthode (ou les deux) pour envoyer des données de profil d’acheteur à Einstein.

Lorsque vous envoyez des données à Einstein, gardez à l’esprit les points suivants :

Salesforce vous recommande vivement de ne pas envoyer d’informations personnelles identifiables (PII) à Einstein en dehors des identifiants recommandés spécifiés.
Toutes les données collectées sont conservées en interne pendant un an au maximum. Au bout d’un an, les données deviennent obsolètes et sont supprimées de toutes les bases de données Einstein. Pour continuer à utiliser ces données de profil, vous devez les renvoyer à Einstein.
Lorsqu’Einstein reçoit de nouvelles valeurs pour des attributs de profil d’acheteur existants, ces nouvelles valeurs sont annexées aux valeurs existantes.
Einstein utilise toutes les données de profil fournies. Les nouvelles données ne sont pas évaluées différemment des données les précédant.

Téléchargement par lot vers le serveur

Salesforce propose un point de terminaison sécurisé pour le téléchargement par lot vers le serveur, qui permet aux clients de télécharger toutes les anciennes données de profil d’acheteur qu’ils ont recueillies.

L’option de téléchargement par lot vers le serveur est prévue pour :

Toutes les données relatives au profil des acheteurs que vous avez suivies et collectées.
Toutes les donnée provenant d’un tiers de confiance que vous souhaitez qu’Einstein utilise pour personnaliser davantage les achats.

Autorisation

Le téléchargement des données par lot peut avoir un impact important sur les données Einstein. Pour cette raison, nous ne permettons qu’aux utilisateurs autorisés de télécharger de grandes quantités de données vers le serveur. En outre, chaque appel API de téléchargement vers le serveur doit passer un jeton d’accès à l’en-tête d’autorisation requis (bearer) obtenu auprès d’Account Manager.

Remarque : Pour réduire la charge sur le serveur Account Manager, évitez de générer de nouveaux jetons avant l’expiration du jeton actuel. Reportez-vous à la spécification de l’API pour en savoir plus sur les appels API de téléchargement par lot vers le serveur.

Préparation des données de téléchargement par lot vers le serveur

Pour préparer les données de téléchargement par lot pour la consommation d’Einstein, contrôlez les points suivants :

Le fichier de lot est un fichier gzippé TSV (de valeurs séparées par des tabulations).
Le fichier TSV est correctement formaté et enregistré en utilisant le codage de caractères UTF-8.
Le mimetype du fichier est défini correctement pour être utilisé par l’application gzip.
La ligne d’en-tête doit contenir le champ d’identification login_id, le champ d’identification email_address, ou les deux.
Vous pouvez ajouter des colonnes supplémentaires pour chaque attribut du profil d’acheteur que vous souhaitez envoyer.
Les valeurs sont soit des chaînes de caractères, soit des listes de chaînes de caractères. Pour une liste de chaînes de caractères, veillez à séparer les valeurs à l’aide du séparateur barre verticale (|). Par exemple, orange|yellow.
Les colonnes vierges sont ignorées. Lorsqu’Einstein rencontre une colonne vide, il ignore cette colonne et continue à traiter les autres données des attributs de l’utilisateur.

Téléchargement par lot d’identifiants utilisateurs vers le serveur

Pour aider à générer des recommandations de produits pertinentes pour chaque acheteur, l’API Profile Connector a besoin de l’un ou l’autre de ces identifiants utilisateurs pour l’identification des acheteurs dans le téléchargement par lot vers le serveur.

Champ	Description
login_id	Identifiant de connexion de l’acheteur. Dans certains cas, il s’agit de la même valeur que la valeur email_address.
email_address	Adresse e-mail complète de l’acheteur. Par exemple, acheteur1@quelquepart.com.

Exemple de données téléchargées par lot

Voici un exemple de données TSV téléchargées par lot de profils d’acheteurs avec des noms de colonnes aléatoires :

login_id	email_address	sexe	couleurs	brand_list
acheteur1	acheteur1@site.com	homme	orange\|jaune	marqueA\|marqueB
acheteur2	acheteur2@site.com	femme	bleu\|noir	marqueD
acheteur3	acheteur3@site.com	femme	rouge\|noir\|violet	marqueB\|marqueE

Limites du point de terminaison de téléchargement par lot de profils d’acheteurs

Lorsque vous effectuez un téléchargement par lot de profils d’acheteurs, gardez à l’esprit les limitations suivantes des points de terminaison :

Vous ne pouvez télécharger qu’un seul fichier à la fois. Vous pouvez toutefois télécharger plusieurs fichiers, l’un après l’autre.
La taille maximale autorisée des fichiers est de 2 Go.

Téléchargement par lot des données de profils d’acheteurs vers Einstein

Après avoir préparé les fichiers de données par lot des profils d’acheteurs, créez une archive gzip de chaque fichier individuel et téléchargez-la vers le point de terminaison Einstein du téléchargement par lot des profils d’acheteurs. Pour en savoir plus, reportez-vous à la rubrique Envoyer le point de terminaison de profils par lot.

Suivi des activités en temps réel

Utilisez le point de terminaison de suivi de l’activité updateProfile pour appeler et envoyer en temps réel des mises à jour des données de profils d’acheteurs et de leurs préférences. La capture en temps réel des informations fournies par un acheteur dans votre boutique permet aux recommandations de répercuter immédiatement ces changements.

L’option de suivi des activités en temps réel est prévue pour :

Capturer les activités de préférences des acheteurs en temps réel.
Effectuer des mises à jour du profil des acheteurs en temps réel.

Pour aider à générer des recommandations de produits pertinentes pour chaque acheteur, l’API Profile Connector fournit deux identifiants utilisateurs pour l’identification des acheteurs dans le suivi en temps réel.

cookieId (obligatoire) : identifiant unique d’un acheteur anonyme. En général, le cookieId est la valeur d’un cookie de première partie.
- Lorsque vous lancez des requests API à partir d’une boutique Commerce Cloud classique, passez la valeur du cookie cqcid pour correspondre au suivi automatique des activités sur la boutique classique. Pour plus d’informations, reportez-vous à la section Stockage de données local basé sur navigateur.
- Si vous utilisez OCAPI ou Salesforce Commerce API, utilisez la valeur visit_id de la réponse de connexion de l’invité pour faire correspondre les activités automatiques. Pour plus d’informations, consultez le Document client OCAPI.
userId (recommandé) : identifiant unique d’un acheteur connecté. Ce paramètre permet à Einstein de relier le même utilisateur connecté entre plusieurs appareils.
- Lorsque vous lancez des requests API à partir d’une boutique Commerce Cloud classique, utilisez la valeur du cookie cquid pour la correspondance lors du suivi automatique des activités sur la boutique classique. Pour plus d’informations, reportez-vous à la section Stockage de données local basé sur navigateur.
- Si vous utilisez OCAPI ou l’API Salesforce Commerce, utilisez la valeur hashed_login de la réponse de connexion de l’utilisateur enregistré pour la correspondance des activités automatiques. Pour plus d’informations, consultez le Document client OCAPI.

Pour éviter toute activité malveillante potentielle, les paramètres d’identification de l’utilisateur doivent être non séquentiels. Les paramètres ne doivent pas inclure de séquences, de schémas, d’adresses IP, d’adresses électroniques, de noms ou tout autre élément lié à une personne spécifique. Tous les paramètres d’identification des utilisateurs doivent se conformer au règlement général sur la protection des données (RGPD) par le biais d’un hachage ou d’autres méthodes.

Note