Sie befinden sich hier:
Verwenden eines Formular-Handlers zum Aktualisieren von Salesforce-Objekten mit Formulardaten
Verwenden Sie einen Formular-Handler, um Daten aus einem Formular auf einer externen Website zu erfassen und diese Daten zum Erstellen oder Aktualisieren von Datensätzen in Salesforce zu verwenden. Formular-Handler ermöglichen es, die vorhandenen Formulare auf Ihrer Site zu verwenden, ohne Ihre Site so zu aktualisieren, dass in Salesforce erstellte Formulare verwendet werden. Beim Erstellen eines Formular-Handlers geben Sie die Feldnamen in Ihrem vorhandenen Formular und die Salesforce-Felder an, denen sie zugeordnet sind.
Erforderliche Editionen
Unterstützte Editionen anzeigen.
| Erforderliche Benutzerberechtigungen | |
|---|---|
| Erstellen eines Formular-Handlers: | Berechtigungssatz "Marketing Cloud-Manager" UND Beliebige Rolle als Beitragender der CMS-Arbeitsumgebung |
| Veröffentlichen eines Formular-Handlers: | Berechtigungssatz "Marketing Cloud-Manager" UND Rolle des Inhaltsadministrators oder Inhaltsmanagers als Beitragender der CMS-Arbeitsumgebung |
Wenn Sie einen Formular-Handler erstellen, erstellen Sie auch eine Datenquelle in Data 360. Diese Datenquelle speichert die Daten, die das Formular erfasst. Überlegen Sie sich vor dem Erstellen eines Formular-Handlers und einer entsprechenden Datenquelle, wie Sie die vom Formular erfassten Daten am besten strukturieren können. Es gibt zwei allgemeine Muster zum Entwerfen der Datenstruktur: explizite Feldnamen und allgemeine Feldnamen.
Geben Sie in einer Datenquelle, die explizite Feldnamen verwendet, jeden Feldnamen im Datenmodell an. Diese Struktur ist leicht verständlich, muss jedoch jedes Mal geändert werden, wenn Sie ein Feld hinzufügen. Ein Datenmodell mit expliziter Struktur ähnelt diesem Beispiel.
| Feldname | Typ |
|---|---|
| Vorname | Text |
| Nachname | Text |
| Text | |
| Adresse | Text |
| Beruf | Text |
| ... | ... |
Alternativ kann eine Datenquelle generische Feldnamen verwenden oder häufiger eine Kombination aus expliziten und generischen Feldnamen. Dieser Ansatz bietet mehr Flexibilität, sodass Sie neue Feldnamen verarbeiten können, ohne das Objekt zu ändern. Allgemeine Feldnamen sind jedoch mehrdeutig und erfordern die Verwendung von Metadaten zur Beschreibung der Attribute in der Nutzlast. Ein Datenmodell mit einer generischen Struktur ähnelt diesem Beispiel.
| Feldname | Typ |
|---|---|
| Vorname | Text |
| Nachname | Text |
| Text | |
| Attribute1 | Text |
| Attribute2 | Text |
| Attribut3 | Text |
| ... | ... |
Erstellen eines Formular-Handlers
- Wählen Sie auf der Registerkarte "Inhalt" eine Inhaltsarbeitsumgebung aus, in der der Formular-Handler erstellt werden soll.
- Klicken Sie auf Hinzufügen | Inhalt .
- Wählen Sie im Fenster "CMS-Inhalt erstellen" die Option Formular-Handler aus und klicken Sie dann auf Erstellen.
-
Klicken Sie oben links im Fenster neben "Ohne Titel" auf das Stiftsymbol (
). Geben Sie einen Namen für den Formular-Handler ein.
-
Fügen Sie eine Datenquelle hinzu.
- Klicken Sie im Bereich auf der rechten Seite unter "Datenquelle" auf Datenquelle hinzufügen.
- Geben Sie einen Namen für die Datenquelle ein.
- Wählen Sie als Typ Salesforce-Datensatz aus.
- Wählen Sie für "Objekt" den Datensatztyp aus, mit dem der Formular-Handler arbeitet. Wenn Sie beispielsweise Kontaktdatensätze aktualisieren möchten, wählen Sie Kontakt aus.
- Speichern Sie Ihre Änderungen.
-
Ordnen Sie die Formularfelder zu.
- Klicken Sie im Bereich auf der linken Seite auf ein Feld, das aus dem Formular erfasst werden soll, und ziehen Sie es in die Mitte der Seite. Wählen Sie beispielsweise das Kontaktobjekt aus, wenn Ihr Formular Informationen über den Vornamen, den Nachnamen oder die E-Mail-Adresse des Benutzers erfasst. Wiederholen Sie diesen Schritt für jedes Feld, mit dem die Formulardaten interagieren.
- Klicken Sie in der Mitte der Seite auf einen der Feldnamen, die Sie hinzugefügt haben. Geben Sie dann im Bereich auf der rechten Seite einen externen Feldnamen ein. Wiederholen Sie diesen Schritt für alle ausgewählten Felder.
Der Name des externen Felds ist die Verknüpfung zwischen Ihrem Website-Formular und Salesforce. Sie verbindet jedes Feld in Ihrem Formular mit dem Salesforce-Feld, in dem der gesendete Wert gespeichert wird. Beachten Sie beim Angeben der zu erfassenden Felder die folgenden Anforderungen:
- Der von Ihnen eingegebene externe Feldname muss genau mit dem HTML-Namenattribut des Felds in Ihrem Formular übereinstimmen.
- Datumswerte verwenden das Format
YYYY-MM-DD. - Uhrzeitwerte verwenden das Format
hh:mm:ss. - DateTime-Werte verwenden das Format
YYYY-MM-DDTHH:mm:ss.sssZ(ISO 8601-Format). - Wenn bei Kontrollkästchenwerten das Kontrollkästchen im Formular aktiviert ist, zeichnet Salesforce es als
trueim Objekt auf.
- Speichern Sie Ihre Änderungen.
Informationen zum Aktualisieren Ihrer Site für die sichere Verarbeitung von Formularsendungen finden Sie in der Entwicklerdokumentation: Integrieren Sie Formularsendungen in die Connect-API.
Hinzufügen von Spam-Schutz zu einem Formular-Handler (optional)
Schützen Sie sich vor Hacking und Spam, indem Sie Ihrem Formular ein ausgeblendetes Honeypot-Feld hinzufügen. Wenn ein Bot versucht, ein Formular zu senden, füllt er oft alle Felder im Formular aus, einschließlich ausgeblendeter Felder. Wenn Sie ein Honeypot-Feld in Ihr Formular aufnehmen, blockiert der Formular-Handler alle Einreichungen, die einen Wert in diesem Feld enthalten.
- Fügen Sie im Bereich "Spam-Schutzfelder" das Feld "Honeypot" hinzu.
-
Geben Sie für "Name des externen Felds" einen Feldnamen ein, der für den Honeypot verwendet werden soll.
Tipp Bots versuchen, Formularfelder auszunutzen, mit denen Benutzer Text frei eingeben können. Sie suchen nach Feldern mit generischen Bezeichnungen wiecompany,websiteoderfax. Geben Sie einen Namen ein, der das Honeypot-Feld zu einem ansprechenden Ziel macht, sich jedoch nicht mit den im Formular zu erfassenden Daten überschneidet. Verwenden Sie keinen offensichtlichen Namen wiehoneypotoderdo_not_fill. - Fügen Sie im HTML-Code Ihres Formulars ein ausgeblendetes Eingabefeld mit dem übereinstimmenden Namensattribut hinzu.
Automatisieren von Aktionen mit einem Flow
Verbinden Sie einen Flow mit dem Formular-Handler, um Aufgaben wie das Erstellen von Leads oder das Senden von E-Mails zu automatisieren, nachdem ein Benutzer ein Formular gesendet hat. Klicken Sie im Formular-Handler im Abschnitt "Flow" auf Neuer Flow, um Flow Builder zu öffnen.
Wenn Sie einen Flow über die Seite des Formular-Handlers erstellen, sind die von Ihnen angegebenen externen Feldnamen als Ressourcen im Flow verfügbar. Verwenden Sie die Werte dieser externen Felder in Flow-Entscheidungsschritten, zum Personalisieren von Nachrichteninhalten und in anderen Flow-Aktionen. Verwenden Sie diese Ressourcen auch, um ein beliebiges Objekt zu ändern, nicht nur das Objekt, das Sie beim Erstellen des Formular-Handlers ausgewählt haben.
Konfigurieren von Einreichungsumleitungen
Geben Sie im Abschnitt "Übermittlungsumleitung" die vollständigen URLs ein, an die Benutzer gesendet werden sollen, wenn eine Formularsendung erfolgreich ist oder fehlschlägt.
Veröffentlichen des Formular-Handlers
Veröffentlichen Sie den Formular-Handler, um den Code zu generieren, der Ihr Website-Formular mit Salesforce verbindet.
Wenn Ihr Formular reCAPTCHA verwendet, generieren und senden Sie das erforderliche Token mit der Formularsendung.
- Wenn Sie bereit sind, das Formular und seinen Flow zu veröffentlichen, klicken Sie auf Veröffentlichen.
- Aktivieren Sie die Webverfolgung, um das Benutzerengagement zu überwachen.
Nach der Veröffentlichung generiert der Formular-Handler den Code, den Sie zum Konfigurieren Ihres Formulars verwenden, um Daten an den Formular-Handler zu senden.
