Loading
Marketing Cloud Nästa
Anslut ett externt formulär till en formulärhanterare

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Marketing Cloud nästa

Anslut ett externt formulär till en formulärhanterare

När du har skapat och publicerat en formulärhanterare, konfigurera ditt externa formulär att skicka data till Salesforce.

Versioner som krävs

Visa versioner som stöds.

Användarbehörigheter som krävs för att
Skapa en formulärhanterare:

Behörighetsuppsättningen Marketing Cloud Manager

OCH

En CMS-arbetsområdesmedarbetarroll
Publicera en formulärhanterare:

Behörighetsuppsättningen Marketing Cloud Manager

OCH

En CMS-arbetsområdesmedarbetarroll för innehållsadministratör eller innehållsansvarig
Konfigurera CORS-tillåtelselistan: Ändra all data

Innan du utför dessa steg, skapa och publicera en formulärhanterare.

Det finns två sätt att skicka data från ditt formulär till Salesforce. Välj den anslutningstyp som passar din webbplats struktur och kapacitet bäst.

  JavaScript-stycke (klientsida)

Direkt POST URL (serversida)
Så fungerar det Ett skript på din sida skickar formulärdata till Salesforce när en besökare skickar formuläret. Ditt formulär publicerar data direkt till en Salesforce-URL, utan något skript på sidan.
Lägg till på din webbplats En <script> och formulärattribut som du klistrar in i HTML-koden för din sida. En URL som du anger som åtgärden för ditt formulär eller webhook-destination.
Bäst lämpad för Sidor där du styr HTML och kan lägga till skript. Formulärbyggare från tredje part som inte tillåter egna skript, sidor med strikta CSP-regler (Content Security Policy) och formulär som gör inlägg från en backendserver.
Stöder webbspårning Ja Nej
Stöder identitetslösning Ja Nej
Kräver en CORS-tillåtelselistapost Ja Ja

Båda metoderna skickar data till samma formulärhanterare och utlöser samma flöde. Båda metoderna kräver även att du auktoriserar din domän i CORS-tillåtelselistan.

Med någon av anslutningstyperna, se till att varje fält i ditt formulär använder ett HTML-attribut för name som exakt matchar motsvarande externa fältnamn i formulärhanteraren. Om namnen inte matchar fångar inte formulärhanteraren värdet. Om du till exempel har mappat email_address för det externa fältnamnet till fältet Email måste attributet name för motsvarande fält i formuläret också vara email_address.

Alternativ 1: Konfigurera ditt formulär att använda en anslutning på klientsidan

Använd denna metod när du styr HTML för din sida och kan lägga till ett skript till den. Eftersom skriptet körs i besökarens webbläsare har denna metod stöd för webbspårning och identitetslösning. Som ett resultat av detta kan denna metod ansluta ett formulärinskickning till en besökares webbaktivitet.

  1. Publicera formulärhanteraren.
  2. På fliken Kodstycke, under Hanterare för klientsideformulär, kopiera spårningsskriptet. Skriptet liknar detta exempel. 
    <script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script>
  3. I webbplatsens HTML-kod, klistra in skriptet innan den avslutande </body>.
  4. På fliken Kodstycke, kopiera formulärattributen. Attributen liknar detta exempel. 
    <form id="CONTENT_KEY" data-uma-forms="true"></form>
  5. I din HTML, lägg till attributen id och data-uma-forms i taggen <form>.
  6. Bekräfta att attributet HTML name för varje formulärfält matchar det mappade externa fältnamnet.
  7. Lägg till domänen som är värd för ditt formulär på CORS-tillåtelselistan. Detta steg auktoriserar din domän att skicka inskickningar till Salesforce.
  8. För att bevaka användarengagemang, slå på webbspårning.

När en besökare skickar formuläret skickar skriptet data till Salesforce och formulärhanteraren bearbetar inskickningen och utlöser ditt flöde. Formulärhanteraren omdirigerar dem sedan till den URL för framgång eller fel som du konfigurerade.

Alternativ 2: Konfigurera ditt formulär att använda en anslutning på serversidan

Använd en anslutning på serversidan om du inte kan lägga till kod på din sida eller göra egna konfigurationer av din kod. Med denna metod ger formulärhanteraren dig en destinations-URL och du konfigurerar formuläret att skicka sina data till denna URL. Eftersom du inte bäddar in ett skript fungerar denna metod med formulärverktyg som inte tillåter egen JavaScript. Denna metod är även användbar med sidor som har strikta CSP-regler (Content Security Policy), och med formulär som skickas från en backendserver.

  1. På fliken Kodstycke för formulärhanteraren, under Serversida för formulärhanterare, kopiera formuläråtgärdens URL. URL:en liknar detta exempel. 
    https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY
  2. Konfigurera formuläret för att skicka data till Salesforce. Implementeringsstegen beror på hur du implementerar ditt formulär.
    Om du använder en formulärbyggare eller plugin från tredje part I inställningarna för tredjepartsverktyget, hitta fältet för att konfigurera formulärets åtgärd, post-to-URL eller webhook-destination. Ange Salesforce-URL:en i detta fält.
    Om du kan ändra HTML men inte lägga till ett skript Ställ in attributet action för din <form> till Salesforce URL och ställ in attributet method till POST.
    Om ditt formulär använder en backendprocess Skicka en POST-begäran till Salesforce URL med formulärdata, med application/x-www-form-urlencoded.
  3. Bekräfta att namnet på varje fält matchar det mappade externa fältnamnet exakt.
    Formulärhanteraren samlar endast in fält när de matchar exakt.
  4. Lägg till domänen som är värd för ditt formulär på CORS-tillåtelselistan. Detta steg auktoriserar din domän att skicka inskickningar till Salesforce.

Konfigurera CORS-tillåtelselistan

Båda anslutningsmetoderna kräver att du auktoriserar din domän innan Salesforce accepterar formulärinskickningar. Om du inte auktoriserar din domän blockerar Salesforce inskickningen innan den bearbetas. För att auktorisera din domän, lägg till den på CORS-tillåtelselistan.

  1. Identifiera domänen som är värd för formuläret, till exempel https://www.example.com. För att auktorisera alla underdomäner, använd ett jokertecken, till exempel https://*.example.com.
  2. Lägg till domänen på CORS-tillåtelselistan.

Testa formuläret

När du har anslutit ditt formulär till formulärhanteraren, testa det för att se till att det beter sig som du förväntar dig.

  1. I formuläret, skicka in en testpost och bekräfta att du skickas till framgångs-URL:en.
  2. I Salesforce, kontrollera om en post som motsvarar testposten har skapats eller uppdaterats.
    Tips
    Tips Om en post inte skapas eller uppdateras efter att en testpost har skickats, bekräfta att varje formulärfälts namnattribut matchar ett externt fältnamn. Om formulärhanteraren är ansluten till ett flöde, bekräfta att flödet slutförs utan fel.
 
Laddar
Salesforce Help | Article