Connessione Azure Blob
Registro modifiche destinazione changelog
Con la versione di Experience Platform di luglio 2023, la destinazione Azure Blob fornisce nuove funzionalità, come elencato di seguito:
- Supporto per l’esportazione di set di dati.
- Nuove opzioni di denominazione file.
- Possibilità di impostare intestazioni di file personalizzate nei file esportati tramite il passaggio di mappatura migliorato.
- Possibilità di personalizzare la formattazione dei file CSV esportati.
Panoramica overview
Azure Blob (di seguito Blob) è la soluzione di archiviazione oggetti di Microsoft per il cloud. Questo tutorial descrive i passaggi per creare una destinazione Blob utilizzando l'interfaccia utente Experience Platform.
Connettersi all'archiviazione Azure Blob tramite API o interfaccia utente connect-api-or-ui
- Per connettersi al percorso di archiviazione Azure Blob tramite l'interfaccia utente di Experience Platform, leggere le sezioni Connetti alla destinazione e Attiva i tipi di pubblico a questa destinazione di seguito.
- Per connettersi al percorso di archiviazione Azure Blob a livello di programmazione, leggere l'esercitazione Attiva tipi di pubblico in destinazioni basate su file.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
-
Experience Data Model (XDM) Sistema: framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri i blocchi predefiniti di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull'editor di schemi: scopri come creare schemi personalizzati utilizzando l'interfaccia utente dell'editor di schemi.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Se disponi già di una destinazione Blob valida, puoi saltare il resto del documento e passare all'esercitazione sull'attivazione dei tipi di pubblico nella tua destinazione.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
Esporta i set di dati export-datasets
Questa destinazione supporta le esportazioni di set di dati. Per informazioni complete su come impostare le esportazioni dei set di dati, consulta le esercitazioni:
Formato file dei dati esportati file-format
Durante l'esportazione di dati sul pubblico, Experience Platform crea un file .csv, parquet o .json nel percorso di archiviazione fornito. Per ulteriori informazioni sui file, consulta la sezione formati di file supportati per l'esportazione nell'esercitazione di Audience Activation.
Durante l'esportazione di set di dati, Experience Platform crea un file .parquet o .json nel percorso di archiviazione fornito. Per ulteriori informazioni sui file, consulta la sezione Verifica dell'esportazione dei set di dati nell'esercitazione sull'esportazione dei set di dati.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
Autenticarsi nella destinazione authenticate
Per autenticare nella destinazione, compilare i campi obbligatori e selezionare Connect to destination.
-
Connection string: la stringa di connessione è necessaria per accedere ai dati nell'archiviazione BLOB. Il modello di stringa di connessione Blob inizia con:
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.- Per ulteriori informazioni sulla configurazione della stringa di connessione Blob, vedere Configurare una stringa di connessione per un account di archiviazione Azure nella documentazione di Microsoft.
-
Encryption key: facoltativamente, è possibile allegare la chiave pubblica in formato RSA per aggiungere la crittografia ai file esportati. Visualizza un esempio di chiave di crittografia formattata correttamente nell’immagine seguente.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
-
Name: immettere un nome che consenta di identificare la destinazione.
-
Description: immettere una descrizione della destinazione.
-
Folder path: immettere il percorso della cartella di destinazione che ospiterà i file esportati.
-
Container: immettere il nome del contenitore Azure Blob Storage da utilizzare per questa destinazione.
-
File type: selezionare il formato che Experience Platform deve utilizzare per i file esportati. Quando selezioni l'opzione CSV, puoi anche configurare le opzioni di formattazione del file.
-
Compression format: selezionare il tipo di compressione che Experience Platform deve utilizzare per i file esportati.
-
Include manifest file: attivare questa opzione se si desidera che le esportazioni includano un file JSON manifesto contenente informazioni sul percorso di esportazione, sulle dimensioni di esportazione e altro ancora. Il manifesto è denominato nel formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Visualizza un file manifesto di esempio. Il file manifesto include i campi seguenti:flowRunId: esecuzione del flusso di dati che ha generato il file esportato.scheduledTime: ora in UTC in cui è stato esportato il file.exportResults.sinkPath: il percorso nel percorso di archiviazione in cui è depositato il file esportato.exportResults.name: nome del file esportato.size: dimensione del file esportato, in byte.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli della connessione di destinazione, selezionare Next.
Attivare tipi di pubblico in questa destinazione activate
- Per attivare i dati, sono necessarie le View Destinations, Activate Destinations, View Profiles e View Segments autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- Per esportare identità, è necessario disporre dell'autorizzazione View Identity Graph per il controllo degli accessi.
Per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione, consulta Attiva dati pubblico nelle destinazioni di esportazione profilo batch.
Convalidare l’esportazione dei dati exported-data
Per verificare se i dati sono stati esportati correttamente, controllare l'archivio Azure Blob e assicurarsi che i file esportati contengano le popolazioni di profilo previste.