Loading
Marketing Cloud Næste
Tilslut en ekstern formular til en formularhåndtering

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Marketing Cloud Næste

Tilslut en ekstern formular til en formularhåndtering

Når du har oprettet og udgivet en formularhåndtering, skal du konfigurere din eksterne formular til at sende data til Salesforce.

EditionsHeading

Vis understøttede versioner.

Brugertilladelser påkrævet
Hvis du vil oprette en formularhåndtering:

Marketing Cloud Manager-tilladelsessæt

OG

Enhver CMS-arbejdsområdemedarbejderrolle
Hvis du vil udgive en formularhåndtering:

Marketing Cloud Manager-tilladelsessæt

OG

En CMS-arbejdsområdedeltagerrolle som indholdsadministrator eller indholdsmanager
Hvis du vil konfigurere CORS-tilladelseslisten: Rediger alle data

Før du udfører disse trin, skal du oprette og udgive en formularhåndtering.

Der er to måder, hvorpå du kan sende data fra din formular til Salesforce. Vælg den forbindelsestype, der bedst passer til din lokalitets struktur og funktioner.

  JavaScript-kodestykke (på klientsiden)

Direkte POST URL (Side server)
Hvordan det fungerer Et script på din side sender formulardata til Salesforce, når en besøgende indsender formularen. Din formular sender data direkte til en Salesforce-URL uden script på siden.
Føj til din hjemmeside Et <script> og formularattributter, som du indsætter i HTML'en for din side. En URL, som du angiver som handlingen for din formular eller webhook-destination.
Bedst egnet til Sider, hvor du kontrollerer HTML og kan tilføje scripts. Tredjepartsformularkonstruktører, der ikke tillader tilpassede scripts, sider med strenge CSP-regler (Content Security Policy) og formularer, der sendes fra en backendserver.
Støtter websporing Ja Nej
Støtter identitetsløsning Ja Nej
Kræver en CORS-tilladelseslisteoplysning Ja Ja

Begge metoder sender data til den samme formularhåndtering og udløser det samme forløb. Begge metoder kræver også, at du godkender dit domæne på CORS-tilladelseslisten.

Med begge forbindelsestyper skal du sørge for, at hvert felt i din formular bruger en HTML name-attribut, der nøjagtigt matcher det tilsvarende eksterne feltnavn i formularhåndteringen. Hvis navnene ikke matcher, registrerer formularhåndteringen ikke værdien. Hvis du f.eks. tilknyttede det eksterne feltnavn email_address til Email-feltet, skal name-attributten for det tilsvarende felt i formularen også være email_address.

Indstilling 1: Konfigurer din formular til at bruge en forbindelse på klientsiden

Brug denne metode, når du kontrollerer HTML'en for din side og kan føje et script til den. Da scriptet kører i den besøgendes browser, understøtter denne metode websporing og identitetsløsning. Som resultat kan denne metode tilslutte en formularindsendelse til en besøgendes webaktivitet.

  1. Udgiv formularhåndteringen.
  2. På fanen Kodestykke under Formularhåndtering på klientsiden skal du kopiere sporingsscriptet. Scriptet minder om dette eksempel. 
    <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 HTML-koden for lokaliteten skal du indsætte scriptet før det lukkende </body>.
  4. På fanen Kodestykke skal du kopiere formularattributterne. Attributterne minder om dette eksempel. 
    <form id="CONTENT_KEY" data-uma-forms="true"></form>
  5. Føj id- og data-uma-forms-attributterne til <form>-tagget i din HTML-kode.
  6. Bekræft, at HTML name-attributten for hvert formularfelt matcher det tilknyttede eksterne feltnavn.
  7. Føj det domæne, der er vært for din formular til CORS-tilladelseslisten. Dette trin autoriserer dit domæne til at sende indsendelser til Salesforce.
  8. Hvis du vil overvåge brugerengagement, skal du aktivere websporing.

Når en besøgende indsender formularen, sender scriptet dataene til Salesforce, og formularhåndteringen behandler indsendelsen og udløser dit forløb. Formularhåndteringen omdirigerer dem derefter til den succes- eller fejl-URL, som du konfigurerede.

Indstilling 2: Konfigurer din formular til at bruge en serverforbindelse

Brug en serverforbindelse, når du ikke kan føje kode til din side eller foretage tilpassede konfigurationer af din kode. Med denne metode giver formularhåndteringen dig en destinations-URL, og du konfigurerer formularen til at sende dens data til den pågældende URL. Da du ikke integrerer et script, fungerer denne metode med formularværktøjer, der ikke tillader tilpasset JavaScript. Denne metode er også nyttig med sider, der har strenge CSP-regler (Content Security Policy) og med formularer, der sendes fra en backendserver.

  1. På fanen Kodestykke for formularhåndteringen skal du under Formularhåndtering på serversiden kopiere formularhandlings-URL'en. URL'en minder om dette eksempel. 
    https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY
  2. Konfigurer formularen til at sende dataene til Salesforce. Implementeringstrinene afhænger af, hvordan du implementerer din formular.
    Hvis du bruger en formularkonstruktør eller et plugin fra tredjepart I indstillingerne for tredjepartsværktøjet skal du finde feltet til konfiguration af formularens handling, efter-til-URL eller webhook-destination. Angiv Salesforce-URL'en i dette felt.
    Hvis du kan redigere HTML, men ikke kan tilføje et script Indstil action-attributten for dit <form>-tag til Salesforce-URL'en, og indstil method-attributten til POST.
    Hvis din formular bruger en backendproces Send en POST-anmodning til Salesforce-URL'en med formulardataene med application/x-www-form-urlencoded kodning.
  3. Bekræft, at navnet på hvert felt matcher det tilknyttede eksterne feltnavn nøjagtigt.
    Formularhåndteringen registrerer kun felter, når de matcher nøjagtigt.
  4. Føj det domæne, der er vært for din formular til CORS-tilladelseslisten. Dette trin autoriserer dit domæne til at sende indsendelser til Salesforce.

Konfigurer CORS-tilladelseslisten

Begge forbindelsesmetoder kræver, at du autoriserer dit domæne, før Salesforce accepterer formularindsendelser. Hvis du ikke autoriserer dit domæne, blokerer Salesforce indsendelsen, før den behandles. Hvis du vil godkende dit domæne, skal du føje det til CORS-tilladelseslisten.

  1. Identificer det domæne, der er vært for formularen, f.eks. https://www.example.com. Hvis du vil godkende alle underdomæner, skal du bruge et jokertegn, f.eks. https://*.example.com.
  2. Føj domænet til CORS-tilladelseslisten.

Test formularen

Når du har tilsluttet din formular til formularhåndteringen, kan du teste den for at sikre, at den fungerer, som du forventer det.

  1. På formularen skal du indsende en testoplysning og bekræfte, at du er sendt til succes-URL'en.
  2. I Salesforce skal du kontrollere, om der er oprettet eller opdateret en registrering, der svarer til testposten.
    Tip
    Tip Hvis en registrering ikke oprettes eller opdateres efter indsendelse af en testoplysning, skal du bekræfte, at hvert formularfelts navneattribut matcher et eksternt feltnavn. Hvis formularhåndteringen er tilsluttet et forløb, skal du bekræfte, at forløbet fuldføres uden fejl.
 
Indlæser
Salesforce Help | Article