A Salesforce Marketing Cloud integrációval mindenki, aki regisztrál, kontaktként jön létre vagy frissül a Marketing Cloudban, kontaktkulcsként az e-mail-címmel. A beállításhoz általában a Salesforce-adminisztrátor segítségére lesz szüksége.
Amire szüksége lesz
- Egy Salesforce Marketing Cloud-fiók, valamint egy felhasználó, aki hozzáfér a Setup > Installed Packages menühöz (általában egy Marketing Cloud-adminisztrátor).
- Egy Scratcher-csomag, amely tartalmazza az összes natív integrációt. Ha a gomb zárolva van, olvassa el a Próbaidőszak, csomagok és mi történik a próbaidőszak lejárta után című cikket.
1. lépés: API-hitelesítő adatok létrehozása a Marketing Cloudban
- A Marketing Cloudban nyissa meg a Setup menüt (a neve alatti menüből).
- Lépjen az Apps > Installed Packages menüpontra, és kattintson a New gombra. Adjon nevet a csomagnak, például „Scratcher”, majd mentse.
- Kattintson az Add Component gombra, válassza az API Integration, majd a Server-to-Server lehetőséget.
- Állítsa be az alább felsorolt jogosultságokat, és mentse.
- Nyissa meg a komponenst. Másolja ki a Client Id, Client Secret, Authentication Base URI és REST Base URI értékét.
- Győződjön meg róla, hogy a csomag hozzáfér ahhoz az üzleti egységhez, amelybe a kontaktokat szeretné (a csomag Access részében).
- Keresse meg annak az adatbővítménynek (data extension) a külső kulcsát, amelyet csapata a Scratcher-leadekhez használ. A Contact Builder vagy az Email Studio felületén nyissa meg az adatbővítményt, és másolja ki az External Key értékét.
A csomaghoz szükséges jogosultságok
A Scratcher pontosan ezeket a hatóköröket kéri a Marketing Cloudtól, ezért a komponensnek engedélyeznie kell őket:
- Contacts > List and Subscribers: Read és Write. A kontaktok e-mail-cím alapján történő kereséséhez, létrehozásához és frissítéséhez.
- Data > Data Extensions: Write.
Másra nincs szükség.
2. lépés: Csatlakoztatás a Scratcherhez
- A Scratcherben lépjen a Beállítások > Integrációk menüpontra, és kattintson a Salesforce Marketing Cloud elemre.
- Töltse ki a mezőket:
- Auth Base URL: az Authentication Base URI, például
https://xxxx.auth.marketingcloudapis.com. - Rest Base URL: a REST Base URI, például
https://xxxx.rest.marketingcloudapis.com. - Client ID és Client Secret.
- Data extension id: az 1. lépésben kimásolt külső kulcs.
- Auth Base URL: az Authentication Base URI, például
- Kattintson az Integráció telepítése gombra. A Scratcher bejelentkezik a Marketing Cloudba az adatok ellenőrzéséhez.
Mindkét URL-nek Marketing Cloud API-címnek kell lennie (marketingcloudapis.com végződéssel). Más címeket a rendszer elutasít.
3. lépés: Bekapcsolás egy kampányban
- A Szerkesztőben lépjen a Kapcsolódás > Integrációk > Salesforce Marketing Cloud menüpontra, és kattintson az Aktiválás gombra.
- Ha több fiókot is csatlakoztatott, válassza ki a megfelelőt a Fiók kiválasztása alatt.
- A Mezőleképezések alatt kattintson a Mezőleképezés hozzáadása gombra, válassza ki a Scratcher-mezőt, és írja be a Marketing Cloud-attribútum nevét a Külső mezőnév mezőbe.
- A Szűrés hozzájárulások alapján (opcionális) alatt szükség esetén válassza ki a hozzájárulási jelölőnégyzetet.
- Kattintson a Mentés, majd a Teszt gombra.
Jó tudni: itt nincs kiválasztandó lista, így a Scratcher az Aktiválás gombra kattintva azonnal megkezdi az adatküldést. Aktiválja a kampány indulása előtt, vagy azonnal állítsa be a leképezéseket.
Milyen adatok kerülnek átküldésre
- Az e-mail-cím kontaktkulcsként szolgál, és az Email Addresses attribútumkészletbe kerül, bekapcsolt HTML-e-mailekkel.
- Az űrlapon megadott kereszt- és vezetéknév az Email Demographics készletbe kerül.
- A leképezett mezők a Custom Data nevű attribútumkészletbe kerülnek, az Ön által megadott nevekkel. Kérje meg adminisztrátorát, hogy hozza létre ezt az attribútumkészletet a Contact Builderben, egyező attribútumnevekkel.
Az új regisztrációk egy-két percen belül átkerülnek, a kampány meglévő leadjei pedig az aktiváláskor.
Hibaelhárítás
- „All or some of the fields are invalid. The integration failed to validate the fields.” telepítéskor: ellenőrizze a két URL-t, a Client ID-t és a Client Secretet, valamint hogy a csomag rendelkezik-e a fenti jogosultságokkal.
- A küldés ismeretlen attribútum miatt sikertelen: egy Külső mezőnév nem egyezik a Custom Data egyik attribútumával sem. Javítsa a nevet, vagy adja hozzá az attribútumot.
- „The Salesforce Marketing Cloud urls must be marketingcloudapis.com addresses.”: telepítse újra az integrációt a helyes URL-ekkel.
Mélyebb Salesforce-kapcsolatra van szüksége, például a Sales Clouddal? Enterprise csomag esetén közösen kiépítjük. Foglaljon időpontot.