Destinazione Data Landing Zone

IMPORTANT
Questa pagina della documentazione fa riferimento alla Data Landing Zone destinazione. Esiste anche un Data Landing Zone source nel catalogo delle origini. Per ulteriori informazioni, leggere la documentazione di Data Landing Zone source.

Panoramica overview

Data Landing Zone è un’interfaccia di archiviazione Azure Blob fornita da Adobe Experience Platform che consente di accedere a una struttura di archiviazione dei file sicura e basata su cloud per esportare i file da Platform. È possibile accedere a un contenitore Data Landing Zone per sandbox e il volume totale di dati in tutti i contenitori è limitato ai dati totali forniti con la licenza di Platform Products and Services. Per tutti i clienti di Platform e delle relative applicazioni, ad esempio Customer Journey Analytics, Journey Orchestration, Intelligent Services e Real-Time Customer Data Platform, viene eseguito il provisioning con un contenitore Data Landing Zone per sandbox. È possibile leggere e scrivere file nel contenitore tramite Azure Storage Explorer o l'interfaccia della riga di comando.

Data Landing Zone supporta l'autenticazione basata su SAS e i relativi dati sono protetti con meccanismi di protezione di archiviazione standard Azure Blob in modalità di riposo e transito. SAS sta per firma di accesso condiviso.

L'autenticazione basata su SAS consente di accedere in modo sicuro al contenitore Data Landing Zone tramite una connessione Internet pubblica. Non sono necessarie modifiche di rete per accedere al contenitore Data Landing Zone, pertanto non è necessario configurare elenchi consentiti o impostazioni per più aree geografiche per la rete.

Platform applica un TTL (time-to-live) di sette giorni rigoroso su tutti i file caricati in un contenitore Data Landing Zone. Tutti i file vengono eliminati dopo sette giorni.

Connettiti all'archivio Data Landing Zone tramite API o interfaccia utente connect-api-or-ui

Tipi di pubblico supportati supported-audiences

Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.

Origine pubblico
Supportato
Descrizione
Segmentation Service
Tipi di pubblico generati tramite il servizio di segmentazione Experience Platform.
Caricamenti personalizzati
Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Basato su profilo
Stai esportando tutti i membri di un segmento, insieme ai campi dello schema applicabili (ad esempio il tuo PPID), come scelto nella schermata Seleziona attributi profilo del flusso di lavoro di attivazione della destinazione.
Frequenza di esportazione
Batch
Le destinazioni batch esportano i file sulle piattaforme a valle con incrementi di tre, sei, otto, dodici o ventiquattro ore. Ulteriori informazioni sulle destinazioni basate su file batch.

Esporta 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, 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, 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.

Prerequisiti prerequisites

Prendere nota dei seguenti prerequisiti che devono essere soddisfatti prima di poter utilizzare la destinazione Data Landing Zone.

Connetti il contenitore Data Landing Zone a Azure Storage Explorer

È possibile utilizzare Azure Storage Explorer per gestire il contenuto del contenitore Data Landing Zone. Per iniziare a utilizzare Data Landing Zone, devi prima recuperare le credenziali, inserirle in Azure Storage Explorer e connettere il contenitore Data Landing Zone a Azure Storage Explorer.

Nell'interfaccia utente di Azure Storage Explorer, selezionare l'icona di connessione nella barra di navigazione a sinistra. Viene visualizzata la finestra Seleziona risorsa che fornisce le opzioni per la connessione. Selezionare Blob container per connettersi all'archivio Data Landing Zone.

Selezionare la risorsa evidenziata nellinterfaccia utente di Azure.

Selezionare URL firma di accesso condiviso (SAS) come metodo di connessione, quindi selezionare Avanti.

Selezionare il metodo di connessione evidenziato nellinterfaccia utente di Azure.

Dopo aver selezionato il metodo di connessione, è necessario fornire nome visualizzato e l'URL SAS del contenitore Blob che corrisponde al contenitore Data Landing Zone.

recommendation-more-help

Recupera le credenziali per Data Landing Zone retrieve-dlz-credentials

Per recuperare le credenziali di Data Landing Zone, è necessario utilizzare le API di Platform. La chiamata API per recuperare le credenziali è descritta di seguito. Per informazioni su come ottenere i valori richiesti per le intestazioni, consulta la Guida introduttiva alle API di Adobe Experience Platform.

Formato API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
Parametri della query
Descrizione
dlz_destination
Il tipo dlz_destination consente all'API di distinguere un contenitore di destinazione di una zona di destinazione dagli altri tipi di contenitori disponibili.

Richiesta

L’esempio di richiesta seguente recupera le credenziali per una zona di destinazione esistente.

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Risposta

