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.

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

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.

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 destinos Amazon S3, mas o processo é idêntico para todos os destinos em lote (por exemplo, SFTP ou Armazenamento Azure Blob).

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:

  • Nome do segmento: Você pode anexar o nome do segmento ao nome do arquivo.
  • 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: Adicione texto personalizado aos nomes dos arquivos.

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

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.

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

IMPORTANTE

Nesta etapa, o Adobe Experience Platform verifica 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, consulte Aplicação da política na seção de documentação de governança de dados .

Imagem que mostra um exemplo de violação da política de dados.

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

Imagem que mostra a tela de revisão do fluxo de trabalho de ativação do segmento.

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. Espera que um novo arquivo seja criado no seu local de armazenamento todos os dias. O formato de arquivo padrão é:
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

Os arquivos que você receberia em três dias consecutivos podem 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