---
title: "Collega Bloomreach"
description: "Crea una chiave API in Bloomreach Engagement, collegala e crea o aggiorna i clienti con i loro consensi."
url: https://scratcher.io/it/help/integrations/bloomreach
language: it
---

1. [Centro assistenza](https://scratcher.io/it/help)
2. [Integrazioni](https://scratcher.io/it/help/integrations)
3. Collega Bloomreach

# Collega Bloomreach

Crea una chiave API in Bloomreach Engagement, collegala e crea o aggiorna i clienti con i loro consensi.

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

1. In Bloomreach Engagement, apri il progetto e vai su **Project settings** > **Access management** > **API**.
2. Copia il **Project token** e l'**API base URL** mostrati nella pagina.
3. Nei gruppi API, crea un nuovo gruppo con **Private access** e chiamalo per esempio "Scratcher".
4. Crea una nuova chiave API nel gruppo. Copia l'**API key ID** e l'**API secret**. Il secret viene mostrato una sola volta.
5. 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

1. In Scratcher, vai su **Impostazioni** > **Integrazioni** e clicca su **Bloomreach**.
2. Incolla API base URL, project token, API key ID e API secret nei campi corrispondenti.
3. Clicca su **Installa integrazione**. Scratcher controlla i dati con Bloomreach.

## Passaggio 3: attivalo in una campagna

1. Nell'editor, vai su **Collega** > **Integrazioni** > **Bloomreach** e clicca su **Attiva**.
2. Se hai collegato più di un progetto, sceglilo in **Seleziona account**.
3. 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**.
4. Scegli la categoria di consenso che devono ricevere le persone, per esempio "newsletter", oppure nessuna.
5. In **Filtra per consensi (facoltativo)**, scegli la tua casella di consenso al marketing, così vengono inviate solo le persone che l'hanno spuntata.
6. 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](https://scratcher.io/it/help/integrations/delivery-status).

## 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.

Integrazioni

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work)
- [Tutte le integrazioni](https://scratcher.io/it/help/integrations/other-integrations)
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status)
- [Collega HubSpot](https://scratcher.io/it/help/integrations/hubspot)
- [Collega Salesforce Marketing Cloud](https://scratcher.io/it/help/integrations/salesforce-marketing-cloud)
- [Collega Microsoft Dynamics 365 con Zapier](https://scratcher.io/it/help/integrations/microsoft-dynamics-365)
- [Collega Emarsys](https://scratcher.io/it/help/integrations/emarsys)
- [Collega Klaviyo](https://scratcher.io/it/help/integrations/klaviyo)
- [Collega Mailchimp](https://scratcher.io/it/help/integrations/mailchimp)
- [Collega ActiveCampaign](https://scratcher.io/it/help/integrations/activecampaign)
- [Collega Apsis One](https://scratcher.io/it/help/integrations/apsis-one)
- [Collega Drip](https://scratcher.io/it/help/integrations/drip)
- [Collega HeyLoyalty](https://scratcher.io/it/help/integrations/heyloyalty)
- [Collega Peytz](https://scratcher.io/it/help/integrations/peytz)
- [Collega Marketingplatform](https://scratcher.io/it/help/integrations/marketingplatform)
- [Collega Campaign Monitor con Zapier](https://scratcher.io/it/help/integrations/campaign-monitor)
- [Collega ActiveTrail con Zapier](https://scratcher.io/it/help/integrations/activetrail)
- [Collega Bloomreach](https://scratcher.io/it/help/integrations/bloomreach)
- [Collega Iterable](https://scratcher.io/it/help/integrations/iterable)
- [Collega Mapp](https://scratcher.io/it/help/integrations/mapp)
- [Collega Agillic](https://scratcher.io/it/help/integrations/agillic)
- [Collega Ortto](https://scratcher.io/it/help/integrations/ortto)
- [Collega Emarketeer](https://scratcher.io/it/help/integrations/emarketeer)
- [Collega Shopify](https://scratcher.io/it/help/integrations/shopify)
- [Collega Hello Retail](https://scratcher.io/it/help/integrations/hello-retail)
- [Collega oltre 8.000 app con Zapier](https://scratcher.io/it/help/integrations/zapier)
- [Collega monday.com con Zapier](https://scratcher.io/it/help/integrations/monday-com)
- [Collega Asana con Zapier](https://scratcher.io/it/help/integrations/asana)
- [Collega Podio con Zapier](https://scratcher.io/it/help/integrations/podio)
- [Collega Intercom con Zapier](https://scratcher.io/it/help/integrations/intercom)

Continua a imparare

## Articoli correlati

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work): Collega una volta il tuo strumento di email marketing o il CRM, attivalo in ogni campagna, scegli una lista, abbina i campi e invia solo chi ha dato il consenso.
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status): Scopri quali lead sono stati inviati ai tuoi strumenti, capisci i messaggi di errore, risolvi il problema e inviali di nuovo.
- [Chiedi il consenso e aggiungi termini e condizioni](https://scratcher.io/it/help/forms/consent-and-permissions): Aggiungi caselle di consenso per le newsletter, collega il tuo regolamento, scegli quale casella iscrive le persone e invia al tuo strumento di email marketing solo chi ha detto sì.

Ti serve una mano?

## Hai ancora bisogno di aiuto?

Persone vere sono qui per aiutarti. Se usi già Scratcher, il modo più veloce è la chat all'interno della piattaforma.

- **[Chatta con noi](https://platform.scratcher.io/it/login)**

    Accedi e clicca sul pulsante della chat in basso a destra. Rex risponde subito e il nostro team è a un clic di distanza.
- **[Prenota un incontro](https://scratcher.io/it/book-a-meeting)**

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.
- **[Scrivici](mailto:contact@scratcher.io)**

    Scrivi a contact@scratcher.io e ti risponderemo.
