[Disponibilidade limitada]{class="badge informative"}
Públicos-alvo da Source do armazenamento da Azure
Conecte o Azure Blob Storage ou o Azure Data Lake Storage (ADLS) Gen2 ao Adobe Real-Time CDP Collaboration para obter dados de público-alvo primário para ativação e análise de sobreposição.
Use este guia para criar uma conexão de dados Azure reutilizável e executar uma importação única do local de armazenamento configurado. Antes de começar, confirme se seus arquivos de público-alvo atendem à Especificação de origem de público-alvo. Você concederá à Adobe acesso de leitura ao seu armazenamento Azure durante o processo de configuração.
Escolha seu tipo de origem Azure choose-source-type
O Collaboration oferece suporte a duas opções de assimilação de Azure. Use a tabela abaixo para escolher o caminho do guia que corresponde ao local em que seus arquivos de público-alvo vivem.
Você só pode configurar um tipo de origem por conexão de dados. Para origem do Blob e do ADLS, crie conexões de dados separadas.
Pré-requisitos prerequisites
Antes de seguir este guia, conclua a integração e a configuração da conta. Em seguida, conclua os pré-requisitos nesta seção antes de iniciar o workflow de configuração.
Algumas etapas requerem ação de um Azureadministrador. Se você não for o administrador Azure da sua organização, identifique a pessoa apropriada antes de iniciar.
Azure acesso e permissões azure-access-and-permissions
Antes de configurar a conexão no Collaboration, você ou o administrador do Azure deve conceder ao Adobe acesso de leitura ao contêiner de armazenamento ou ao sistema de arquivos ADLS Gen2 que contém os arquivos de público-alvo. Após a conclusão da configuração de permissão, o fluxo de trabalho de configuração do Collaboration valida o acesso durante a etapa Consentimento.
Preparar os dados do público prepare-audience-data
Seus arquivos de público-alvo devem estar em conformidade com a Especificação de origem de público-alvo (v1.2) antes do início do fornecimento.
Os principais requisitos incluem:
- Formato de arquivo: CSV, usando vírgulas como delimitadores de campo e barras verticais (
|) como separadores para vários valores em um único campo. - Campos obrigatórios: todos os registros devem incluir uma coluna
AUDIENCE_IDe pelo menos uma coluna de chave de correspondência com suporte. - Chaves de correspondência com suporte:
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_ID. - Requisitos de hash: Todos os valores de chave correspondentes devem ser cortados, ter letras minúsculas e ter hash SHA256 antes do carregamento. O Collaboration não faz hash ou normaliza dados antes da assimilação.
- Consistência de coluna: todos os arquivos no caminho configurado devem usar estruturas de coluna idênticas.
Todas as chaves de correspondência presentes nos arquivos de público-alvo também devem ser habilitadas para a conta do Collaboration. Consulte Configurar chaves de correspondência para obter orientação.
Valores obrigatórios antes de começar values-required
Tenha os seguintes valores prontos antes de iniciar o fluxo de trabalho de configuração.
customerdatastoredatalake-prodaudience-ingestaudiencessourcing/audiences/path1/sourcing/inbound/00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000Configurar Azure permissões set-up-azure-permissions
Conclua as etapas desta seção para preparar seu ambiente do Azure. O Adobe exige acesso de leitura ao seu contêiner de armazenamento para que o fluxo de trabalho de configuração do Collaboration possa estabelecer uma conexão. Este trabalho é executado no portal Azure e pode precisar ser concluído pelo administrador Azure.
Após concluir esta seção, prossiga para Configurar sua Azure conexão.
Obter o identificador da entidade de serviço Azure da Adobe obtain-principal-identifier
Antes de concluir as etapas de atribuição de função abaixo, entre em contato com sua equipe de conta da Adobe para obter o identificador da entidade de serviço Azure para sua região (América do Norte, EMEA ou Austrália e Nova Zelândia). Você usará esse identificador para conceder à Adobe acesso de leitura ao seu armazenamento.
Configurar Azure Blob Storage permissões set-up-azure-blob-storage-permissions
- No Azure portal, abra a conta de armazenamento, vá para Containers e selecione o contêiner que contém seus arquivos de público-alvo.
- Selecione Access control (IAM) e depois Add role assignment.
- Atribua a função Storage Blob Data Reader à entidade de segurança da Adobe no escopo do contêiner.
- Selecione Salvar.
Configurar permissões do ADLS Gen2 set-up-adls-gen2-permissions
Para conexões ADLS Gen2, o campo Container no Collaboration corresponde ao sistema de arquivos ADLS Gen2 em Azure. Use o sistema de arquivos que contém os arquivos de público-alvo.
Antes de atribuir permissões, confirme se a conta de armazenamento tem o namespace hierárquico habilitado e se as regras de firewall ou ponto de extremidade privado permitem acesso ao Adobe.
- No Azure portal, abra a conta de armazenamento que contém seu sistema de arquivos ADLS Gen2.
- Abra o sistema de arquivos que contém os arquivos de público-alvo.
- Selecione Controle de acesso (IAM) e Adicionar atribuição de função.
- Atribua a função Storage Blob Data Reader à entidade de segurança da Adobe no escopo do sistema de arquivos ou diretório.
- Selecione Salvar.
Após concluir a configuração de permissão para o seu tipo de origem, prossiga para Configurar sua Azure conexão.
Configurar sua conexão com o Azure configure-your-azure-connection
Use o fluxo de trabalho de configuração do Collaboration para validar os detalhes de armazenamento do Azure, confirmar o acesso ao Adobe, revisar campos de identidade mapeados automaticamente e criar a conexão de dados.
Adicionar uma nova conexão de dados add-new-data-connection
Navegue até Configuração > Meus públicos-alvo e selecione o ícone adicionar (
O fluxo de trabalho Adicionar público-alvo é exibido. Selecione Adicionar nova conexão de dados e Avançar.
Selecione sua fonte de dados Azure select-azure-data-source
Selecione Azure Blob Storage ou Azure Data Lake Storage Gen2 e, em seguida, Next.
Continue com as etapas restantes para validar sua conexão com o Azure, confirmar o acesso ao Adobe, revisar os mapeamentos de campo e criar a conexão de dados.
Inserir credenciais de conexão enter-connection-credentials
Na etapa Credenciais, forneça as informações necessárias para acessar seu local de armazenamento Azure.
Depois de inserir os valores necessários, selecione Conectar-se ao Azure.
Uma mensagem de confirmação indica que a conexão foi estabelecida com sucesso. Clique em Avançar para continuar.
Conceder acesso à Adobe para seu armazenamento do Azure grant-adobe-access
Na etapa Consentimento, o Collaboration valida as permissões Azure configuradas anteriormente.
Selecione o ícone de inicialização ao lado de URL de consentimento para abrir o fluxo de trabalho de autorização em Azure. Faça logon com uma conta que tenha permissão para conceder consentimento ao local de armazenamento e, em seguida, conclua os prompts de autorização do Azure que concedem à Adobe acesso ao local de armazenamento configurado. Após a conclusão da autorização, volte para a Collaboration e selecione Confirmar consentimento para validar o acesso da Adobe.
Quando a validação do consentimento for bem-sucedida, será exibida uma mensagem de confirmação Consentimento concedido. Clique em Avançar para continuar.
Revisar mapeamentos de campo review-field-mappings
Na etapa Mapeamento de campos, o Collaboration mapeia automaticamente os campos de identidade compatíveis a partir dos arquivos de origem.
Nenhuma configuração manual é necessária.
Revise os mapeamentos exibidos e confirme se os campos de origem correspondem às colunas de identidade nos arquivos de público-alvo. Clique em Avançar para continuar.
Revisar e concluir a conexão review-and-complete
Na etapa Revisão, verifique a conta de armazenamento, o contêiner, o caminho de origem, a ID do locatário e os mapeamentos de campo.
A página de revisão também indica que o fluxo de trabalho Azure atual executa uma única fonte e não configura um agendamento recorrente.
Quando a configuração estiver correta, selecione Concluído.
Confirme a conexão e monitore os públicos-alvo de origem confirm-connection-and-monitor-audiences
Depois que você selecionar Concluído, o Collaboration criará a conexão de dados e navegará você para Instalação > Minhas conexões de dados.
Confirmar se a conexão foi criada confirm-connection-created
O cartão de conexão em Minhas conexões de dados confirma que a conexão foi criada com êxito. O cartão exibe o tipo de origem (Azure Blob Storage ou Azure Data Lake Storage Gen2), a data de criação, as chaves de correspondência, o contagem de público-alvo e o status de conexão atual.
Exibir públicos-alvo de origem view-sourced-audiences
Depois que a conexão é criada, o Collaboration começa automaticamente a fornecer públicos-alvo a partir do local Azure configurado. Navegue até Configuração > Meus públicos-alvo para monitorar o progresso do fornecimento e revisar os públicos-alvo originados.
Os públicos-alvo de origem aparecem na tabela Meus públicos-alvo. Use o status do público-alvo, a contagem de identidades, a origem, a conexão de dados e a data da última atualização para confirmar se os públicos-alvo esperados foram obtidos da sua conexão Azure.
Limitações conhecidas known-limitations
Analise as limitações a seguir antes de criar ou gerenciar uma conexão de dados do Azure.
- Restrições de chave de correspondência: As chaves de correspondência não podem ser removidas de uma conexão existente. Para alterar as chaves de correspondência ativas, exclua a conexão e crie uma nova.
- Uma conexão ativa por Azure tipo de origem: Você pode ter uma conexão Blob ativa e uma conexão ADLS Gen2 ativa por conta. Para alterar o local de armazenamento, exclua a conexão existente e crie uma nova.
- Suporte a subpastas: o Collaboration assimila somente arquivos diretamente no caminho configurado. Ele não assimila arquivos de subpastas aninhadas.
- Tipos de origem separados: Blob e ADLS Gen2 são conexões distintas; não misture configuração entre elas em uma única execução de assistente.
Solução de problemas troubleshooting
Os públicos-alvo não estão aparecendo ou a fonte está lenta audiences-not-appearing
Se os públicos-alvo de origem não forem exibidos depois que você criar a conexão, conclua as ações a seguir.
- Confirme se os arquivos de público-alvo existem diretamente no caminho configurado e estão em conformidade com a Especificação de origem de público-alvo.
- Verificar Minhas conexões de dados em busca de erros.
- Entre em contato com o suporte da Adobe com o nome da conexão, a conta de armazenamento e os detalhes do contêiner se os problemas persistirem após 24 horas.
Públicos-alvo de origem, mas mostrar identidades zero ou inesperadas zero-identities
Se os públicos-alvo aparecerem após a origem, mas as contagens de identidade forem zero ou menores que o esperado, conclua as seguintes ações.
- Verifique se todos os valores de chave correspondentes nos arquivos de público-alvo foram cortados, colocados em minúsculas e com hash SHA256 antes do upload. O Collaboration não faz hash ou normalização de dados na assimilação.
- Confirme se as chaves de correspondência presentes nos arquivos estão habilitadas para a conta do Collaboration. Consulte Configurar chaves de correspondência.
A conexão falhou após o sucesso inicial connection-failed
Use essas verificações quando uma conexão foi criada com êxito, mas depois entra em estado de falha.
- Verifique se a atribuição de função RBAC Azure para a entidade de segurança da Adobe não foi removida ou restringida.
- Confirme se os arquivos ainda existem no caminho e correspondem à especificação.
Importar ou formatar erros format-errors
Use essas verificações quando a origem falhar devido a problemas de estrutura de arquivo, hash ou formato de coluna.
- Certifique-se de que todos os arquivos mantenham a mesma estrutura de coluna e regras de hash da assimilação inicial.
Próximas etapas next-steps
Após a conclusão da fonte, os públicos-alvo estarão disponíveis em Meus públicos-alvo para ativação, análise de sobreposição e fluxos de trabalho de medição. Para ativar públicos-alvo de origem com colaboradores, consulte Ativar públicos-alvo.
Outros métodos de fornecimento disponíveis incluem Experience Platform, Amazon S3, Google Cloud Storage, Snowflake e carregamento de arquivo CSV. Para outros métodos de fornecimento de público-alvo, consulte: