So integrierst du Salesforce CRM

Übersicht

Erfahre, wie du Salesforce CRM mit Klaviyo integrierst. Diese Integration macht es dir leicht, dein Salesforce-Konto zu verbinden, die zu synchronisierenden Objekte auszuwählen und Felder zuzuordnen – all dies über einen geführten In-App-Einrichtungs-Flow.

Mit dieser Integration kann Klaviyo Salesforce-Daten (wie Leads oder Kontakte) automatisch mit Klaviyo-Profilen synchronisieren. So kannst du Nachrichten personalisieren und Kund*innen mithilfe von CRM-Daten segmentieren.

Bevor du anfängst

Bevor du anfängst, solltest du Folgendes beachten:

• Du bist bei deinem Salesforce-Konto angemeldet.
• Wenn dein Unternehmen mehrere Salesforce-Organisationen hat, bist du bei der richtigen Organisation angemeldet.
• Du hast Admin-Zugriff auf dein Salesforce-Konto.

Verbinde Salesforce mit Klaviyo

1. Melde dich bei Klaviyo an. Klicke dann auf die Registerkarte Integrationen.
2. Klicke auf Apps entdecken, um die Klaviyo App Marketplace zu öffnen. Suche und öffne den Eintrag in der Salesforce- App. Klicke dann auf Installieren.
3. Du wirst zum Flow zur Einrichtung der Salesforce-Integration weitergeleitet. In Schritt 1 wählst du aus, ob du eine Verbindung zu einer Salesforce-Produktions- oder Sandbox-Organisation herstellst. Klicke dann auf Installiere die Klaviyo Client-App.
   

4. Folge in Salesforce dem Installationsassistenten, um das Paket „Klaviyo Salesforce OAuth Connector“ in der Salesforce-Organisation, die du mit Klaviyo verbindest, zu bestätigen und zu installieren.
   

5. Kehre nach Abschluss der Installation zur Einrichtungsseite für die Salesforce-Integration in Klaviyo zurück. Folge dann Schritt 2 und klicke auf Verbinde dich mit Salesforce.
   

6. Klicke auf Zulassen, um den OAuth-Flow abzuschließen und die Verbindung zwischen Klaviyo und Salesforce abzuschließen.
   

Wähle ein Salesforce-Objekt für die Synchronisierung aus

Nachdem du die Verbindung hergestellt hast, wirst du aufgefordert, die Salesforce-Objekte auszuwählen, die du mit Klaviyo synchronisieren möchtest. Klicke auf Weiter, um fortzufahren.

Du kannst jetzt bis zu drei Objekte auswählen, die mit Klaviyo synchronisiert werden sollen. Zu den verfügbaren Optionen gehören:

• Lead – Potenzielle Kund*innen, die Interesse an deinen Salesforce-Produkten oder -Services gezeigt haben
• Kontakt – Personen, die mit Konten in deiner Salesforce-Organisation verknüpft sind
• Konto – Organisationen oder Personen, die mit deinem Unternehmen zu tun haben (z. B. Kund*innen, Mitbewerber*innen und Partner*innen)
• Verkaufschance – Potenzielle Verkäufe oder Angebote
• Andere (Verfügbarkeit hängt von deiner Salesforce-Einrichtung ab)

Objekte, die aus Salesforce synchronisiert werden, werden als Klaviyo-Profile erstellt oder aktualisiert. Wenn du mehrere Objekte synchronisierst:

• Datensätze aus allen ausgewählten Objekten werden mit Klaviyo synchronisiert.
• Wenn die E-Mail-Adresse eines Eintrags mit einem bestehenden Klaviyo-Profil übereinstimmt, wird dieses Profil aktualisiert.
• Wenn die E-Mail-Adresse eines Eintrags in Klaviyo nicht vorhanden ist, wird ein neues Profil erstellt.
• Wenn dieselbe Person in mehreren synchronisierten Objekten mit derselben E-Mail-Adresse vorhanden ist, konsolidiert Klaviyo sie auf der Grundlage der E-Mail in einem einzigen Profil. (Feldzuordnungen werden im nächsten Schritt pro Objekt konfiguriert.)

Salesforce-Felder Klaviyo-Eigenschaften zuordnen

