[Disponibilità limitata]{class="badge informative"}

Tipi di pubblico di Source dall’archiviazione Azure

Connetti Azure Blob Storage o Azure Data Lake Storage (ADLS) Gen2 ad Adobe Real-Time CDP Collaboration per generare i dati del pubblico di prime parti per l’analisi di attivazione e sovrapposizione.

Utilizzare questa guida per creare una connessione dati Azure riutilizzabile ed eseguire un’importazione una tantum dal percorso di archiviazione configurato. Prima di iniziare, verifica che i file del pubblico soddisfino le specifiche di Audience Sourcing. Durante il processo di configurazione, potrai concedere ad Adobe l’accesso in lettura allo storage Azure.

Scegli il tipo di origine Azure choose-source-type

Collaboration supporta due opzioni di acquisizione di Azure. Utilizza la tabella seguente per scegliere il percorso della guida che corrisponde alla posizione in cui vivono i file del pubblico.

Azure Blob Storage
Azure Data Lake StorageGen2
Usa quando
I file si trovano in un BLOB standard contenitore su un account di archiviazione (non è richiesto alcuno spazio dei nomi gerarchico).
I file si trovano in un filesystem su un account di archiviazione con spazio dei nomi gerarchico abilitato (ADLS Gen2).
Opzione Source in Collaboration
Azure Blob Storage
Azure Data Lake StorageGen2
Campi obbligatori in Collaboration
Account di archiviazione, Contenitore, Percorso
Account di archiviazione, Contenitore (file system ADLS Gen2), Percorso
Sezione autorizzazioni
Azure Blob autorizzazioni
Azure Data Lake Storage Autorizzazioni Gen2

È possibile configurare solo un tipo di origine per connessione dati. Per creare l’origine sia da Blob che da ADLS, creare connessioni dati separate.

Prerequisiti prerequisites

Prima di seguire questa guida, completa l’onboarding e la configurazione dell’account. Quindi completa i prerequisiti in questa sezione prima di avviare il flusso di lavoro di configurazione.

Alcuni passaggi richiedono l’intervento di un amministratore Azure. Se non sei l’amministratore Azure per la tua organizzazione, identifica la persona appropriata prima di iniziare.

Accesso e autorizzazioni Azure azure-access-and-permissions

Prima di configurare la connessione in Collaboration, l’utente o l’amministratore di Azure deve concedere ad Adobe l’accesso in lettura al contenitore di archiviazione o al file system ADLS Gen2 che contiene i file di pubblico. Una volta completata la configurazione delle autorizzazioni, il flusso di lavoro di configurazione di Collaboration convalida l’accesso durante il passaggio Consenso.

Preparare i dati sul pubblico prepare-audience-data

I file del pubblico devono essere conformi alla Specifica di origine del pubblico (v1.2) prima dell’inizio dell’origine.

I requisiti principali includono:

  • Formato file: CSV, utilizzando virgole come delimitatori di campo e barre verticali (|) come separatori per più valori all’interno di un singolo campo.
  • Campi obbligatori: Ogni record deve includere una colonna AUDIENCE_ID e almeno una colonna chiave di corrispondenza supportata.
  • Chiavi di corrispondenza supportate: HASHED_EMAIL_SHA_256, HASHED_PHONE_SHA_256, HASHED_IPV4_SHA_256, CRM_ID, LOYALTY_ID, ADFIXUS_ID.
  • Requisiti di hashing: tutti i valori chiave di corrispondenza devono essere tagliati, in minuscolo e con hash SHA256 prima del caricamento. Collaboration non esegue l’hashing o la normalizzazione dei dati prima dell’acquisizione.
  • Coerenza colonna: tutti i file nel percorso configurato devono utilizzare strutture di colonna identiche.

Tutte le chiavi di corrispondenza presenti nei file del pubblico devono essere abilitate anche per il tuo account Collaboration. Consulta Configurare le chiavi di corrispondenza per maggiori informazioni.

IMPORTANT
Le chiavi di corrispondenza abilitate per una connessione dati non possono essere rimosse dopo la creazione della connessione. Per modificare il set attivo di chiavi di corrispondenza, è necessario eliminare la connessione e crearne una nuova. Conferma la configurazione completa della chiave di corrispondenza prima di avviare il flusso di lavoro di configurazione.

Valori richiesti prima di iniziare values-required

Prepara i seguenti valori prima di avviare il flusso di lavoro di configurazione.

