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

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

Selecione o destino

  1. Vá para Connections > Destinations e selecione a guia Catalog.

    Guia Catálogo de destino

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

    Botão Ativar segmentos

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

    Selecionar destino

  4. Mova para a próxima seção para selecionar 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 selecione Next.

Selecionar segmentos

Agendar exportação de segmentos

Adobe Experience Platform exporta dados para marketing por email e destinos de armazenamento na nuvem na forma de CSV arquivos. Na página Scheduling, é possível configurar o agendamento e os nomes de arquivo para cada segmento que você 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 botão Create schedule correspondente ao segmento que você deseja enviar para o destino.

Botão Criar programação

Exportar arquivos completos

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

Exportar arquivos completos

  1. Use o seletor Frequency 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 seletor Time para escolher a hora do dia, no formato UTC, em que 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 seletor Date para escolher o dia ou o intervalo em que a exportação deve ocorrer.

    DICA

    Para exportações diárias, defina sua data de início e término para estar alinhada à duração das campanhas em suas plataformas de downstream.

  4. Selecione Create para salvar o agendamento.

Exportar arquivos incrementais

Selecione Exportar arquivos incrementais para acionar uma exportação onde 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.

Exportar arquivos incrementais

  1. Use o seletor Frequency 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 seletor Time para escolher a hora do dia, no formato UTC, em que 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 seletor Date para escolher o dia ou o intervalo em que a exportação deve ocorrer.

    DICA

    Defina sua data de início e término para se alinhar com a duração de suas campanhas em suas plataformas de downstream.

  4. Selecione Create para salvar o agendamento.

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.

configurar nome do arquivo

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

editar opções de nome de 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:

  • Nome do segmento: Você pode anexar o nome do segmento ao nome do arquivo.
  • Data e hora: Selecione entre adicionar um MMDDYYYY_HHMMSS formato ou um carimbo de data e hora de 10 dígitos do Unix 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.

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

IMPORTANTE

Se você não selecionar o componente Date and Time, 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 Next 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. Na página Selecionar atributos, selecione Adicionar novo campo.

    Adicionar novo mapeamento

  2. Selecione a seta à direita da entrada Schema field.

    Selecionar campo de origem

  3. Na página Select field, selecione os atributos XDM que deseja enviar para o destino e escolha Select.

    Página Selecionar campo de origem

  4. Para adicionar mais mapeamentos, repita as etapas de 1 a 3.

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 estiver selecionado:

  • Se o campo segmentMembership.status for selecionado, os arquivos exportados incluirão membros Ativos no instantâneo completo inicial e membros Ativos e Expirados nas exportações incrementais subsequentes.
  • Se o campo segmentMembership.status não estiver selecionado, os arquivos exportados incluirão apenas membros Ativos no instantâneo completo inicial e nas exportações incrementais subsequentes.

atributos recomendados

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 exporte apenas os perfis que incluam o atributo específico. Como resultado, ele pode ser usado como uma forma adicional de filtragem. Marcar um atributo como obrigatório é não necessá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 de identidade na documentação Destinos de marketing de email .

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

  • Uso de um único namespace de identidade como uma chave de desduplicação
  • Usar um único atributo de perfil de um perfil XDM como uma chave de desduplicação
  • Uso de uma combinação de dois atributos de perfil de um perfil 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 namespace Email, 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 atributo 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

Considerando a 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 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 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 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

Na página Revisar, você pode ver um resumo da sua seleção. Selecione Cancelar para quebrar o fluxo, Voltar para modificar suas configurações ou Concluir para confirmar sua 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 de política na seção Documentação de governança de dados.

violação da política de dados

Se nenhuma violação de política tiver sido detectada, selecione Finish para confirmar a seleção e iniciar o envio de dados para o destino.

Revisão

Verificar ativação de segmento

Para destinos de marketing por email e destinos de armazenamento na nuvem, o Adobe Experience Platform cria um arquivo .csv delimitado por tabulação 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 são estruturados, você pode baixar um arquivo .csv de amostra. Este arquivo de amostra inclui os atributos de perfil person.firstname, person.lastname, person.gender, person.birthyear e personalEmail.address.

Nesta página