Als Nächstes ordnest du Salesforce-Felder Klaviyo-Profileigenschaften zu. Beachte, dass einige wichtige Zuordnungen wie E-Mail, Telefonnummer, Vorname und Nachname bereits zugeordnet sind. Die Zuordnung der Salesforce-E-Mail-Adresse ist erforderlich.

Wenn du mehrere Salesforce-Objekte zur Synchronisierung ausgewählt hast, konfigurierst du die Feldzuordnungen für jedes Objekt separat. So kannst du steuern, welche Felder von jedem Objekt zu Klaviyo-Profileigenschaften werden.

Füge Zuordnungen hinzu oder bearbeite sie

• Verwende die Zuordnung Hinzufügen, um zusätzliche Salesforce-Felder für das derzeit ausgewählte Objekt zuzuordnen.
• Wähle links ein Salesforce-Feld und rechts die entsprechende Klaviyo-Eigenschaft aus.
• Entferne Zuordnungen bei Bedarf mit dem Papierkorbsymbol.
• Wiederhole diesen Vorgang für jedes synchronisierte Objekt.
  

Wenn dieselbe Klaviyo-Profileigenschaft (z. B. Phone Number oder City) von mehreren Salesforce-Objekten zugeordnet wird, synchronisiert Klaviyo den zuletzt aktualisierten Wert von Salesforce mit dem Profil.

Zuordnungen über CSV importieren (optional)

Abmeldebehandlung (optional)

Du kannst die Option aktivieren, um das Salesforce-Objekt als abgemeldet zu synchronisieren, wenn E-Mail Opt-out für das Salesforce-Objekt auf true festgelegt ist. Dadurch wird das Profil als von der E-Mail in Klaviyo abgemeldet markiert.

Einrichtung abschließen

Sobald deine Zuordnungen abgeschlossen sind, klicke auf Einrichtung abschließen. Klaviyo schließt die Integration ab (normalerweise dauert dies ein paar Sekunden). Sobald dein Salesforce-Konto erfolgreich verbunden und synchronisiert wurde, siehst du eine Bestätigungsnachricht.

Salesforce-Synchronisierung überwachen und Daten verifizieren

Die Salesforce-Integration wird stündlich mit Klaviyo synchronisiert.

So überprüfst du deine Integration:

1. Klicke in Klaviyo auf das Auswertungen- Drop-down-Menü und wähle Metriken. Filtere nach Salesforce, suche dann die Metrik Became Lead und klicke auf das Aktivitäts-Feed- Symbol.
2. Wenn die Synchronisierung deiner Daten mit deiner Integration begonnen hat, siehst du Ereignisse, die zu Lead geworden sind, mit dem Salesforce-Symbol, das zu diesem Aktivitäts-Feed hinzugefügt wurde.
3. Klaviyo importiert alle deine Salesforce-Leads. Um dies zu überprüfen, vergleiche die Anzahl der Leads, die an einem bestimmten Tag zu Klaviyo hinzugefügt werden, mit der Anzahl der Leads, die zu Salesforce hinzugefügt werden, und bestätige, dass sie übereinstimmen.
4. Bewege den Mauszeiger über den Datenpunkt von gestern (im Aktivitäts-Feed für Became Lead, den du durch Klicken auf die Metrik findest) oder sieh dir die Datentabelle unter dem Diagramm an, um zu sehen, wie viele Zahlungen gestern stattgefunden haben, und vergleiche sie mit den in Salesforce gespeicherten Daten.
5. Wenn die Daten nicht übereinstimmen, besteht das Problem höchstwahrscheinlich darin, dass die Zeitzone in deinem Klaviyo-Konto nicht mit der Zeitzone in deinem Salesforce-Konto übereinstimmt. So überprüfst du deine Zeitzoneneinstellungen in Klaviyo:
   • Klicke unten links auf deinen Kontonamen.
   • Wähle aus und klicke dann auf Einstellungen > Organisation.
   • Scrolle nach unten zur Zeitzone.

Salesforce-Metriken in Klaviyo

Derzeit synchronisiert Klaviyo eine Metrik mit Salesforce CRM: Became Lead.

Diese Metrik wird nachverfolgt, wenn ein neuer Lead in Salesforce erstellt wird. Das Ereignis selbst enthält keine Daten von Salesforce. Wenn dieses Ereignis jedoch protokolliert wird, synchronisiert Klaviyo die folgenden benutzerdefinierten Eigenschaften für jeden Lead und fügt sie dem Klaviyo-Profil des Leads hinzu:

