Destino da Data Landing Zone

Exportar arquivos de dados de aplicativos do Adobe CX Enterprise para o local de armazenamento na nuvem do Data Landing Zone.

Aplicativos Adobe CX Enterprise com suporte supported-applications

Este destino está disponível nos seguintes aplicativos Adobe CX Enterprise:

Como o Data Landing Zone funciona overview

Data Landing Zone é uma interface de armazenamento na nuvem provisionada por Adobe Experience Platform. Use-a para exportar arquivos do Experience Platform para um local seguro de armazenamento de arquivos baseado em nuvem. O Experience Platform e seus aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Services e Real-Time Customer Data Platform, provisionam um contêiner Data Landing Zone por sandbox. O volume de dados total em todos os contêineres é limitado ao total de dados fornecidos com sua licença de Produtos e Serviços da Experience Platform.

O Experience Platform exclui automaticamente todos os arquivos em um contêiner Data Landing Zone após sete dias. Você também pode excluir arquivos exportados manualmente antes do prazo de sete dias.

O conector de destino Data Landing Zone está disponível para o Experience Platform em execução no Azure ou no Amazon Web Services (AWS). O mecanismo de autenticação depende da nuvem em que o destino é provisionado. Todo o restante sobre o destino e seus casos de uso é o mesmo. Leia mais sobre os dois mecanismos de autenticação nas seções Autenticar na Zona de Aterrissagem de Dados provisionada no Blob de Azure e Autenticar na Zona de Aterrissagem de Dados provisionada pela AWS.

{modal="regular"}

Conecte-se ao armazenamento da Zona de Aterrissagem de Dados por meio da API ou da interface connect-api-or-ui

Públicos-alvo compatíveis supported-audiences

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino. Os públicos-alvo com suporte diferem dependendo do aplicativo Adobe CX Enterprise do qual você os ativa para esse destino.

Real-Time CDP supported-audiences-rtcdp

Os seguintes públicos-alvo têm suporte quando você ativa a partir do Real-Time CDP:

Públicos-alvo compatíveis por tipo de dados de público-alvo:

Real-Time CDP Collaboration supported-audiences-collaboration

Em Real-Time CDP Collaboration, você pode originar públicos-alvo de Adobe Experience Platform ou outras fontes da nuvem. Os públicos-alvo em Real-Time CDP Collaboration são formados por chaves de correspondência. Você pode usar esses públicos-alvo em uma Collaboration para colaboração de dados ou atividades de mídia paga.

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Exportar conjuntos de dados export-datasets

Esse destino suporta exportações de conjunto de dados. Para obter informações completas sobre como configurar exportações de conjunto de dados, leia os tutoriais:

Formato de arquivo dos dados exportados file-format

Ao exportar dados de público-alvo, o Experience Platform cria um arquivo .csv, parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção formatos de arquivo compatíveis com a exportação no tutorial de ativação de público-alvo.

Ao exportar conjuntos de dados, o Experience Platform cria um arquivo .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção verificar exportação bem-sucedida do conjunto de dados no tutorial exportar conjuntos de dados.

Autenticar na Landing Zone de dados provisionada no Azure Blob authenticate-dlz-azure

Você pode ler e gravar arquivos no seu contêiner por meio do Azure Storage Explorer ou da interface de linha de comando.

Data Landing Zone dá suporte à autenticação baseada em SAS. Os mecanismos de segurança de armazenamento Azure Blob padrão protegem seus dados em repouso e em trânsito. SAS significa assinatura de acesso compartilhado.

Para proteger seus dados em uma conexão pública com a Internet, use a autenticação baseada em SAS para acessar com segurança o contêiner Data Landing Zone. Não é necessário fazer alterações na rede para acessar o contêiner Data Landing Zone. Isso significa que você não precisa definir nenhum incluo na lista de permissões ou configurações entre regiões para sua rede.

Conectar seu contêiner do Data Landing Zone a Azure Storage Explorer connect-container-to-storage-explorer

Use o Azure Storage Explorer para gerenciar o conteúdo do seu contêiner Data Landing Zone. Para começar a usar o Data Landing Zone, primeiro recupere suas credenciais. Em seguida, insira-os em Azure Storage Explorer para conectar seu contêiner Data Landing Zone.

Em Azure Storage Explorer, abra a caixa de diálogo conectar. A janela Selecionar Recurso é exibida, listando os recursos aos quais você pode se conectar. Selecione Blob container para se conectar ao seu armazenamento Data Landing Zone.

Em seguida, selecione SAS (URL de assinatura de acesso compartilhado) como seu método de conexão e selecione Avançar.

Após selecionar o método de conexão, forneça um nome para exibição e a URL SAS do contêiner Blob que corresponda ao contêiner Data Landing Zone.

Recupere as credenciais para o seu Data Landing Zone retrieve-dlz-credentials

