Loading
Marketing Cloud Volgende
Een extern formulier verbinden met een formulierhandler

U bent hier:

  1. Help van Salesforce
  2. Documenten
  3. Marketing Cloud Volgende

Een extern formulier verbinden met een formulierhandler

Nadat u een formulierhandler hebt gemaakt en gepubliceerd, configureert u uw externe formulier om gegevens naar Salesforce te verzenden.

Vereiste editions

Ondersteunde editions weergeven.

Benodigde gebruikersmachtigingen
Een formulierhandler maken:

Machtigingenset Marketing Cloud Manager

AND

Elke CMS-werkruimtebijdragerrol
Een formulierhandler publiceren:

Machtigingenset Marketing Cloud Manager

AND

Een CMS-werkruimtebijdragerrol van inhoudsbeheerder of inhoudsmanager
De CORS-whitelist configureren: Alle gegevens wijzigen

Voordat u deze stappen voltooit, maakt en publiceert u een formulierhandler.

Er zijn twee manieren om gegevens vanuit uw formulier naar Salesforce te verzenden. Selecteer het verbindingstype dat het beste past bij de structuur en mogelijkheden van uw site.

  JavaScript-snippet (clientzijde)

Direct POST-URL (serverzijde)
Hoe het werkt Een script op uw pagina verzendt formuliergegevens naar Salesforce wanneer een bezoeker het formulier indient. Uw formulier post gegevens rechtstreeks naar een Salesforce-URL, zonder script op de pagina.
Toevoegen aan uw site Een <script> en formulierkenmerken die u in de HTML voor uw pagina plakt. Een URL die u instelt als de actie voor uw formulier- of webhookbestemming.
Meest geschikt voor Pagina's waarop u de HTML bepaalt en scripts kunt toevoegen. Externe formuliersamenstellers die geen aangepaste scripts toestaan, pagina's met strenge regels voor Content Security Policy (CSP) en formulieren die posten vanaf een back-endserver.
Ondersteunt web bijhouden Ja Nee
Ondersteunt identiteitsoplossing Ja Nee
Vereist een CORS-ingang op de goedgekeurde lijst Ja Ja

Beide methoden verzenden gegevens naar dezelfde formulierhandler en activeren dezelfde stroom. Voor beide methoden moet u ook uw domein autoriseren in de CORS-whitelist.

Zorg er bij een van beide typen verbindingen voor dat elk veld in uw formulier een HTML name kenmerk gebruikt dat exact overeenkomt met de overeenkomende externe veldnaam in de formulierhandler. Als de namen niet overeenkomen, legt de formulierhandler de waarde niet vast. Als u bijvoorbeeld de email_address van de externe veldnaam hebt toegewezen aan het veld Email, moet het kenmerk name voor het overeenkomende veld in het formulier ook email_address zijn.

Optie 1: Uw formulier configureren om een verbinding aan clientzijde te gebruiken

Gebruik deze methode wanneer u de HTML voor uw pagina bepaalt en er een script aan kunt toevoegen. Omdat het script wordt uitgevoerd in de browser van de bezoeker, ondersteunt deze methode web bijhouden en identiteitsoplossing. Hierdoor kan deze methode een formulierindiening koppelen aan de webactiviteit van een bezoeker.

  1. Publiceer de formulierhandler.
  2. Kopieer het trackingscript op het tabblad Codesnippet, onder Formulierhandler aan clientzijde. Het script lijkt op dit voorbeeld. 
    <script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script>
  3. Plak in de HTML-code voor de site het script vóór de afsluitende </body>.
  4. Kopieer op het tabblad Codesnippet de formulierkenmerken. De kenmerken lijken op dit voorbeeld. 
    <form id="CONTENT_KEY" data-uma-forms="true"></form>
  5. Voeg in uw HTML de kenmerken id en data-uma-forms toe aan de tag <form>.
  6. Controleer of het kenmerk HTML name voor elk formulierveld overeenkomt met de toegewezen externe veldnaam.
  7. Voeg het domein dat uw formulier host toe aan de CORS-whitelist. Deze stap autoriseert uw domein om indieningen naar Salesforce te verzenden.
  8. Als u de betrokkenheid van gebruikers wilt bewaken, schakelt u Web bijhouden in.

