Perguntas frequentes sobre assimilação de dados de entrada do cliente

Perguntas frequentes sobre como trazer dados offline para o Audience Manager.

Você pode resumir o processo de integração?

O processo de integração consiste em duas etapas descritas em Enviar dados em lote para a visão geral do Audience Manager:

  • Etapa 1: sincronizar IDs de usuário;
  • Etapa 2: criar e transferir o arquivo de dados de entrada seguindo os requisitos de formato de arquivo.

Você pode resumir o processo de implantação?

Recomendamos o seguinte:

  • Trabalhe com seu provedor de dados para formatar o arquivo de dados de entrada diário de acordo com as especificações da Adobe. Consulte a documentação a seguir para conhecer os requisitos de sintaxe e nome de arquivo:
  • Trabalhe com o consultor da Adobe para transferir um arquivo de dados de teste para a Adobe para verificação de formato.
  • Trabalhe com o consultor da Adobe para produzir uma taxonomia adequada para interpretar o conteúdo do arquivo de dados.
  • No ambiente de armazenamento temporário/desenvolvimento, confirme se a sincronização da ID está configurada para coletar corretamente a ID do visitante do provedor de dados e transferi-la para os servidores do Audience Manager em tempo real.
  • Implantar sincronização de DIL/ID para produção. A sincronização de ID já será configurada como um módulo dentro do código de DIL pelo consultor da Adobe.
  • Transfira os arquivos de dados de produção para o Audience Manager. Considerando as dependências nos mapeamentos de sincronização de ID, pode fazer sentido começar a transferir dados até uma semana após a implantação do código de produção, embora seja possível começar a transferir os arquivos de dados assim que o código entrar em produção.

Que modo FTP devo usar para transferir arquivos compactados ou criptografados?

Consulte Compactação de arquivos de transferência de dados de entrada.

AVISO

Estamos removendo gradualmente o suporte para configurações FTP. Embora a assimilação de arquivos de dados de entrada ainda seja aceita em integrações FTP existentes, recomendamos o uso do Amazon S3 para dados offline integrados para novas integrações. Consulte Requisitos de nome e tamanho de arquivo do Amazon S3 para arquivos de dados de entrada para obter detalhes.

É possível carregar um arquivo de dados de entrada (.sync ou arquivo .overwrite) antes de implantar o código Audience Manager na produção?

Sim. Desde que você use um cross-device data source para armazenar os dados do CRM que você carrega, o Audience Manager sempre armazena os dados. Na verdade, após os aprimoramentos Profile Merge Rules que o Audience Manager lançou em outubro de 2019 e permitem casos de uso somente offline, você pode fazer upload e executar ações em dados sem implantar o código Audience Manager na produção. Consulte:


 

<!

  • If the data provider is configured to use Profile Link for cross-device targeting, the data available for targeting shortly after an ID sync identifies to the matching Audience Manager visitor ID.

  • If the data provider is not configured to use the Profile Link feature, Audience Manager processes only the data for visitor IDs in the inbound data file that have been previously synced/matched back to an Audience Manager visitor ID.

Consider the following use cases in which the data provider is not configured to use Profile Merge:

Use Case Description

Case 1

On Monday, a visitor identified in the CRM database as visitor ABC logs in, which initiates a client-side ID sync. Audience Manager stores the mapping of visitor ABC to Audience Manager visitor 123.

On Tuesday, the CRM database transfers a data file ( .sync) to the Audience Manager server with the following record:

  • ABC "gender"="male","luxury_shopper"="yes"

In this case, Audience Manager:

  • Recognizes visitor ABC from the stored ID sync mapping.
  • Associates the traits male and luxury_shopper with the visitor 123 profile.

Case 2

On Monday, the CRM database pushes a data file ( .sync) to the Audience Manager server with the following record:

  • DEF "gender"="female","wine_enthusiast"="yes"

Audience Manager does not have a record of this visitor (or an associated visitor ID) so this record is not processed.

