Show Menu
TÓPICOS×

Requisitos de nome e tamanho de arquivo do Amazon S3 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 o Audience Manager. Defina os nomes e os tamanhos dos arquivos de acordo com essas especificações ao enviar dados para um diretório / Audience Manager Amazon S3 .
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 do nome do arquivo

S3 os nomes de arquivo contêm os seguintes elementos obrigatórios e opcionais:
  • S3 prefixo: 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 Integrações personalizadas de parceiros personalizadas de parceiros.
Audience Manager só processa ASCII e UTF-8 codifica arquivos.

Elementos de nome

A tabela define os elementos em um nome de S3 arquivo.
Elemento de nome Descrição
AWS_diretory
O caminho e o nome do seu bucket Amazon S3. Entre em contato com seu Gerente de contas para obter o nome, o caminho e as credenciais do diretório S3.
date= aaaa-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
A ID do provedor de dados (DPID) é um identificador que informa ao Audience Manager se um arquivo de dados contém suas próprias IDs de usuário ou IDs do Android ou iOS. Aceita as seguintes opções:
ID do parceiro de dados
Esta é uma ID exclusiva que o Audience Manager atribui à sua empresa ou organização. 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 diz ao Audience Manager que um parceiro com ID 21 enviou o arquivo e contém IDs de usuário atribuídas por esse parceiro.
IDs do Android (GAID)
Use a ID 20914 como DPID em um nome de arquivo de dados se o arquivo contiver IDs do Android. Ao usar a ID 20914 como DPID, ainda é necessário identificar sua empresa para o Audience Manager . Isso significa que o nome do arquivo deve usar o parâmetro _DPID_TARGET_DATA_OWNER para manter a ID da empresa. Por exemplo, digamos que você esteja transmitindo arquivos com IDs do Android e sua ID do provedor de dados seja 21. Nesse caso, o nome do arquivo seria ...ftp_dpm_20914_21_123456789.sync . Isso informa ao Audience Manager que o arquivo contém IDs do Android e é de um parceiro identificado pela ID 21.
IDs do iOS (IDFA)
Use a ID 20915 como DPID em um nome de arquivo de dados se o arquivo contiver IDs do iOS. Ao usar a ID 20915 como DPID, ainda é necessário identificar sua empresa para o Audience Manager . Isso significa que o nome do arquivo deve usar o parâmetro _DPID_TARGET_DATA_OWNER para manter a ID da empresa. Por exemplo, digamos que você esteja transmitindo arquivos com IDs do Android e sua ID do provedor de dados seja 21. Nesse caso, o nome do arquivo seria ...ftp_dpm_20915_21_123456789.sync . Isso informa ao Audience Manager que o arquivo contém IDs do iOS e é de um parceiro identificado pela ID 21.
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.
Consulte também a entrada _DPID_TARGET_DATA_OWNER abaixo.
_DPID_TARGET_DATA_OWNER
Um espaço reservado para uma ID. Por exemplo, você pode defini-la como sua ID do Audience Manager se definir o DPID como uma ID de fonte de dados ou uma ID do Android ou iOS. Isso permite que o Audience Manager vincule os dados do arquivo de volta à sua organização.
Por exemplo:
  • ...ftp_dpm_33_21_1234567890.sync mostra que um parceiro com ID 21 enviou dados de uma fonte de dados que usa a ID 33.
  • ...ftp_dpm_20914_21_1234567890.sync mostra que um parceiro com ID 21 enviou dados que contêm IDs do Android.
  • ...ftp_dpm_20915_21_1234567890.sync mostra que um parceiro com ID 21 enviou dados que contêm IDs do iOS.
partner_name
O nome da empresa ou organização que você usa no Audience Manager .
CARIMBO DE DATA E HORA
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:
  • sincronização : Cenário normal quando provedores de dados de terceiros enviam características por usuário para serem adicionadas ou removidas no sistema do Audience Manager.
  • substituir : 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 Exemplos de nome de arquivo de nome de arquivo abaixo.
[.gz]
Ao enviar arquivos para o Amazon S3, use apenas a compactação gzip. Quando compactados, esses arquivos recebem 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 para 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>/<nome_do_parceiro>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
  • s3n://<AWS_Bucket>/<nome_do_parceiro>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
  • s3n://<AWS_Bucket>/<nome_parceiro>/date=2016-05-09/ftp_dpm_478_1366545717.sync
  • s3n://<AWS_Bucket>/<nome_do_parceiro>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
  • s3n://<AWS_Bucket>/<nome_parceiro>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Você pode baixar o arquivo de amostra se quiser exemplos adicionais. Este arquivo foi salvo com a extensão do .overwrite arquivo. Abra-o com um editor de texto simples.

Tamanhos de arquivo aceitos

Considere as figuras 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 Audience Manager / Amazon S3 diretório.
Tipo de arquivo Tamanho ideal Tamanho máximo
Compactado
200 a 300 MB
3 GB
Descompactado
1 GB
5 GB
O processo de validação de dados de entrada marcará arquivos vazios como inválidos e não os processará.