Use as APIs do Experience Platform para recuperar suas credenciais do Data Landing Zone, conforme descrito nesta seção. Para obter informações sobre como obter os valores necessários para seus cabeçalhos, consulte o guia Introdução às APIs do Adobe Experience Platform.

Formato da API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Solicitação

O exemplo de solicitação a seguir recupera credenciais para uma zona de aterrissagem existente.

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' \

Resposta

A resposta a seguir retorna as informações de credencial da sua zona de aterrissagem, incluindo as SASToken e SASUri atuais, e a storageAccountName que corresponde ao seu contêiner de zona de aterrissagem.

{
    "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"
}

Atualizar credenciais de Data Landing Zone update-dlz-credentials

Você pode atualizar suas credenciais a qualquer momento. Para atualizar seu SASToken, faça uma solicitação POST para o ponto de extremidade /credentials da API Connectors.

Formato da API

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

Solicitação

A solicitação a seguir atualiza suas credenciais de zona de aterrissagem.

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' \

Resposta

A resposta a seguir retorna valores atualizados para o(a) 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"
}

Forneça seu nome para exibição (containerName) e a URL SAS Data Landing Zone, conforme retornado na chamada de API descrita acima, e selecione Avançar.

A janela Resumo é exibida, fornecendo uma visão geral das configurações, incluindo informações sobre o ponto de extremidade e as permissões do Blob. Quando estiver pronto, selecione Conectar.

Uma conexão bem-sucedida atualiza a interface do usuário Azure Storage Explorer com o contêiner Data Landing Zone.

Com o contêiner Data Landing Zone conectado ao Azure Storage Explorer, você pode começar a exportar arquivos do Experience Platform para o contêiner Data Landing Zone. Para exportar arquivos, conecte-se ao destino Data Landing Zone na interface do usuário do Experience Platform, conforme descrito em Conectar ao destino.

Autenticar na zona de aterrissagem de dados provisionada pela AWS authenticate-dlz-aws

Siga as etapas desta seção para obter credenciais para sua instância Data Landing Zone provisionada no AWS. Em seguida, use um cliente de sua escolha para se conectar à instância do Data Landing Zone.

Recupere as credenciais para o seu Data Landing Zone retrieve-dlz-credentials-aws

Use as APIs do Experience Platform para recuperar suas credenciais do Data Landing Zone, conforme descrito nesta seção. Para obter informações sobre como obter os valores necessários para seus cabeçalhos, consulte o guia Introdução às APIs do Adobe Experience Platform.

Formato da API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

Solicitação

O exemplo de solicitação a seguir recupera credenciais para uma zona de aterrissagem existente.

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'

Resposta

A resposta a seguir retorna as informações de credencial da sua zona de aterrissagem, incluindo o awsAccessKeyId, awsSecretAccessKey e outras informações atuais.

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

Conectar ao destino connect

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow da configuração de destino, preencha os campos listados nas duas seções abaixo.

Autenticar para o destino authenticate

Se o Data Landing Zone for provisionado no Azure, verifique se você conectou o contêiner Data Landing Zone ao Azure Storage Explorer, conforme descrito em Conectar o contêiner Data Landing Zone ao Azure Storage Explorer. Como Data Landing Zone é um armazenamento provisionado pela Adobe, não é necessário executar outras etapas na interface do usuário do Experience Platform para autenticar no destino.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

Você pode ativar públicos para este destino de Real-Time CDP ou de um projeto Real-Time CDP Collaboration.

Ativar públicos-alvo de Real-Time CDP activate-rtcdp

Consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.

Agendamento scheduling

Na etapa Agendamento, você pode configurar o agendamento de exportação para o seu destino Data Landing Zone e também configurar o nome dos seus arquivos exportados.

Mapear atributos e identidades map

Na etapa Mapeamento, você pode selecionar quais campos de atributo e identidade serão exportados para seus perfis. Você também pode optar por alterar os cabeçalhos no arquivo exportado para qualquer nome amigável. Para obter mais informações, exiba a etapa de mapeamento no tutorial de ativação da interface de destinos em lote.

Ativar públicos-alvo de Real-Time CDP Collaboration activate-collaboration

Para obter instruções sobre como ativar públicos para este destino de um projeto Real-Time CDP Collaboration, consulte a visão geral dos destinos do Real-Time CDP Collaboration.

Validar exportação de dados bem-sucedida exported-data

Para verificar se a exportação foi bem-sucedida, verifique o armazenamento do Data Landing Zone e se os arquivos exportados contêm as populações de perfis esperadas.

Excluir arquivos exportados delete-exported-files

O Experience Platform exclui automaticamente os arquivos exportados do contêiner Data Landing Zone após sete dias. Você também pode excluir arquivos manualmente do container antes do prazo de sete dias. A exclusão manual está disponível para Data Landing Zone contêineres provisionados no Azure e no AWS.