Ulkoisen lomakkeen yhdistäminen lomakkeiden käsittelijään
Kun olet luonut ja julkaissut lomakkeen käsittelijän, määritä ulkoinen lomakkeesi lähettämään dataa Salesforceen.
Vaaditut versiot
| Tarvittavat käyttöoikeudet | |
|---|---|
| Lomakkeen käsittelijän luominen: | Marketing Cloud Manager -käyttöoikeusjoukko AND Mikä tahansa CMS-työtilan sisällöntuottajan rooli |
| Lomakkeen käsittelijän julkaiseminen: | Marketing Cloud Manager -käyttöoikeusjoukko AND Sisältöpäällikön tai sisältöpäällikön CMS-työtilan sisällöntuottajan rooli |
| CORS-allowlist-luettelon määrittäminen: | Kaikkien tietojen muokkausoikeus |
Ennen kuin suoritat nämä vaiheet, luo ja julkaise lomakkeen käsittelijä.
Voit lähettää tietoja lomakkeestasi Salesforceen kahdella eri tavalla. Valitse yhteyden tyyppi, joka sopii parhaiten sivuston rakenteeseen ja ominaisuuksiin.
| JavaScript-koodikatkelma (asiakaspuoli) | Suora POST URL (palvelinpuoleinen) |
|
|---|---|---|
| Miten se toimii | Sivullasi oleva komentosarja lähettää lomakkeen tiedot Salesforceen, kun vierailija lähettää lomakkeen. | Lomakkeesi lähettää dataa suoraan Salesforcen URL-osoitteeseen ilman komentosarjaa sivulla. |
| Lisää sivustollesi | <script>-tunniste ja -lomakeattribuutit, jotka liität sivusi HTML-koodiin. |
URL-osoite, jonka määrität lomakkeesi tai webhook-kohteesi toiminnoksi. |
| Suosituin | Sivut, joilla voit hallita HTML-koodia ja lisätä komentosarjoja. | Kolmansien osapuolten lomakkeiden rakennusohjelmat, jotka eivät salli mukautettuja komentosarjoja, sivut, joilla on tiukat Content Security Policy (CSP) -säännöt, sekä lomakkeet, jotka lähetetään taustapalvelimelta. |
| Tukee verkkojen seurantaa | Kyllä | Ei |
| Tukee identiteetin ratkaisemista | Kyllä | Ei |
| Vaatii CORS Allowlist -merkinnän | Kyllä | Kyllä |
Molemmat metodit lähettävät dataa samaan lomakkeen käsittelijään ja käynnistävät saman kulun. Molemmat menetelmät vaativat myös, että valtuutat toimialueesi CORS Allowlist-luettelosta.
Kun käytät molempia yhteystyyppejä, varmista, että lomakkeesi jokainen kenttä käyttää HTML name -attribuuttia, joka vastaa tarkalleen lomakkeen käsittelijän ulkoisen kentän nimeä. Jos nimet eivät vastaa toisiaan, lomakkeen käsittelijä ei kaappaa arvoa. Jos kartoitit esimerkiksi ulkoisen kentän nimen email_address Email-kenttään, lomakkeen vastaavan kentän name-attribuutin täytyy olla myös email_address.
Vaihtoehto 1: Lomakkeesi määrittäminen asiakassivun yhteyden käyttämiseksi
Käytä tätä menetelmää, kun hallitset sivusi HTML-koodia ja voit lisätä siihen komentosarjan. Koska komentosarja suoritetaan vierailijan selaimessa, tämä menetelmä tukee verkkon seurantaa ja identiteetin ratkaisemista. Tästä syystä tämä menetelmä voi yhdistää lomakkeen lähetyksen vierailijan verkkotoimintoon.
- Julkaise lomakkeen käsittelijä.
-
Kopioi seurantakomentosarja Koodinpätkä-välilehden Client-Side Form Handler -osiosta. Komentosarja muistuttaa tätä esimerkkiä.
<script async src="https://YOUR_DOMAIN/lp/assets/scripts/external-form-handler-host.min.js" onload="SFDCFormHandler.init('https://YOUR_DOMAIN/lp')"></script> -
Liitä komentosarja sivuston HTML-koodissa ennen sulkevaa
</body>-tunnistetta. -
Kopioi laitetyypit Koodinpätkä-välilehdestä. Attribuutit muistuttavat tätä esimerkkiä.
<form id="CONTENT_KEY" data-uma-forms="true"></form> -
Lisää HTML-koodissasi
id- jadata-uma-forms-attribuutit<form>-tunnisteeseen. -
Varmista, että kunkin lomakekentän HTML
name-attribuutti vastaa kartoitetun ulkoisen kentän nimeä. - Lisää lomakkeesi isännöivä toimialue CORS Allowlist-luetteloon. Tämä vaihe valtuuttaa toimialueesi lähettämään lähetyksiä Salesforceen.
- Ota verkkoseuranta käyttöön valvoaksesi käyttäjien osallistumista.
Kun vierailija lähettää lomakkeen, komentosarja lähettää tiedot Salesforceen ja lomakkeen käsittelijä käsittelee lähetyksen ja käynnistää kulkusi. Sen jälkeen lomakkeen käsittelijä ohjaa ne määrittämääsi onnistumisen tai virheen URL-osoitteeseen.
Vaihtoehto 2: Lomakkeesi määrittäminen palvelinpuolen yhteyden käyttämiseksi
Käytä palvelinpuolen yhteyttä, kun et voi lisätä koodia sivullesi tai tehdä mukautettuja kokoonpanoja koodillesi. Tällä menetelmällä lomakkeen käsittelijä antaa sinulle kohdesi URL-osoitteen ja määrität lomakkeen lähettämään sen tiedot kyseiseen URL-osoitteeseen. Koska et upota komentosarjaa, tämä menetelmä toimii lomakkeiden työkaluissa, jotka eivät salli mukautettua JavaScriptia. Tämä menetelmä soveltuu myös sivuille, joilla on tiukat Content Security Policy (CSP) -säännöt, sekä lomakkeille, jotka lähetetään taustapalvelimelta.
-
Kopioi lomakkeen käsittelijän Koodinpätkä-välilehden Palvelinpuolen lomakkeen käsittelijä -osiosta lomakkeen toiminnon URL. URL muistuttaa tätä esimerkkiä.
https://YOUR_DOMAIN/lp/cms/form/submit/v1/CONTENT_KEY -
Määritä lomake lähettämään tiedot Salesforceen. Toteutusvaiheet riippuvat lomakkeesi toteutustavoista.
Jos käytät kolmannen osapuolen lomakkeiden rakennusohjelmaa tai lisäosaa Etsi kolmannen osapuolen työkalun asetuksista kenttä lomakkeen toiminnon, URL-osoitteen lähetyksen tai Webhook-kohteen määrittämiseksi. Syötä Salesforcen URL-osoite kyseiseen kenttään. Jos voit muokata HTML-koodia, mutta et lisätä komentosarjaa Määritä <form>-tunnisteenaction-attribuutiksi Salesforcen URL ja määritämethod-attribuutiksiPOST.Jos lomakkeesi käyttää taustaprosessia Lähetä POST-pyyntö Salesforcen URL-osoitteeseen lomakkeen tiedoilla ja application/x-www-form-urlencoded-koodilla. -
Varmista, että kunkin kentän nimi vastaa kartoitetun ulkoisen kentän nimeä tarkalleen.
Lomakkeen käsittelijä kaappaa kentät vain, kun ne vastaavat toisiaan tarkalleen.
- Lisää lomakkeesi isännöivä toimialue CORS Allowlist-luetteloon. Tämä vaihe valtuuttaa toimialueesi lähettämään lähetyksiä Salesforceen.
CORS-allowlist-luettelon määrittäminen
Molemmat yhteyden menetelmät vaativat, että valtuutat toimialueesi ennen kuin Salesforce hyväksyy lomakkeiden lähetyksiä. Jos et valtuuta toimialuettasi, Salesforce estää lähetyksen ennen kuin se käsitellään. Jos haluat valtuuttaa toimialueesi, lisää se CORS Allowlist -luetteloon.
-
Valitse toimialue, joka isännöi lomaketta, kuten
https://www.example.com. Jos haluat valtuuttaa kaikki alatoimialueet, käytä yleismerkkiä, kutenhttps://*.example.com. - Lisää toimialue CORS-allowlist-luetteloon.
Testaa lomaketta
Kun olet yhdistänyt lomakkeesi lomakkeen käsittelijään, testaa sitä varmistaaksesi, että se toimii odotetulla tavalla.
- Lähetä lomakkeesta testimerkintä ja vahvista, että olet lähetetty onnistuneen URL-osoitteen.
-
Tarkasta Salesforcessa, luotiinko tai päivitettiinko testimerkintää vastaava tietue.
Vihje Jos tietuetta ei luoda tai päivitetä testimerkinnän lähettämisen jälkeen, varmista, että kunkin lomakekentän nimen attribuutti vastaa ulkoisen kentän nimeä. Jos lomakkeen käsittelijä on yhdistetty kulkuun, varmista, että kulku suoritetaan virheettömästi.
