Con l'integrazione Bloomreach, chiunque si iscriva viene creato o aggiornato come cliente (customer) nel tuo progetto Bloomreach Engagement, identificato dal suo indirizzo email. Puoi anche dargli un consenso di Bloomreach, così puoi inviargli comunicazioni di marketing.
Cosa ti serve
- Un progetto Bloomreach Engagement e un utente che possa gestire l'accesso API nelle impostazioni del progetto (di solito un amministratore del progetto).
Passaggio 1: crea una chiave API in Bloomreach
- In Bloomreach Engagement, apri il progetto e vai su Project settings > Access management > API.
- Copia il Project token e l'API base URL mostrati nella pagina.
- Nei gruppi API, crea un nuovo gruppo con Private access e chiamalo per esempio "Scratcher".
- Crea una nuova chiave API nel gruppo. Copia l'API key ID e l'API secret. Il secret viene mostrato una sola volta.
- Dai al gruppo i permessi indicati qui sotto e salva.
I permessi di cui ha bisogno la chiave
Nei permessi del gruppo, consenti:
- Customer properties: get e set, per trovare i clienti e crearli o aggiornarli, e per mostrare le tue customer property nella mappatura dei campi.
- Events: set, per l'evento
consent, così Scratcher può registrare i consensi.
Non serve altro. Senza i permessi set, le consegne non riescono con l'errore di accesso di Bloomreach.
Passaggio 2: collega Bloomreach a Scratcher
- In Scratcher, vai su Impostazioni > Integrazioni e clicca su Bloomreach.
- Incolla API base URL, project token, API key ID e API secret nei campi corrispondenti.
- Clicca su Installa integrazione. Scratcher controlla i dati con Bloomreach.
Passaggio 3: attivalo in una campagna
- Nell'editor, vai su Collega > Integrazioni > Bloomreach e clicca su Attiva.
- Se hai collegato più di un progetto, sceglilo in Seleziona account.
- In Mappature dei campi, clicca su Aggiungi mappatura dei campi e abbina ogni Campo Scratcher a una customer property di Bloomreach, per esempio "Lead - Nome" a first_name.
- Scegli la categoria di consenso che devono ricevere le persone, per esempio "newsletter", oppure nessuna.
- In Filtra per consensi (facoltativo), scegli la tua casella di consenso al marketing, così vengono inviate solo le persone che l'hanno spuntata.
- Clicca su Salva e poi su Test.
Buono a sapersi: Bloomreach non ha liste. Tutti finiscono nel progetto e li raggruppi con i segmenti in Bloomreach. Per questo Scratcher inizia a inviare appena clicchi su Attiva. Attivalo prima che la campagna vada online, oppure configuralo subito.
Mappatura dei campi
- L'indirizzo email viene sempre inviato e serve a trovare il cliente. Non devi mapparlo.
- L'elenco Campo di destinazione mostra le customer property del tuo progetto. Se ne manca una, creala prima in Bloomreach.
- Per indicare da dove arrivano i clienti, mappa un Usa valore personalizzato come "Scratcher gioco estivo" su una property che usi per la fonte.
Consenso
Se scegli una categoria di consenso, Scratcher registra un evento consent con l'azione accept e il nome della campagna come fonte. La categoria deve esistere in Bloomreach (nelle impostazioni dei consensi in Project settings). Usa Filtra per consensi così ricevono il consenso solo le persone che hanno spuntato la tua casella per il marketing.
Cosa viene inviato e quando
I nuovi iscritti vengono inviati entro un paio di minuti. Quando attivi l'integrazione, vengono inviati anche i lead già presenti nella campagna. Quando qualcuno partecipa di nuovo, il cliente viene aggiornato. Controlla ogni consegna in Impostazioni > Integrazioni > Stato della consegna. Vedi Controlla lo stato della consegna e invia di nuovo i lead.
Risoluzione dei problemi
- "All or some of the fields are invalid..." durante l'installazione: controlla l'API base URL e il project token, e copia di nuovo key ID e secret.
- Le consegne non riescono con un errore di accesso: al gruppo API manca uno dei permessi indicati sopra. Modificalo in Bloomreach.
- Il consenso non compare sul cliente: la categoria di consenso non esiste in Bloomreach oppure è scritta in modo diverso.
- Bloomreach ha le sue guide per le chiavi API. Cerca "API access management" nella documentazione di Bloomreach se i menu sono diversi.