La seguente risposta restituisce le informazioni sulle credenziali per la tua zona di destinazione, inclusi SASToken e SASUri correnti e storageAccountName che corrispondono al contenitore della tua zona di destinazione.

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
Proprietà
Descrizione
containerName
Il nome della zona di destinazione.
SASToken
Il token di firma di accesso condiviso per la tua zona di destinazione. Questa stringa contiene tutte le informazioni necessarie per autorizzare una richiesta.
SASUri
URI della firma di accesso condiviso per la zona di destinazione. Questa stringa è una combinazione dell'URI della zona di destinazione per la quale si sta effettuando l'autenticazione e del token SAS corrispondente,

Aggiorna credenziali Data Landing Zone update-dlz-credentials

Se necessario, puoi anche aggiornare le credenziali. È possibile aggiornare SASToken effettuando una richiesta POST all'endpoint /credentials dell'API Connectors.

Formato API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Parametri della query
Descrizione
dlz_destination
Il tipo dlz_destination consente all'API di distinguere un contenitore di destinazione di una zona di destinazione dagli altri tipi di contenitori disponibili.
refresh
L'azione refresh consente di reimpostare le credenziali della zona di destinazione e generare automaticamente un nuovo SASToken.

Richiesta

La richiesta seguente aggiorna le credenziali della zona di destinazione.

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

Risposta

La seguente risposta restituisce valori aggiornati per SASToken e SASUri.

{
    "containerName": "dlz-user-container",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

Fornisci il nome visualizzato (containerName) e l'URL SAS Data Landing Zone, come restituito nella chiamata API descritta in precedenza, quindi seleziona Avanti.

Immettere le informazioni di connessione evidenziate nellinterfaccia utente di Azure.

Viene visualizzata la finestra Riepilogo che fornisce una panoramica delle impostazioni, incluse informazioni sull'endpoint Blob e sulle autorizzazioni. Al termine, selezionare Connetti.

Riepilogo delle impostazioni visualizzate nellinterfaccia utente di Azure.

Una connessione riuscita aggiorna l'interfaccia utente di Azure Storage Explorer con il contenitore Data Landing Zone.

Riepilogo del contenitore utenti DLZ evidenziato nellinterfaccia utente di Azure.

Con il contenitore Data Landing Zone connesso a Azure Storage Explorer, ora puoi iniziare a esportare i file da Experience Platform al contenitore Data Landing Zone. Per esportare i file, è necessario stabilire una connessione alla destinazione Data Landing Zone nell'interfaccia utente di Experience Platform, come descritto nella sezione seguente.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

Verificare di aver connesso il contenitore Data Landing Zone a Azure Storage Explorer come descritto nella sezione prerequisiti. Poiché Data Landing Zone è un archivio con provisioning Adobe, non è necessario eseguire ulteriori passaggi nell'interfaccia utente Experience Platform per l'autenticazione nella destinazione.

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.

  • Nome: immettere il nome preferito per la destinazione.

  • Descrizione: facoltativo. Ad esempio, puoi indicare per quale campagna stai utilizzando questa destinazione.

  • Percorso cartella: immettere il percorso della cartella di destinazione che ospiterà i file esportati.

  • Tipo di file: selezionare il formato da utilizzare per i file esportati dall'Experience Platform. Quando selezioni l'opzione CSV, puoi anche configurare le opzioni di formattazione del file.

  • Formato di compressione: selezionare il tipo di compressione che Experience Platform deve utilizzare per i file esportati.

  • Includi file manifesto: attivare questa opzione se si desidera che le esportazioni includano un file JSON manifesto contenente informazioni sul percorso di esportazione, sulle dimensioni dell'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 per la connessione di destinazione, seleziona Avanti.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione, consulta Attiva dati pubblico nelle destinazioni di esportazione profilo batch.

Pianificazione

Nel passaggio Pianificazione, puoi impostare la pianificazione dell'esportazione per la destinazione Data Landing Zone e configurare il nome dei file esportati.

Mappare attributi e identità map

Nel passaggio Mappatura, puoi selezionare l'attributo e i campi di identità da esportare per i profili. Puoi anche scegliere di modificare le intestazioni nel file esportato con qualsiasi nome descrittivo. Per ulteriori informazioni, vedi il passaggio di mappatura nell'esercitazione dell'interfaccia utente per l'attivazione di destinazioni batch.

Convalidare l’esportazione dei dati exported-data

Per verificare se i dati sono stati esportati correttamente, controllare l'archivio Data Landing Zone e assicurarsi che i file esportati contengano le popolazioni di profilo previste.

7f4d1967-bf93-4dba-9789-bb6b505339d6