Destino da Data Landing Zone

Visão geral overview

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 contêiner Data Landing Zone por sandbox, e o volume total de dados em todos os contêineres é limitado ao total de dados fornecidos com sua licença de Produtos e Serviços da Plataforma. Todos os clientes da Platform e seus aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Services e Real-Time Customer Data Platform, são provisionados com um contêiner Data Landing Zone por sandbox. Você pode ler e gravar arquivos no seu contêiner por meio do Azure Storage Explorer ou da interface de linha de comando.

O Data Landing Zone oferece suporte à autenticação baseada em SAS e seus dados estão protegidos com mecanismos de segurança de armazenamento Azure Blob padrão em repouso e em trânsito. SAS significa assinatura de acesso compartilhado.

A autenticação baseada em SAS permite que você acesse com segurança o contêiner do Data Landing Zone por meio de uma conexão pública com a Internet. Não há alterações de rede necessárias para você acessar o contêiner Data Landing Zone, 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 contêiner Data Landing Zone. Todos os arquivos são excluídos após sete dias.

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.

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

Pré-requisitos prerequisites

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

Conectar seu contêiner do Data Landing Zone a Azure Storage Explorer

Você pode usar 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 você deve recuperar suas credenciais, inseri-las no Azure Storage Explorer e conectar seu contêiner do Data Landing Zone ao Azure Storage Explorer.

Na interface do usuário do Azure Storage Explorer, selecione o ícone de conexão na barra de navegação esquerda. A janela Selecionar Recurso é exibida, fornecendo opções para conexão. 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, você deve fornecer 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

Você deve usar as APIs da plataforma para recuperar suas credenciais do Data Landing Zone. A chamada à API para recuperar suas credenciais é descrita abaixo. 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-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"
}

Atualizar credenciais de Data Landing Zone update-dlz-credentials

Você também pode atualizar suas credenciais quando desejar. Você pode atualizar seu SASToken fazendo 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-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 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, você deve estabelecer uma conexão com o destino Data Landing Zone na interface do usuário do Experience Platform, conforme descrito na seção abaixo.

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

Verifique se você conectou o contêiner Data Landing Zone a Azure Storage Explorer conforme descrito na seção pré-requisitos. Como Data Landing Zone é um armazenamento provisionado por Adobe, não é necessário executar outras etapas na interface do usuário de 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

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.

Agendando

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.

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

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