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 tamanhos dos arquivos de acordo com essas especificações quando enviar dados para um diretório Audience Manager / Amazon S3.
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.
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 só processa ASCII e UTF-8 codifica arquivos.
A tabela define os elementos em um nome de arquivo S3.
Elemento de nome | Descrição |
---|---|
|
O caminho e o nome do seu bucket do Amazon S3. Entre em contato com seu Gerente de contas para obter o nome, o caminho e as credenciais do diretório S3. |
|
Um carimbo de data e hora (com base no horário UTC) de quando você envia os arquivos para o bucket S3. |
|
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:
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. |
|
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:
|
|
O nome da empresa ou organização que você usa em 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 único. |
|
Opções de sincronização que incluem:
|
|
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:
Consulte os primeiros 2 exemplos de nome de arquivo abaixo. |
|
Ao enviar arquivos para o Amazon S3, use apenas a compactação gzip. Quando compactados, esses arquivos obtêm a extensão Os arquivos compactados devem ter 3 GB ou menos. Se seus 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. Seus nomes de arquivo 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] (assets/ftp_dpm_1234_1445374061.overwrite) o arquivo de amostra se quiser exemplos adicionais. Este arquivo foi salvo com a extensão de arquivo .overwrite
. Abra-o com um editor de texto simples.
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 / Amazon S3.
Tipo de arquivo | Tamanho ideal | Tamanho máximo |
---|---|---|
Compactado | 200 a 300 MB |
3 GB |
Descompactado | 1 GB |
5 GB |
O processo de validação de dados de entrada marcará os 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 102400 bytes. As linhas que excedem este limite são excluídas da transferência.