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.
Alguns clientes que participam do programa beta de funcionalidade de exportação de arquivos aprimorado estão vendo o novo Mapeamento como parte de seu fluxo de trabalho de ativação para a novos destinos de armazenamento na nuvem beta. Observe também a limitações conhecidas como parte da versão.
Este artigo explica o workflow necessário para ativar dados de público-alvo em destinos com base em perfis em lote do Adobe Experience Platform, como armazenamento em nuvem e destinos de marketing por email.
Para ativar dados em destinos, você deve ter conectado a um destino. Se ainda não o fez, acesse o catálogo de destinos, navegue pelos destinos compatíveis e configure o destino que deseja usar.
Ir para Conexões > Destinos e selecione o Catálogo guia .
Selecionar Ativar segmentos no cartão correspondente ao destino onde você deseja ativar seus segmentos, conforme mostrado na imagem abaixo.
Selecione a conexão de destino que deseja usar para ativar seus segmentos e selecione Próximo.
Mova para a próxima seção para selecione seus segmentos.
Use as caixas de seleção à esquerda dos nomes de segmentos para selecionar os segmentos que deseja ativar para o destino e, em seguida, selecione Próximo.
Adobe Experience Platform exporta dados para marketing por email e destinos de armazenamento em nuvem na forma de CSV arquivos. No Agendamento você pode configurar o agendamento e os nomes de arquivo para cada segmento que está exportando. A configuração do agendamento é obrigatória, mas a configuração do nome do arquivo é opcional.
Adobe Experience Platform divide automaticamente os arquivos de exportação em 5 milhões de registros (linhas) por arquivo. Cada linha representa um perfil.
Nomes de arquivos divididos são anexados com um número que indica que o arquivo faz parte de uma exportação maior, desta forma: filename.csv
, filename_2.csv
, filename_3.csv
.
Selecione o Criar programação botão correspondente ao segmento que você deseja enviar para o destino.
Selecionar Exportar arquivos completos para acionar a exportação de um arquivo contendo um instantâneo completo de todas as qualificações de perfil para o segmento selecionado.
Use o Frequência seletor para selecionar a frequência de exportação:
Use o Hora alterne para selecionar se a exportação deve ocorrer imediatamente após a avaliação do segmento ou de acordo com uma programação, em um horário especificado. Ao selecionar o Programado , você pode usar o seletor para escolher a hora do dia, em UTC , quando a exportação deve ocorrer.
O Após a avaliação do segmento A opção descrita abaixo está disponível somente para selecionar clientes Beta.
Use o Após a avaliação do segmento para que o trabalho de ativação seja executado imediatamente após a conclusão do trabalho diário de segmentação em lote da Platform. Isso garante que, quando o trabalho de ativação for executado, os perfis mais atualizados sejam exportados para o seu destino.
Use o Programado para que o trabalho de ativação seja executado em um horário fixo. Isso garante que os dados do perfil do Experience Platform sejam exportados ao mesmo tempo a cada dia, mas os perfis que você exporta podem não ser os mais atualizados, dependendo se o trabalho de segmentação em lote foi concluído antes do início do trabalho de ativação.
Devido à forma como os processos internos do Experience Platform são configurados, a primeira exportação de arquivo incremental ou completo pode não conter todos os dados de preenchimento retroativo.
Para garantir uma exportação de dados de preenchimento retroativo completa e mais atualizada para arquivos completos e incrementais, o Adobe recomenda definir o primeiro tempo de exportação de arquivo após as 12 PM GMT do dia seguinte. Essa limitação será solucionada em versões futuras.
Use o Data seletor para escolher o dia ou o intervalo em que a exportação deve ocorrer. Para exportações diárias, a prática recomendada é definir sua data de início e término para estar alinhada à duração de suas campanhas em suas plataformas de downstream.
Ao selecionar um intervalo de exportação, o último dia do intervalo não é incluído nas exportações. Por exemplo, se você selecionar um intervalo de 4 a 11 de janeiro, a última exportação de arquivo ocorrerá em 10 de janeiro.
Selecionar Criar para salvar o cronograma.
Selecionar Exportar arquivos incrementais para acionar uma exportação em que o primeiro arquivo é um instantâneo completo de todas as qualificações de perfil para o segmento selecionado e os arquivos subsequentes são qualificações de perfil incrementais desde a exportação anterior.
O primeiro arquivo incremental exportado inclui todos os perfis qualificados para um segmento, que funcionam como um preenchimento retroativo.
Use o Frequência seletor para selecionar a frequência de exportação:
Use o Hora seletor para escolher a hora do dia, em UTC , quando a exportação deve ocorrer.
Devido à forma como os processos internos do Experience Platform são configurados, a primeira exportação de arquivo incremental ou completo pode não conter todos os dados de preenchimento retroativo.
Para garantir uma exportação de dados de preenchimento retroativo completa e mais atualizada para arquivos completos e incrementais, o Adobe recomenda definir o primeiro tempo de exportação de arquivo após as 12 PM GMT do dia seguinte. Essa limitação será solucionada em versões futuras.
Use o Data seletor para escolher o intervalo em que a exportação deve ocorrer. A prática recomendada é definir sua data de início e término para alinhar-se à duração de suas campanhas em suas plataformas de downstream.
O último dia do intervalo não está incluído nas exportações. Por exemplo, se você selecionar um intervalo de 4 a 11 de janeiro, a última exportação de arquivo ocorrerá em 10 de janeiro.
Selecionar Criar para salvar o cronograma.
Para a maioria dos destinos, os nomes de arquivo padrão consistem em nome de destino, ID de segmento e um indicador de data e hora. Por exemplo, você pode editar os nomes de arquivo exportados para distinguir entre campanhas diferentes ou para ter o tempo de exportação de dados anexado aos arquivos. Observe que alguns desenvolvedores de destino podem optar por ter diferentes opções de anexação de nome de arquivo padrão exibidas para seus destinos.
Selecione o ícone de lápis para abrir uma janela modal e editar os nomes dos arquivos. Os nomes de arquivo são limitados a 255 caracteres.
A imagem abaixo mostra como os nomes de arquivo podem ser editados para Amazon S3 destinos , mas o processo é idêntico para todos os destinos de lote (por exemplo, SFTP, Azure Blob Storageou Google Cloud Storage).
No editor de nome de arquivo, é possível selecionar componentes diferentes para adicionar ao nome do arquivo.
O nome de destino e a ID de segmento não podem ser removidos dos nomes de arquivo. Além disso, você pode adicionar o seguinte:
Opção Nome do arquivo | Descrição |
---|---|
Nome do segmento | O nome do segmento exportado. |
Data e hora | Selecione entre adicionar um MMDDYYYY_HHMMSS ou um carimbo de data e hora Unix de 10 dígitos da hora em que os arquivos são gerados. Escolha uma dessas opções se desejar que seus arquivos tenham um nome de arquivo dinâmico gerado com cada exportação incremental. |
Texto personalizado | Qualquer texto personalizado que você deseja adicionar aos nomes de arquivo. |
ID de destino | A ID do fluxo de dados de destino usado para exportar o segmento. Observação: Essa opção de anexação de nome de arquivo está disponível somente para clientes beta que participam do programa beta aprimorado da funcionalidade de exportação de arquivos. Entre em contato com o representante do Adobe ou com o Atendimento ao cliente se desejar acessar o programa beta. |
Nome do destino | O nome do fluxo de dados de destino usado para exportar o segmento. Observação: Essa opção de anexação de nome de arquivo está disponível somente para clientes beta que participam do programa beta aprimorado da funcionalidade de exportação de arquivos. Entre em contato com o representante do Adobe ou com o Atendimento ao cliente se desejar acessar o programa beta. |
Nome da organização | Nome da organização no Experience Platform. Observação: Essa opção de anexação de nome de arquivo está disponível somente para clientes beta que participam do programa beta aprimorado da funcionalidade de exportação de arquivos. Entre em contato com o representante do Adobe ou com o Atendimento ao cliente se desejar acessar o programa beta. |
Nome da sandbox | A ID da sandbox usada para exportar o segmento. Observação: Essa opção de anexação de nome de arquivo está disponível somente para clientes beta que participam do programa beta aprimorado da funcionalidade de exportação de arquivos. Entre em contato com o representante do Adobe ou com o Atendimento ao cliente se desejar acessar o programa beta. |
Selecionar Aplicar alterações para confirmar a seleção.
Se você não selecionar a variável Data e hora , os nomes de arquivo serão estáticos e o novo arquivo exportado substituirá o arquivo anterior no local de armazenamento com cada exportação. Ao executar um trabalho de importação recorrente de um local de armazenamento em uma plataforma de marketing por email, essa é a opção recomendada.
Após concluir a configuração de todos os segmentos, selecione Próximo para continuar.
Para destinos com base em perfil, você deve selecionar os atributos de perfil que deseja enviar para o destino do target.
No Selecionar atributos página, selecione Adicionar novo campo.
Selecione a seta à direita da Campo Esquema entrada.
No Selecionar campo selecione os atributos XDM ou os namespaces de identidade que deseja enviar para o destino e escolha Selecionar.
Para adicionar mais mapeamentos, repita as etapas de um a três.
O Adobe Experience Platform preenche sua seleção com quatro atributos recomendados e comumente usados do esquema: person.name.firstName
, person.name.lastName
, personalEmail.address
, segmentMembership.status
.
Devido a uma limitação conhecida, não é possível usar atualmente a variável Selecionar campo janela para adicionar segmentMembership.status
para suas exportações de arquivo. Em vez disso, é necessário colar manualmente o valor xdm: segmentMembership.status
no campo schema , conforme mostrado abaixo.
As exportações de arquivo variam das seguintes maneiras, dependendo se segmentMembership.status
está selecionada:
segmentMembership.status
for selecionado, os arquivos exportados incluirão Ativo membros no instantâneo completo inicial e Ativo e Expirado membros em exportações incrementais subsequentes.segmentMembership.status
não estiver selecionado, os arquivos exportados incluem somente Ativo membros no instantâneo completo inicial e nas exportações incrementais subsequentes.Um atributo obrigatório é uma caixa de seleção ativada pelo usuário que garante que todos os registros de perfil contenham o atributo selecionado. Por exemplo: todos os perfis exportados contêm um endereço de email.
Você pode marcar atributos como obrigatórios para garantir que Platform exporta apenas os perfis que incluem o atributo específico. Como resultado, ele pode ser usado como uma forma adicional de filtragem. Marcar um atributo como obrigatório é not obrigatório.
A não seleção de um atributo obrigatório exporta todos os perfis qualificados, independentemente de seus atributos.
Recomenda-se que um dos atributos seja um identificador exclusivo do esquema. Para obter mais informações sobre atributos obrigatórios, consulte a seção identidade na Destinos de marketing por email documentação.
Uma chave de desduplicação é uma chave primária definida pelo usuário que determina a identidade pela qual os usuários desejam que seus perfis sejam desduplicados.
Chaves de desduplicação eliminam a possibilidade de ter vários registros do mesmo perfil em um arquivo de exportação.
Há três maneiras de usar as chaves de desduplicação no Platform:
Você pode exportar um único namespace de identidade para um destino, e o namespace é automaticamente definido como chave de desduplicação. Não há suporte para o envio de vários namespaces para um destino.
Não é possível usar uma combinação de namespaces de identidade e atributos de perfil como chaves de desduplicação.
Este exemplo ilustra como a desduplicação funciona, dependendo das chaves de desduplicação selecionadas.
Vamos considerar os dois perfis a seguir.
Perfil A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "existing",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Perfil B
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "existing",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Sem desduplicação, o arquivo de exportação conteria as seguintes entradas.
emailpessoal | firstName | lastName |
---|---|---|
johndoe@example.com | John | Doe |
johndoe@example.com | John | D |
Considerando a desduplicação pelo Email namespace, o arquivo de exportação conteria as seguintes entradas. O Perfil B é o mais recente que se qualificou para o segmento, por isso é o único que está sendo exportado.
Email* | emailpessoal | firstName | lastName |
---|---|---|---|
johndoe_1@example.com | johndoe@example.com | John | D |
johndoe_2@example.com | johndoe@example.com | John | D |
Considerando a desduplicação pelo personal Email
, o arquivo de exportação conteria a seguinte entrada. O Perfil B é o mais recente que se qualificou para o segmento, por isso é o único que está sendo exportado.
emailpessoal* | firstName | lastName |
---|---|---|
johndoe@example.com | John | D |
Assumindo desduplicação pela chave composta personalEmail + lastName
, o arquivo de exportação conteria as seguintes entradas.
emailpessoal* | lastName* | firstName |
---|---|---|
johndoe@example.com | D | John |
johndoe@example.com | Doe | John |
O Adobe recomenda selecionar um namespace de identidade, como um CRM ID ou endereço de email como uma chave de desduplicação, para garantir que todos os registros de perfil sejam identificados exclusivamente.
Se algum rótulo de uso de dados tiver sido aplicado a determinados campos em um conjunto de dados (em vez do conjunto de dados inteiro), a imposição desses rótulos em nível de campo na ativação ocorrerá sob as seguintes condições:
Por exemplo, se o campo person.name.firstName
Se tiver determinados rótulos de uso de dados que entram em conflito com a ação de marketing do destino, você verá uma violação da política de uso de dados na etapa de revisão. Para obter mais informações, consulte Governança de dados no Adobe Experience Platform.
Clientes beta selecionados podem exibir um relatório aprimorado Mapeamento que substitui Selecionar atributos de perfil etapa descrita acima. Este novo Mapeamento permite editar os cabeçalhos de arquivos exportados para quaisquer nomes personalizados que você desejar.
A funcionalidade e a documentação estão sujeitas a alterações. Entre em contato com o representante do Adobe ou com o Atendimento ao cliente se desejar acessar esse programa beta.
Nesta etapa, você deve selecionar os atributos de perfil que deseja adicionar aos arquivos exportados para o destino do target. Para selecionar os atributos e identidades do perfil para exportação:
No Mapeamento página, selecione Adicionar novo campo.
Selecione a seta à direita da Campo de origem entrada.
No Selecionar campo de origem selecione os atributos e identidades do perfil que deseja incluir nos arquivos exportados para o destino e escolha Selecionar.
Você pode usar o campo de pesquisa para restringir sua seleção, como mostrado na imagem abaixo.
O campo selecionado para exportação agora aparece na visualização de mapeamento. Se desejar, é possível editar o nome do cabeçalho no arquivo exportado. Para fazer isso, selecione o ícone no campo target .
No Selecionar campo de destino digite o nome desejado do cabeçalho no arquivo exportado e escolha Selecionar.
O campo selecionado para exportação agora aparece na exibição de mapeamento e mostra o cabeçalho editado no arquivo exportado.
(Opcional) Você pode selecionar o campo exportado para ser um chave obrigatória ou chave de desduplicação.
Para adicionar mais campos para exportação, repita as etapas acima.
O novo Mapeamento tem as seguintes limitações conhecidas:
Devido a uma limitação conhecida, não é possível usar atualmente a variável Selecionar campo janela para adicionar segmentMembership.status
para suas exportações de arquivo. Em vez disso, é necessário colar manualmente o valor xdm: segmentMembership.status
no campo schema , conforme mostrado abaixo.
As exportações de arquivo variam das seguintes maneiras, dependendo se segmentMembership.status
está selecionada:
segmentMembership.status
for selecionado, os arquivos exportados incluirão Ativo membros no instantâneo completo inicial e Ativo e Expirado membros em exportações incrementais subsequentes.segmentMembership.status
não estiver selecionado, os arquivos exportados incluem somente Ativo membros no instantâneo completo inicial e nas exportações incrementais subsequentes.No momento, não há suporte para a seleção de namespaces de identidade para exportação, como mostrado na imagem abaixo. Selecionar qualquer namespace de identidade para exportação resultará em um erro no Revisão etapa.
Como solução temporária, se você precisar adicionar namespaces de identidade aos arquivos exportados durante o beta, é possível:
No Revisão você pode ver um resumo da sua seleção. Selecionar Cancelar para quebrar o fluxo, Voltar para modificar suas configurações, ou Concluir para confirmar a seleção e começar a enviar dados para o destino.
Se sua organização comprou Blindagem do Adobe Healthcare ou Privacidade e proteção de segurança do Adobe, selecione Exibir políticas de consentimento aplicáveis para ver quais políticas de consentimento são aplicadas e quantos perfis são incluídos na ativação como resultado delas. Leia sobre avaliação da política de consentimento para obter mais informações.
No Revisão , o Experience Platform também verifica se há violações da política de uso de dados. Veja abaixo um exemplo de violação de uma política. Não é possível concluir o fluxo de trabalho de ativação de segmento até que você tenha resolvido a violação. Para obter informações sobre como resolver violações de política, leia sobre violações da política de uso de dados na seção de documentação de governança de dados .
Além disso, nesta etapa, você pode usar os filtros disponíveis na página para exibir apenas os segmentos cujo agendamento ou mapeamento foi atualizado como parte desse fluxo de trabalho. Também é possível alternar quais colunas de tabela você deseja visualizar.
Se estiver satisfeito com sua seleção e nenhuma violação de política tiver sido detectada, selecione Concluir para confirmar a seleção e começar a enviar dados para o destino.
Para destinos de marketing por email e destinos de armazenamento em nuvem, o Adobe Experience Platform cria um .csv
no local de armazenamento fornecido. Esperar que um novo arquivo seja criado no local de armazenamento de acordo com a programação definida no fluxo de trabalho. O formato de arquivo padrão é mostrado abaixo, mas você pode editar os componentes do nome do arquivo:
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv
Por exemplo, se você selecionasse uma frequência de exportação diária, os arquivos que você receberia em três dias consecutivos poderiam ter a seguinte aparência:
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv
A presença desses arquivos no local de armazenamento é a confirmação de uma ativação bem-sucedida. Para entender como os arquivos exportados estão estruturados, você pode baixar um arquivo .csv de amostra. Esse arquivo de amostra inclui os atributos do perfil person.firstname
, person.lastname
, person.gender
, person.birthyear
e personalEmail.address
.