Show Menu
TÓPICOS×

Requisitos de nome e tamanho de arquivo FTP 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 tamanhos dos arquivos de acordo com essas especificações ao enviar dados para um FTP diretório do Audience Manager.
Estamos gradualmente removendo 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 o 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.
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

FTP os nomes de arquivo contêm os seguintes elementos obrigatórios e opcionais:
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 FTP arquivo.
Elemento de nome de arquivo Descrição
ftp_dpm_
O caminho e o nome do diretório FTP do Audience Manager . Entre em contato com seu Gerente de contas para obter o diretório FTP e as credenciais.
DPID
Uma ID 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 informa ao Audience Manager que um parceiro com ID 21 enviou o arquivo e ele contém IDs de usuário atribuídas por esse parceiro.
  • IDs do Android (GAID): Use a ID 20914 em um nome de arquivo de dados se ela contiver a ID do Android. Por exemplo, ...ftp_dpm_20914_123456789.sync informa ao Audience Manager que o arquivo de dados contém somente IDs Android.
  • IDs do iOS (IDFA): Use a ID 20915 em um nome de arquivo de dados se ela contiver IDs do iOS. Por exemplo, ...ftp_dpm_20915_123456789.sync informa ao Audience Manager que o arquivo de dados contém somente IDs do iOS.
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
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 a 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 a ID 21 enviou dados que contêm IDs do Android.
  • ...ftp_dpm_20915_21_1234567890.sync mostra que um parceiro com a ID 21 enviou dados que contêm IDs do iOS.
(.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 do Audience Manager.
  • overwrite : Permite que os clientes e provedores de dados enviem uma lista de características por usuário que devem substituir todas as características existentes desse usuário para uma determinada fonte 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. As características que não estão atribuídas à fonte de dados de destino não serão apagadas.
[ 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.
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.
[.gz]
Gzip é o formato de compactação permitido para um nome de arquivo FTP. Se você usar a compactação de arquivo, verifique se o nome do arquivo tem a extensão correta.
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 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.
  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite
Baixe o arquivo de amostra se precisar de outros exemplos. Esse arquivo é 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 / FTP diretório.
Tipo de arquivo Tamanho ideal Tamanho máximo
Compactado
200 a 300 MB
3 GB
Descompactado
1 GB
5 GB