Wanneer een bezoeker het formulier indient, verzendt het script de gegevens naar Salesforce, waarna de formulierhandler de indiening verwerkt en uw stroom activeert. De formulierhandler leidt ze vervolgens om naar de URL voor succes of fout die u hebt geconfigureerd.

Optie 2: Uw formulier configureren voor gebruik van een verbinding aan serverzijde

Gebruik een verbinding aan de serverzijde wanneer u geen code kunt toevoegen aan uw pagina of geen aangepaste configuraties aan uw code kunt aanbrengen. Met deze methode geeft de formulierhandler u een bestemmings-URL en configureert u het formulier om de gegevens ervan naar die URL te verzenden. Omdat u geen script inbedt, werkt deze methode met formuliertools die geen aangepast JavaScript toestaan. Deze methode is ook handig bij pagina's met strenge regels voor Content Security Policy (CSP) en bij formulieren die worden ingediend vanaf een back-endserver.

  1. Kopieer op het tabblad Codesnippet voor de formulierhandler, onder Formulierhandler aan serverzijde, de URL van de formulieractie. De URL lijkt op dit voorbeeld. 
    https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY
  2. Configureer het formulier om de gegevens naar Salesforce te verzenden. De implementatiestappen zijn afhankelijk van de manier waarop u uw formulier implementeert.
    Als u een externe formuliersamensteller of invoegtoepassing gebruikt Zoek in de instellingen voor de externe tool het veld voor het configureren van de actie, post-naar-URL of webhookbestemming van het formulier. Geef de Salesforce-URL in dat veld op.
    Als u de HTML wel kunt wijzigen, maar geen script kunt toevoegen Stel het kenmerk action van uw <form> in op de Salesforce-URL en stel het kenmerk method in op POST.
    Als uw formulier een back-endproces gebruikt Verzend een POST-aanvraag naar de Salesforce-URL met de formuliergegevens, met application/x-www-form-urlencoded.
  3. Controleer of de naam van elk veld exact overeenkomt met de toegewezen externe veldnaam.
    De formulierhandler legt velden alleen vast wanneer ze exact overeenkomen.
  4. Voeg het domein dat uw formulier host toe aan de CORS-whitelist. Deze stap autoriseert uw domein om indieningen naar Salesforce te verzenden.

De CORS-whitelist configureren

Voor beide verbindingsmethoden moet u uw domein autoriseren voordat Salesforce formulierindieningen accepteert. Als u uw domein niet autoriseert, blokkeert Salesforce de indiening voordat deze wordt verwerkt. Als u uw domein wilt autoriseren, voegt u het toe aan de CORS-whitelist.

  1. Identificeer het domein dat het formulier host, zoals https://www.example.com. Gebruik voor het autoriseren van alle subdomeinen een jokerteken, zoals https://*.example.com.
  2. Voeg het domein toe aan de CORS-whitelist.

Het formulier testen

Nadat u uw formulier hebt verbonden met de formulierhandler, test u het om er zeker van te zijn dat het werkt zoals u verwacht.

  1. Dien op het formulier een testitem in en bevestig dat u naar de succes-URL wordt gestuurd.
  2. Controleer in Salesforce of er een record is gemaakt of bijgewerkt die overeenkomt met het testitem.
    Tip
    Tip Als er geen record wordt gemaakt of bijgewerkt na het indienen van een testinvoer, controleert u of het naamkenmerk van elk formulierveld overeenkomt met de naam van een extern veld. Als de formulierhandler is verbonden met een stroom, controleert u of de stroom zonder fouten wordt voltooid.
 
Wordt geladen
Salesforce Help | Article