Destinazione Data Landing Zone

Esporta i file di dati dalle applicazioni Adobe CX Enterprise nel percorso di archiviazione cloud Data Landing Zone.

Adobe CX Enterprise applicazioni supportate supported-applications

Questa destinazione è disponibile nelle seguenti applicazioni Adobe CX Enterprise:

Come funziona Data Landing Zone overview

Data Landing Zone è un’interfaccia di archiviazione cloud fornita da Adobe Experience Platform. Utilizzalo per esportare i file da Experience Platform in un percorso di archiviazione file sicuro e basato su cloud. Experience Platform e le relative applicazioni, ad esempio Customer Journey Analytics, Journey Orchestration, Intelligent Services e Real-Time Customer Data Platform, eseguono il provisioning di un contenitore Data Landing Zone per sandbox. Il volume totale di dati in tutti i contenitori è limitato ai dati totali forniti con la licenza di Experience Platform Products and Services.

Experience Platform elimina automaticamente tutti i file in un contenitore Data Landing Zone dopo sette giorni. È inoltre possibile eliminare manualmente i file esportati prima che siano trascorsi sette giorni.

Il connettore di destinazione Data Landing Zone è disponibile per Experience Platform su Azure o Amazon Web Services (AWS). Il meccanismo di autenticazione dipende dal cloud in cui viene eseguito il provisioning della destinazione. Tutto il resto sulla destinazione e sui suoi casi d’uso è lo stesso. Ulteriori informazioni sui due meccanismi di autenticazione nelle sezioni Autentica nella Data Landing Zone con provisioning in Azure Blob e Autentica nella Data Landing Zone con provisioning AWS.

{modal="regular"}

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. I tipi di pubblico supportati variano a seconda dell’applicazione Adobe CX Enterprise da cui vengono attivati in questa destinazione.

Real-Time CDP supported-audiences-rtcdp

I seguenti tipi di pubblico sono supportati quando si attiva da Real-Time CDP:

Tipi di pubblico supportati per tipo di dati sul pubblico:

Real-Time CDP Collaboration supported-audiences-collaboration

In Real-Time CDP Collaboration, è possibile generare tipi di pubblico da Adobe Experience Platform o da altre origini cloud. I tipi di pubblico in Real-Time CDP Collaboration sono costituiti da chiavi corrispondenti. Puoi utilizzare questi tipi di pubblico all’interno di un Collaboration per la collaborazione dati o attività multimediali a pagamento.

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.

Autenticazione nell’area di destinazione dati fornita nel BLOB di Azure authenticate-dlz-azure

È 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. I meccanismi di protezione dello storage Azure Blob standard proteggono i dati a riposo e in transito. SAS sta per firma di accesso condiviso.

Per proteggere i dati tramite una connessione Internet pubblica, utilizzare l’autenticazione basata su SAS per accedere in modo sicuro al contenitore Data Landing Zone. Non è necessario apportare modifiche alla rete per accedere al contenitore Data Landing Zone. Ciò significa che non è necessario configurare alcun elenco Consentiti di rete o impostazioni tra aree geografiche diverse per la rete.

Connetti il contenitore Data Landing Zone a Azure Storage Explorer connect-container-to-storage-explorer

Utilizza Azure Storage Explorer per gestire il contenuto del contenitore Data Landing Zone. Per iniziare a utilizzare Data Landing Zone, recupera innanzitutto le credenziali. Quindi, immetterli in Azure Storage Explorer per collegare il contenitore Data Landing Zone.

In Azure Storage Explorer aprire la finestra di dialogo di connessione. Viene visualizzata la finestra Seleziona risorsa, in cui sono elencate le risorse a cui è possibile connettersi. Selezionare Blob container per connettersi all’archivio Data Landing Zone.

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

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

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

Utilizzare le API di Experience Platform per recuperare le credenziali di Data Landing Zone, come descritto in questa sezione. 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

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-destination",
    "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-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Aggiorna credenziali Data Landing Zone update-dlz-credentials

È possibile aggiornare le credenziali in qualsiasi momento. Per aggiornare SASToken, effettuare una richiesta POST all’endpoint /credentials dell’API Connectors.

Formato API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

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-destination",
    "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-destination?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.

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

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

Con il contenitore Data Landing Zone connesso a Azure Storage Explorer, puoi iniziare a esportare i file da Experience Platform al contenitore Data Landing Zone. Per esportare i file, connettersi alla destinazione Data Landing Zone nell’interfaccia utente di Experience Platform, come descritto in Connettersi alla destinazione.

Autenticazione nell’area di destinazione dati con provisioning di AWS authenticate-dlz-aws

Segui i passaggi descritti in questa sezione per ottenere le credenziali per l’istanza Data Landing Zone per la quale è stato eseguito il provisioning in AWS. Quindi, utilizzare un client scelto per connettersi all’istanza Data Landing Zone.

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

Utilizzare le API di Experience Platform per recuperare le credenziali di Data Landing Zone, come descritto in questa sezione. 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

Richiesta

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

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

Risposta

La risposta seguente restituisce le informazioni sulle credenziali per la zona di destinazione, inclusi awsAccessKeyId, awsSecretAccessKey e altre informazioni correnti.

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

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

Se il provisioning di Data Landing Zone è stato eseguito in Azure, verificare di aver connesso il contenitore Data Landing Zone a Azure Storage Explorer, come descritto in Connettere il contenitore Data Landing Zone ad Azure Storage Explorer. Poiché Data Landing Zone è un archivio con provisioning Adobe, non è necessario eseguire ulteriori passaggi nell’interfaccia utente di 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.

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

È possibile attivare i tipi di pubblico per questa destinazione da Real-Time CDP o da un progetto Real-Time CDP Collaboration.

Attiva tipi di pubblico da Real-Time CDP activate-rtcdp

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

Pianificazione scheduling

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.

Attiva tipi di pubblico da Real-Time CDP Collaboration activate-collaboration

Per istruzioni sull’attivazione dei tipi di pubblico in questa destinazione da un progetto Real-Time CDP Collaboration, consulta la panoramica sulle destinazioni Real-Time CDP Collaboration.

Convalidare l’esportazione dei dati exported-data

Per verificare che l’esportazione sia riuscita, controllare l’archivio Data Landing Zone e assicurarsi che i file esportati contengano le popolazioni di profilo previste.

Elimina file esportati delete-exported-files

Experience Platform elimina automaticamente i file esportati dal contenitore Data Landing Zone dopo sette giorni. Puoi anche eliminare manualmente i file dal contenitore prima del termine dei sette giorni. L’eliminazione manuale è disponibile per i contenitori Data Landing Zone per i quali è stato eseguito il provisioning in Azure e AWS.