Salesforce Data 360

• Ciblez les visiteurs appartenant à une audience Salesforce spécifique, comme les clients à forte valeur.
• Ciblez les clients en fonction d’un attribut spécifique, comme un customer_tier égal à Or.
• Personnalisez une expérience en fonction des données comportementales, comme loyalty_status, lifetime_value_band ou churn_risk.
• Combinez les données Salesforce nativement avec n’importe quelle autre condition de ciblage Kameleoon.

​

Fonctionnement de la synchronisation Salesforce Data 360

1. Envoyer l’identifiant : Votre site web envoie le code visiteur Kameleoon à Salesforce Data 360 lors de la visite de l’utilisateur.
2. Exporter les données : Salesforce publie périodiquement les appartenances aux audiences et les attributs clients sélectionnés vers une destination S3 ou SFTP.
3. Ingérer les données : Kameleoon traite ces fichiers d’activation et stocke les données Salesforce par rapport au kameleoon_visitor_code correspondant.
4. Cibler le visiteur : Lors de la prochaine interaction du visiteur, Kameleoon récupère ces informations via les données personnalisées et les évalue pour les segments de ciblage actifs.

​

Configuration requise pour l’intégration Salesforce Data 360

• Vous avez un compte Salesforce Data 360 avec les autorisations administrateur pour configurer les objets de modèle de données, les mappages, les segments, les connexions et les cibles d’activation.
• Vous avez un projet Kameleoon actif.
• Votre représentant Kameleoon vous a fourni les identifiants de connexion S3 ou SFTP spécifiques pour votre projet.

​

Étape 1 : Envoyer le code visiteur Kameleoon à Salesforce

// Assurez-vous que cela s'exécute uniquement lors de la première page vue de la visite actuelle
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Core.runWhenConditionTrue(
        function () {
            // Attendez l'initialisation du SDK Salesforce Interactions
            return (
                typeof window.SalesforceInteractions !== "undefined" &&
                typeof window.SalesforceInteractions.sendEvent === "function"
            );
        },
        function () {
            // Transmettez le code visiteur Kameleoon à Salesforce
            window.SalesforceInteractions.sendEvent({
                user: {
                    attributes: {
                        eventType: "kameleoonIdentity",
                        kameleoonVisitorCode: Kameleoon.API.Visitor.code
                    }
                }
            });
        },
        500 // Intervalle d'interrogation en millisecondes
    );
}

​

Étape 2 : Ajouter et mapper le code visiteur dans Salesforce Data 360

​

Créer le champ dans Salesforce Data 360

1. Dans Salesforce Data 360, accédez à Data Model.
2. Ouvrez Individual DMO et cliquez sur Edit.
3. Cliquez sur Add Field et configurez-le en utilisant les valeurs exactes ci-dessous :

4. Cliquez sur Save pour mettre à jour le DMO.

​

Mapper le champ vers l’objet du lac de données

1. Accédez à l’objet de lac de données pertinent (par exemple, votre DLO de site web).
2. Mappez le champ source contenant l’identifiant de visiteur Kameleoon vers Individual.kameleoon_visitor_code.

​

Étape 3 : Configurer la connexion entre Salesforce et Kameleoon

​

Option A : Configurer Amazon S3 pour Salesforce Data 360

1. Dans Salesforce Data 360, accédez à Data Cloud Setup.
2. Sous External Integrations, sélectionnez More Connectors > New.
3. Sous Target, sélectionnez Amazon S3.
4. Entrez un nom de connexion (par exemple, Intégration Kameleoon).
5. Sélectionnez Access Key/Secret Based authentication.
6. Entrez la clé d’accès AWS, la clé d’accès secret AWS, le compartiment S3 et le répertoire parent fournis par Kameleoon.
7. Cliquez sur Test Connection, puis sur Save.
8. Accédez à Activation Targets > New.
9. Sous File Storage, sélectionnez Amazon S3 et sélectionnez votre connexion Kameleoon nouvellement créée.
10. Sélectionnez CSV comme format de fichier, entrez un nom de cible (par exemple, Synchronisation audience Kameleoon), et cliquez sur Save.

​

Option B : Configurer SFTP pour Salesforce Data 360

1. Dans Salesforce Data 360, accédez à Data Cloud Setup.
2. Sous External Integrations, sélectionnez Other Connectors.
3. Cliquez sur New et sélectionnez Target > Secure File Transfer (SFTP).
4. Entrez un nom de connexion (par exemple, Intégration Kameleoon).
5. Entrez l’hôte SFTP Kameleoon, le port, le nom d’utilisateur et le répertoire parent fournis par Kameleoon.
6. Entrez votre clé privée SSH et votre phrase de passe facultative.
7. Cliquez sur Test Connection, puis sur Save.
8. Accédez à Activation Targets > New.
9. Sous File Storage, sélectionnez SFTP et sélectionnez votre connexion Kameleoon nouvellement créée.
10. Sélectionnez CSV comme format de fichier, entrez un nom de cible (par exemple, Synchronisation audience Kameleoon), et cliquez sur Save.

