Vďaka integrácii so Salesforce Marketing Cloud sa každý, kto sa zaregistruje, vytvorí alebo aktualizuje ako kontakt v Marketing Cloud, pričom e-mailová adresa slúži ako kľúč kontaktu. S nastavením vám zvyčajne bude musieť pomôcť váš správca Salesforce.
Čo potrebujete
- Účet Salesforce Marketing Cloud a používateľa s prístupom do Setup > Installed Packages (zvyčajne správca Marketing Cloud).
- Plán Scratcher, ktorý zahŕňa všetky natívne integrácie. Ak je tlačidlo zamknuté, pozrite si článok Vaša skúšobná verzia, plány a čo sa stane po skončení skúšobnej verzie.
Krok 1: Vytvorte prístupové údaje k API v Marketing Cloud
- V Marketing Cloud otvorte Setup (z ponuky pod vaším menom).
- Prejdite do Apps > Installed Packages a kliknite na New. Pomenujte balík, napríklad „Scratcher“, a uložte ho.
- Kliknite na Add Component, vyberte API Integration a potom Server-to-Server.
- Nastavte oprávnenia uvedené nižšie a uložte.
- Otvorte komponent. Skopírujte Client Id, Client Secret, Authentication Base URI a REST Base URI.
- Uistite sa, že balík má prístup k obchodnej jednotke, do ktorej chcete kontakty ukladať (v časti Access pri balíku).
- Nájdite externý kľúč dátového rozšírenia, ktoré váš tím používa pre leady zo Scratcheru. V Contact Builder alebo Email Studio otvorte dátové rozšírenie a skopírujte jeho External Key.
Oprávnenia, ktoré balík potrebuje
Scratcher žiada Marketing Cloud presne o tieto rozsahy, takže ich komponent musí povoliť:
- Contacts > List and Subscribers: Read a Write. Na vyhľadávanie kontaktov podľa e-mailu a ich vytváranie či aktualizáciu.
- Data > Data Extensions: Write.
Nič iné nie je potrebné.
Krok 2: Prepojte ho so Scratcherom
- V Scratcheri prejdite do Nastavenia > Integrácie a kliknite na Salesforce Marketing Cloud.
- Vyplňte polia:
- Auth Base URL: Authentication Base URI, napríklad
https://xxxx.auth.marketingcloudapis.com. - Rest Base URL: REST Base URI, napríklad
https://xxxx.rest.marketingcloudapis.com. - Client ID a Client Secret.
- Data extension id: externý kľúč z kroku 1.
- Auth Base URL: Authentication Base URI, napríklad
- Kliknite na Nainštalovať integráciu. Scratcher sa prihlási do Marketing Cloud a overí údaje.
Obe URL adresy musia byť adresami API Marketing Cloud (končiace na marketingcloudapis.com). Iné adresy budú odmietnuté.
Krok 3: Zapnite ju v kampani
- V editore prejdite do Prepojiť > Integrácie > Salesforce Marketing Cloud a kliknite na Aktivovať.
- Ak ste prepojili viac ako jeden účet, vyberte ho v časti Vybrať účet.
- V časti Mapovanie polí kliknite na Pridať mapovanie poľa, vyberte pole Scratcheru a do Názov externého poľa zadajte názov atribútu v Marketing Cloud.
- V časti Filtrovať podľa súhlasov (voliteľné) v prípade potreby vyberte svoje políčko so súhlasom.
- Kliknite na Uložiť a potom na Otestovať.
Dobré vedieť: nevyberá sa žiadny zoznam, takže Scratcher začne odosielať hneď, ako kliknete na Aktivovať. Aktivujte integráciu ešte pred spustením kampane alebo mapovanie nastavte okamžite.
Čo sa odosiela
- E-mailová adresa sa použije ako kľúč kontaktu a uloží sa do sady atribútov Email Addresses so zapnutými HTML e-mailmi.
- Meno a priezvisko z vášho formulára sa uložia do Email Demographics.
- Vaše namapované polia sa uložia do sady atribútov s názvom Custom Data pod názvami, ktoré ste zadali. Požiadajte svojho správcu, aby túto sadu atribútov vytvoril v Contact Builder so zodpovedajúcimi názvami atribútov.
Nové registrácie sa odošlú do minúty či dvoch a existujúce leady kampane sa odošlú pri jej aktivácii.
Riešenie problémov
- „All or some of the fields are invalid. The integration failed to validate the fields.“ pri inštalácii: skontrolujte obe URL adresy, client ID a secret a či má balík vyššie uvedené oprávnenia.
- Odoslanie zlyhá s neznámym atribútom: niektorý Názov externého poľa nezodpovedá atribútu v Custom Data. Opravte názov alebo atribút pridajte.
- „The Salesforce Marketing Cloud urls must be marketingcloudapis.com addresses.“: nainštalujte integráciu znova so správnymi URL adresami.
Potrebujete hlbšie prepojenie so Salesforce, napríklad so Sales Cloud? V plánoch Enterprise ho môžeme vytvoriť spoločne s vami. Dohodnite si stretnutie.