Datensätze in Empfängerlisten kopieren

  • Aktualisiert

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

  1. Wechseln Sie in Salesforce in den Setup-Bereich.

    Bild: Setup

  2. Wählen Sie in der Seitennavigation Prozessautomatisierung > Prozessgenerator.

    Bild: Prozessgenerator

  3. Im Fenster Meine Prozesse klicken Sie auf Neu.

    Bild: Neuer Prozess

  4. Geben Sie im Feld Prozessname einen Namen für den Prozess ein, z. B. Premium-Kunden.

    Bild: Prozessname

  5. Geben Sie unter API-Name einen Namen ein, z. B. Premium_Kunden.
  6. Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.
  7. Wählen Sie aus der Drop-down-Liste Der Prozess beginnt, wenn den Eintrag Ein Datensatz wurde geändert aus.

    Bild: Ein Datensatz wurde geändert

  8. Klicken Sie auf Speichern.

Kriterien hinzufügen und Apex-Klassen definieren

  1. Klicken Sie in dem Ablaufdiagramm auf Objekt hinzufügen.

    Bild: Objekt hinzufügen

  2. 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.

    Bild: Objekt-Auswahlliste

  3. Aktivieren Sie unter Prozess starten die Option wenn ein Datensatz erstellt oder bearbeitet wird.

    Bild: Wenn ein Datensatz erstellt oder bearbeitet wird

  4. Klicken Sie auf Speichern.
  5. Klicken Sie auf + Kriterien hinzufügen.

    Bild: Kriterien hinzufügen

  6. Geben Sie im rechten Fenster im Feld Kriterienname einen Namen für das Kriterium ein, z. B. ist Premium-Kunde.

    Bild: Kriterienname

  7. Wählen Sie unter Kriterien zum Ausführen von Aktionen die Option Bedingungen sind erfüllt aus.

    Bild: Kriterien zum Ausführen von Aktionen

  8. Wählen Sie unter Bedingungen festlegen aus der Drop-down-Liste unter Feld das Referenzfeld Premium-Kunde aus und bestätigen Sie Ihre Auswahl.

    Bild: Referenzfeld auswählen

  9. Setzen Sie den Operator auf Gleich, den Typ auf Boolesch und den Wert auf True.

    Bild: Bedingungen festlegen

  10. Wählen Sie unter Bedingungen die Option Alle Bedingungen sind erfüllt (AND) aus.

    Bild: Alle Bedingungen sind erfüllt (AND)

  11. Klicken Sie auf Speichern.
  12. Klicken Sie im Ablaufdiagramm unter Sofortige Aktionen auf Aktion hinzufügen.

    Bild: Aktion hinzufügen

  13. Im Fenster Aktion auswählen und definieren wählen Sie aus der Drop-down-Liste Aktionstyp den Eintrag Apex aus.

    Bild: Aktionstyp Apex

  14. Geben Sie unter Aktionsname einen Namen ein, z. B. Premium-Kunden hinzufügen.

    Bild: Aktionsname

  15. Wählen Sie aus der Drop-down-Liste Apex-Klasse den Eintrag Upsert Recipient aus.

    Bild: Apex-Klasse auswählen

    Für die Apex-Klasse Upsert Recipient müssen Sie drei Variablen konfigurieren: recipientId, recipientListId und sfOptInId.

  16. Klicken Sie unter Apex-Variablen festlegen dreimal auf Zeile hinzufügen.

    Bild: Zeilen hinzufügen

  17. 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.

    Bild: Apex-Variable (recipientId) festlegen

  18. 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.

    Bild: Apex-Variable (recipientListId) festlegen

  19. 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.

    Bild: Apex-Variable (sfOpotInId) festlegen

  20. 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.

Bild: Apex-Klasse Delete Recipient

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:

  1. Wechseln Sie in den Reiter Verwaltung (Episerver Campaign).

    Bild: Verwaltung (Episerver Campaign)

  2. Klicken im Fenster Verwaltung (Episerver Campaign) unter Gelöschte Empfänger synchronisieren auf Starten.

    Bild: Synchronisierung starten

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.