Datensätze in Empfängerlisten kopieren
Note
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Salesforce.
Dieses Kapitel beschreibt, wie Sie Salesforce-Datensätze von Kontakten, Leads und Personen-Accounts kopieren und mit Ihren Optimizely Campaign Empfängerlisten synchronisieren können. Das Salesforce-Add-on fügt dafür dem Salesforce Process Builder zwei Apex-Klassen hinzu:
- Upsert Recipient. Empfänger aktualisieren oder neue Empfänger hinzufügen.
- Delete Recipient. Leads, Kontakte und Personen-Accounts aus einer Optimizely Campaign Empfängerliste löschen.
Voraussetzungen
Die Optimizely Kundenbetreuung muss Ihre Optimizely Campaign Empfängerlisten für die Salesforce-Synchronisierung vorbereiten. Teilen Sie mit, in welchen Mandanten Sie Empfängerlisten für die Salesforce-Synchronisierung verwenden möchten.
Prozesse einrichten und Apex-Klassen verwenden
Wenn die Kundenbetreuung die gewünschten Empfängerlisten vorbereitet hat, müssen Sie in Salesforce Prozesse einrichten, um Kontakte, Leads beziehungsweise Personen-Accounts automatisch in Optimizely Campaign Empfängerlisten zu kopieren – entsprechend der von Ihnen festgelegten Prozess-Logik. Sie können beispielsweise Prozesse einrichten, die Kunden nach einem bestimmten Status filtern und zu einer entsprechenden Optimizely Campaign Empfängerliste übertragen, bspw. Neukunden in eine Empfängerliste, die nur Neukunden enthält.
Für das Beispiel wurde für Kontakte, Leads und Personen-Accounts im Vorfeld ein boolesches Referenzfeld (true/false) mit der Bezeichnung Premium-Kunde angelegt, das Sie für die Konfiguration des Prozesses benötigen.
Prozesse einrichten
- Wechseln Sie in Salesforce in den Setup-Bereich.
- Wählen Sie in der Seitennavigation Prozessautomatisierung > Prozessgenerator.
- Im Fenster Meine Prozesse klicken Sie auf Neu.
- Geben Sie im Feld Prozessname einen Namen für den Prozess ein, z. B. Premium-Kunden.
- Geben Sie unter API-Name einen Namen ein, z. B. Premium_Kunden.
- Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.
- Wählen Sie aus der Drop-down-Liste Der Prozess beginnt, wenn den Eintrag Ein Datensatz wurde geändert aus.
- Klicken Sie auf Speichern.
Kriterien hinzufügen und Apex-Klassen definieren
- Klicken Sie in dem Ablaufdiagramm auf Objekt hinzufügen.
- Wählen Sie im Fenster Objekt auswählen und angeben, wann der Prozess gestartet werden soll aus der Drop-down-Liste Objekt die Entität aus, für die Sie den Prozess einrichten möchten: Lead, Kontakt oder Personaccount.
- Aktivieren Sie unter Prozess starten die Option wenn ein Datensatz erstellt oder bearbeitet wird.
- Klicken Sie auf Speichern.
- Klicken Sie auf + Kriterien hinzufügen.
- Geben Sie im rechten Fenster im Feld Kriterienname einen Namen für das Kriterium ein, z. B. ist Premium-Kunde.
- Wählen Sie unter Kriterien zum Ausführen von Aktionen die Option Bedingungen sind erfüllt aus.
- Wählen Sie unter Bedingungen festlegen aus der Drop-down-Liste unter Feld das Referenzfeld Premium-Kunde aus und bestätigen Sie Ihre Auswahl.
- Setzen Sie den Operator auf Gleich, den Typ auf Boolesch und den Wert auf True.
- Wählen Sie unter Bedingungen die Option Alle Bedingungen sind erfüllt (AND) aus.
- Klicken Sie auf Speichern.
- Klicken Sie im Ablaufdiagramm unter Sofortige Aktionen auf Aktion hinzufügen.
- Im Fenster Aktion auswählen und definieren wählen Sie aus der Drop-down-Liste Aktionstyp den Eintrag Apex aus.
- Geben Sie unter Aktionsname einen Namen ein, z. B. Premium-Kunden hinzufügen.
- Wählen Sie aus der Drop-down-Liste Apex-Klasse den Eintrag Upsert Recipient aus.
Note
Für die Apex-Klasse Upsert Recipient müssen Sie drei Variablen konfigurieren: recipientId, recipientListId und sfOptInId.
- Klicken Sie unter Apex-Variablen festlegen dreimal auf Zeile hinzufügen.
- Wählen Sie in der ersten Drop-down-Liste unter Feld die Variable recipientId aus und setzen Sie den Typ auf Feldverweis. Wählen Sie im Feld Wert – je nach gewünschtem Entitätstyp – die Lead-ID, die Kontakt-ID oder Personenaccount-ID aus.
- Wählen Sie in der zweiten Drop-down-Liste unter Feld die Variable recipientListId aus und setzen Sie den Wert auf die ID der Optimizely Campaign Empfängerliste, in die die Premium-Kunden kopiert werden sollen. Der Typ wird automatisch auf Zahl gesetzt, nehmen Sie hier keine Änderung vor. Die Empfängerlisten-ID finden Sie im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Empfängerlisten.
- Wählen Sie in der dritten Drop-down-Liste unter Feld die Variable sfOptInId aus und setzen Sie den Wert auf die Salesforce-ID des angelegten Werbeeinverständnisses. Der Typ wird automatisch auf Zeichenfolge gesetzt, nehmen Sie hier keine Änderung vor.
- Klicken Sie auf Speichern.
Empfänger aus einer Empfängerliste löschen und in eine andere Empfängerliste aufnehmen
Ein Premium-Kunde hat beispielsweise einen hohen Umsatz getätigt und sich als Platin-Kunde qualifiziert. Jetzt möchten Sie diesen Kunden aus der Premium-Liste löschen und in die Platin-Liste aufnehmen.
Um Empfänger aus einer Empfängerliste zu löschen und in eine andere Empfängerliste aufzunehmen, richten Sie neben der Apex-Klasse Upsert (die den Kunden in die Platin-Liste aufnimmt) die Klasse Delete Recipient ein (die den Kunden aus der Premium-Liste löscht). Die Apex-Klasse Delete Recipient konfigurieren Sie nur mit den Parametern recipientId und recipientListId, vgl. Schritte 18 und 19 im vorherigen Abschnitt.
Synchronisierung von gelöschten Kontakten, Leads und Personenacounts aktivieren
Um in Ihrem Salesforce-Datenbestand vollständig gelöschte Kontakte, Leads und Personenaccounts auch aus Ihren Optimizely Campaign Empfängerlisten zu löschen, richten Sie keinen eigenen Prozess in Salesforce ein. Die Synchronisierung Ihrer gelöschten Salesforce-Datensätze erledigt das Add-on, wenn Sie die automatische Synchronisierung gelöschter Kontakte, Leads beziehungsweise Personen-Accounts aktivieren. Führen Sie die folgenden Schritte aus:
- Wechseln Sie in den Reiter Verwaltung (Episerver Campaign).
- Klicken im Fenster Verwaltung (Episerver Campaign) unter Gelöschte Empfänger synchronisieren auf Starten.
Tip
Klicken Sie auf Beenden, um die Synchronisierung der gelöschten Datensätze zu unterbrechen. Der Abbruch der Datensynchronisierung ist z. B. notwendig, wenn Sie eine fehlerhafte Konfiguration korrigieren müssen.
Klicken Sie unter Manuell synchronisieren auf Starten, um die Datensynchronisierung einmalig manuell auszuführen. Die manuelle Synchronisierung ermöglicht es Ihnen, den Zeitraum des Zugriffs zwischen Salesforce und Optimizely Campaign in den Protokolldateien einzugrenzen und die Fehlerdiagnose zu unterstützen.