Valore
Descrizione
Esempio di archiviazione BLOB di Azure
Esempio ADLS Gen2
Account di archiviazione
Nome dell’account di archiviazione Azure che ospita i file del pubblico.
customerdatastore
datalake-prod
Contenitore
Per Azure Blob Storage, il contenitore di archiviazione che contiene i file del pubblico. Per Azure Data Lake Storage Gen2, immettere il nome del file system ADLS Gen2 nel campo Contenitore.
audience-ingest
audiences
Percorso
Percorso della cartella all’interno del contenitore o del file system che contiene i file del pubblico da acquisire. Collaboration acquisisce solo i file direttamente nel percorso configurato e non i file dalle sottocartelle nidificate.
sourcing/audiences/path1/
sourcing/inbound/
ID tenant
L’ID tenant Microsoft Entra associato all’account di archiviazione Azure.
00000000-0000-0000-0000-000000000000
00000000-0000-0000-0000-000000000000

Configura autorizzazioni Azure set-up-azure-permissions

Completa i passaggi descritti in questa sezione per preparare l’ambiente Azure. Adobe richiede l’accesso in lettura al contenitore di archiviazione prima che il flusso di lavoro di configurazione Collaboration possa stabilire una connessione. Questo lavoro viene eseguito nel portale Azure e potrebbe dover essere completato dall’amministratore Azure.

Dopo aver completato questa sezione, passare a Configurare la Azure connessione.

Ottenere l’identificatore dell’entità servizio Azure di Adobe obtain-principal-identifier

Prima di completare i passaggi di assegnazione dei ruoli riportati di seguito, contattare il team dell’account Adobe per ottenere l’identificatore dell’entità servizio Azure per la propria area geografica (Nord America, EMEA, Australia e Nuova Zelanda). Utilizzerai questo identificatore per concedere ad Adobe l’accesso in lettura al tuo archivio.

Configura autorizzazioni Azure Blob Storage set-up-azure-blob-storage-permissions

IMPORTANT
È necessaria l'autorizzazione per assegnare ruoli all'account o al contenitore di archiviazione (ad esempio, Proprietario o Amministratore degli accessi utente o equivalente).
  1. Nel Azure portale, apri l’account di archiviazione, quindi vai a Contenitori e seleziona il contenitore che contiene i tuoi file di pubblico.
  2. Seleziona Access control (IAM), quindi seleziona Add role assignment.
  3. Assegnare il ruolo Storage Blob Data Reader all’entità di Adobe nell’ambito del contenitore.
  4. Seleziona Salva.

Configurare le autorizzazioni ADLS Gen2 set-up-adls-gen2-permissions

Per le connessioni ADLS Gen2, il campo Container in Collaboration corrisponde al file system ADLS Gen2 in Azure. Utilizza il file system che contiene i file del pubblico.

Prima di assegnare le autorizzazioni, verifica che l’account di archiviazione abbia spazio dei nomi gerarchico abilitato e che le regole firewall o endpoint privato consentano l’accesso ad Adobe.

  1. Nel Azure portale, aprire l’account di archiviazione che contiene il file system ADLS Gen2.
  2. Apri il file system che contiene i file del pubblico.
  3. Selezionare Controllo dell’accesso (IAM), quindi selezionare Aggiungi assegnazione ruolo.
  4. Assegnare il ruolo Storage Blob Data Reader all’entità Adobe nell’ambito del file system o della directory.
  5. Seleziona Salva.

Dopo aver completato l’impostazione delle autorizzazioni per il tipo di origine, passare a Configurare la Azure connessione.

Configura la connessione Azure configure-your-azure-connection

Utilizza il flusso di lavoro di configurazione di Collaboration per convalidare i dettagli di archiviazione di Azure, confermare l’accesso ad Adobe, rivedere i campi di identità mappati automaticamente e creare la connessione dati.

Aggiungi una nuova connessione dati add-new-data-connection

Passa a Configurazione > Tipi di pubblico, quindi seleziona l’icona Aggiungi ( Icona Aggiungi. ) e scegli Pubblico.

La visualizzazione Pubblico personale mostra l'opzione Aggiungi pubblico utilizzata per creare un nuovo pubblico o una nuova connessione dati. {modal="regular"}

Viene visualizzato il flusso di lavoro Aggiungi pubblico. Seleziona Aggiungi una nuova connessione dati, quindi seleziona Avanti.

La visualizzazione Pubblico personale mostra l'opzione Aggiungi nuova connessione dati selezionata ed evidenziata Successivo. {modal="regular"}

Seleziona l’origine dati Azure select-azure-data-source

Seleziona Archiviazione BLOB Azure o Archiviazione Data Lake Azure Gen2, quindi seleziona Avanti.

