Ativar dados do público-alvo para destinos de exportação de perfil em lote

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.

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.

Visão geral

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.

Pré-requisitos

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.

Selecione o destino

  1. Ir para Conexões > Destinos e selecione o Catálogo guia .

    Imagem destacando como chegar à guia catálogo de destinos

  2. Selecionar Ativar segmentos no cartão correspondente ao destino onde você deseja ativar seus segmentos, conforme mostrado na imagem abaixo.

    Imagem destacando o botão Ativar segmentos

  3. Selecione a conexão de destino que deseja usar para ativar seus segmentos e selecione Próximo.

    Imagem que destaca como selecionar um ou vários destinos para ativar segmentos no

  4. Mova para a próxima seção para selecione seus segmentos.

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.

Imagem destacando como selecionar um ou vários segmentos para ativar

Agendar exportação de segmentos

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.

IMPORTANTE

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.

Imagem destacando o botão Criar programação

Exportar arquivos completos

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.

Imagem da interface do usuário com a opção Exportar arquivos completos selecionada.

  1. Use o Frequência seletor para selecionar a frequência de exportação:

    • Uma vez: agendar uma exportação de arquivo completo sob demanda única.
    • Diariamente: agendar exportações completas de arquivos uma vez por dia, todos os dias, no momento especificado.
  2. 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.

    OBSERVAÇÃO

    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.

    Imagem destacando a opção Após avaliação do segmento no fluxo de ativação para destinos em lote.
    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.

    Imagem destacando a opção Scheduled no fluxo de ativação para destinos em lote e mostrando o seletor de tempo.

    IMPORTANTE

    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.

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

    IMPORTANTE

    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.

  4. Selecionar Criar para salvar o cronograma.

Exportar arquivos incrementais

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.

IMPORTANTE

O primeiro arquivo incremental exportado inclui todos os perfis qualificados para um segmento, que funcionam como um preenchimento retroativo.

Imagem da interface do usuário com a opção Exportar arquivos incrementais selecionada.

  1. Use o Frequência seletor para selecionar a frequência de exportação:

    • Diariamente: agendar exportações de arquivos incrementais uma vez por dia, todos os dias, no momento especificado.
    • Por hora: agendar exportações de arquivos incrementais a cada 3, 6, 8 ou 12 horas.
  2. Use o Hora seletor para escolher a hora do dia, em UTC , quando a exportação deve ocorrer.

    IMPORTANTE

    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.

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

    IMPORTANTE

    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.

  4. Selecionar Criar para salvar o cronograma.

Configurar nomes de arquivo

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.

OBSERVAÇÃO

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

Imagem destacando o ícone de lápis, que é usado para configurar nomes de arquivos.

No editor de nome de arquivo, é possível selecionar componentes diferentes para adicionar ao nome do arquivo.

Imagem exibindo todas as opções de nome de arquivo disponíveis.

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.

IMPORTANTE

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.

Selecionar atributos de perfil

Para destinos com base em perfil, você deve selecionar os atributos de perfil que deseja enviar para o destino do target.

  1. No Selecionar atributos página, selecione Adicionar novo campo.

    Imagem destacando o botão Add new field .

  2. Selecione a seta à direita da Campo Esquema entrada.

    Imagem destacando como selecionar um campo de origem.

  3. No Selecionar campo selecione os atributos XDM ou os namespaces de identidade que deseja enviar para o destino e escolha Selecionar.

    Imagem que mostra os vários campos disponíveis como campos de origem.

  4. Para adicionar mais mapeamentos, repita as etapas de um a três.

OBSERVAÇÃO

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.

IMPORTANTE

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.

Gravação de tela mostrando a solução alternativa de associação de segmento na etapa de mapeamento do fluxo de trabalho de ativação.

As exportações de arquivo variam das seguintes maneiras, dependendo se segmentMembership.status está selecionada:

  • Se a variável 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.
  • Se a variável segmentMembership.status não estiver selecionado, os arquivos exportados incluem somente Ativo membros no instantâneo completo inicial e nas exportações incrementais subsequentes.

Imagem mostrando atributos recomendados pré-preenchidos na etapa de mapeamento do fluxo de trabalho de ativação do segmento.

Atributos obrigatórios

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.

Chaves de desduplicaçã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:

  • Uso de um único namespace de identidade como um chave de desduplicação
  • Usar um único atributo de perfil de um XDM como um chave de desduplicação
  • Uso de uma combinação de dois atributos de perfil de uma XDM como uma chave composta
IMPORTANTE

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.

Exemplo 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"
  }
}

Caso de uso de desduplicação 1: sem desduplicação

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

Caso de uso de desduplicação 2: desduplicação com base no namespace de identidade

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

Caso de uso de desduplicação 3: desduplicação com base em um único atributo de perfil

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

Caso de uso de desduplicação 4: desduplicação com base em dois atributos de perfil

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.

OBSERVAÇÃO

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:

  • Os campos são usados na definição do segmento.
  • Os campos são configurados como atributos projetados para o destino.

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.

Mapeamento (Beta)

IMPORTANTE

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:

  1. No Mapeamento página, selecione Adicionar novo campo.

    Adicionar novo controle de campo destacado no workflow de mapeamento.

  2. Selecione a seta à direita da Campo de origem entrada.

    Selecione o controle de campo de origem destacado no workflow de mapeamento.

  3. No Selecionar campo de origem selecione os atributos e identidades do perfil que deseja incluir nos arquivos exportados para o destino e escolha Selecionar.

    DICA

    Você pode usar o campo de pesquisa para restringir sua seleção, como mostrado na imagem abaixo.

    Janela modal que mostra os atributos de perfil que podem ser exportados para o destino.

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

    Janela modal que mostra os atributos de perfil que podem ser exportados para o destino.

  5. No Selecionar campo de destino digite o nome desejado do cabeçalho no arquivo exportado e escolha Selecionar.

    Janela modal mostrando um nome amigável digitado para um cabeçalho.

  6. O campo selecionado para exportação agora aparece na exibição de mapeamento e mostra o cabeçalho editado no arquivo exportado.

    Janela modal que mostra os atributos de perfil que podem ser exportados para o destino.

  7. (Opcional) Você pode selecionar o campo exportado para ser um chave obrigatória ou chave de desduplicação.

    Janela modal que mostra os atributos de perfil que podem ser exportados para o destino.

  8. Para adicionar mais campos para exportação, repita as etapas acima.

Limitações conhecidas

O novo Mapeamento tem as seguintes limitações conhecidas:

Não é possível selecionar o atributo de associação de segmento por meio do fluxo de trabalho de mapeamento

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.

Gravação de tela mostrando a solução alternativa de associação de segmento na etapa de mapeamento do fluxo de trabalho de ativação.

As exportações de arquivo variam das seguintes maneiras, dependendo se segmentMembership.status está selecionada:

  • Se a variável 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.
  • Se a variável segmentMembership.status não estiver selecionado, os arquivos exportados incluem somente Ativo membros no instantâneo completo inicial e nas exportações incrementais subsequentes.

Os namespaces de identidade não podem ser selecionados no momento para exportações

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.

Mapeamento não suportado mostrando exportações de identidade

Como solução temporária, se você precisar adicionar namespaces de identidade aos arquivos exportados durante o beta, é possível:

  • Use os destinos herdados de armazenamento em nuvem para os fluxos de dados nos quais deseja incluir namespaces de identidade nas exportações
  • Faça upload de identidades como atributos no Experience Platform para exportá-las para os destinos de armazenamento na nuvem.

Consulte a seção

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.

Resumo da seleção na etapa de revisão.

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.

Verificações da política de uso de dados

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 .

violação da política de dados

Filtrar segmentos

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.

Gravação de tela mostrando os filtros de segmento disponíveis na etapa de revisão.

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.

Verificar ativação de segmento

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.birthyeare personalEmail.address.

Nesta página