FTPRequisitos 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 os tamanhos dos arquivos de acordo com essas especificações ao enviar dados para um diretório Audience Manager FTP.

AVISO

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

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

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 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 FTP.

Elemento de nome de arquivo Descrição

ftp_dpm_

O caminho e o nome do diretório FTP Audience Manager. Entre em contato com seu Gerente de contas para obter o diretório FTP e as credenciais.

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.

(.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 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 do público alvo 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 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 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

[] (assets/ftp_dpm_1234_1445374061.overwrite) Baixe o arquivo de amostra se precisar de outros exemplos. Esse arquivo é salvo com a extensão .overwrite do arquivo. 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 / FTP.

Tipo de arquivo Tamanho ideal Tamanho máximo
Compactado

200 a 300 MB

3 GB

Descompactado

1 GB

5 GB

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