FTPRequisitos de nome e tamanho de arquivo para arquivos de dados de entrada ftp-name-and-file-size-requirements-for-inbound-data-files
Descreve os campos, a sintaxe, as convenções de nomenclatura e os tamanhos de arquivo necessários 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 Audience Manager FTP diretório.
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 file-name-syntax
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.
Nomear elementos
A tabela define os elementos em um FTP nome do arquivo.
ftp_dpm_
DPID
Uma ID que diz Audience Manager se um arquivo de dados contiver 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): Este é um identificador exclusivo que o Audience Manager atribui a uma fonte de dados (consulte o Audience Manager índice de IDs). Use essa ID atribuída em um nome de arquivo ao enviar dados que contêm 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. - IDs do Android (GAID): Use a ID 20914 em um nome de arquivo de dados se ele contiver IDs do Android. Você precisa usar o campo
_DPID_TARGET_DATA_OWNER
quando você usa 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 do Android e as IDs devem se qualificar para as características pertencentes ao_DPID_TARGET_DATA_OWNER
fonte de dados. - IDs da iOS (IDFA): Use a ID 20915 em um nome de arquivo de dados se ele contiver iOS IDs. Você precisa usar o campo
_DPID_TARGET_DATA_OWNER
quando você usa iOS IDs. 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 as IDs devem se qualificar para as características pertencentes ao_DPID_TARGET_DATA_OWNER
fonte de dados. - IDs pertencentes a outras fontes de dados globais: é possível 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 na seção artigo de 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 Android, não coloque iOS IDs 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, iOS ID ou outra ID pertencente às fontes de dados globais. Isso permite Audience Manager vincule os dados do arquivo à sua organização.
Esta fonte de dados de destino precisa ser de propriedade de sua empresa. Para fins de compartilhamento de dados de terceiros, para assimilar dados em uma fonte de dados de destino pertencente a outra empresa, é necessário ter um mapeamento de acesso entre sua empresa e a fonte de dados de destino. Entre em contato com seu consultor do Adobe ou com o Suporte ao cliente para configurar o mapeamento.
Observação importante: Você não É necessário solicitar um mapeamento para os relacionamentos de compartilhamento de dados existentes (para fontes de dados de destino pertencentes a outras empresas nas quais você integrou dados antes de 14 de março de 2022). O mapeamento também não é necessário ao integrar dados em fontes de dados de destino que pertencem ao seu PID.
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.- IDs do Android (GAID):
...ftp_dpm_20914_21_1234567890.sync
informa Audience Manager que o arquivo de dados contém apenas IDs do Android e as IDs devem se qualificar para as características pertencentes à fonte de dados 21. - IDs da iOS (IDFA):
...ftp_dpm_20915_21_1234567890.sync
informa Audience Manager que o arquivo de dados contém apenas IDs do iOS 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 Audience Manager que o arquivo de dados contém somente IDs Roku e 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 na seção 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 somente os usuários que deseja alterar. As características que não forem 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 os tempos de processamento. O número indica em qual parte do arquivo original você está enviando.
Para um processamento de arquivos eficiente, divida os arquivos de dados conforme indicado:
- Não compactado: 1 GB
- Compactado: 200 a 300 MB
Veja os primeiros 2 exemplos de nome de arquivo abaixo.
TIMESTAMP
[.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, 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 file-name-examples
Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Os nomes dos arquivos podem ser semelhantes.
ftp_dpm_478_1366545717.sync.1.gz
ftp_dpm_478_1366545717.sync.2.gz
ftp_dpm_478_1366545717.overwrite
Baixar o arquivo de amostra se precisar de exemplos adicionais. Esse arquivo é salvo com o .overwrite
extensão de arquivo. Abra-o com um editor de texto simples.
Tamanhos de arquivo aceitos accepted-file-sizes
Considere os números abaixo para o processamento mais rápido/antecipado de seus arquivos, bem como para as limitações de tamanho de arquivo ao enviar dados para um Audience Manager / FTP diretório.