Cu integrarea Bloomreach, toți cei care se înscriu sunt creați sau actualizați ca clienți în proiectul Bloomreach Engagement, identificați după adresa de e-mail. Le puteți da și un consimțământ Bloomreach, ca să le puteți trimite mesaje de marketing.
De ce aveți nevoie
- Un proiect Bloomreach Engagement și un utilizator care poate gestiona accesul API în setările proiectului (de obicei un administrator al proiectului).
Pasul 1: Creați o cheie API în Bloomreach
- În Bloomreach Engagement, deschideți proiectul și mergeți la Project settings > Access management > API.
- Copiați Project token și API base URL afișate pe pagină.
- Sub grupurile API, creați un grup nou cu Private access și dați-i un nume, de exemplu „Scratcher”.
- Creați o cheie API nouă în grup. Copiați API key ID și API secret. Secretul este afișat o singură dată.
- Dați grupului permisiunile de mai jos și salvați.
Permisiunile de care are nevoie cheia
În permisiunile grupului, permiteți:
- Customer properties: get și set, pentru a găsi clienți și a-i crea sau actualiza și pentru a afișa proprietățile clienților în maparea câmpurilor.
- Events: set, pentru evenimentul
consent, ca Scratcher să poată înregistra consimțăminte.
Nu este nevoie de nimic altceva. Fără permisiunile set, livrările eșuează cu eroarea de acces a Bloomreach.
Pasul 2: Conectați Bloomreach la Scratcher
- În Scratcher, mergeți la Setări > Integrări și faceți clic pe Bloomreach.
- Lipiți URL-ul de bază API, tokenul proiectului, ID-ul cheii API și secretul API în câmpurile corespunzătoare.
- Faceți clic pe Instalați integrarea. Scratcher verifică datele cu Bloomreach.
Pasul 3: Activați-o într-o campanie
- În editor, mergeți la Conectați > Integrări > Bloomreach și faceți clic pe Activați.
- Dacă ați conectat mai multe proiecte, alegeți-l pe cel potrivit sub Selectați contul.
- Sub Mapări de câmpuri, faceți clic pe Adăugați mapare de câmp și asociați fiecare Câmp Scratcher cu o proprietate de client din Bloomreach, de exemplu „Lead - Prenume” cu first_name.
- Alegeți categoria de consimțământ pe care trebuie să o primească oamenii, de exemplu „newsletter”, sau niciuna.
- Sub Filtrare după consimțăminte (opțional), alegeți caseta de consimțământ pentru marketing, astfel încât să fie trimiși doar cei care au bifat-o.
- Faceți clic pe Salvați, apoi pe Testați.
Bine de știut: Bloomreach nu are liste. Toată lumea ajunge în proiect, iar dumneavoastră grupați oamenii cu segmente în Bloomreach. De aceea, Scratcher începe să trimită imediat ce faceți clic pe Activați. Activați integrarea înainte ca campania să devină live sau configurați-o pe loc.
Maparea câmpurilor
- Adresa de e-mail este trimisă întotdeauna și este folosită pentru a găsi clientul. Nu trebuie să o mapați.
- Lista Câmp de destinație afișează proprietățile de client din proiect. Dacă o proprietate lipsește, creați-o mai întâi în Bloomreach.
- Pentru a marca de unde vin clienții, folosiți Folosiți valoare personalizată pentru a mapa o valoare precum „Jocul de vară Scratcher” la o proprietate pe care o folosiți pentru sursă.
Consimțământ
Dacă alegeți o categorie de consimțământ, Scratcher înregistrează un eveniment consent cu acțiunea accept și numele campaniei ca sursă. Categoria trebuie să existe în Bloomreach (în setările de consimțământ din Project settings). Folosiți Filtrare după consimțăminte (opțional), astfel încât doar cei care au bifat caseta de marketing să primească consimțământul.
Ce se trimite și când
Înscrierile noi sunt trimise în decurs de un minut sau două. Când activați integrarea, sunt trimise și lead-urile existente ale campaniei. Când cineva participă din nou, clientul este actualizat. Verificați fiecare livrare la Setări > Integrări > Starea livrării. Consultați Verificați starea livrării și retrimiteți lead-uri.
Depanare
- „Toate sau unele dintre câmpuri nu sunt valide...” la instalare: verificați URL-ul de bază API și tokenul proiectului și copiați din nou ID-ul cheii și secretul.
- Livrările eșuează cu o eroare de acces: grupului API îi lipsește una dintre permisiunile de mai sus. Editați-l în Bloomreach.
- Consimțământul nu apare la client: categoria de consimțământ nu există în Bloomreach sau este scrisă diferit.
- Bloomreach are propriile ghiduri pentru cheile API. Căutați „API access management” în documentația Bloomreach dacă meniurile arată altfel.