Informazioni su file di dati e origini dati per Customer Attributes

Requisiti dei file di dati e diverse origini dati per il caricamento Customer Attributes all'Experience Cloud.

Devi poter accedere ai dati del sistema CRM, o simili, della tua azienda. I dati caricati nell'Experience Cloud devono essere .csv file. Se effettui il caricamento mediante FTP o sFTP, puoi caricare anche un file .fin.

Customer Attributes è progettato per gestire alcuni file al giorno. Per evitare che numerosi file di piccole dimensioni possano ritardare l’elaborazione, i file inviati entro 30 minuti da un batch precedente della stessa organizzazione vengono indirizzati a una coda di priorità inferiore.

Tipi di file consentiti e requisiti per la denominazione section_6F64FA02ACCC4215B0862CB6A1821FBF

Tipo di file
Descrizione
.csv

Un file di valori separati da virgole (ad esempio un file creato in Excel). Questo file contiene i dati di attributi cliente.

Requisiti di denominazione: verifica che le estensioni dei nomi dei file non contengano spazi.

.fin

(Necessario) Il file .fin informa il sistema che il caricamento dei dati è terminato. Il nome del file .fin deve corrispondere al nome del file .csv.

Adobe consiglia di creare un file di testo vuoto con estensione .fin. Un file vuoto consente di risparmiare spazio e tempi per il caricamento.

Nota: non puoi rinominare un file .fin dopo averlo caricato. Devi caricare il file .fin separatamente e non può essere un file caricato precedentemente e rinominato.

Dopo aver caricato il file .fin nell'FTP degli Attributi del cliente, il sistema restituisce velocemente i dati (entro un minuto). In questo si distingue da altri sistemi Adobe basati su FTP, che raccolgono i dati meno frequentemente (una volta all'ora circa).

Il file .fin non è necessario quando si utilizza il metodo di caricamento di trascinamento della selezione.

.gz o .zip

.gz (gzip) o .zip - per file compressi. Un file .zip non può contenere più di un file nell'archivio.

Requisiti per la denominazione: il nome del file .zip o .gz deve corrispondere al nome del file .csv. Ad esempio, se il nome del file .csv è crm_small.csv, il file .zip deve essere denominato crm_small.csv.zip.

Il file .fin deve corrispondere al file .csv.

Requisiti per i file di dati degli attributi section_169FBF5B7BBA47CE825B7A330CF3FE98

Esempio di CSV

Il file CSV deve rispettare il seguente formato:

Requisiti per i file di dati degli attributi

Lo stesso file visualizzato in un editor di testo:

Requisiti per i file di dati degli attributi

Linee guida

Elemento
Descrizione
Trascinamento della selezione

Il file da trascinare deve essere inferiore a 100 MB.

Il file .fin non è necessario quando si utilizza il metodo di caricamento di trascinamento della selezione.

Colonna ID cliente

La prima colonna deve essere un ID cliente univoco. L'ID usato deve corrispondere all'ID che viene passato al servizio Experience Cloud ID.

Per Analytics, l'ID archiviato in una prop o eVar.

Per Target, il valore setCustomerID.

Questo ID cliente è l’identificatore univoco che il sistema CRM utilizza per ogni persona nel database. Le colonne rimanenti sono attributi provenienti dai dati del sistema CRM. Puoi scegliere quanti attributi caricare.

Per le intestazioni delle colonne sono consigliati nomi descrittivi e leggibili, ma non sono obbligatori. Quando convalidi lo schema dopo il caricamento, puoi mappare i nomi descrittivi alle righe e alle colonne caricate.

Informazioni sugli ID cliente

In genere, un'azienda utilizza un ID cliente proveniente da un sistema di gestione delle relazioni con i clienti (CRM). Tale ID viene impostato usando la chiamata setCustomerIDs quando una persona effettua l'accesso. Questo ID viene utilizzato anche come chiave nel file CRM che viene caricato in Experience Cloud. Un ID aliasè un nome descrittivo per un archivio dati in Audienci Manager, in cui vengono memorizzati i dati alias. Il sistema invia alias a questo archivio di dati (tramite setCustomerIDs). Il file di gestione delle relazioni con i clienti viene applicato ai dati in tale archivio di dati.

