A Bloomreach integrációval mindenki, aki regisztrál, ügyfélként jön létre vagy frissül a Bloomreach Engagement projektjében, az e-mail-címe alapján azonosítva. Bloomreach-hozzájárulást is adhat nekik, így marketingüzeneteket küldhet számukra.
Amire szüksége lesz
- Egy Bloomreach Engagement projekt, valamint egy felhasználó, aki kezelheti az API-hozzáférést a projekt beállításaiban (általában a projekt adminisztrátora).
1. lépés: API-kulcs létrehozása a Bloomreachben
- A Bloomreach Engagementben nyissa meg a projektet, és lépjen a Project settings > Access management > API menüpontra.
- Másolja ki az oldalon látható Project token és API base URL értékeket.
- Az API-csoportok alatt hozzon létre egy új csoportot Private access hozzáféréssel, és nevezze el például „Scratcher”-nek.
- Hozzon létre egy új API-kulcsot a csoportban. Másolja ki az API key ID és az API secret értékét. A titkos kulcs csak egyszer jelenik meg.
- Adja meg a csoportnak az alábbi jogosultságokat, majd mentsen.
A kulcshoz szükséges jogosultságok
A csoport jogosultságainál engedélyezze a következőket:
- Customer properties: get és set, hogy az ügyfeleket meg lehessen találni, létre lehessen hozni vagy frissíteni, és hogy az ügyféltulajdonságok megjelenjenek a mezőmegfeleltetésben.
- Events: set, a
consenteseményhez, hogy a Scratcher rögzíthesse a hozzájárulásokat.
Más nem szükséges. A set jogosultságok nélkül a kézbesítések a Bloomreach saját hozzáférési hibájával meghiúsulnak.
2. lépés: A Bloomreach csatlakoztatása a Scratcherhez
- A Scratcherben lépjen a Beállítások > Integrációk menüpontra, és kattintson a Bloomreach elemre.
- Illessze be az API base URL-t, a project tokent, az API key ID-t és az API secretet a megfelelő mezőkbe.
- Kattintson az Integráció telepítése gombra. A Scratcher ellenőrzi az adatokat a Bloomreachnél.
3. lépés: Bekapcsolás egy kampányban
- A szerkesztőben lépjen a Csatlakoztatás > Integrációk > Bloomreach menüpontra, és kattintson az Aktiválás gombra.
- Ha több projektet is csatlakoztatott, válassza ki a megfelelőt a Fiók kiválasztása alatt.
- A Mezőmegfeleltetések alatt kattintson a Mezőmegfeleltetés hozzáadása gombra, és párosítsa az egyes Scratcher-mezőket egy-egy Bloomreach-ügyféltulajdonsággal, például a „Lead - Keresztnév” mezőt a first_name tulajdonsággal.
- Válassza ki, milyen hozzájárulási kategóriát kapjanak a résztvevők, például „newsletter”, vagy egyiket sem.
- A Szűrés engedélyek szerint (opcionális) alatt válassza ki a marketinghozzájárulási jelölőnégyzetet, így csak azok kerülnek továbbításra, akik bejelölték.
- Kattintson a Mentés, majd a Teszt gombra.
Jó tudni: a Bloomreachben nincsenek listák. Mindenki a projektbe kerül, és a Bloomreachben szegmensekkel csoportosíthatja őket. Ezért a Scratcher azonnal megkezdi a küldést, amint az Aktiválás gombra kattint. Aktiválja a kampány indulása előtt, vagy állítsa be rögtön.
Mezőmegfeleltetés
- Az e-mail-cím mindig továbbításra kerül, és ez alapján azonosítjuk az ügyfelet. Ezt nem kell megfeleltetnie.
- A Célmező lista a projektje ügyféltulajdonságait mutatja. Ha egy tulajdonság hiányzik, előbb hozza létre a Bloomreachben.
- Az ügyfelek forrásának jelöléséhez feleltessen meg egy Egyéni érték használata értéket, például „Scratcher nyári játék”, a forráshoz használt tulajdonsággal.
Hozzájárulás
Ha kiválaszt egy hozzájárulási kategóriát, a Scratcher egy consent eseményt rögzít accept művelettel, forrásként a kampány nevével. A kategóriának léteznie kell a Bloomreachben (a Project settings hozzájárulási beállításai között). Használja a Szűrés engedélyek szerint opciót, hogy csak a marketing-jelölőnégyzetet bejelölők kapják meg a hozzájárulást.
Mi kerül továbbításra és mikor
Az új regisztrációk egy-két percen belül továbbításra kerülnek. Az integráció aktiválásakor a kampány meglévő leadjei is továbbításra kerülnek. Ha valaki ismét részt vesz, az ügyfél adatai frissülnek. Minden kézbesítést ellenőrizhet a Beállítások > Integrációk > Kézbesítési állapot menüpontban. Lásd: A kézbesítési állapot ellenőrzése és a leadek újraküldése.
Hibaelhárítás
- „All or some of the fields are invalid...” üzenet telepítéskor: ellenőrizze az API base URL-t és a project tokent, és másolja ki újra a key ID-t és a secretet.
- A kézbesítések hozzáférési hibával meghiúsulnak: az API-csoportból hiányzik a fenti jogosultságok egyike. Módosítsa a Bloomreachben.
- A hozzájárulás nem jelenik meg az ügyfélnél: a hozzájárulási kategória nem létezik a Bloomreachben, vagy eltérően van írva.
- A Bloomreach saját útmutatókkal rendelkezik az API-kulcsokhoz. Ha a menük másként néznek ki, keressen rá az „API access management” kifejezésre a Bloomreach dokumentációjában.