• ID
• Vorname
• Nachname
• Title
• Unternehmen
• Straße
• City
• Status
• Postleitzahl
• Country
• Latitude
• Longitude
• Telefon
• E-Mail
• Website
• LeadSource
• Status
• Branche
• Anzahl der Mitarbeiter
• Hat sich von E-Mail abgemeldet
• Kontoinhaber-E-Mail

Du kannst diese Eigenschaften dann in Segmenten, in Flows und zum dynamischen Einfügen von Kundeneigenschaften in deine Nachrichten-Vorlagen verwenden.

Fehlerbehebung

Probleme bei der Installation und Authentifizierung

Migration von der einfachen Authentifizierung zu OAuth

Wenn du die Salesforce-Integration eingerichtet hast, bevor OAuth unterstützt wurde, ist deine Salesforce-Anwendung möglicherweise über die Standardauthentifizierung mit Klaviyo verbunden.

Bestehende grundlegende Authentifizierungsverbindungen funktionieren weiterhin, bis ihre Anmeldeinformationen ablaufen. Sobald diese Zugangsdaten jedoch ablaufen, können sie nicht mehr zurückgesetzt oder erneuert werden. Um deine Salesforce-Integration mit Klaviyo zu verbinden, musst du zu OAuth migrieren.

1. Melde dich bei Salesforce Organization an, das mit Klaviyo verbunden ist.
2. Rufe im Klaviyo-Portal die Seite mit deinen Integrationseinstellungen für Salesforce auf. Oben auf der Seite sollte ein Banner mit der Aufschrift „OAuth-Authentifizierung ist jetzt erforderlich“ zu sehen sein. Klicke in der Beschreibung des Banners auf den Hyperlink „external Klaviyo app“ (Externe-App), um das Paket „Klaviyo Salesforce OAuth Connector“ in deinem Salesforce-Unternehmen zu installieren.

3. Sobald die Installation abgeschlossen ist, navigiere zurück zu deiner Seite mit den Einstellungen für die Salesforce-Integration und klicke auf Aktualisieren. Schließe dann den OAuth-Flow ab.

Weitere Informationen findest du im Abschnitt „Verbinde Salesforce mit Klaviyo“ oben in diesem Leitfaden.

Fehler „Externe Klaviyo-App ist nicht installiert. Installiere es und versuche es erneut.“

Dieser Fehler zeigt an, dass das Paket „Klaviyo Salesforce OAuth Connector“ nicht auf der Salesforce-Organisation installiert ist, bei der du dich authentifizieren (oder neu authentifizieren) möchtest.

Bitte stelle sicher, dass:

1. Du bist bei Salesforce angemeldet
2. Du bist bei der Salesforce-Organisation angemeldet, die in Klaviyo integriert ist. Wenn dein Unternehmen mehrere Salesforce-Organisationen hat, bist du möglicherweise bei der falschen Organisation angemeldet.
3. Wenn du bei der richtigen Salesforce-Organisation angemeldet bist und diese Fehlermeldung weiterhin angezeigt wird, durchsuche deine installierten Pakete in Salesforce, um zu überprüfen, ob das Paket „Klaviyo Salesforce OAuth Connector“ installiert ist. Wenn es nicht installiert ist, wiederhole Schritt 1 im Integrations-Setup-Flow, um das Paket zu installieren (siehe Abschnitt „Verbinde Salesforce mit Klaviyo“ oben in dieser Anleitung). Wenn du bereits über eine Integration verfügst und zu OAuth migrierst, klicke auf den Hyperlink „external Klaviyo App“, um das Paket zu installieren (siehe Abschnitt „Migrate to OAuth“ oben).

Wenn du weiterhin Probleme hast, wende dich bitte an den Support.

Fehlermeldung bei Kontokonflikt

Wenn dein Unternehmen mehrere Salesforce-Unternehmen hat, stelle sicher, dass du bei dem Salesforce-Unternehmen, das derzeit mit Klaviyo verbunden ist, angemeldet bist, wenn du die Integration erneut authentifizierst

Wenn du bei einer anderen Salesforce-Organisation angemeldet bist, wird der Fehler „Konto stimmt nicht überein“ angezeigt:

Um den Fehler zu beheben, kannst du einen der folgenden Schritte ausführen:

