Destino da Data Landing Zone

Visão geral

O Data Landing Zone é uma interface de armazenamento de dados do Azure Blob provisionada pela Adobe Experience Platform, que concede acesso a um recurso seguro de armazenamento de arquivos baseado em nuvem para exportar arquivos para fora da Platform. Você tem acesso a um Data Landing Zone por sandbox, e o volume total de dados em todos os containers é limitado ao total de dados fornecido com sua licença de Produtos e Serviços da Platform. Todos os clientes da Platform e seus serviços de aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Services, e Real-Time Customer Data Platform são provisionados com um Data Landing Zone contêiner por sandbox. Você pode ler e gravar arquivos no seu contêiner por meio de Azure Storage Explorer ou na interface de linha de comando.

Data Landing Zone oferece suporte à autenticação baseada em SAS e seus dados estão protegidos com o padrão Azure Blob mecanismos de segurança de armazenamento em repouso e em trânsito. A autenticação baseada em SAS permite que você acesse com segurança seus Data Landing Zone contêiner por meio de uma conexão pública com a internet. Não são necessárias alterações na rede para que você acesse seu Data Landing Zone contêiner, o que significa que você não precisa definir nenhuma configuração de lista de permissões ou entre regiões para sua rede.

A Platform impõe um TTL (time-to-live) rigoroso de sete dias em todos os arquivos carregados em um Data Landing Zone recipiente. Todos os arquivos são excluídos após sete dias.

Conecte-se ao seu Data Landing Zone armazenamento por meio da API ou da interface

• Para se conectar ao seu Data Landing Zone local de armazenamento usando a interface do usuário da Platform, leia as seções Conectar ao destino e Ativar públicos para este destino abaixo.
• Para se conectar ao seu Data Landing Zone local de armazenamento de dados de forma programática, leia as Ative públicos para destinos baseados em arquivo usando o tutorial da API do Serviço de fluxo.

Públicos-alvo compatíveis

Esta seção descreve que tipo de público-alvo você pode exportar para esse destino.

Tipo e frequência de exportação

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

Pré-requisitos

Observe os seguintes pré-requisitos que devem ser atendidos antes de usar o Data Landing Zone destino.

Conecte seu Data Landing Zone contêiner para Azure Storage Explorer

Você pode usar Azure Storage Explorer para gerenciar o conteúdo do Data Landing Zone recipiente. Para começar a usar o Data Landing Zone, você deve primeiro recuperar suas credenciais e inseri-las em Azure Storage Explorere conecte seu Data Landing Zone contêiner para Azure Storage Explorer.

No Azure Storage Explorer Selecione o ícone de conexão na barra de navegação esquerda. A variável Selecionar recurso é exibida, fornecendo opções para conexão. Selecionar Blob container para se conectar ao seu Data Landing Zone armazenamento.

Em seguida, selecione URL de assinatura de acesso compartilhado (SAS) como seu método de conexão e, em seguida, selecione Próxima.

Depois de selecionar o método de conexão, você deve fornecer um nome de exibição e a variável BlobURL SAS do contêiner que corresponde ao seu Data Landing Zone recipiente.

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

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

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

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

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

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

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

A variável Resumo é exibida, fornecendo uma visão geral de suas configurações, incluindo informações sobre Blob endpoint e permissões. Quando estiver pronto, selecione Conectar.

Uma conexão bem-sucedida atualiza seu Azure Storage Explorer Interface com o seu Data Landing Zone recipiente.

Com o seu Data Landing Zone contêiner conectado a Azure Storage Explorer, agora é possível começar a exportar arquivos do Experience Platform para o seu Data Landing Zone recipiente. Para exportar arquivos, é necessário estabelecer uma conexão com o Data Landing Zone destino na interface do usuário do Experience Platform, conforme descrito na seção abaixo.

Conectar ao destino

Para se conectar a esse 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

Verifique se você conectou o Data Landing Zone contêiner para Azure Storage Explorer conforme descrito na seção pré-requisitos seção. Porque Data Landing Zone é um armazenamento provisionado por Adobe, não é necessário executar outras etapas na interface do usuário do Experience Platform para autenticar no destino.

Preencher detalhes do destino

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.

• Nome: Preencha o nome preferencial para este destino.
• Descrição: Opcional. Por exemplo, você pode mencionar para qual campanha está usando esse destino.
• Caminho da pasta: insira o caminho para a pasta de destino que hospedará os arquivos exportados.
• Tipo de arquivo: selecione o formato que o Experience Platform deve usar para os arquivos exportados. Ao selecionar a variável CSV , você também pode configurar as opções de formatação de arquivo.
• Formato de compactação: selecione o tipo de compactação que o Experience Platform deve usar para os arquivos exportados.
• Incluir arquivo de manifesto: ative essa opção se desejar que as exportações incluam um arquivo JSON de manifesto que contenha informações sobre o local de exportação, o tamanho da exportação e muito mais. O manifesto é nomeado usando o formato manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um exemplo de arquivo de manifesto. O arquivo de manifesto inclui os seguintes campos:
  • flowRunId: A variável execução do fluxo de dados que gerou o arquivo exportado.
  • scheduledTime: a hora em UTC quando o arquivo foi exportado.
  • exportResults.sinkPath: O caminho no local de armazenamento em que o arquivo exportado está depositado.
  • exportResults.name: o nome do arquivo exportado.
  • size: o tamanho do arquivo exportado, em bytes.

Ativar alertas

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 do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino

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.

Programação

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

Mapear atributos e identidades

No Mapeamento etapa, 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, consulte etapa de mapeamento no tutorial ativar interface do usuário de destinos em lote.

Exportar conjuntos de dados

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:

• Como exportar conjuntos de dados usando a interface do usuário da Platform.
• Como exportar conjuntos de dados de forma programática usando a API do Serviço de fluxo.

Validar exportação de dados bem-sucedida

Para verificar se os dados foram exportados com êxito, verifique Data Landing Zone armazenamento e verifique se os arquivos exportados contêm as populações de perfis esperadas.