Z integracijo Bloomreach se vsak, ki se prijavi, ustvari ali posodobi kot stranka v vašem projektu Bloomreach Engagement, prepoznana po e-poštnem naslovu. Dodelite ji lahko tudi privolitev v Bloomreachu, tako da ji smete pošiljati marketinška sporočila.
Kaj potrebujete
- Projekt Bloomreach Engagement in uporabnika, ki lahko v nastavitvah projekta upravlja dostop do API-ja (običajno skrbnik projekta).
1. korak: Ustvarite API ključ v Bloomreachu
- V Bloomreach Engagement odprite projekt in pojdite na Project settings > Access management > API.
- Kopirajte Project token in API base URL, ki sta prikazana na strani.
- Pod skupinami API ustvarite novo skupino s Private access in jo poimenujte na primer „Scratcher“.
- V skupini ustvarite nov API ključ. Kopirajte API key ID in API secret. Skrivnost je prikazana samo enkrat.
- Skupini dodelite spodnja dovoljenja in shranite.
Dovoljenja, ki jih ključ potrebuje
V dovoljenjih skupine omogočite:
- Customer properties: get in set, za iskanje strank, njihovo ustvarjanje ali posodabljanje ter za prikaz lastnosti strank pri preslikavi polj.
- Events: set, za dogodek
consent, da lahko Scratcher beleži privolitve.
Drugega ni treba. Brez dovoljenj set pošiljanja ne uspejo, Bloomreach pa javi lastno napako dostopa.
2. korak: Povežite Bloomreach s Scratcherjem
- V Scratcherju pojdite na Nastavitve > Integracije in kliknite Bloomreach.
- V ustrezna polja prilepite API base URL, project token, API key ID in API secret.
- Kliknite Namesti integracijo. Scratcher podatke preveri pri Bloomreachu.
3. korak: Vklopite jo v kampanji
- V urejevalniku pojdite na Poveži > Integracije > Bloomreach in kliknite Aktiviraj.
- Če ste povezali več projektov, izberite želenega pod Izberite račun.
- Pod Preslikave polj kliknite Dodaj preslikavo polja in vsako polje Scratcher povežite z lastnostjo stranke v Bloomreachu, na primer „Lead - Ime“ z first_name.
- Izberite kategorijo privolitve, ki naj jo ljudje prejmejo, na primer „newsletter“, ali nobene.
- Pod Filtriraj po dovoljenjih (neobvezno) izberite potrditveno polje za marketinško privolitev, da se pošljejo samo tisti, ki so ga označili.
- Kliknite Shrani in nato Preizkusi.
Dobro je vedeti: Bloomreach nima seznamov. Vsi gredo v projekt, v Bloomreachu pa jih združujete s segmenti. Zato Scratcher začne pošiljati takoj, ko kliknete Aktiviraj. Aktivirajte jo, preden kampanja zaživi, ali jo nastavite takoj.
Preslikava polj
- E-poštni naslov se vedno pošlje in se uporablja za iskanje stranke. Preslikati ga ni treba.
- Seznam Ciljno polje prikazuje lastnosti strank v vašem projektu. Če lastnost manjka, jo najprej ustvarite v Bloomreachu.
- Če želite označiti, od kod so stranke prišle, preslikajte Uporabi lastno vrednost, na primer „Scratcher poletna igra“, v lastnost, ki jo uporabljate za vir.
Privolitev
Če izberete kategorijo privolitve, Scratcher zabeleži dogodek consent z dejanjem accept in imenom kampanje kot virom. Kategorija mora obstajati v Bloomreachu (v nastavitvah privolitev pod Project settings). Uporabite Filtriraj po dovoljenjih, da privolitev prejmejo samo tisti, ki so označili vaše marketinško potrditveno polje.
Kaj se pošlje in kdaj
Nove prijave se pošljejo v minuti ali dveh. Ko aktivirate integracijo, se pošljejo tudi obstoječi leadi kampanje. Ko nekdo znova sodeluje, se stranka posodobi. Vsako pošiljanje preverite pod Nastavitve > Integracije > Stanje pošiljanja. Glejte Preverite stanje pošiljanja in znova pošljite leade.
Odpravljanje težav
- „All or some of the fields are invalid...“ pri namestitvi: preverite API base URL in project token ter znova kopirajte ID ključa in skrivnost.
- Pošiljanja ne uspejo zaradi napake dostopa: skupini API manjka katero od zgornjih dovoljenj. Uredite jo v Bloomreachu.
- Privolitev se pri stranki ne prikaže: kategorija privolitve v Bloomreachu ne obstaja ali je drugače zapisana.
- Bloomreach ima lastna navodila za API ključe. Če so meniji videti drugače, v dokumentaciji Bloomreacha poiščite „API access management“.