Ativar públicos para destinos de exportação de perfil em lote

Visão geral overview

Este artigo explica o fluxo de trabalho necessário para ativar públicos-alvo no Adobe Experience Platform para destinos baseados em arquivo de perfil em lote, como destinos de marketing por email e armazenamento em nuvem.

Pré-requisitos prerequisites

Para ativar públicos para destinos, você deve ter se conectado com êxito a um destino. Se ainda não tiver feito isso, vá para o catálogo de destinos, navegue pelos destinos compatíveis e configure o destino que deseja usar.

Formatos de arquivo compatíveis para exportação supported-file-formats-export

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 de formatação de arquivo para arquivos CSV.

Selecione o formato de arquivo desejado para exportação ao criar uma conexão com o destino baseado em arquivo.

Selecione seu destino select-destination

Selecione seus públicos-alvo select-audiences

Para selecionar os públicos que você deseja ativar para o destino, use as caixas de seleção à esquerda dos nomes de público e selecione Avançar.

Você pode selecionar entre vários tipos de públicos-alvo, dependendo de sua origem:

Programar exportação de público-alvo scheduling

Adobe Experience Platform exporta dados para destinos de marketing por email e armazenamento na nuvem como tipos de arquivos diferentes. Na página Agendamento, você pode configurar o agendamento e os nomes de arquivo para cada público-alvo que está exportando.

O Experience Platform define automaticamente um agendamento padrão para cada exportação de arquivo. Você pode modificar o agendamento padrão de acordo com suas necessidades, selecionando o ícone de lápis ao lado de cada agendamento e definindo um agendamento personalizado.

Para editar vários agendamentos ao mesmo tempo, marque os públicos usando as caixas de seleção no lado esquerdo da tela e selecione Editar agendamento. O agendamento configurado será aplicado a todos os arquivos exportados para os públicos selecionados.

Exportar arquivos completos export-full-files

Selecione Exportar arquivos completos para acionar a exportação de um arquivo que contém um instantâneo completo de todas as qualificações de perfil para o público selecionado.

Noções básicas sobre o comportamento de exportação programado export-behavior

As exportações programadas incluem dados de instantâneo do público-alvo, além de quaisquer alterações incrementais de perfil ou identidade que ocorram entre a criação do instantâneo e o momento da exportação. Isso é diferente de exportações sob demanda, que usam apenas dados de instantâneo.

A tabela a seguir destaca como as exportações programadas diferem das exportações sob demanda, particularmente em termos de atualização de dados e uso pretendido:

Se os perfis forem atualizados após a avaliação do público-alvo, as exportações agendadas incluirão os valores de atributo atualizados, mesmo que a associação do público-alvo tenha sido determinada no momento da avaliação.

Exemplo: um público-alvo para “perfis em que retailID é nulo” poderá exportar perfis com retailID preenchido se esse campo tiver sido atualizado após a avaliação, mas antes da exportação agendada.

Recomendações

Para exportações sob demanda, consulte a documentação em exportando arquivos sob demanda.

Exportar arquivos incrementais export-incremental-files

Selecione 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 público-alvo selecionado, e os arquivos subsequentes são qualificações de perfil incrementais desde a exportação anterior.

Configurar nomes de arquivo configure-file-names

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.

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:

Para editar vários nomes de arquivo ao mesmo tempo, marque os públicos usando as caixas de seleção no lado esquerdo da tela e selecione Editar nome do arquivo. As opções de nome de arquivo configuradas serão aplicadas a todos os arquivos exportados para os públicos selecionados.

Selecione Aplicar alterações para confirmar a seleção.

Após concluir a configuração de todos os públicos-alvo, selecione Avançar para continuar.

Mapeamento mapping

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:

Atributos obrigatórios mandatory-attributes

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 o Experience Platform exporte apenas os perfis que incluem o atributo específico. Como resultado, pode ser usado como uma forma adicional de filtragem. É necessário marcar um atributo como obrigatório não.

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 documentação de Destinos de marketing por email.

Chaves de desduplicação deduplication-keys

Uma chave de desduplicação é uma chave primária definida pelo usuário que determina como os perfis são desduplicados. Quando existem vários registros para o mesmo indivíduo, a desduplicação garante que somente o registro mais recente seja exportado.

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 em Experience Platform:

Exemplo de desduplicação deduplication-example

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@example.com"
      },
      {
        "id": "doejohn_1@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@example.com"
      },
      {
        "id": "doejohn_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"
  }
}

Caso de uso de desduplicação 1: sem desduplicação deduplication-use-case-1

Sem a desduplicação, o arquivo de exportação conteria as seguintes entradas.

Caso de uso de desduplicação 2: desduplicação com base no namespace de identidade deduplication-use-case-2

Considerando a desduplicação pelo namespace 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.

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

Considerando a desduplicação pelo atributo 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.

Caso de uso de desduplicação 4: desduplicação com base em dois atributos de perfil deduplication-use-case-4

Considerando a desduplicação pela chave composta personalEmail + lastName, o arquivo de exportação conteria as entradas a seguir.

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

Comportamento de desduplicação para perfis com o mesmo carimbo de data e hora deduplication-same-timestamp

Ao exportar perfis para destinos baseados em arquivo, a desduplicação garante que apenas um perfil seja exportado quando vários perfis compartilharem a mesma chave de desduplicação e o mesmo carimbo de data e hora de referência. Esse carimbo de data e hora representa o momento em que a associação de público-alvo ou o gráfico de identidade de um perfil foi atualizado pela última vez. Para obter mais informações sobre como os perfis são atualizados e exportados, consulte o documento comportamento de exportação do perfil.