​

Étape 4 : Activer les audiences et attributs Salesforce vers Kameleoon

1. Dans Salesforce Data 360, accédez à Segments.
2. Sélectionnez le segment que vous souhaitez synchroniser avec Kameleoon.
3. Dans l’onglet Activations, cliquez sur New et sélectionnez votre cible Kameleoon Audience Sync.
4. Sélectionnez Individual comme objet d’appartenance d’activation.
5. Cliquez sur Add Attributes, développez l’entité Individual, et ajoutez kameleoon_visitor_code.
6. Ajoutez tous les attributs Salesforce supplémentaires que vous souhaitez utiliser pour le ciblage dans Kameleoon (par exemple, customer_tier ou churn_risk).

​

Étape 5 : Récupérer les données Salesforce dans votre script global

// Assurez-vous que cela s'exécute uniquement lors de la première page vue de la visite actuelle
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Data.retrieveDataFromRemoteSource(
        Kameleoon.API.Visitor.code,
        function (data) {
            // Enregistrez chaque appartenance à une audience Salesforce synchronisée
            if (Array.isArray(data.salesforce_audiences)) {
                data.salesforce_audiences.forEach(function (audience) {
                    Kameleoon.API.Data.setCustomData("Salesforce Audiences", audience);
                });
            }

            // Enregistrez l'attribut Salesforce Customer Tier synchronisé
            if (data.customer_tier) {
                Kameleoon.API.Data.setCustomData("Salesforce Customer Tier", data.customer_tier);
            }
        }
    );
}

​

Récupérer les données Salesforce pour Feature Experimentation

import { KameleoonClient, CustomData } from '@kameleoon/javascript-sdk';

const client = new KameleoonClient({ siteCode: 'my_site_code' });

async function init() {
    await client.initialize();

    // Obtenez le code visiteur
    const visitorCode = client.getVisitorCode();

    // Récupérez le contenu Salesforce synchronisé pour ce visiteur
    const jsonData = await client.getRemoteData(visitorCode);
    const data = JSON.parse(jsonData);

    // Enregistrez les appartenances aux audiences Salesforce synchronisées en un seul appel.
    // Les appels addData() répétés avec le même nom de donnée personnalisée remplacent la
    // valeur précédente au lieu d'ajouter, alors passez chaque audience en tant qu'argument
    // variadique à une instance CustomData unique.
    if (Array.isArray(data.salesforce_audiences) && data.salesforce_audiences.length > 0) {
        client.addData(visitorCode, new CustomData('Salesforce Audiences', ...data.salesforce_audiences));
    }

    // Enregistrez l'attribut Salesforce Customer Tier synchronisé
    if (data.customer_tier) {
        client.addData(visitorCode, new CustomData('Salesforce Customer Tier', data.customer_tier));
    }

    // Évaluez le drapeau de fonctionnalité en utilisant les données que vous venez d'ajouter
    const isActive = client.isFeatureFlagActive(visitorCode, 'my_feature_key');
}

init();

​

Étape 6 : Créer une donnée personnalisée dans Kameleoon

​

Exemple 1 : Mapper les audiences Salesforce (données de liste)

• Name : Salesforce Audiences
• Retrieval method : Kameleoon Activation API
• Type : List
• Format : String
• Scope : Visit

​

Exemple 2 : Mapper les attributs de profil Salesforce (données de chaîne)

• Name : Salesforce Customer Tier
• Retrieval method : Kameleoon Activation API
• Type : Single
• Format : String
• Scope : Visitor

​

Étape 7 : Cibler les audiences Salesforce dans Kameleoon

1. Accédez au Segment Builder (Settings > Segments > New segment).
2. Faites glisser votre condition de donnée personnalisée nouvellement créée dans la règle de segment.
3. Configurez l’opérateur logique. Par exemple, pour cibler les clients à forte valeur, configurez :
   • Salesforce Audiences is among High-value customers

​

Considérations pour l’intégration Salesforce Data 360

• Identifier consistency : La chaîne kameleoon_visitor_code que Salesforce exporte doit correspondre exactement à la chaîne de cookie du visiteur dans Kameleoon. Si l’identifiant est altéré ou haché lors du processus d’importation Salesforce, la synchronisation échoue.
• Data freshness : L’intégration s’appuie sur des dépôts de fichiers asynchrones. Les modifications apportées au profil d’un utilisateur ne deviennent disponibles dans Kameleoon qu’après l’actualisation du segment Salesforce, la livraison du fichier d’activation CSV par Salesforce et l’ingestion du contenu résultant par Kameleoon.
• Data privacy : Activez uniquement les attributs spécifiques requis pour l’expérimentation ou la personnalisation. Évitez d’activer des informations personnellement identifiables (PII) lorsqu’un attribut catégorique plus large (comme un LTV_band générique) atteint le même objectif de ciblage.