Informazioni su file di dati e origini dati per Customer Attributes

Requisiti dei file di dati e diverse origini dati per caricare i dati degli attributi del cliente in Experience Cloud.

Devi poter accedere ai dati del sistema CRM, o simili, della tua azienda. I dati caricati in Experience Cloud devono essere un file .csv. 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 degli attributi del cliente. Requisiti di denominazione: verifica che le estensioni dei nomi dei file non contengano spazi.
.fin
(Obbligatorio) 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 tempo di caricamento. Nota: la ridenominazione di un file .fin non è consentita dopo il caricamento. Il file .fin deve essere caricato 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 recupera i dati rapidamente (entro un minuto). Questo si differenzia da altri sistemi Adobe basati su FTP, che raccolgono i dati meno frequentemente (circa una volta all'ora). 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 di denominazione: il nome di .zip o .gz deve corrispondere al nome del file .csv. Ad esempio, se il file .csv è crm_small.csv, il file .zip deve essere crm_small.csv.zip. Il file .fin deve corrispondere a .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). Questo ID viene impostato utilizzando 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 diè un nome descrittivo per un archivio dati in Audience Manager, dove vengono memorizzati i dati alias. Il sistema invia alias a questo archivio dati (tramite setcustomerID). Il file di gestione delle relazioni con i clienti viene applicato ai dati in tale archivio di dati.

Per informazioni setcustomerID , vedi 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 sistema di gestione delle relazioni con i clienti.

limiti degli attributi

In Experience Cloud è possibile caricare centinaia di colonne .csv nel servizio attributo cliente. 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 sono archiviate come null .

File multipli

Durante il caricamento dei dati dell'attributo del cliente, 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 il file successivo. Puoi monitorare questo passaggio controllando se il file precedente è stato spostato nella cartella elaborati o non riusciti all'interno dell'account FTP Customer Attributes.

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

attributi del cliente associati al profilo del visitatore sottostante in Analytics. Di conseguenza, Customer Attributes sono associati al visitatore per l'intera durata del profilo del visitatore 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 backfill 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 multiple

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 sorgente 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"
});

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

In Experience Cloud > Customer Attributes:

Crea due origini attributo del cliente con 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