Loading

Fehlerbehebung für den Formular-Handler

Veröffentlichungsdatum: Sep 30, 2025
Beschreibung
Über Formular-Handler können Sie Formulare selbst verwalten und die Daten in Pardot posten. So können Sie das Erscheinungsbild Ihres Formulars vollständig anpassen und die Formularsendungen weiterhin über Pardot nachverfolgen. Eine Anleitung zur Implementierung eines Formular-Handlers finden Sie in dieser Dokumentation
Lösung

Fehlende Übereinstimmung bei Feldzuordnung
Erforderliche Felder fehlen
Fehlende Feldtypübereinstimmung
Zeichenkodierung
Falscher Enctype
Verwenden von Ajax bei Übermittlung
Fehlender verweisender URL
Fehler beim Senden
Besucher-Tracking
Mehrere doppelte Übermittlungen
Identisches Bundesland/Land für übermittelte potenzielle Kunden
S
erverseitige Übermittlungen

 

Fehlende Übereinstimmung bei Feldzuordnung

Der in den Pardot-Formular-Handler eingegebene Name des externen Felds muss mit dem name=-Attribut des <input>-Tags im HTML-Code Ihres Orginalformulars übereinstimmen. Bei Feldzuordnungen wird zwischen Groß- und Kleinschreibung unterschieden.

Angenommen, der Code Ihres Website-Formulars lautet wie folgt:

<label for=”first”>Vorname</label> <input name=“first” type=”text” id=“first” /><br />
 

Überprüfen Sie in Ihrem Pardot-Formular-Handler, ob für den Namen des externen Felds “first” festgelegt ist, da er mit dem Eingabenamen übereinstimmt.

 

Erforderliche Felder fehlen

Alle in Pardot als Pflichtfelder markierten Felder müssen in der Einsendung enthalten sein. Bei Einsendungen, die nicht alle Pflichtfelder aufweisen, treten Fehler auf. Passen Sie die Formular-Handler-Fehlermeldungen für die einzelnen Felder an, um genau nachvollziehen zu können, welche Felder Fehler generieren. Sie können die Fehlermeldungen mit folgenden Schritten anpassen:

1. Bearbeiten Sie Ihren Formular-Handler.
2. Klicken Sie auf das Stiftsymbol neben der jeweiligen Feldzuordnung.
3. Klicken Sie auf die Registerkarte Erweitert.
4. Bearbeiten Sie den Text der Fehlermeldung.
5. Klicken Sie auf Änderungen speichern.
6. Wiederholen Sie diesen Vorgang für alle verbleibenden Formularfelder.
7. Klicken Sie auf Formular-Handler speichern, wenn Sie fertig sind.
 

Fehlende Feldtypübereinstimmung

Die eingesendeten Daten müssen mit dem ausgewählten Feldtyp übereinstimmen. Wenn Sie beispielsweise eine Telefonnummer an einen Formular-Handler senden, die Zeichen wie Bindestriche und Klammern enthält, tritt ein Fehler auf, wenn das Feld einem Feld mit dem Feldtyp Nummer zugeordnet ist. Passen Sie die Formular-Handler-Fehlermeldungen für die einzelnen Felder an, um genau nachvollziehen zu können, welche Felder Fehler generieren. Sie können die Fehlermeldungen mit folgenden Schritten anpassen:

1. Bearbeiten Sie Ihren Formular-Handler.
2. Klicken Sie auf das Stiftsymbol neben der jeweiligen Feldzuordnung.
3. Klicken Sie auf die Registerkarte Erweitert.
4. Bearbeiten Sie den Text der Fehlermeldung.
5. Klicken Sie auf Änderungen speichern.
6. Wiederholen Sie diesen Vorgang für alle verbleibenden Formularfelder.
7. Klicken Sie auf Formular-Handler speichern, wenn Sie fertig sind.

 

Zeichencodierung

Sonderzeichen in Feldwerten – wie beispielsweise $, &amp;, %, (), + – sollten URL-codiert sein wenn das Formular Daten durch Anhängen von Feldnamen und -werten an den Endpunkt-URL des Formular-Handlers an den Formular-Handler sendet (so wie bei der iFrame-Methode "Ausgeblendet"). Zeichen sollten nicht codiert werden, wenn der Formular-Handler Daten in normaler Form an den Formular-Handler sendet (über Formular-POST).
 

Falscher Enctype

Pardot-Formular-Handler können nur über ein leeres enctype-Attribut oder den enctype application/x-www-form-urlencoded in Formulare integriert werden. Der enctype von multipart/form-data wird in Pardot nicht akzeptiert.
 

Verwenden von Ajax bei Übermittlungen

Das Senden von Daten an Formular-Handler über Ajax-Anforderungen wird von Pardot nicht unterstützt. Wenn Sie versuchen, Daten mit Ajax an einen Formular-Handler zu senden, erhalten Sie wahrscheinlich Fehler, die dem Folgenden ähneln:
XMLHttpRequest kann {www.site.com/FormHandlerURL} nicht laden. In der angeforderten Ressource ist keine "Access-Control-Allow-Origin"-Kopfzeile vorhanden. Dem Ursprung "{Seite, von der aus der Formular-Handler an die Client-Website übermittelt werden sollte}" wird daher kein Zugriff gewährt.
Dies wird als Cross-Origin Resource Sharing (CORS) bezeichnet. CORS oder JSONP werden für Formular-Handler in Pardot derzeit nicht unterstützt. Es besteht die Möglichkeit, eine JSONP-Antwort zu simulieren, indem Sie die Erfolg- und Fehler-URLs für den Formular-Handler als JavaScript-URLs festlegen, die Erfolgs- bzw. Fehler-Rückmeldungen ausführen.
 

