Documentação Experience Platform Guia de destinos

Destino da Data Landing Zone

Última atualização: 4 de abril de 2025

Tópicos:
Destinos

Criado para:

Administrador
Usuário

IMPORTANT

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

Visão geral

Data Landing Zone é uma interface de armazenamento em nuvem provisionada pela Adobe Experience Platform, que concede a você acesso a um recurso de armazenamento de arquivos seguro e baseado em nuvem para exportar arquivos do Experience Platform. Você tem acesso a um Data Landing Zone contêiner 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 Experience Platform. Todos os clientes do Experience 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.

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

O conector de destino Data Landing Zone está disponível para clientes que usam o suporte na nuvem do Azure ou do Amazon Web Service. O mecanismo de autenticação é diferente com base na nuvem em que o destino é provisionado, tudo sobre o destino e seus casos de uso são os mesmos. Leia mais sobre os dois mecanismos de autenticação diferentes nas seções Autenticar na Zona de Aterrissagem de Dados provisionada no Blob do Azure e Autenticar na Zona de Aterrissagem de Dados provisionada pela AWS.

Diagrama que mostra como a implementação do destino da Zona de Aterrissagem de Dados é diferente com base no suporte da nuvem.

Conecte-se ao armazenamento da Zona de Aterrissagem de Dados por meio da API ou da interface

Para se conectar ao local de armazenamento da Zona de Aterrissagem de Dados usando a interface do usuário da Experience Platform, leia as seções Conectar-se ao destino e Ativar públicos-alvo para este destino abaixo.
Para se conectar ao local de armazenamento da Zona de Aterrissagem de Dados de forma programática, leia o Tutorial da API de Serviço de Fluxo para ativar públicos-alvo para destinos baseados em arquivo.

Públicos-alvo compatíveis

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.

Origem do público	Suportado	Descrição
Segmentation Service	✓	Públicos-alvo gerados pelo Serviço de Segmentação da Experience Platform.
Uploads personalizados	✓	Públicos importados 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, seu PPID), conforme escolhido na tela selecionar atributos de perfil do fluxo de trabalho 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 com base em arquivo de 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:

Formato de arquivo dos dados exportados

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 para a Zona de aterrissagem de dados provisionada no Blob do Azure

AVAILABILITY

Esta seção se aplica às implementações do Experience Platform em execução no Microsoft Azure. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

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.

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

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.

Selecione o recurso realçado na interface do Azure.

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

Selecione o método de conexão realçado na interface do Azure.

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.

recommendation-more-help

Recupere as credenciais para o seu Data Landing Zone

Você deve usar as APIs do Experience Platform 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

Parâmetros de consulta

Descrição

dlz_destination

O tipo dlz_destination 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 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"
}

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 credenciais de Data Landing Zone

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

Parâmetros de consulta

Descrição

dlz_destination

O tipo dlz_destination 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 ação refresh permite redefinir suas credenciais de zona de aterrissagem e gerar automaticamente um novo 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 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.

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

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.

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

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

Resumo do contêiner de usuário DLZ realçado na interface do usuário do Azure.

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.

Autenticar na zona de aterrissagem de dados provisionada pela AWS

AVAILABILITY

Esta seção se aplica às implementações do Experience Platform em execução no Amazon Web Services (AWS). O Experience Platform em execução no AWS está disponível atualmente para um número limitado de clientes. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

Execute as operações abaixo para obter credenciais para sua instância do Data Landing Zone provisionada no AWS. Em seguida, use um cliente de sua escolha para se conectar à sua instância do Data Landing Zone.

Recupere as credenciais para o seu Data Landing Zone

Você deve usar as APIs do Experience Platform 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'

Parâmetros de consulta

Descrição

dlz_destination

Adicione o parâmetro de consulta dlz_destination para especificar que você deseja que o tipo de credenciais de contêiner Data Landing Zone destino seja recuperado. Para conectar e recuperar credenciais de uma fonte da Zona de Aterrissagem de Dados, exiba a documentação de fontes.

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
}

Propriedade

Descrição

credentials

Esse objeto inclui o awsAccessKeyId, awsSecretAccessKey e awsSessionToken que a Experience Platform usa para exportar arquivos para o local da Zona de Aterrissagem de Dados provisionada.

dlzPath

Esse objeto inclui o caminho no local do AWS provisionado pela Adobe onde os arquivos exportados são depositados.

dlzProvider

Indica que esta é uma Zona de aterrissagem de dados provisionada pelo Amazon S3.

expiryTime

Indica quando as credenciais no objeto credentials irão expirar. Para atualizar as credenciais, execute a solicitação novamente.

Conectar ao destino

IMPORTANT

Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

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

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

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 opção 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, tamanho da exportação e muito mais. O manifesto é nomeado usando o formato manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um arquivo de manifesto de exemplo. O arquivo de manifesto inclui os seguintes campos:
- flowRunId: A 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 onde 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.

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

Ativar públicos-alvo para esse destino

IMPORTANT

Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
Para exportar identidades, você precisa da permissão Exibir Gráfico de Identidade controle de acesso.

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

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

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.