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.
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.
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. |
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. |
Observe os seguintes pré-requisitos que devem ser atendidos antes de usar o Data Landing Zone destino.
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.
Em seguida, selecione URL de assinatura de acesso compartilhado (SAS) como seu método de conexão e, em seguida, selecione Próxima.
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.
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, |
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.
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.
Uma conexão bem-sucedida atualiza seu Azure Storage Explorer Interface com o seu Data Landing Zone recipiente.
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.
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.
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.
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.
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.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.
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.
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.
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.
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:
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.