FTPRequisitos de nome e tamanho de arquivo para arquivos de dados de entrada

Descreve os campos, sintaxe, convenções de nomenclatura e tamanhos de arquivo necessários 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 removendo gradualmente o suporte para configurações FTP. Embora a assimilação do arquivo de dados de entrada ainda seja compatível 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 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

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.

Nomear elementos

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

Elemento do nome do arquivo Descrição

ftp_dpm_

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

DPID

Um ID 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 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 informa Audience Manager para integrar dados a IDs pertencentes à fonte de dados 21.
  • Android IDs (GAID): use a ID 20914 em um nome de arquivo de dados se ela contiver Android IDs. Você precisa usar o campo _DPID_TARGET_DATA_OWNER quando 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 IDs do Android somente e 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. Você precisa usar o campo _DPID_TARGET_DATA_OWNER quando 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 IDs do iOS somente 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 publicidade (RIDA), IDs de publicidade da Microsoft (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 nos 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

Este campo informa ao Audience Manager para qual fonte de dados integrar dados. Esse campo é obrigatório se você definir a 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 à organização.

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.
  • Android IDs (GAID): ...ftp_dpm_20914_21_1234567890.sync informa ao Audience Manager que o arquivo de dados contém Android IDs somente e 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 Audience Manager que o arquivo de dados contém IDs do iOS somente 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 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 de 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 clientes e provedores de dados enviem uma lista de características por usuário que deve 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 apenas 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 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 eficiente de arquivos, divida os arquivos de dados conforme indicado:

  • Descompactado: 1 GB
  • Compactado: 200-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 exclusivo.

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

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, podemos ajudá-lo a reduzir o tamanho dos 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. Os 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 mais exemplos. Esse arquivo é salvo com a extensão .overwrite do 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 do arquivo ao enviar dados para um diretório Audience Manager / FTP.

Tipo de arquivo Tamanho ideal Tamanho máximo
Comprimido

200-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
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now