Fehlender verweisender URL

Je nachdem, wie der URL geladen wird, ist möglicherweise kein verweisender URL vorhanden, an den die Daten weitergeleitet werden können. In diesem Fall können Sie den Speicherort für die erfolgreiche Ausführung für den Formular-Handler als expliziten URL festlegen. Wenn Sie das Formular an mehreren Orten verwenden und die Erfolgs- bzw. Weiterleitungsadresse abhängig davon, wo das Formular übermittelt wird, festgelegt werden muss, akzeptieren die Formular-Handler auch die Parameter "success_location" und "error_location" als URL-Parameter. Dadurch werden die gespeicherten Einstellungen für Erfolgs- oder Fehlerspeicherort überschrieben.
 

Fehler beim Senden

Pardot-Formular-Handler können keine Daten empfangen, die nicht erfolgreich gesendet wurden. Überprüfen Sie noch einmal, ob Ihr System Daten übermitteln kann und ob die Übermittlung an den richtigen Formular-Handler-Endpunkt-URL erfolgt.
 

Besucher-Tracking

Formular-Handler, für die der Kiosk-Modus festgelegt ist, verhindern, dass Pardot einen Cookie im Browser des Besuchers setzt, sodass dessen weitere Aktivitäten nicht nachverfolgt werden. Serverseitige Übermittlungen an Formular-Handler hindern Pardot zudem daran, einen Cookie im Browser des Benutzers zu platzieren und dessen Aktivität nachzuverfolgen. Wenn Sie Besucher in einem dieser beiden Fälle nachverfolgen möchten, lesen Sie diesen Artikel zu den Möglichkeiten, den Besucherdatensatz dem Datensatz für potenzielle Kunden zuzuordnen:
▸▸ https://help.salesforce.com/articleView?id=000318305&type=1&mode=1
 

Mehrere doppelte Übermittlungen

Gelegentlich werden mehrere Formular-Handler-Sendungen desselben Formular-Handlers in der Aktivitätentabelle eines potenziellen Kunden aufgelistet und/oder es werden mehrere Zeilen mit ausgelösten Vervollständigungsaktionen in den Aktivierungen potenzieller Kunden angezeigt, obgleich diese Einzelperson das externe Formular nur einmal übermittelt hat. 
 
Das tritt in der Regel auf, wenn ein Server eines externen Formulars mehrfach am Endpunkt-URL des Pardot-Formular-Handlers postet. Da Pardot keine Kontrolle darüber hat, wie oft eine Formularübermittlung an den Formular-Handler erfolgt, sollten Pardot-Administratoren bei diesem Problem mit dem Team zusammenarbeiten, das das externe Formular verwaltet, und/oder mit dem Support-Team des externen Formulars. Um dieses Problem zu lösen, müssen Sie herausfinden, warum das Formular mehrfach an den Endpunkt-URL des Formular-Handlers Pardot gesendet wird.
 

Identisches Bundesland/Land für übermittelte potenzielle Kunden

Wenn für Ihren Account die Einstellung Auto-fill Prospect Location Data from IP Address (Standortdaten potenzieller Kunden automatisch anhand der IP-Adresse ausfüllen) aktiviert ist, wird in den Datensätzen aller potenzieller Kunden mit erfolgreicher Formular-Handler-Sendung das gleiche Land/Bundesland angezeigt. Dies tritt auf, wenn der Formular-Handler serverseitig übermittelt wird, also wenn ein Formular an einen externen Server sendet, der wiederum an den Formular-Handler von Pardot postet. Bei einer serverseitigen Übermittlung erhält Pardot nur die IP-Adresse des externen Servers, der die Formulareingabe an den Formular-Handler von Pardot weiterleitet. Das bedeutet, dass die IP-Adresse für jede Eingabe für alle potenziellen Kunden identisch ist.

Sie können dieses Problem mit einem der folgenden Schritte lösen:

1. Aktivieren Sie den Kiosk-Modus in Ihrem Formular-Handler; Land und Bundesland der IP-Adresse des potenziellen Kunden werden nicht automatisch angehängt, wenn der Kiosk-Modus aktiviert ist. 
2. Deaktivieren Sie die Einstellung Auto-fill Prospect Location Data from IP Address (Standortdaten potenzieller Kunden automatisch anhand der IP-Adresse ausfüllen).
3. Senden Sie externe Formulardaten direkt an den Pardot-Formular-Handler (clientseitige Übermittlung), anstatt von einem externen Server aus zu posten (serverseitige Übermittlung).
4. Nutzen Sie ein Pardot-Formular anstelle eines Formular-Handlers.

Serverseitige Übermittlungen

Wenn Ihr Formular eine serverseitige Übermittlung durchführt, erhalten Sie im folgenden Artikel weitere Informationen:
▸▸ https://help.salesforce.com/articleView?id=000322102&type=1&mode=1

Nummer des Knowledge-Artikels

000383081

 
Laden
Salesforce Help | Article