(Beta) Destino da zona de aterrissagem de dados

IMPORTANTE
  • No momento, esse destino está na versão beta e só está disponível para um número limitado de clientes. Para solicitar acesso à Data Landing Zone conexão, entre em contato com o representante da Adobe e forneça Organization ID.
  • 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

Data Landing Zone é um Azure Blob interface de armazenamento de dados provisionada pela Adobe Experience Platform, que concede acesso a um recurso seguro de armazenamento de arquivos baseado em nuvem para exportar arquivos da plataforma. 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.

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, primeiro é necessário recuperar as credenciais, 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

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, bem como 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"
}
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,

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

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 segmentos para este destino

IMPORTANTE

Para ativar os dados, é necessário Gerenciar destinos, Ativar destinos, Exibir perfis, e Exibir segmentos 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.

Consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar segmentos de público-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.

(Beta) 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 o exportar tutorial de conjuntos de dados.

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