Il flusso di lavoro Aggiungi pubblico mostra Azure Blob Storage selezionato come tipo di connessione dati e i passaggi di onboarding Credenziali, Consenso, Mappatura campi e Revisione. {modal="regular"}

Continua i passaggi rimanenti per convalidare la connessione Azure, confermare l’accesso ad Adobe, rivedere le mappature dei campi e creare la connessione dati.

Immetti le credenziali di connessione enter-connection-credentials

Nel passaggio Credenziali, fornisci le informazioni necessarie per accedere al percorso di archiviazione Azure.

Campo
Descrizione
Account di archiviazione
Account di archiviazione Azure contenente i file del pubblico.
Contenitore
Il contenitore di archiviazione o il file system ADLS Gen2 che contiene i file di pubblico.
Percorso
Il percorso della cartella all’interno del contenitore in cui sono memorizzati i file del pubblico.
ID tenant
L’identificatore tenant Azure associato al tuo account di archiviazione.

Dopo aver immesso i valori richiesti, selezionare Connetti ad Azure.

Un messaggio di conferma indica che la connessione è stata stabilita correttamente. Seleziona Avanti per continuare.

Il passaggio Credenziali che mostra i campi Account di archiviazione, Contenitore, Percorso e ID tenant completati con un messaggio di conferma Connesso a Azure. {modal="regular"}

Concedi l’accesso Adobe al tuo archivio Azure grant-adobe-access

Nel passaggio Consenso, Collaboration convalida le autorizzazioni Azure configurate in precedenza.

Seleziona l’icona di avvio accanto a URL di consenso per aprire il flusso di lavoro di autorizzazione in Azure. Accedi con un account che disponga dell’autorizzazione per concedere il consenso per il percorso di archiviazione, quindi completa le richieste di autorizzazione di Azure che concedono l’accesso di Adobe al percorso di archiviazione configurato. Al termine dell’autorizzazione, tornare a Collaboration e selezionare Conferma consenso per convalidare l’accesso di Adobe.

NOTE
La propagazione delle assegnazioni di ruolo Azure può richiedere alcuni minuti. Se la convalida del consenso non riesce immediatamente, attendi alcuni minuti, verifica che l’entità servizio di Adobe disponga dell’assegnazione del ruolo richiesta, quindi riprova.

Quando la convalida del consenso viene eseguita correttamente, viene visualizzato un messaggio di conferma Consenso concesso. Seleziona Avanti per continuare.

Il passaggio Consenso mostra un URL di consenso, l'identificatore dell'applicazione zuree un messaggio di conferma del consenso concesso. {modal="regular"}

Rivedi mappature campi review-field-mappings

Nel passaggio Mappatura campi, Collaboration mappa automaticamente i campi di identità supportati dai file di origine.

Non è richiesta alcuna configurazione manuale.

IMPORTANT
Collaboration mappa automaticamente i campi di identità in base alle specifiche di Audience Sourcing. Se le mappature visualizzate non sono corrette, aggiorna i file di origine prima di completare il flusso di lavoro di onboarding.

Esamina le mappature visualizzate e verifica che i campi sorgente corrispondano alle colonne di identità nei file di pubblico. Seleziona Avanti per continuare.

Il passaggio Mappatura campi mostra i campi di origine mappati automaticamente e i campi di identità di destinazione senza alcuna configurazione manuale richiesta. {modal="regular"}

Verifica e completa la connessione review-and-complete

Nel passaggio Rivedi, verifica le mappature dell’account di archiviazione, del contenitore, del percorso di origine, dell’ID tenant e dei campi.

La pagina Revisione indica inoltre che il flusso di lavoro Azure corrente esegue una singola esecuzione dell’origine e non configura una pianificazione ricorrente.

Quando la configurazione è corretta, selezionare Completa.

Il passaggio Revisione che mostra i dettagli di connessione, le mappature dei campi e un messaggio che indica che l'importazione del pubblico è un'importazione una tantum senza alcuna pianificazione configurata. {modal="regular"}

Conferma la connessione e monitora i tipi di pubblico originati confirm-connection-and-monitor-audiences

Dopo aver selezionato Completa, Collaboration crea la connessione dati e passa a Configurazione > Le mie connessioni dati.

Conferma la creazione della connessione confirm-connection-created

La scheda di connessione in Le mie connessioni dati conferma che la connessione è stata creata correttamente. Nella scheda vengono visualizzati il tipo di origine (Archiviazione BLOB di Azure o Archiviazione Data Lake di Azure Gen2), la data di creazione, le chiavi di corrispondenza, il conteggio del pubblico e lo stato della connessione corrente.

