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.
Este artigo explica o fluxo de trabalho necessário para ativar públicos-alvo em destinos baseados em perfil de lote do Adobe Experience Platform, como destinos de armazenamento em nuvem e marketing por email.
Para ativar públicos para destinos, você deve ter o conectado a um destino. Se ainda não tiver feito isso, acesse o catálogo de destinos, navegue pelos destinos compatíveis e configure o destino que deseja usar.
Os seguintes formatos de arquivo são compatíveis ao exportar públicos:
Observe que a exportação de arquivos CSV oferece maior flexibilidade em termos de como você deseja estruturar os arquivos exportados. Leia mais sobre configuração da formatação de arquivos CSV.
Selecione o formato de arquivo desejado para exportação quando criação de uma conexão com o destino baseado em arquivo.
Ir para Conexões > Destinos e selecione a variável Catálogo guia.
Selecionar Ativar públicos no cartão correspondente ao destino em que deseja ativar os públicos-alvo, conforme mostrado na imagem abaixo.
Selecione a conexão de destino que deseja usar para ativar os públicos-alvo e selecione Próxima.
Mover para a próxima seção para selecionar seus públicos.
Para selecionar os públicos que deseja ativar para o destino, use as caixas de seleção à esquerda dos nomes dos públicos e selecione Próxima.
Você pode selecionar entre vários tipos de públicos-alvo, dependendo de sua origem:
Seleção de públicos-alvo originados de Uploads personalizados ativa automaticamente a variável Selecionar atributos de enriquecimento etapa.
Adobe Experience Platform exporta dados para destinos de marketing por email e armazenamento na nuvem na forma de CSV arquivos. No Agendamento você pode configurar o agendamento e os nomes de arquivo para cada público-alvo que está exportando. A configuração do agendamento é obrigatória, mas a configuração do nome do arquivo é opcional.
Adobe Experience Platform O 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 é parte de uma exportação maior, como: filename.csv
, filename_2.csv
, filename_3.csv
.
Selecione o Criar programação botão correspondente ao público-alvo que você deseja enviar para o seu 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 público-alvo 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 público-alvo ou de forma programada, em um horário especificado. Ao selecionar a variável Agendado você pode usar o seletor para escolher a hora do dia, em UTC formato, quando a exportação deve ocorrer.
A variável Após a avaliação do segmento A opção descrita abaixo está disponível somente para clientes Beta selecionados.
Use o Após a avaliação do segmento opção para que o trabalho de ativação seja executado imediatamente após a conclusão diária do trabalho de segmentação em lote do Platform. Essa opção garante que, quando o trabalho de ativação for executado, os perfis mais atualizados sejam exportados para o seu destino.
Use o Agendado opção para que o trabalho de ativação seja executado em um horário fixado. Essa opção garante que os dados do perfil de Experience Platform sejam exportados no mesmo horário todos os dias. No entanto, os perfis exportados 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.
Use o Data seletor para escolher o dia ou intervalo em que a exportação deve ocorrer. Para exportações diárias, a prática recomendada é definir a data de início e término para alinhar-se à duração das campanhas em suas plataformas 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 do público-alvo 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 público-alvo, funcionando 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 formato, quando a exportação deve ocorrer.
Use o Data seletor para escolher o intervalo em que a exportação deve ocorrer. A prática recomendada é definir as datas de início e término para que se alinhem à duração das campanhas nas plataformas downstream.
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.
Para a maioria dos destinos, os nomes de arquivo padrão consistem no nome do destino, ID do público-alvo e um indicador de data e hora. Por exemplo, você pode editar os nomes de arquivo exportados para distinguir entre campanhas diferentes ou para anexar o tempo de exportação de dados aos arquivos. Observe que alguns desenvolvedores de destino podem optar por ter diferentes opções de anexação de nome de arquivo padrão mostradas para seus destinos.
Para abrir uma janela modal e editar os nomes dos arquivos, selecione o ícone de lápis. Os nomes de arquivo são limitados a 255 caracteres.
A imagem abaixo mostra como os nomes de arquivos podem ser editados para Amazon S3 destinos, mas o processo é idêntico para todos os destinos em lote (por exemplo, SFTP, Azure Blob Storageou Google Cloud Storage).
No editor de nome de arquivo, você pode selecionar diferentes componentes para adicionar ao nome do arquivo.
O nome de destino e a ID de público-alvo não podem ser removidos dos nomes de arquivo. Além dessas opções, você pode adicionar as seguintes opções:
Opção Nome do arquivo | Descrição |
---|---|
Nome do público | O nome do público exportado. |
Data e hora | Selecione entre adicionar um MMDDYYYY_HHMMSS formato ou um carimbo de data e hora de 10 dígitos do UNIX com a 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 público-alvo. |
Nome do destino | O nome do fluxo de dados de destino usado para exportar o público. |
Nome da organização | O nome da sua organização em Experience Platform. |
Nome da sandbox | A ID da sandbox usada para exportar o público-alvo. |
Selecionar Aplicar alterações para confirmar a seleção.
Se você não selecionar a opção Data e hora , os nomes dos arquivos serão estáticos e o novo arquivo exportado substituirá o arquivo anterior no local de armazenamento a 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.
Depois de concluir a configuração de todos os públicos-alvo, selecione Próxima para continuar.
Nesta etapa, você deve selecionar os atributos de perfil que deseja adicionar aos arquivos exportados para o destino. Para selecionar atributos de perfil e identidades para exportação:
No Mapeamento selecione Adicionar novo campo.
Selecione a seta à direita da Campo de origem entrada.
No Selecionar campo de origem selecione os atributos de perfil e as identidades que deseja incluir nos arquivos exportados para o destino e, em seguida, 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, edite o nome do cabeçalho no arquivo exportado. Para fazer isso, selecione o ícone no campo de destino.
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) É possível selecionar seu campo exportado para ser um chave obrigatória ou um chave de desduplicação.
Para adicionar mais campos para exportação, repita as etapas acima.
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.
É possível marcar atributos como obrigatórios para garantir que Platform O exporta somente os perfis que incluem o atributo específico. Como resultado, pode ser usado como uma forma adicional de filtragem. É obrigatório marcar um atributo não obrigatório.
Não selecionar um atributo obrigatório exporta todos os perfis qualificados, independentemente dos 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.
As 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 chaves de desduplicação no Platform:
É possível exportar um único namespace de identidade para um destino, e o namespace é automaticamente definido como chave de desduplicação. Não há suporte para enviar 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": "realized",
"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": "realized",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
Sem a desduplicação, o arquivo de exportação conteria as seguintes entradas.
personalEmail | firstName | lastName |
---|---|---|
johndoe@example.com | John | Doe |
johndoe@example.com | John | D |
Presumindo a desduplicação pelo Email , o arquivo de exportação conteria as entradas a seguir. O Perfil B é o mais recente qualificado para o público-alvo, portanto, é o único que está sendo exportado.
Email* | personalEmail | firstName | lastName |
---|---|---|---|
johndoe_1@example.com | johndoe@example.com | John | D |
johndoe_2@example.com | johndoe@example.com | John | D |
Presumindo a desduplicação pelo personal Email
, o arquivo de exportação conteria a seguinte entrada. O Perfil B é o mais recente qualificado para o público-alvo, portanto, é o único que está sendo exportado.
personalEmail* | firstName | lastName |
---|---|---|
johndoe@example.com | John | D |
Presumindo desduplicação pela chave composta personalEmail + lastName
, o arquivo de exportação conteria as entradas a seguir.
personalEmail* | 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 e-mail 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 aplicação desses rótulos de nível de campo na ativação ocorrerá nas seguintes condições:
Por exemplo, se o person.name.firstName
tiver determinados rótulos de uso de dados que entrem em conflito com a ação de marketing do destino, você verá uma violação de política do uso de dados na etapa de revisão. Para obter mais informações, consulte Governança de dados no Adobe Experience Platform.
Os clientes beta selecionados podem exportar objetos de matriz do Experience Platform para destinos de armazenamento na nuvem. Leia mais sobre exportação de matrizes e campos calculados e entre em contato com o representante da Adobe para obter acesso à funcionalidade.
O novo Mapeamento A página tem as seguintes limitações conhecidas:
Devido a uma limitação conhecida, não é possível usar o Selecionar campo janela para adicionar segmentMembership.status
para suas exportações de arquivo. Em vez disso, você precisa colar manualmente o valor xdm: segmentMembership.status
no campo schema, conforme mostrado abaixo.
As exportações de arquivos variam das seguintes maneiras, dependendo se segmentMembership.status
está selecionado:
segmentMembership.status
for selecionado, os arquivos exportados serão Ativo membros no instantâneo completo inicial e em eventos Ativo e Expirado membros em exportações incrementais subsequentes.segmentMembership.status
não estiver selecionado, os arquivos exportados incluirão apenas Ativo membros no instantâneo completo inicial e em exportações incrementais subsequentes.Leia mais sobre comportamento de exportação de perfil para destinos baseados em arquivo.
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 na variável Revisão etapa.
Como solução temporária, se você precisar adicionar namespaces de identidade aos arquivos exportados durante a versão beta, será possível:
Todos os destinos de armazenamento em nuvem no catálogo podem visualizar uma Mapeamento etapa que substitui a Selecionar atributos etapa descrita nesta seção.
Este Selecionar atributos A etapa ainda é exibida para os destinos de marketing por email do Marketing Cloud do Adobe Campaign, Oracle Responsys, Oracle Eloqua e Salesforce.
Para destinos baseados em perfil, você deve selecionar os atributos de perfil que deseja enviar ao destino.
No Selecionar atributos selecione Adicionar novo campo.
Selecione a seta à direita da Campo de esquema entrada.
No Selecionar campo selecione os atributos XDM ou os namespaces de identidade que deseja enviar ao 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, usados com frequência a partir do esquema: person.name.firstName
, person.name.lastName
, personalEmail.address
, segmentMembership.status
.
Devido a uma limitação conhecida, não é possível usar o Selecionar campo janela para adicionar segmentMembership.status
para suas exportações de arquivo. Em vez disso, cole manualmente o valor xdm: segmentMembership.status
no campo schema, conforme mostrado abaixo.
As exportações de arquivos variam das seguintes maneiras, dependendo se segmentMembership.status
está selecionado:
segmentMembership.status
for selecionado, os arquivos exportados serã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 incluirão apenas Ativo membros no instantâneo completo inicial e em exportações incrementais subsequentes.Esta etapa só será exibida se você tiver selecionado Upload personalizado públicos-alvo durante o seleção de público etapa.
Os atributos de enriquecimento correspondem aos públicos-alvo carregados personalizados assimilados no Experience Platform como Uploads personalizados. Nesta etapa, você pode selecionar quais atributos deseja exportar para o seu destino, para cada público externo selecionado.
Siga as etapas abaixo para selecionar atributos de enriquecimento para cada público externo:
Se quiser ativar públicos externos para seus destinos sem exportar nenhum atributo, habilite a opção Excluir atributos de enriquecimento alternar. Essa opção exporta os perfis dos públicos externos, mas nenhum dos atributos correspondentes é enviado para o seu destino.
Selecionar Próxima para ir para a Revisão etapa.
No Revisão você poderá ver um resumo da sua seleção. Selecionar Cancelar para interromper 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 adquiriu o Adobe Healthcare Shield ou o Adobe Privacy & Security Shield, 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. Ler sobre avaliação da política de consentimento para obter mais informações.
No Revisão etapa, o Experience Platform também verifica se há violações de 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 público-alvo até que a violação seja resolvida. Para obter informações sobre como resolver violações de política, leia sobre violações de política de uso de dados na seção documentação de governança de dados.
Também nesta etapa é possível usar os filtros disponíveis na página para exibir somente os públicos-alvo cujo agendamento ou mapeamento foi atualizado como parte desse fluxo de trabalho. Você também pode alternar quais colunas da tabela deseja visualizar.
Se estiver satisfeito com a 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.
Ao exportar públicos para destinos de armazenamento na nuvem, o Adobe Experience Platform cria uma .csv
, .json
ou .parquet
no local de armazenamento fornecido. Espere que um novo arquivo seja criado no local de armazenamento de acordo com o agendamento definido 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 seriam assim:
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 é uma confirmação de ativação bem-sucedida. Para entender como os arquivos exportados são estruturados, é possível baixar um arquivo .csv de amostra. Este arquivo de amostra inclui os atributos do perfil person.firstname
, person.lastname
, person.gender
, person.birthyear
, e personalEmail.address
.