On Tuesday, visitor DEF logs in. This action initiates the first client-side ID sync for that visitor. This action maps visitor DEF to Audience Manager ID 456. However, this visitor does not have CRM data associated with their profile. As a result, Audience Manager does not go back and reprocess old files.

On Wednesday, the CRM database pushes another data file to the Audience Manager server with the following record:

  • DEF "gender"="female","wine_enthusiast"="yes","dma"="paris"

In this case, Audience Manager:

  • Recognizes visitor DEF from the stored ID sync mapping.
  • Associates the traits female, paris, and wine_enthusiast with the visitor 456 profile.

Case 3

On Monday, the Audience Manager server receives two files with the following records:

.sync file containing:

  • GHI 123456789

.overwrite file containing:

  • GHI "gender"="male" "wine_enthusiast"="no"
  • JKL "gender"="female" "wine_enthusiast"="yes"

Audience Manager holds a mapped record of visitor JKL to ID 789, from a previous ID sync.

In this case, Audience Manager:

  • Recognizes visitor JKL from the stored ID sync mapping.
  • Associates the traits female and wine_enthusiast with visitor ID 789's profile.
  • Ignores the trait association for visitor GHI, since its ID was only synced in the current batch. To associate traits with visitor GHI, you need to include them in future .overwrite files.

–>

A que horas do dia devo transferir o arquivo?

O Audience Manager verifica e processa arquivos várias vezes ao longo do dia. Faça upload dos dados sempre que estiver pronto.

Quanto tempo leva até que os dados de um arquivo carregado estejam disponíveis para direcionamento?

Os dados estão disponíveis para direcionamento após 48 horas. Além disso, não interprete o email de "carregamento bem-sucedido" como uma declaração de que os dados estão disponíveis. Isso significa apenas que o Audience Manager selecionou o arquivo e concluiu a primeira etapa do processamento.

Com que frequência devo enviar arquivos? Esses arquivos devem ser completos ou incrementais?

Como prática recomendada, envie um arquivo incremental uma vez por dia para novos visitantes e para visitantes cujos dados foram alterados. Muitos clientes do Audience Manager enviam um arquivo completo uma vez por mês. No entanto, esses intervalos de arquivos e incrementos são flexíveis. Você deve enviar dados em incrementos e quando fizer sentido para você.

Por quanto tempo o Audience Manager mantém os arquivos no servidor?

Os arquivos FTP são removidos após serem processados. Os arquivos S3 são removidos após 30 dias. Os arquivos que não podem ser processados devido a erros de formato, sintaxe ou outros erros são removidos. Consulte também Perguntas frequentes sobre privacidade e retenção de dados.

Qual é a diferença entre arquivos completos e incrementais?

  • Total: um arquivo completo substitui todos os perfis de visitante existentes e os substitui pelos dados do arquivo. Os arquivos completos são identificados pela tag .overwrite anexada ao nome do arquivo. Você pode usar um arquivo .overwrite para redefinir características do visitante ou remover características obsoletas.

    OBSERVAÇÃO

    Os arquivos .overwrite substituem apenas os dados do perfil do Audience Manager associados a esse provedor de dados. Em outras palavras, todos os dados do Audience Manager associados ao visitante permanecem intactos depois que um arquivo .overwrite é processado.

  • Incremental: um arquivo incremental anexa novos dados aos perfis de visitantes existentes. Os arquivos incrementais são identificados pela tag .sync anexada ao nome do arquivo. Enviar um arquivo incremental não apaga nem substitui perfis existentes.

Os casos de uso a seguir demonstram como esses tipos de arquivos afetam os perfis de visitante armazenados.

Caso de uso Descrição
Incremental e completo
  • Conteúdo do arquivo .sync do dia 1: visitor123 = a,b,c
  • Conteúdo do arquivo .overwrite do dia 2: visitor123 = c,d,e
  • Conteúdo da ID de perfil do visitante 123 do dia 3: c,d,e
Apenas incremental
  • Conteúdo do arquivo .sync do dia 1: visitor123 = a,b,c
  • Conteúdo do arquivo .sync do dia 2: visitor123 = c,d,e
  • Conteúdo da ID de perfil do visitante 123 do dia 3: a,b,c,d,e