La visualizzazione Connessioni dati personali mostra una nuova scheda di connessione Azure Blob Storage con dettagli di connessione, chiavi di corrispondenza, conteggio del pubblico e informazioni sullo stato. {modal="regular"}

Visualizzare i tipi di pubblico sorgente view-sourced-audiences

Dopo la creazione della connessione, Collaboration inizia automaticamente a raccogliere i tipi di pubblico dalla posizione Azure configurata. Passa a Configurazione > I miei tipi di pubblico per monitorare l’avanzamento dell’origine e rivedere i tipi di pubblico originati.

I tipi di pubblico sorgente vengono visualizzati nella tabella Tipi di pubblico. Utilizza lo stato del pubblico, il conteggio delle identità, l’origine, la connessione dati e la data dell’ultimo aggiornamento per confermare che i tipi di pubblico previsti provengono dalla connessione Azure.

TIP
Il tempo di determinazione origine varia in base al volume dei dati. Se il pubblico non viene visualizzato dopo 24 ore, vedere Risoluzione dei problemi.

Scheda Pubblico personale dell'area di lavoro di installazione con un nuovo pubblico evidenziato nella tabella.

Limitazioni note known-limitations

Esamina le seguenti limitazioni prima di creare o gestire una connessione dati di Azure.

  • Vincoli chiave di corrispondenza: Le chiavi di corrispondenza non possono essere rimosse da una connessione esistente. Per modificare le chiavi di corrispondenza attive, eliminare la connessione e crearne una nuova.
  • Una connessione attiva per tipo di origine Azure: È possibile avere una connessione BLOB attiva e una connessione ADLS Gen2 attiva per account. Per modificare il percorso di archiviazione, eliminare la connessione esistente e crearne una nuova.
  • Supporto sottocartelle: Collaboration acquisisce solo i file direttamente nel percorso configurato. Non acquisisce i file dalle sottocartelle nidificate.
  • Tipi di origine separati: Blob e ADLS Gen2 sono connessioni distinte. Non combinare le configurazioni in un’unica esecuzione della procedura guidata.

Risoluzione dei problemi troubleshooting

I tipi di pubblico non vengono visualizzati o l’approvvigionamento è lento audiences-not-appearing

Se i tipi di pubblico originati non vengono visualizzati dopo la creazione della connessione, completa le azioni seguenti.

  • Verifica che i file del pubblico siano presenti direttamente nel percorso configurato e siano conformi alle specifiche di Audience Sourcing.
  • Verificare la presenza di errori nelle connessioni dati personali.
  • Se i problemi persistono dopo 24 ore, contatta il supporto Adobe con il nome della connessione, l’account di archiviazione e i dettagli del contenitore.

Origine del pubblico ma senza identità o identità impreviste zero-identities

Se i tipi di pubblico vengono visualizzati dopo la determinazione dell’origine ma i conteggi delle identità sono pari a zero o inferiori a quelli previsti, completa le azioni seguenti.

  • Verifica che tutti i valori delle chiavi corrispondenti nei file del pubblico siano stati tagliati, convertiti in minuscolo e con hash SHA256 prima del caricamento. Collaboration non esegue l’hashing o la normalizzazione dei dati al momento dell’acquisizione.
  • Verifica che le chiavi di corrispondenza presenti nei file siano abilitate per il tuo account Collaboration. Vedere Configurare le chiavi di corrispondenza.

Connessione non riuscita dopo il completamento iniziale connection-failed

Utilizzare questi controlli quando una connessione è stata creata correttamente ma successivamente entra in uno stato di errore.

  • Verificare che l’assegnazione del ruolo RBAC Azure per l’entità Adobe non sia stata rimossa o limitata.
  • I file di conferma esistono ancora nel percorso e corrispondono alla specifica.

Importare o formattare gli errori format-errors

Utilizzare questi controlli quando la determinazione origine non riesce a causa di problemi di struttura del file, hashing o formato colonna.

  • Assicurati che tutti i file mantengano la stessa struttura di colonne e le stesse regole di hashing dell’acquisizione iniziale.

Passaggi successivi next-steps

Al termine dell’origine, i tipi di pubblico sono disponibili in I miei tipi di pubblico per l’attivazione, l’analisi di sovrapposizione e i flussi di lavoro di misurazione. Per attivare i tipi di pubblico originati con i collaboratori, vedi Attiva tipi di pubblico.

Altri metodi di determinazione origine disponibili includono Experience Platform, Amazon S3, Google Cloud Storage, Snowflake e il caricamento di file CSV. Per altri metodi di determinazione dell’origine del pubblico, vedi:

recommendation-more-help
real-time-cdp-collaboration-help-guide