Salesforce Data 360

• Zielbesucher, die zu einer bestimmten Salesforce-Zielgruppe gehören, wie etwa Hochwertige Kunden.
• Besucher basierend auf einem bestimmten Attribut ansprechen, etwa ein customer_tier von Gold.
• Erlebnisse basierend auf Verhaltensdaten personalisieren, wie loyalty_status, lifetime_value_band oder churn_risk.
• Salesforce-Daten systemeigen mit beliebigen anderen Kameleoon-Zieleinstellungsbedingungen kombinieren.

​

So funktioniert die Salesforce Data 360-Synchronisierung

1. Senden Sie den Identifikator: Ihre Website sendet den Kameleoon-Besuchercode während des Besuchs des Benutzers an Salesforce Data 360.
2. Exportieren Sie die Daten: Salesforce veröffentlicht in regelmäßigen Abständen Zielgruppenmitgliedschaften und ausgewählte Kundenattribute an ein S3- oder SFTP-Ziel.
3. Erfassen Sie die Daten: Kameleoon verarbeitet diese Aktivierungsdateien und speichert die Salesforce-Daten gegen den entsprechenden kameleoon_visitor_code.
4. Zielgruppe des Besuchers: Bei der nächsten Interaktion des Besuchers ruft Kameleoon diese Informationen über benutzerdefinierte Daten ab und bewertet sie für aktive Zieleinstellungssegmente.

​

Voraussetzungen für die Salesforce Data 360-Integration

• Sie verfügen über ein Salesforce Data 360-Konto mit Administratorberechtigungen zum Konfigurieren von Datenmodelobjekten, Zuordnungen, Segmenten, Verbindungen und Aktivierungszielen.
• Sie haben ein aktives Kameleoon-Projekt.
• Ihr Kameleoon-Vertreter hat Ihnen die spezifischen S3- oder SFTP-Verbindungsanmeldeinformationen für Ihr Projekt bereitgestellt.

​

Schritt 1: Senden Sie den Kameleoon-Besuchercode an Salesforce

// Stellen Sie sicher, dass dies nur bei der ersten Seitenansicht des aktuellen Besuchs ausgeführt wird
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Core.runWhenConditionTrue(
        function () {
            // Warten Sie, bis das Salesforce Interactions SDK initialisiert wird
            return (
                typeof window.SalesforceInteractions !== "undefined" &&
                typeof window.SalesforceInteractions.sendEvent === "function"
            );
        },
        function () {
            // Übertragen Sie den Kameleoon-Besuchercode an Salesforce
            window.SalesforceInteractions.sendEvent({
                user: {
                    attributes: {
                        eventType: "kameleoonIdentity",
                        kameleoonVisitorCode: Kameleoon.API.Visitor.code
                    }
                }
            });
        },
        500 // Abfrageintervall in Millisekunden
    );
}

​

Schritt 2: Hinzufügen und Zuordnen des Besuchercodes in Salesforce Data 360

​

Erstellen Sie das Feld in Salesforce Data 360

1. Navigieren Sie in Salesforce Data 360 zu Data Model.
2. Öffnen Sie das Individual DMO und klicken Sie auf Edit.
3. Klicken Sie auf Add Field und konfigurieren Sie es mit den genauen Werten unten:

4. Klicken Sie auf Save, um das DMO zu aktualisieren.

​

Ordnen Sie das Feld dem Data Lake Object zu

1. Navigieren Sie zum relevanten Data Lake Object (beispielsweise Ihr Website-DLO).
2. Ordnen Sie das Quellfeld, das den Kameleoon-Besucheridentifikator enthält, auf Individual.kameleoon_visitor_code zu.

​

Schritt 3: Konfigurieren Sie die Verbindung zwischen Salesforce und Kameleoon

​

Option A: Konfigurieren Sie Amazon S3 für Salesforce Data 360

1. Navigieren Sie in Salesforce Data 360 zu Data Cloud Setup.
2. Wählen Sie unter External Integrations die Option More Connectors > New.
3. Wählen Sie unter Target die Option Amazon S3.
4. Geben Sie einen Verbindungsnamen ein (beispielsweise Kameleoon integration).
5. Wählen Sie Access Key/Secret Based authentication.
6. Geben Sie den AWS Access Key, AWS Secret Access Key, S3-Bucket und Parent Directory ein, die von Kameleoon bereitgestellt werden.
7. Klicken Sie auf Test Connection und dann auf Save.
8. Navigieren Sie zu Activation Targets > New.
9. Wählen Sie unter File Storage die Option Amazon S3 und wählen Sie Ihre neu erstellte Kameleoon-Verbindung.
10. Wählen Sie CSV als Dateiformat, geben Sie einen Zielnamen ein (beispielsweise Kameleoon audience sync) und klicken Sie auf Save.

​

Option B: Konfigurieren Sie SFTP für Salesforce Data 360

1. Navigieren Sie in Salesforce Data 360 zu Data Cloud Setup.
2. Wählen Sie unter External Integrations die Option Other Connectors.
3. Klicken Sie auf New und wählen Sie Target > Secure File Transfer (SFTP).
4. Geben Sie einen Verbindungsnamen ein (beispielsweise Kameleoon integration).
5. Geben Sie den Kameleoon SFTP-Host, -Port, -Benutzername und -Parent Directory ein, die von Kameleoon bereitgestellt werden.
6. Geben Sie Ihren privaten SSH-Schlüssel und optionale Passphrase ein.
7. Klicken Sie auf Test Connection und dann auf Save.
8. Navigieren Sie zu Activation Targets > New.
9. Wählen Sie unter File Storage die Option SFTP und wählen Sie Ihre neu erstellte Kameleoon-Verbindung.
10. Wählen Sie CSV als Dateiformat, geben Sie einen Zielnamen ein (beispielsweise Kameleoon audience sync) und klicken Sie auf Save.

