Requisitos de nome e tamanho de arquivo Amazon S3 para arquivos de dados de entrada amazon-s-name-and-file-size-requirements-for-inbound-data-files

Descreve os campos obrigatórios, a sintaxe, as convenções de nomenclatura e os tamanhos de arquivo que devem ser seguidos ao enviar dados para Audience Manager. Defina os nomes e tamanhos dos seus arquivos de acordo com essas especificações quando você enviar dados para um diretório Audience Manager / Amazon S3.

NOTE
Estilos de texto (monospaced text, itálico, colchetes [ ] ( ) etc.) neste documento indique elementos e opções de código. Consulte Convenções de estilo para código e elementos de texto para obter mais informações.

Sintaxe do nome do arquivo file-name-syntax

S3 nomes de arquivo contêm os seguintes elementos obrigatórios e opcionais:

  • S3prefixo: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

  • Elementos de nome de arquivo: ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

Para outros formatos de nome de arquivo aceitos, consulte Integrações personalizadas de parceiros.

NOTE
Audience Manager processa somente arquivos codificados de ASCII e UTF-8.

Nomear elementos

A tabela define os elementos em um nome de arquivo S3.

Elemento do nome
Descrição
AWS_directory
O caminho e o nome do seu bucket do Amazon S3. Entre em contato com o Gerente de conta para obter seu nome de diretório, caminho e credenciais do S3.
date=yyyy-mm-dd
Um carimbo de data e hora (com base no horário UTC) de quando você envia os arquivos para o bucket do S3.
DPID

Uma ID que informa ao Audience Manager se um arquivo de dados contém suas próprias IDs de usuário, Android IDs, iOS IDs ou outras IDs pertencentes a fontes de dados globais. Aceita as seguintes opções:

  • ID do Data Source (também conhecida como ID do Provedor de Dados): Essa é uma ID exclusiva que o Audience Manager atribui a uma fonte de dados (consulte o índice Audience Manager de IDs). Use essa ID atribuída em um nome de arquivo ao enviar dados que contêm suas próprias IDs de usuário. Por exemplo, ...ftp_dpm_21_123456789.sync instrui Audience Manager a integrar dados a IDs pertencentes à fonte de dados 21.
  • Android IDs (GAID): Use a ID 20914 em um nome de arquivo de dados se ele contiver Android IDs. Você precisa usar o campo _DPID_TARGET_DATA_OWNER ao usar Android IDs. Por exemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync diz a Audience Manager que o arquivo de dados contém somente IDs Android e as IDs devem se qualificar para as características pertencentes à fonte de dados _DPID_TARGET_DATA_OWNER.
  • iOS IDs (IDFA): Use a ID 20915 em um nome de arquivo de dados se ele contiver iOS IDs. Você precisa usar o campo _DPID_TARGET_DATA_OWNER ao usar iOS IDs. Por exemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync diz a Audience Manager que o arquivo de dados contém somente IDs iOS e as IDs devem se qualificar para as características pertencentes à fonte de dados _DPID_TARGET_DATA_OWNER.
  • IDs pertencentes a outras fontes de dados globais: você pode integrar IDs Roku para Advertising (RIDA), Microsoft Advertising IDs (MAID) e outras IDs. Use a ID correspondente a cada fonte de dados, conforme descrito no artigo de fontes de dados globais.

Observação: não misture tipos de ID em seus arquivos de dados. Por exemplo, se o nome do arquivo incluir o identificador do Android, não coloque iOS IDs ou suas próprias IDs no arquivo de dados.

_DPID_TARGET_DATA_OWNER

Este campo informa ao Audience Manager para qual fonte de dados integrar dados. Esse campo é obrigatório se você definir a DPID como uma Android ID, iOS ID ou outra ID pertencente às fontes de dados globais. Isso permite que o Audience Manager vincule os dados do arquivo de volta à sua organização.
Esta fonte de dados de destino precisa ser de propriedade de sua empresa. Para fins de compartilhamento de dados de terceiros, para assimilar dados em uma fonte de dados de destino pertencente a outra empresa, é necessário ter um mapeamento de acesso entre sua empresa e a fonte de dados de destino. Entre em contato com seu consultor do Adobe ou com o Suporte ao cliente para configurar o mapeamento.