1. Verbinde die bestehende Salesforce-Organisation erneut: Schließe das Fenster, melde dich bei Salesforce ab, melde dich dann bei der Salesforce-Organisation an, die derzeit mit Klaviyo verbunden ist, und versuche es erneut.
2. Verbinde eine andere Salesforce-Organisation: Deinstalliere die Salesforce-Integration in Klaviyo, installiere sie neu und schließe die Einrichtung des Salesforce-Integrations-Flows mit der neuen Salesforce-Organisation ab.

Warnungen und Fehler bei der Feldzuordnung

Klaviyo überprüft kontinuierlich deine Salesforce-Feldzuordnungen, um sicherzustellen, dass die Daten zuverlässig synchronisiert werden können. Wenn ein zugeordnetes Salesforce-Feld nicht mehr verfügbar ist (z. B. wenn es gelöscht, umbenannt oder Berechtigungen geändert werden), siehst du möglicherweise eine Warnung oder einen Fehler in deinen Integrationseinstellungen.

Wenn ein nicht erforderliches Feld nicht verfügbar ist

Wenn ein zugeordnetes Salesforce-Feld nicht mehr verfügbar und nicht erforderlich ist, führt Klaviyo Folgendes durch:

• Zeige eine Warnung an, die anzeigt, welches Feld fehlt.
• Setze die Synchronisierung aller anderen verfügbaren Felder fort.
• Schließe das nicht verfügbare Feld von zukünftigen Synchronisierungen aus, bis es aktualisiert oder entfernt wird.

Um dies zu beheben,

1. Rufe deine Salesforce-Integration in Klaviyo auf.
2. Öffne das betroffene Objekt.
3. Aktualisiere oder entferne die ungültige Feldzuordnung.
4. Speichere deine Änderungen.

Nach der Aktualisierung wird die Synchronisierung wie erwartet fortgesetzt.

Wenn ein Pflichtfeld (E-Mail) nicht verfügbar ist

Wenn das Feld Salesforce-E-Mail für ein Objekt nicht mehr verfügbar ist (z. B. aufgrund von Schemaänderungen oder Berechtigungen), führt Klaviyo Folgendes durch:

• Zeigt eine Fehlermeldung an, die anzeigt, dass das Feld E-Mail fehlt.
• Beende die Synchronisierung von Daten für das betroffene Objekt.
• Du wirst aufgefordert, deine Feldzuordnungen zu aktualisieren, um die Synchronisierung wiederherzustellen.

Um dies zu beheben,

1. Rufe deine Salesforce-Integration in Klaviyo auf.
2. Öffne das betroffene Objekt.
3. Vergewissere dich, dass der Eigenschaft „E-Mail“ von Klaviyo ein gültiges Feld für die Salesforce-E-Mail zugeordnet ist.
4. Speichere deine Änderungen.

Sobald das Feld für die E-Mail wieder erfolgreich zugeordnet wurde, wird die Datensynchronisierung automatisch fortgesetzt.

Fehlende Profile in Klaviyo

Wenn Salesforce-Einträge in Klaviyo nicht als Profile angezeigt werden, überprüfe zunächst, ob für jedes Objekt, das du synchronisierst, ein gültiges E-Mail-Feld zugeordnet ist. Klaviyo verwendet die E-Mail-Adresse als erforderliche Kennung, um Profile zu erstellen oder zu aktualisieren. Datensätze ohne zugeordnetes Profilfeld oder ohne gültige Werte für die E-Mail werden nicht als E-Mail synchronisiert. Stelle sicher, dass:

• Für jedes ausgewählte Objekt wird der Klaviyo-Eigenschaft „E-Mail“ ein Feld für die Salesforce- E-Mail zugeordnet.
• Das Feld „Zugeordnete E-Mail“ enthält die tatsächlichen Werte der E-Mail in Salesforce. Leere oder ungültige E-Mails können dazu führen, dass Datensätze nicht als Profile synchronisiert werden.

Sobald ein gültiges Profilfeld zugeordnet ist und die Datensätze E-Mail-E-Mails enthalten, erstellt oder aktualisiert Klaviyo diese Profile bei der nächsten Synchronisierung.

Ergebnis

Du hast jetzt dein Klaviyo-Konto mit Salesforce CRM integriert und deine synchronisierten Daten überprüft.