Bloomreachi integratsiooniga luuakse või uuendatakse iga registreerunu kliendina teie Bloomreach Engagementi projektis, kusjuures teda tuvastatakse e-posti aadressi järgi. Samuti saate talle anda Bloomreachi nõusoleku, et võiksite talle turundussõnumeid saata.
Mida on vaja
- Bloomreach Engagementi projekti ja kasutajat, kes saab projekti seadetes API-juurdepääsu hallata (tavaliselt projekti administraator).
1. samm: looge Bloomreachis API-võti
- Avage Bloomreach Engagementis projekt ja minge jaotisse Project settings > Access management > API.
- Kopeerige lehel kuvatud Project token ja API base URL.
- Looge API-gruppide all uus grupp, millel on Private access, ja pange sellele nimeks näiteks „Scratcher“.
- Looge grupis uus API-võti. Kopeerige API key ID ja API secret. Salajast võtit näidatakse ainult üks kord.
- Andke grupile allpool toodud õigused ja salvestage.
Võtmele vajalikud õigused
Lubage grupi õigustes:
- Customer properties: get ja set – klientide leidmiseks, loomiseks või uuendamiseks ning teie kliendiomaduste kuvamiseks väljade vastendamisel.
- Events: set sündmusele
consent, et Scratcher saaks nõusolekuid salvestada.
Muud pole vaja. Ilma set-õigusteta ebaõnnestuvad saatmised Bloomreachi enda juurdepääsuveaga.
2. samm: ühendage Bloomreach Scratcheriga
- Minge Scratcheris jaotisse Seaded > Integratsioonid ja klõpsake Bloomreach.
- Kleepige API base URL, project token, API key ID ja API secret vastavatele väljadele.
- Klõpsake Paigalda integratsioon. Scratcher kontrollib andmeid Bloomreachiga.
3. samm: lülitage see kampaanias sisse
- Minge redaktoris jaotisse Ühenda > Integratsioonid > Bloomreach ja klõpsake Aktiveeri.
- Kui olete ühendanud mitu projekti, valige õige jaotises Vali konto.
- Klõpsake jaotises Väljade vastendused nuppu Lisa välja vastendus ja vastendage iga Scratcheri väli Bloomreachi kliendiomadusega, näiteks „Lead – Eesnimi“ omadusega first_name.
- Valige nõusolekukategooria, mille inimesed saavad, näiteks „newsletter“, või jätke see valimata.
- Valige jaotises Filtreeri nõusolekute järgi (valikuline) oma turundusnõusoleku märkeruut, et saadetaks ainult need, kes selle märkisid.
- Klõpsake Salvesta ja seejärel Testi.
Hea teada: Bloomreachis pole loendeid. Kõik lähevad projekti ning te rühmitate nad Bloomreachis segmentide abil. Seetõttu alustab Scratcher saatmist kohe, kui klõpsate Aktiveeri. Aktiveerige see enne kampaania käivitamist või seadistage see kohe lõpuni.
Väljade vastendamine
- E-posti aadress saadetakse alati ja selle järgi leitakse klient. Seda pole vaja vastendada.
- Loend Sihtväli näitab teie projekti kliendiomadusi. Kui omadus puudub, looge see esmalt Bloomreachis.
- Klientide päritolu märkimiseks vastendage Kasuta kohandatud väärtust, näiteks „Scratcher summer game“, omadusega, mida kasutate allika jaoks.
Nõusolek
Kui valite nõusolekukategooria, salvestab Scratcher sündmuse consent toiminguga accept ja kampaania nimega allikana. Kategooria peab Bloomreachis olemas olema (nõusolekuseadetes jaotises Project settings). Kasutage valikut Filtreeri nõusolekute järgi, et nõusoleku saaksid ainult need, kes märkisid teie turundusnõusoleku ruudu.
Mida ja millal saadetakse
Uued registreerumised saadetakse minuti-paari jooksul. Integratsiooni aktiveerimisel saadetakse ka kampaania olemasolevad leadid. Kui keegi osaleb uuesti, uuendatakse klienti. Iga saatmist saate kontrollida jaotises Seaded > Integratsioonid > Saatmise olek. Vaadake juhendit Saatmise oleku kontrollimine ja leadide uuesti saatmine.
Veaotsing
- Paigaldamisel kuvatakse „All or some of the fields are invalid...“: kontrollige API base URL-i ja project tokenit ning kopeerige võtme ID ja salajane võti uuesti.
- Saatmised ebaõnnestuvad juurdepääsuveaga: API-grupil puudub mõni ülaltoodud õigus. Muutke seda Bloomreachis.
- Nõusolekut kliendi juures ei kuvata: nõusolekukategooriat Bloomreachis pole või see on teisiti kirjutatud.
- Bloomreachil on API-võtmete kohta oma juhendid. Kui menüüd näevad välja teistsugused, otsige Bloomreachi dokumentatsioonist „API access management“.