Para obter mais informações sobre tipos de arquivos completos e incrementais, consulte:

O que acontece se eu enviar um arquivo com IDs para visitantes que nunca executaram a sincronização de ID na página?

Durante o processamento, o Audience Manager ignora esse registro e avança para o seguinte. Se uma DPID (ID do provedor de dados) estiver configurada como uma DPID entre dispositivos, os dados assimilados antes de uma sincronização de ID serão salvos e estarão disponíveis para uso logo após a sincronização de ID.

Para que serve o carimbo de data e hora? Você pode dar um exemplo?

Os carimbos de data e hora são usados para fazer registros e mantê-los. Eles são exigidos pela sintaxe usada para um nome de arquivo de entrada corretamente formatado. Consulte:

O que é um Data Provider ID (DPID) e como o obtenho?

O consultor da Adobe atribuirá uma DPID (ID do provedor de dados) de três ou quatro dígitos à sua fonte de dados específica. Essa ID é exclusiva e não é alterada.

Que tamanho podem ter os arquivos de dados diários?

Consulte Compactação de arquivos de transferência de dados de entrada.

O Audience Manager oferece suporte à compactação de arquivos?

Sim, consulte:

A chave primária no meu banco de dados de fonte de dados é um endereço de email. Ele é considerado informação pessoal?

Sim. O Audience Manager não armazena endereços de email no banco de dados. Os visitantes devem receber uma ID gerada aleatoriamente ou uma versão com hash unidirecional do endereço de email antes de iniciar sincronizações de ID.

O conteúdo do arquivo de dados faz distinção entre maiúsculas e minúsculas? E a sincronização de ID?

Há dois componentes básicos de um arquivo de dados: Uma User ID (consulte User ID em Variáveis de arquivo definidas) e dados de perfil, geralmente na forma de pares de valores-chave ou códigos. O User ID diferencia maiúsculas e minúsculas. Geralmente, os dados de perfil ou valor-chave não fazem distinção entre maiúsculas e minúsculas.

Devo usar o FTP ou o Amazon S3 para transferir arquivos?

Como prática recomendada, recomendamos o Amazon S3 porque o processo é mais simples. O Audience Manager transfere arquivos FTP para o S3 independentemente, de modo que o processo é mais simples se você soltar os arquivos no próprio Amazon S3. Além disso, os clientes que fazem upload simultaneamente para FTP compartilham a largura de banda do FTP, portanto as velocidades de upload são mais lentas. O Amazon S3 também é replicado e distribuído, portanto, geralmente é mais seguro e confiável do que um servidor FTP. Para obter mais informações, consulte Sobre o Amazon S3.

AVISO

Estamos removendo gradualmente o suporte para configurações FTP. Embora a ingestão de arquivos de dados de entrada ainda seja suportada em integrações FTP existentes, recomendamos usar Amazon S3 para dados offline integrados para novas integrações. Consulte Requisitos de nome e tamanho de arquivo do Amazon S3 para arquivos de dados de entrada para obter detalhes.

Como o Audience Manager processa arquivos de entrada?

O Audience Manager usa o Amazon Simple Queue Service (SQS) para processar dados de entrada. Veja como isso funciona:

  1. Os clientes do Audience Manager fazem o upload de dados de entrada em um bucket do Amazon S3.
  2. Os dados entram na fila do Amazon SQS, aguardando para serem processados pelo Audience Manager.
  3. O Audience Manager lê até 119.000 entradas da fila do Amazon SQS e as divide em até 3 lotes. Os arquivos em cada lote são processados simultaneamente.

Preciso carregar vários arquivos ao mesmo tempo… Os arquivos serão processados simultaneamente?

Depende. O Audience Manager lê até 119.000 entradas da fila do Amazon SQS e as divide em até 3 lotes. Os arquivos serão processados simultaneamente somente se eles terminarem no mesmo lote. No entanto, devido à grande quantidade de dados assimilados pelo Audience Manager diariamente, não podemos garantir nenhuma ordem de processamento de arquivos.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now