Invio dei dati di profilo

Gli sviluppatori possono impostare due metodi per consentire ai clienti di inviare ad Einstein gli attributi di profilo acquirente: caricamento in blocco e monitoraggio delle attività in tempo reale. Per inviare ad Einstein i dati del profilo degli acquirenti è possibile utilizzare uno dei due metodi (o entrambi).

Quando si inviano dati ad Einstein, tenere presente quanto segue:

Salesforce consiglia vivamente di non inviare ad Einstein dati di identificazione personale diversi dagli identificatori utente suggeriti specificati.
Tutti i dati raccolti vengono archiviati internamente e conservati per un massimo di un anno. Trascorso un anno, i dati vengono rimossi da tutti i database di Einstein. Per continuare a utilizzarli, è necessario reinviarli ad Einstein.
I nuovi valori ricevuti da Einstein per gli attributi di profilo acquirente esistenti vengono aggiunti ai valori già presenti.
Einstein utilizza tutti i dati di profilo forniti. I nuovi dati vengono trattati in modo analogo a quelli esistenti.

Caricamento in blocco

Salesforce offre un endpoint di caricamento in blocco sicuro per consentire ai clienti di caricare i dati storici del profilo degli acquirenti che hanno raccolto.

L’opzione di caricamento in blocco è destinata a essere utilizzata per:

Tutti i dati correlati al profilo degli acquirenti che sono stati monitorati e raccolti.
Tutti i dati di terze parti affidabili che si desidera vengano utilizzati da Einstein per un livello di personalizzazione ulteriore per gli acquirenti.

Autorizzazione

Il caricamento dei dati in blocco può avere un impatto notevole sui dati di Einstein. Per questo motivo, solo agli utenti autorizzati viene consentito di caricare grandi quantitativi di dati. Inoltre, ogni chiamata API di caricamento deve passare un token di accesso (bearer) dell’intestazione di autorizzazione obbligatorio ottenuto da Account Manager.

Nota: Per ridurre il carico sul server di Account Manager, evitare di generare nuovi token finché non scade quello corrente. Per ulteriori informazioni sulle chiamate API di caricamento in blocco, fare riferimento alla specifica dell’API.

Preparazione dei dati di caricamento in blocco

Per preparare i dati di caricamento in blocco per l’utilizzo in Einstein:

Il file di caricamento in blocco deve essere in formato TSV (valori separati da tabulazione) gzip.
Il file TSV deve essere correttamente formattato e salvato mediante codifica dei caratteri UTF-8.
Il tipomime del file deve essere correttamente impostato per essere utilizzato dall’applicazione gzip.
La riga dell’intestazione deve contenere il campo di identificazione login_id, il campo di identificazione email_address o entrambi.
È possibile aggiungere altre colonne per ogni attributo di profilo acquirente che si desidera inviare.
I valori devono essere stringhe o elenchi di stringhe. Nel caso di un elenco di stringhe, separare i valori utilizzando il separatore barra verticale (|), ad esempio orange|yellow.
Le colonne vuote devono essere ignorate. Quando Einstein incontra una colonna vuota, la ignora e continua a elaborare i dati degli attributi utente rimanenti.

Identificatori utente per il caricamento in blocco

Per generare suggerimenti di prodotto pertinenti per ogni acquirente, Profile Connector API necessita di uno dei seguenti identificatori utente per l’identificazione dell’acquirente nel caricamento in blocco.

Campo	Descrizione
login_id	ID di accesso dell’acquirente. In alcuni casi equivale al valore email_address.
email_address	Indirizzo email completo dell’acquirente. Ad esempio acquirente1@luogo.com.

Esempio di dati di caricamento in blocco

Di seguito è riportato un esempio di dati TSV di caricamento in blocco del profilo acquirente con nomi di colonna casuali:

login_id	email_address	genere	colori	brand_list
acquirente1	acquirente1@luogo.com	maschio	arancione\|giallo	brandA\|brandB
acquirente2	acquirente2@luogo.com	femmina	blu\|nero	brandD
acquirente3	acquirente3@luogo.com	femmina	rosso\|nero\|viola	brandB\|brandE

Limitazioni relative agli endpoint di caricamento in blocco dei profili acquirente

Quando si esegue un caricamento in blocco di profili acquirente, tenere presente le seguenti limitazioni relative agli endpoint:

È possibile caricare solo un file per volta. In caso di più file, caricarli uno dopo l’altro.
Le dimensioni dei file massime consentite sono 2 GB.

Caricamento dei dati del profilo degli acquirenti in blocco in Einstein

Dopo aver preparato i file dei dati di caricamento in blocco del profilo degli acquirenti, comprimere ciascuno di essi tramite gzip e caricarli nell’endpoint di caricamento in blocco del profilo degli acquirenti di Einstein. Per ulteriori informazioni, fare riferimento all’endpoint di invio profili in blocco.

Monitoraggio delle attività in tempo reale

Utilizzare l’endpoint di monitoraggio delle attività updateProfile per richiamare e inviare le preferenze e gli aggiornamenti dei dati del profilo degli acquirenti in tempo reale. L’acquisizione in tempo reale delle informazioni fornite da un acquirente nello storefront fa sì che i suggerimenti riflettano tali modifiche immediatamente.

L’opzione di monitoraggio delle attività in tempo reale è destinata a essere utilizzata per:

Acquisire in tempo reale le attività preferite degli acquirenti.
Apportare aggiornamenti in tempo reale al profilo degli acquirenti.

Per generare suggerimenti di prodotto pertinenti per ogni acquirente, Profile Connector API fornisce due identificatori utente per l’identificazione dell’acquirente nel monitoraggio in tempo reale.

cookieId (obbligatorio) - Identificatore univoco di un acquirente anonimo. Di norma, cookieId è il valore di un cookie proprietario.
- Quando si effettuano richieste API da uno storefront Commerce Cloud tradizionale, passare il valore cookie cqcid per la corrispondenza con il monitoraggio delle attività automatiche nello storefront tradizionale. Per ulteriori informazioni, vedere Archiviazione dati locale basata su browser.
- Quando si utilizza OCAPI o Salesforce Commerce API, usare il valore visit_id della risposta di accesso utente ospite per la corrispondenza con le attività automatiche. Per ulteriori informazioni, vedere il documento cliente OCAPI.
userId (consigliato) - Identificatore univoco di un acquirente che ha eseguito l’accesso. Questo parametro consente ad Einstein di collegare lo stesso utente che ha eseguito l’accesso su più dispositivi.
- Quando si effettuano richieste API da uno storefront Commerce Cloud tradizionale, utilizzare il valore cookie cquid per la corrispondenza con il monitoraggio delle attività automatiche nello storefront tradizionale. Per ulteriori informazioni, vedere Archiviazione dati locale basata su browser.
- Quando si utilizza OCAPI o Salesforce Commerce API, usare il valore hashed_login della risposta di accesso utente registrato per la corrispondenza con le attività automatiche. Per ulteriori informazioni, vedere il documento cliente OCAPI.

Per evitare attività potenzialmente dannose, i parametri degli identificatori utente non devono essere sequenziali. I parametri non devono includere sequenze, modelli, indirizzi IP, indirizzi email, nomi o altri elementi collegati a una persona specifica. Tutti i parametri degli identificatori utente devono essere conformi con il GDPR (General Data Protection Regulation) mediante hashing o altri metodi.

Note