Destino da Data Landing Zone

IMPORTANT
Esta página de documentação se refere ao Data Landing Zone destino. Existe também uma Data Landing Zone origem no catálogo de origens. Para obter mais informações, leia a Data Landing Zone origem documentação.

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

Origem do público
Compatível
Descrição
Segmentation Service
Públicos-alvo gerados pelo Experience Platform Serviço de segmentação.
Uploads personalizados
Públicos-alvo importado para o Experience Platform de arquivos CSV.

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.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
Você está exportando todos os membros de um segmento, juntamente com os campos de esquema aplicáveis (por exemplo, o PPID), conforme escolhido na tela Selecionar atributos de perfil da workflow de ativação de destino.
Frequência de exportação
Lote
Os destinos em lote exportam arquivos para plataformas downstream em incrementos de três, seis, oito, doze ou vinte e quatro horas. Leia mais sobre destinos baseados em arquivo em lote.

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, a Platform cria um .csv, parquetou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte 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 .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte 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 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.

Selecione o recurso destacado na interface do usuário do Azure.

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

Selecione o método de conexão destacado na interface do Azure.

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.

recommendation-more-help

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

Você deve usar as APIs da plataforma para recuperar seus Data Landing Zone credenciais. 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 Introdução às APIs do Adobe Experience Platform guia.

Formato da API

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
Parâmetros de consulta
Descrição
dlz_destination
A variável dlz_destination O tipo permite que a API diferencie um contêiner de destino de zona de aterrissagem dos outros tipos de contêineres disponíveis para você.

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 a atual SASToken e SASUri, e o 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"
}
Propriedade
Descrição
containerName
O nome da sua zona de destino.
SASToken
O token de assinatura de acesso compartilhado para sua zona de aterrissagem. Esta cadeia de caracteres contém todas as informações necessárias para autorizar uma solicitação.
SASUri
O URI de assinatura de acesso compartilhado para sua zona de aterrissagem. Essa string é uma combinação do URI para a zona de aterrissagem para a qual você está sendo autenticado e seu token SAS correspondente,

Atualizar Data Landing Zone credenciais update-dlz-credentials

Você também pode atualizar suas credenciais quando desejar. Você pode atualizar seu SASToken fazendo uma solicitação POST para o /credentials endpoint do Connectors API.

Formato da API

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
Parâmetros de consulta
Descrição
dlz_destination
A variável dlz_destination O tipo permite que a API diferencie um contêiner de destino de zona de aterrissagem dos outros tipos de contêineres disponíveis para você.
refresh
A variável refresh permite redefinir suas credenciais de zona de aterrissagem e gerar automaticamente uma nova SASToken.

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 os valores atualizados para o 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 Data Landing Zone URL SAS, conforme retornado na chamada de API descrita acima, e selecione Próxima.

Insira as informações de conexão destacadas na interface do usuário do Azure.

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.

Resumo das configurações mostradas na interface do usuário do Azure.

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

Resumo do contêiner de usuário DLZ destacado na interface do usuário do Azure.

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 connect

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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 destino authenticate

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

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

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

Ativar públicos para este destino activate

IMPORTANT

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

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 map

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.

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

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.

7f4d1967-bf93-4dba-9789-bb6b505339d6