Uz Bloomreach integraciju svaka osoba koja se registrira izrađuje se ili ažurira kao kupac u vašem Bloomreach Engagement projektu, a identificira se putem adrese e-pošte. Možete joj dodijeliti i Bloomreach privolu kako biste joj smjeli slati marketinške poruke.
Što vam je potrebno
- Bloomreach Engagement projekt i korisnik koji može upravljati API pristupom u postavkama projekta (obično administrator projekta).
1. korak: izradite API ključ u Bloomreachu
- U Bloomreach Engagementu otvorite projekt i idite na Project settings > Access management > API.
- Kopirajte Project token i API base URL prikazane na stranici.
- U odjeljku API grupa izradite novu grupu s Private access i nazovite je, primjerice, „Scratcher”.
- U grupi izradite novi API ključ. Kopirajte API key ID i API secret. Tajni ključ prikazuje se samo jednom.
- Grupi dodijelite dolje navedena dopuštenja i spremite.
Dopuštenja koja ključ treba
U dopuštenjima grupe omogućite:
- Customer properties: get i set, kako bi se kupci mogli pronaći, izraditi ili ažurirati te kako bi se vaša svojstva kupaca prikazala u mapiranju polja.
- Events: set, za događaj
consent, kako bi Scratcher mogao bilježiti privole.
Ništa drugo nije potrebno. Bez dopuštenja set slanja ne uspijevaju i Bloomreach vraća vlastitu pogrešku pristupa.
2. korak: povežite Bloomreach sa Scratcherom
- U Scratcheru idite na Postavke > Integracije i kliknite Bloomreach.
- U odgovarajuća polja zalijepite API base URL, project token, API key ID i API secret.
- Kliknite Instaliraj integraciju. Scratcher će provjeriti podatke s Bloomreachom.
3. korak: uključite je u kampanji
- U uređivaču idite na Poveži > Integracije > Bloomreach i kliknite Aktiviraj.
- Ako ste povezali više projekata, odaberite željeni pod Odaberi račun.
- Pod Mapiranje polja kliknite Dodaj mapiranje polja i svako Scratcher polje povežite sa svojstvom kupca u Bloomreachu, primjerice „Lead - Ime” s first_name.
- Odaberite kategoriju privole koju sudionici trebaju dobiti, primjerice „newsletter”, ili nijednu.
- Pod Filtriraj prema dopuštenjima (neobavezno) odaberite potvrdni okvir marketinške privole kako bi se slale samo osobe koje su ga označile.
- Kliknite Spremi, a zatim Testiraj.
Dobro je znati: Bloomreach nema popise. Svi ulaze u projekt, a u Bloomreachu ih grupirate pomoću segmenata. Zato Scratcher počinje slati podatke čim kliknete Aktiviraj. Aktivirajte integraciju prije pokretanja kampanje ili je odmah postavite.
Mapiranje polja
- Adresa e-pošte uvijek se šalje i koristi za pronalazak kupca. Ne morate je mapirati.
- Popis Odredišno polje prikazuje svojstva kupaca u vašem projektu. Ako svojstvo nedostaje, najprije ga izradite u Bloomreachu.
- Kako biste označili odakle kupci dolaze, mapirajte Koristi prilagođenu vrijednost, primjerice „Scratcher ljetna igra”, na svojstvo koje koristite za izvor.
Privola
Ako odaberete kategoriju privole, Scratcher bilježi događaj consent s radnjom accept i nazivom kampanje kao izvorom. Kategorija mora postojati u Bloomreachu (u postavkama privola pod Project settings). Koristite Filtriraj prema dopuštenjima kako bi privolu dobile samo osobe koje su označile vaš marketinški potvrdni okvir.
Što se šalje i kada
Nove registracije šalju se u roku od minute-dvije. Kada aktivirate integraciju, šalju se i postojeći leadovi kampanje. Kada netko ponovno sudjeluje, kupac se ažurira. Svako slanje provjerite pod Postavke > Integracije > Status isporuke. Pogledajte Provjera statusa isporuke i ponovno slanje leadova.
Rješavanje problema
- „All or some of the fields are invalid...” pri instalaciji: provjerite API base URL i project token te ponovno kopirajte key ID i secret.
- Slanja ne uspijevaju zbog pogreške pristupa: API grupi nedostaje neko od gore navedenih dopuštenja. Uredite je u Bloomreachu.
- Privola se ne prikazuje kod kupca: kategorija privole ne postoji u Bloomreachu ili je drukčije napisana.
- Bloomreach ima vlastite upute za API ključeve. Ako izbornici izgledaju drukčije, u Bloomreachovoj dokumentaciji potražite „API access management”.