​

Schritt 4: Aktivieren Sie Salesforce-Zielgruppen und -Attribute für Kameleoon

1. Navigieren Sie in Salesforce Data 360 zu Segments.
2. Wählen Sie das Segment aus, das Sie mit Kameleoon synchronisieren möchten.
3. Klicken Sie auf der Registerkarte Activations auf New und wählen Sie Ihr Kameleoon Audience Sync-Ziel.
4. Wählen Sie Individual als Activation Membership-Objekt.
5. Klicken Sie auf Add Attributes, erweitern Sie die Entität Individual und fügen Sie kameleoon_visitor_code hinzu.
6. Fügen Sie alle zusätzlichen Salesforce-Attribute hinzu, die Sie für die Zieleinstellung in Kameleoon verwenden möchten (beispielsweise customer_tier oder churn_risk).

​

Schritt 5: Rufen Sie Salesforce-Daten in Ihrem globalen Skript ab

// Stellen Sie sicher, dass dies nur bei der ersten Seitenansicht des aktuellen Besuchs ausgeführt wird
if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Data.retrieveDataFromRemoteSource(
        Kameleoon.API.Visitor.code,
        function (data) {
            // Registrieren Sie jede synchronisierte Salesforce-Zielgruppenmitgliedschaft
            if (Array.isArray(data.salesforce_audiences)) {
                data.salesforce_audiences.forEach(function (audience) {
                    Kameleoon.API.Data.setCustomData("Salesforce Audiences", audience);
                });
            }

            // Registrieren Sie das synchronisierte Salesforce Customer Tier-Attribut
            if (data.customer_tier) {
                Kameleoon.API.Data.setCustomData("Salesforce Customer Tier", data.customer_tier);
            }
        }
    );
}

​

Rufen Sie Salesforce-Daten für Kameleoon Feature Experimentation ab

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

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

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

    // Rufen Sie den Besuchercode ab
    const visitorCode = client.getVisitorCode();

    // Rufen Sie das synchronisierte Salesforce-Payload für diesen Besucher ab
    const jsonData = await client.getRemoteData(visitorCode);
    const data = JSON.parse(jsonData);

    // Registrieren Sie die synchronisierten Salesforce-Zielgruppenmitgliedschaften in einem Aufruf.
    // Wiederholte addData()-Aufrufe mit dem gleichen benutzerdefinierten Datennamen ersetzen den
    // vorherigen Wert, anstatt ihn anzuhängen, sodass Sie jede Zielgruppe als
    // variadic-Argument an eine CustomData-Instanz übergeben.
    if (Array.isArray(data.salesforce_audiences) && data.salesforce_audiences.length > 0) {
        client.addData(visitorCode, new CustomData('Salesforce Audiences', ...data.salesforce_audiences));
    }

    // Registrieren Sie das synchronisierte Salesforce Customer Tier-Attribut
    if (data.customer_tier) {
        client.addData(visitorCode, new CustomData('Salesforce Customer Tier', data.customer_tier));
    }

    // Evaluieren Sie das Feature Flag mit den Daten, die Sie gerade hinzugefügt haben
    const isActive = client.isFeatureFlagActive(visitorCode, 'my_feature_key');
}

init();

​

Schritt 6: Erstellen Sie benutzerdefinierte Daten in Kameleoon

​

Beispiel 1: Zuordnen von Salesforce-Zielgruppen (Listendaten)

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

​

Beispiel 2: Zuordnen von Salesforce-Profilattributen (Zeichenfolgendaten)

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

​

Schritt 7: Zielgruppe Salesforce-Zielgruppen in Kameleoon

1. Navigieren Sie zum Segment Builder (Settings > Segments > New segment).
2. Ziehen Sie Ihre neu erstellte benutzerdefinierte Datenbedingung in die Segmentregel.
3. Konfigurieren Sie den Logik-Operator. Beispielsweise können Sie zum Ansprechen hochgewertiger Kunden Folgendes konfigurieren:
   • Salesforce Audiences is among High-value customers

​

Überlegungen zur Salesforce Data 360-Integration

• Identifikatorenkonsistenz: Der kameleoon_visitor_code-String, den Salesforce exportiert, muss genau mit der Cookie-Zeichenfolge des Besuchers in Kameleoon übereinstimmen. Wenn der Identifikator während des Salesforce-Importvorgangs geändert oder gehashed wird, schlägt die Synchronisierung fehl.
• Datenfriechheit: Die Integration basiert auf asynchronen Dateien. Änderungen am Profil eines Benutzers werden in Kameleoon erst verfügbar, nachdem sich das Salesforce-Segment aktualisiert hat, Salesforce die CSV-Aktivierungsdatei bereitgestellt hat und Kameleoon das resultierende Payload erfasst hat.
• Datenschutz: Aktivieren Sie nur die spezifischen Attribute, die für Experimente oder Personalisierung erforderlich sind. Vermeiden Sie die Aktivierung von personenbezogenen Informationen (PII), wenn ein breiteres kategorisches Attribut (etwa ein generisches LTV_band) das gleiche Zieleinstellungsziel erreicht.