Per informazioni su setCustomerIDs consulta ID cliente e stati di autenticazione.

Intestazioni e colonne successive

Le intestazioni successive devono rappresentare il nome di ciascun attributo.

Queste colonne devono contenere gli Attributi del cliente provenienti dal CRM.

Limiti degli attributi

Puoi caricare centinaia di .csv colonne del servizio Attributi del cliente in Experience Cloud. Tuttavia, quando configuri le sottoscrizioni e selezioni gli attributi, si applicano i seguenti limiti a seconda delle applicazioni che possiedi:

  • Analytics Standard: 3 totali
  • Analytics Premium: 200 per suite di rapporti
  • Adobe Target Standard: 5
  • Adobe Target Premium: 200
Limiti delle righe
Non esiste alcun limite noto al numero di righe.
Limiti delle colonne
Per praticità, limita il numero di colonne a circa 200.
Limiti dei caratteri
Quando crei una sottoscrizione Analytics, le lunghezze dei campi per i file caricati vengono troncate a 255.
Linee guida FTP e limiti di dimensione
  • La dimensione massima del file per l'FTP è 4 GB per ciascun caricamento.
  • La dimensione minima del file è di 10 MB per ogni caricamento.
  • puoi caricare un file ogni mezz'ora.
  • Devi rilasciare il file .csv (e .fin) nella cartella root del sito FTP.

Importante: lo spazio totale consentito per l'account FTP è 40 GB. È tua responsabilità eliminare i file elaborati.

Requisiti dei file

Ciascuna sorgente attributo deve contenere lo stesso numero di campi separati da virgola.

I campi contenenti un'interruzione di riga, virgolette o virgole devono essere tra virgolette.

Le virgolette doppie in un campo devono essere precedute da una barra inversa (\).

Le colonne vuote vengono memorizzate come nulle .

File multipli

Durante il caricamento dei dati di attributi clienti, se devi caricare diversi file in rapida successione, in particolare se sono di grandi dimensioni, accertati che il file precedente sia stato elaborato prima di caricare quello successivo. Puoi monitorare questo passaggio controllando se il file precedente è stato spostato nella cartella dei file elaborati o non riusciti, nel tuo account FTP per Attributi del cliente.

Considera inoltre che la suddivisione di un file di grandi dimensioni in file più piccoli inviandoli in rapida successione potrebbe rallentare l’elaborazione, se non ti assicuri che ogni file sia stato elaborato prima di inviare quello successivo.

Codifica caratteri
Per il Giappone, è obbligatoria la codifica UTF-8.
Dati storici

Gli attributi del cliente sono associati al profilo del visitatore sottostante in Analytics. Pertanto, gli Attributi del cliente sono associati al visitatore per l’intero ciclo di vita del suo profilo in Analytics. Questo profilo include il comportamento precedente al primo accesso del cliente.

Se utilizzi il metodo di recupero dati Data Warehouse, i dati vengono associati a un valore post_visid_high/low basato sull’ID di Analytics (AID). Se utilizzi il servizio Experience Cloud ID, i dati sono legati a un post_visid_high/low basato sull'Experience Cloud ID (MID).

Il metodo di recupero Data Warehouse non sarà più disponibile a partire da ottobre 2022.

Feed di dati
Gli attributi del cliente non sono disponibili nei feed di dati.

Utilizzo di più origini dati section_76DEB6001C614F4DB8BCC3E5D05088CB

Quando crei, modifichi o elimini sorgenti di attributi del cliente, si verifica un ritardo di circa un’ora prima della effettiva sincronizzazione degli ID con la nuova origine dati.

L’ID alias per ogni origine di attributi del cliente deve essere univoco. Se hai più sorgenti di dati che utilizzano lo stesso ID, puoi impostarle come segue:

In VisitorAPI.js o nello strumento Experience Cloud ID in Dynamic Tag Management:

Imposta due ID cliente corrispondenti alle origini dati appropriate:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(Consulta ID cliente e stati di autenticazione per ulteriori informazioni.)

In Experience Cloud > Persone > Attributi del cliente:

Crea due origini di attributi del cliente utilizzando ID alias univoci corrispondenti agli ID cliente qui sopra. Questo metodo consente di inviare lo stesso ID di riferimento a più origini di attributi del cliente.

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f