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 / Amazon S3 diretório.
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.
S3 os nomes de arquivo contêm os seguintes elementos obrigatórios e opcionais:
S3prefixo: 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 personalizadas de parceiros.
Audience Manager somente processos ASCII e UTF-8 arquivos codificados.
A tabela define os elementos em um S3 nome do arquivo.
Elemento do nome | Descrição |
---|---|
|
O caminho e o nome do seu bucket do Amazon S3. Entre em contato com o Gerente de conta para obter seu nome de diretório, caminho e credenciais do S3. |
|
Um carimbo de data e hora (com base no horário UTC) de quando você envia os arquivos para o bucket do S3. |
|
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:
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. |
|
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 que o Audience Manager vincule os dados do arquivo de volta à sua organização. 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:
|
|
O nome da empresa ou organização usado no Audience Manager. |
|
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. |
|
Opções de sincronização que incluem:
|
|
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:
Veja os primeiros 2 exemplos de nome de arquivo abaixo. |
|
Ao enviar arquivos para o Amazon S3, use somente a compactação gzip. Quando compactados, esses arquivos obtêm o 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. |
Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Os nomes dos arquivos podem ser semelhantes.
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Você pode baixar o arquivo de amostra se desejar exemplos adicionais. Este arquivo foi salvo com o .overwrite
extensão de arquivo. Abra-o com um editor de texto simples.
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 / Amazon S3 diretório.
Tipo de arquivo | Tamanho ideal | Tamanho máximo |
---|---|---|
Compactado | 200 a 300 MB |
3 GB |
Não compactado | 1 GB |
5 GB |
O processo de validação de dados de entrada marcará arquivos vazios como inválidos e não os processará.
Os arquivos de dados de entrada têm um limite de comprimento de linha de 102.400 bytes. As linhas que excedem esse limite são excluídas da transferência.