Principais considerações key-considerations

Considere os seguintes dados, em que a chave de desduplicação é a coluna Email:

Após a desduplicação, o arquivo de exportação conterá:

Explicação: para test1@test.com, ambos os perfis compartilham a mesma chave de desduplicação e carimbo de data/hora. O algoritmo classifica os valores de coluna first_name e last_name lexicograficamente. Como os nomes são idênticos, o vínculo é resolvido usando a coluna last_name, em que “Doe” vem antes de “Morris”.

Confiabilidade aprimorada: esse processo de desduplicação atualizado garante que execuções sucessivas com as mesmas coordenadas sempre produzirão os mesmos resultados, melhorando a consistência.

Executar transformações de dados por meio de campos calculados calculated-fields

Você pode usar o controle Campos calculados para executar várias transformações de dados nos dados exportados para destinos baseados em arquivo.

Limitações conhecidas known-limitations

A nova página Mapeamento tem as seguintes limitações conhecidas:

O atributo de associação de público não pode ser selecionado por meio do fluxo de trabalho de mapeamento audience-membership-attribute-mapping

Devido a uma limitação conhecida, no momento, você não pode usar a janela Selecionar campo para adicionar segmentMembership.seg_namespace.seg_id.status às suas exportações de arquivo. Em vez disso, você precisa colar manualmente o valor xdm: segmentMembership.seg_namespace.seg_id.status no campo de esquema, como mostrado abaixo.

As exportações de arquivos variam das seguintes maneiras, dependendo se segmentMembership.seg_namespace.seg_id.status está ou não selecionado:

Leia mais sobre comportamento de exportação de perfil para destinos baseados em arquivo.

Os namespaces de identidade não podem ser selecionados atualmente para exportações identity-namespaces-export-limitation

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 etapa Revisão.

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

Selecionar atributos de perfil select-attributes

Para destinos baseados em perfil, você deve selecionar os atributos de perfil que deseja enviar ao destino.

IMPORTANT

Devido a uma limitação conhecida, no momento, você não pode usar a janela Selecionar campo para adicionar segmentMembership.seg_namespace.seg_id.status às suas exportações de arquivo. Em vez disso, você deve colar manualmente o valor xdm: segmentMembership.seg_namespace.seg_id.status no campo de esquema, conforme mostrado abaixo.

As exportações de arquivos variam das seguintes maneiras, dependendo se segmentMembership.seg_namespace.seg_id.status está ou não selecionado:

Selecionar atributos de enriquecimento select-enrichment-attributes

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. Essa opção exporta os perfis dos públicos externos, mas nenhum dos atributos correspondentes é enviado para o seu destino.

Selecione Avançar para ir até a etapa Revisão.

[Beta]{class="badge informative"} Exportar matrizes e objetos de atributos de enriquecimento export-arrays-enrichment-attributes

Ao exportar públicos para destinos de armazenamento na nuvem com saída JSON ou Parquet e a opção Exportar matrizes, mapas e objetos ​​habilitada, você pode exportar estruturas de dados complexas, incluindo matrizes inteiras ou campos selecionados de matrizes de objetos, como atributos de enriquecimento.

A etapa atributos de enriquecimento mostra uma interface de mapeamento de duas colunas:

Essa funcionalidade só estará disponível quando todas as seguintes condições forem atendidas:

Exportar uma matriz inteira export-entire-array

Selecione o nome do atributo de matriz na tela de seleção de campo de origem. O campo de origem é preenchido com o caminho da matriz e o campo de destino é preenchido automaticamente com o nome da matriz. A saída exportada preserva todos os objetos na matriz com todas as suas propriedades.

Exportar um único campo de uma matriz de objetos export-single-array-field

Quando você seleciona uma propriedade aninhada dentro de uma matriz de objetos, o campo do Source é preenchido automaticamente com uma expressão calculada transformArray usando to_object para extrair essa propriedade de cada objeto na matriz.

Por exemplo, selecionar someArray[*].amount preenche o campo de origem com:

transformArray(someArray, x -> to_object("amount", x.amount))

O campo de destino é preenchido automaticamente com o nome do nó folha (amount). Você pode alterar o nome do campo de público-alvo se desejar fazer isso.

Exportar vários campos de uma matriz de objetos export-multiple-array-fields

Para exportar mais de uma propriedade da mesma matriz de objetos, siga este processo de duas etapas:

Por exemplo, para exportar amount e date de someArray, comece selecionando someArray[*].amount e edite a expressão para:

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

Somente os campos especificados são incluídos em cada objeto dentro da matriz exportada. Além disso, você pode alterar o nome da matriz de nível superior no arquivo exportado, se desejar.

Revisar review

Na página Revisão, você pode ver um resumo da sua seleção. Selecione Cancelar para interromper o fluxo, Voltar para modificar suas configurações ou Concluir para confirmar sua seleção e começar a enviar dados ao destino.

Avaliação da política de consentimento consent-policy-evaluation

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. Leia sobre avaliação de política de consentimento para obter mais informações.

Verificações de política de uso de dados data-usage-policy-checks

Na etapa Revisão, a 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 de documentação sobre governança de dados.

Filtrar públicos filter-audiences

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 você estiver satisfeito com sua seleção e nenhuma violação de política for detectada, selecione Concluir para confirmar sua seleção e começar a enviar dados para o destino.

Verificar ativação de público verify

Ao exportar públicos para destinos de armazenamento na nuvem, o Adobe Experience Platform cria um arquivo .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, você pode baixar um arquivo .csv de exemplo. Este arquivo de exemplo inclui os atributos de perfil person.firstname, person.lastname, person.gender, person.birthyear e personalEmail.address.