Amazon S3 requisitos de nome e tamanho de arquivo para arquivos de dados de entrada

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

OBSERVAÇÃO

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

Sintaxe de nome de arquivo

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

OBSERVAÇÃO

Audience Manager só processa ASCII e UTF-8 codifica arquivos.

Elementos de nome

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

Elemento de nome Descrição

AWS_directory

O caminho e o nome do seu bucket do Amazon S3. Entre em contato com seu Gerente de contas para obter o nome, o caminho e as credenciais do diretório 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 S3.

DPID

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

  • ID da fonte de dados (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 de Audience Manager de IDs ). Use essa ID atribuída em um nome de arquivo ao enviar dados que contenham 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.
  • IDs do Android (GAID): Use a ID 20914 em um nome de arquivo de dados se ela contiver IDs do Android. É necessário usar o campo _DPID_TARGET_DATA_OWNER ao usar IDs do Android. Por exemplo, ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync informa Audience Manager que o arquivo de dados contém somente IDs Android e que as IDs devem se qualificar para as características pertencentes à fonte de dados _DPID_TARGET_DATA_OWNER.
  • IDs do iOS (IDFA): use a ID 20915 em um nome de arquivo de dados se ela contiver IDs do iOS. É necessário usar o campo _DPID_TARGET_DATA_OWNER ao usar IDs do iOS. Por exemplo, ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync informa Audience Manager que o arquivo de dados contém somente IDs do iOS e que 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 inserir IDs Roku para publicidade (RIDA), IDs de publicidade da Microsoft (MAID) e outras IDs. Use a ID correspondente a cada fonte de dados, conforme descrito no artigo das 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 IDs do iOS ou suas próprias IDs no arquivo de dados.

_DPID_TARGET_DATA_OWNER

Esse campo informa ao Audience Manager a qual fonte de dados os dados integrados. Esse campo é obrigatório se você definir o DPID como uma ID do Android ou iOS ou outra ID pertencente a fontes de dados globais. Isso permite que Audience Manager vincule os dados do arquivo de volta à sua organização.

Por exemplo:

  • ...ftp_dpm_33_21_1234567890.sync informa à 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.
  • IDs do Android (GAID): ...ftp_dpm_20914_21_1234567890.sync diz ao Audiência Manager que o arquivo de dados contém somente IDs do Android e que as IDs devem se qualificar para as características pertencentes à fonte de dados 21.
  • IDs do iOS (IDFA): ...ftp_dpm_20915_21_1234567890.sync informa ao Audiência Manager que o arquivo de dados contém somente IDs do iOS e que 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 diz ao Audiência Manager que o arquivo de dados contém somente IDs Roku e que 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 das fontes de dados globais.

partner_name

O nome da empresa ou organização que você usa 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 único.

(.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 devem 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 você deseja alterar.

[SPLIT_NUMBER]

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

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

  • Descompactado: 1 GB
  • Compactado: 200 a 300 MB

Consulte os primeiros 2 exemplos de nome de arquivo abaixo.

[.gz]

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

Os arquivos compactados devem ter 3 GB ou menos. Se seus 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

Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Seus nomes de arquivo 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] (assets/ftp_dpm_1234_1445374061.overwrite) o arquivo de amostra se quiser exemplos adicionais. Este arquivo foi salvo com a extensão de arquivo .overwrite. Abra-o com um editor de texto simples.

Tamanhos de arquivo aceitos

Considere os números abaixo para o processamento mais rápido/rápido de seus arquivos, bem como para as 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

OBSERVAÇÃO

O processo de validação de dados de entrada marcará os arquivos vazios como inválidos e não os processará.

Limites de comprimento de linha

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

Nesta página