Destino da Data Landing Zone

Última atualização em 2023-11-04
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader
IMPORTANTE

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

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

Públicos-alvo compatíveis

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

Origem do público Suportado 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

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.

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.

select-resource

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

select-connection-method

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.

Recupere as credenciais para o seu Data Landing Zone

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

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.

enter-connection-info

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

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

dlz-user-container

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

IMPORTANTE

Para se conectar ao destino, você precisa da variável Gerenciar destinos permissão 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 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

IMPORTANTE

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:

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.

Nesta página