Vďaka integrácii s Bloomreach sa každý, kto sa zaregistruje, vytvorí alebo aktualizuje ako zákazník vo vašom projekte Bloomreach Engagement, identifikovaný podľa e-mailovej adresy. Môžete mu tiež priradiť súhlas v Bloomreach, aby ste mu mohli posielať marketingovú komunikáciu.
Čo budete potrebovať
- Projekt v Bloomreach Engagement a používateľa, ktorý môže v nastaveniach projektu spravovať prístup k API (zvyčajne administrátor projektu).
Krok 1: Vytvorte API kľúč v Bloomreach
- V Bloomreach Engagement otvorte projekt a prejdite do Project settings > Access management > API.
- Skopírujte Project token a API base URL zobrazené na stránke.
- V časti API groups vytvorte novú skupinu s Private access a pomenujte ju napríklad „Scratcher“.
- V skupine vytvorte nový API kľúč. Skopírujte API key ID a API secret. Secret sa zobrazí iba raz.
- Priraďte skupine nižšie uvedené oprávnenia a uložte.
Oprávnenia, ktoré kľúč potrebuje
V oprávneniach skupiny povoľte:
- Customer properties: get a set – na vyhľadávanie zákazníkov, ich vytváranie či aktualizáciu a na zobrazenie vašich vlastností zákazníkov v mapovaní polí.
- Events: set pre udalosť
consent, aby Scratcher mohol zaznamenávať súhlasy.
Nič iné nie je potrebné. Bez oprávnení set doručenie zlyhá s chybou prístupu priamo od Bloomreach.
Krok 2: Prepojte Bloomreach so Scratcherom
- V Scratcheri prejdite do Nastavenia > Integrácie a kliknite na Bloomreach.
- Do príslušných polí vložte API base URL, project token, API key ID a API secret.
- Kliknite na Nainštalovať integráciu. Scratcher overí údaje v Bloomreach.
Krok 3: Zapnite integráciu v kampani
- V editore prejdite do Prepojenie > Integrácie > Bloomreach a kliknite na Aktivovať.
- Ak máte prepojených viac projektov, vyberte ten správny v časti Vybrať účet.
- V časti Mapovanie polí kliknite na Pridať mapovanie poľa a priraďte každé pole Scratcher k vlastnosti zákazníka v Bloomreach, napríklad „Lead – Meno“ k first_name.
- Vyberte kategóriu súhlasu, ktorú majú ľudia dostať, napríklad „newsletter“, alebo žiadnu.
- V časti Filtrovať podľa súhlasov (voliteľné) vyberte zaškrtávacie pole marketingového súhlasu, aby sa odosielali iba ľudia, ktorí ho zaškrtli.
- Kliknite na Uložiť a potom na Otestovať.
Dobré vedieť: Bloomreach nepoužíva zoznamy. Všetci sa dostanú do projektu a v Bloomreach ich zoskupujete pomocou segmentov. Scratcher preto začne odosielať hneď, ako kliknete na Aktivovať. Aktivujte integráciu pred spustením kampane, alebo ju nastavte hneď.
Mapovanie polí
- E-mailová adresa sa odosiela vždy a slúži na vyhľadanie zákazníka. Nemusíte ju mapovať.
- Zoznam Cieľové pole zobrazuje vlastnosti zákazníkov vo vašom projekte. Ak vlastnosť chýba, najprv ju vytvorte v Bloomreach.
- Ak chcete označiť, odkiaľ zákazníci prišli, namapujte Použiť vlastnú hodnotu, napríklad „Letná hra Scratcher“, na vlastnosť, ktorú používate pre zdroj.
Súhlas
Ak vyberiete kategóriu súhlasu, Scratcher zaznamená udalosť consent s akciou accept a názvom kampane ako zdrojom. Kategória musí v Bloomreach existovať (v nastaveniach súhlasov v Project settings). Použite Filtrovať podľa súhlasov, aby súhlas dostali iba ľudia, ktorí zaškrtli váš marketingový súhlas.
Čo sa odosiela a kedy
Nové registrácie sa odošlú do minúty či dvoch. Po aktivácii integrácie sa odošlú aj existujúce leady kampane. Keď sa niekto zapojí znova, zákazník sa aktualizuje. Každé doručenie skontrolujete v Nastavenia > Integrácie > Stav doručenia. Pozrite si Kontrola stavu doručenia a opätovné odoslanie leadov.
Riešenie problémov
- „All or some of the fields are invalid...“ pri inštalácii: skontrolujte API base URL a project token a znova skopírujte key ID a secret.
- Doručenie zlyhá s chybou prístupu: API skupine chýba niektoré z vyššie uvedených oprávnení. Upravte ju v Bloomreach.
- Súhlas sa pri zákazníkovi nezobrazuje: kategória súhlasu v Bloomreach neexistuje alebo je napísaná inak.
- Bloomreach má vlastné návody k API kľúčom. Ak menu vyzerajú inak, vyhľadajte v dokumentácii Bloomreach „API access management“.