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.

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.

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.

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.

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.

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

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.

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.

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.