> ## Documentation Index > Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt > Use this file to discover all available pages before exploring further. # Salesforce Data 360 > Synchronisieren Sie Salesforce Data 360-Zielgruppen und Kundenattribute mit Kameleoon, um Experimente auszuwählen und Erlebnisse mithilfe einheitlicher Kundenprofile zu personalisieren. Kundenprofile, die in Salesforce Data 360 erstellt werden, einschließlich Zielgruppenzugehörigkeit und Verhaltensattributen, sind für Kameleoon standardmäßig nicht sichtbar. Ohne eine direkte Verbindung zwischen den beiden Plattformen können Marketing- und Produktteams diese einheitlichen Kundendaten nicht nutzen, um Experimente auszurichten oder Erlebnisse auf der Website zu personalisieren. Salesforce Data 360 aktiviert Segmente und Profilattribute für externe Dateispeicher-Ziele, darunter Amazon S3 und Secure File Transfer Protocol (SFTP). Kameleoon erfasst diese Aktivierungsdateien und verknüpft die Salesforce-Daten mit dem entsprechenden Kameleoon-Besucher mithilfe des `kameleoon_visitor_code`. Nach der Synchronisierung machen Sie Salesforce-Zielgruppen und -Attribute als benutzerdefinierte Kameleoon-Daten verfügbar, um sie als Zieleinstellungsbedingungen im Kameleoon-Segment-Builder zu verwenden. Diese Integration ist auf Anfrage verfügbar. Wenden Sie sich für weitere Informationen an Ihren Customer Success Manager (CSM). **Anwendungsfälle:** * 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 Die Integration basiert darauf, dass der Kameleoon-Besuchercode als gemeinsamer Identifikator über beide Plattformen hinweg fungiert. **Die Synchronisierung folgt diesem kontinuierlichen Workflow:** 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 Bevor Sie die Integration zwischen Kameleoon und Salesforce Data 360 konfigurieren, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen: * 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 Um Salesforce-Profile Kameleoon-Besuchern zuzuordnen, muss Ihre Umgebung den Kameleoon-Besuchercode an Salesforce Interactions senden. Fügen Sie das folgende JavaScript zu Ihrem **globalen Skript** in Kameleoon hinzu. Diese Logik stellt sicher, dass das Skript den Besuchercode pro Besuch genau einmal an Salesforce sendet und nur ausgelöst wird, wenn das Salesforce-Objekt auf der Seite verfügbar wird: ```javascript theme={null} // 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 Nachdem der Besuchercode in Ihre Salesforce-Umgebung fließt, erstellen Sie ein Zielfeld auf dem Salesforce Individual Data Model Object (DMO), um diesen zu speichern. ### 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: | Einstellung | Wert | | :-------------------------- | :----------------------- | | **Field label** | Kameleoon visitor code | | **Field API name** | `kameleoon_visitor_code` | | **Data type** | Text | | **Primary key** | No | | **Enable value suggestion** | No | 4. Klicken Sie auf **Save**, um das DMO zu aktualisieren. ### Ordnen Sie das Feld dem Data Lake Object zu Das Erstellen des DMO-Felds füllt es nicht automatisch auf. Sie müssen das Feld vom eingehenden Data Lake Object (DLO) Ihrem neuen DMO-Feld zuordnen. 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 Kameleoon unterstützt Salesforce Data 360-Aktivierungen über Amazon S3 oder SFTP. Wählen Sie eine der folgenden Transportmethoden basierend auf den Anmeldeinformationen aus, die Ihr Kameleoon-Vertreter bereitgestellt hat, und konfigurieren Sie **eine** Methode. Kameleoon empfiehlt, die Integration über die SFTP-Option einzurichten. ### 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 Nachdem die Verbindung hergestellt wurde, wählen Sie die spezifischen Salesforce Data 360-Segmente und -Attribute aus, die Sie an Kameleoon übertragen möchten. 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`). Das Attribut `kameleoon_visitor_code` ist erforderlich. Ohne dies kann Kameleoon die Daten nicht dem korrekten Besucherprofil zuordnen. Wählen Sie beim Konfigurieren des Aktivierungsaktualisierungstyps in Salesforce die Option **Incremental**, um sicherzustellen, dass Zielgruppenmitgliedschaften und Attribute effizient synchronisiert werden, indem nur die geänderten Datensätze aktualisiert werden, anstatt die gesamte Zielgruppe bei jeder Ausführung zu übertragen. *** ## Schritt 5: Rufen Sie Salesforce-Daten in Ihrem globalen Skript ab Um die synchronisierten Salesforce-Daten für die Zieleinstellung verfügbar zu machen, rufen Sie sie aus dem Kameleoon-Remote-Datenspeicher ab und registrieren Sie sie als benutzerdefinierte Daten mithilfe der JavaScript Activation API. Fügen Sie diesen Code zum gleichen globalen Skript hinzu, das den Besuchercode an Salesforce sendet, nicht zum eigenen Abrufcode benutzerdefinierter Daten. Der Abrufaufruf ist asynchron und erfordert einen Rückruf, daher können Sie ihn einmal hier aufrufen, um jedes Attribut und jede Zielgruppe aus einer einzigen Serverantwort zu registrieren, anstatt für jedes Attribut einen separaten Remote-Lookup auszulösen: ```javascript theme={null} // 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); } } ); } ``` Weitere Informationen zu `retrieveDataFromRemoteSource()` und [`setCustomData()`](../../../../developer-docs/apis/activation-api-js/api-reference/api-reference#setcustomdata) finden Sie in der [Activation API-Referenz](../../../../developer-docs/apis/activation-api-js/api-reference/api-reference#retrievedatafromremotesource). ### Rufen Sie Salesforce-Daten für Kameleoon Feature Experimentation ab Wenn Sie Besucher mit Kameleoon Feature Experimentation anstelle von Web Experimentation ansprechen, wird kein globales Skript im Browser ausgeführt. Rufen Sie die Daten stattdessen mit einem Kameleoon SDK ab, verwenden Sie `getRemoteData()` zum Abrufen des Payload und `addData()`, um jeden Wert zu registrieren, bevor Sie ein Feature Flag evaluieren: ```javascript theme={null} 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(); ``` Weitere Informationen zu `getRemoteData()`, `addData()` und `isFeatureFlagActive()` finden Sie in der [JavaScript SDK-Dokumentation](../../../../developer-docs/sdks/web-sdks/js-sdk). Den vollständigen Feature Experimentation-Workflow finden Sie unter [Use external data to target users](../../../../developer-docs/feature-experimentation/targeting-and-segmentation/use-external-data-to-target-users). *** ## Schritt 6: Erstellen Sie benutzerdefinierte Daten in Kameleoon Kameleoon verarbeitet automatisch die eingehenden Salesforce CSV-Aktivierungsdateien. Um diese Daten für die Zieleinstellung zu verwenden, erstellen Sie **benutzerdefinierte Daten**-Objekte auf der Kameleoon-Plattform, die den Werten entsprechen, die Ihr Skript setzt. Navigieren Sie zu **Settings > Custom data > New custom data** und konfigurieren Sie die Objekte basierend auf Ihren erforderlichen Datentypen. Weitere Informationen zu benutzerdefinierten Kameleoon-Daten finden Sie unter [Create custom data](../../../assets/custom-data/create-custom-data). ### Beispiel 1: Zuordnen von Salesforce-Zielgruppen (Listendaten) Um Besucher basierend auf ihrer Präsenz in mehreren Salesforce-Zielgruppen anzusprechen, konfigurieren Sie die benutzerdefinierten Daten mit den folgenden Einstellungen: * **Name:** Salesforce Audiences * **Retrieval method:** Kameleoon Activation API * **Type:** List * **Format:** String * **Scope:** Visit ### Beispiel 2: Zuordnen von Salesforce-Profilattributen (Zeichenfolgendaten) Um Besucher basierend auf einem bestimmten, einzelnen Profilattribut, etwa einer Kundenstufe, anzusprechen, erstellen Sie einen separaten benutzerdefinierten Dateneintrag mit den folgenden Einstellungen: * **Name:** Salesforce Customer Tier * **Retrieval method:** Kameleoon Activation API * **Type:** Single * **Format:** String * **Scope:** Visitor Wenn Sie Besucher mit Kameleoon Feature Experimentation ansprechen, wählen Sie **Kameleoon SDK method** als Abrufmethode für beide benutzerdefinierten Dateneinträge anstelle von **Kameleoon Activation API**. *** ## Schritt 7: Zielgruppe Salesforce-Zielgruppen in Kameleoon Nachdem Sie die benutzerdefinierten Daten zugeordnet haben, werden die Salesforce-Informationen systemeigen im Kameleoon-Segment-Builder verfügbar. **So verwenden Sie die Daten in einem Segment:** 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` Sie können diese systemeigen mit anderen Kameleoon-Kriterien kombinieren, um hochspezifische Segmente zu erstellen (beispielsweise *Salesforce Customer Tier = Gold* **AND** *Device = Mobile*). Weitere Informationen zum Erstellen von Segmenten finden Sie unter [Create a segment](../../../assets/segments/create-a-segment). *** ## Überlegungen zur Salesforce Data 360-Integration Berücksichtigen Sie die folgenden Systemverhalten bei der Verwaltung der Integration zwischen Salesforce Data 360 und Kameleoon: * **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.