Observação importante: você não precisa solicitar um mapeamento para os relacionamentos de compartilhamento de dados existentes (para fontes de dados de destino pertencentes a outras empresas nas quais você integrou dados antes de 14 de março de 2022). O mapeamento também não é necessário ao integrar dados em fontes de dados de destino que pertencem ao seu PID.

Por exemplo:

  • ...ftp_dpm_33_21_1234567890.sync informa ao Audience Manager que você está qualificando as IDs do cliente pertencentes à fonte de dados 33 para características ou sinais pertencentes à fonte de dados 21.
  • GAIDs (Android IDs): ...ftp_dpm_20914_21_1234567890.sync informa ao Audience Manager que o arquivo de dados contém apenas Android IDs e as IDs devem se qualificar para as características pertencentes à fonte de dados 21.
  • iOS IDs (IDFA): ...ftp_dpm_20915_21_1234567890.sync informa ao Audience Manager que o arquivo de dados contém apenas iOS IDs e as IDs devem se qualificar para as características pertencentes à fonte de dados 21.
  • IDs pertencentes a outras fontes de dados globais: ...ftp_dpm_121963_21_1234567890.sync informa ao Audience Manager que o arquivo de dados contém somente IDs Roku e as IDs devem se qualificar para as características pertencentes à fonte de dados 21. Use a ID correspondente a cada fonte de dados, conforme descrito no artigo de fontes de dados globais.

partner_name
O nome da empresa ou organização usado em Audience Manager.
TIMESTAMP
Um carimbo de data e hora UNIX UTC de 10 dígitos em segundos. O carimbo de data e hora ajuda a tornar cada nome de arquivo exclusivo.
(.sync|.overwrite)

Opções de sincronização que incluem:

  • sync: Cenário normal quando provedores de dados de terceiros enviam características por usuário para serem adicionadas ou removidas no sistema Audience Manager.
  • overwrite: Permite que os provedores de dados enviem uma lista de características por usuário que deve substituir todas as características de terceiros existentes para esse provedor de dados no Audience Manager. Não é necessário incluir todos os usuários em um arquivo de substituição. Inclua somente os usuários que deseja alterar.
[SPLIT_NUMBER]

Um inteiro. Usado ao dividir arquivos grandes em várias partes para melhorar os tempos de processamento. O número indica em qual parte do arquivo original você está enviando.

Para um processamento de arquivos eficiente, divida os arquivos de dados conforme indicado:

  • Não compactado: 1 GB
  • Compactado: 200 a 300 MB

Veja os primeiros 2 exemplos de nome de arquivo abaixo.

[.gz]

Ao enviar arquivos para o Amazon S3, use somente a compactação gzip. Quando compactados, esses arquivos obtêm a extensão .gz. Não use a compactação .zip.

Os arquivos compactados devem ter 3 GB ou menos. Se os arquivos forem maiores, entre em contato com o Atendimento ao cliente. Embora o Audience Manager possa lidar com arquivos grandes, talvez possamos ajudá-lo a reduzir o tamanho de seus arquivos e tornar as transferências de dados mais eficientes. Consulte Compactação de Arquivos de Transferência de Dados de Entrada.

Exemplos de nome de arquivo file-name-examples

Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Os nomes dos arquivos podem ser semelhantes.

  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite

Você pode baixar o arquivo de exemplo se desejar mais exemplos. Este arquivo foi salvo com a extensão de arquivo .overwrite. Abra-o com um editor de texto simples.

Tamanhos de arquivo aceitos accepted-file-sizes

Considere os números abaixo para o processamento mais rápido/antecipado de seus arquivos, bem como para limitações de tamanho de arquivo ao enviar dados para um diretório Audience Manager / Amazon S3.

Tipo de arquivo
Tamanho ideal
Tamanho máximo
Compactado
200 a 300 MB
3 GB
Descompactado
1 GB
5 GB
NOTE
O processo de validação de dados de entrada marcará arquivos vazios como inválidos e não os processará.

Limites de comprimento de linha line-limits

Os arquivos de dados de entrada têm um limite de comprimento de linha de 102.400 bytes. As linhas que excedem esse limite são excluídas da transferência.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695