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 o Audience Manager. Defina os nomes e os tamanhos dos arquivos de acordo com essas especificações ao enviar dados para uma 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 do nome do 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 de nome | Descrição |
---|---|
|
O caminho e o nome do seu bucket do Amazon S3. Entre em contato com o Gerente de conta 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 seu bucket S3. |
|
Um ID que informa Audience Manager se um arquivo de dados contiver suas próprias IDs de usuário, Android IDs, iOS IDs ou outras IDs pertencentes a fontes de dados globais. Aceita as seguintes opções:
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 as 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 ou iOS ou outra ID pertencente a fontes de dados globais. Isso permite que o Audience Manager vincule os dados do arquivo à 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 do target 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 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 exclusivo. |
|
Opções de sincronização que incluem:
|
|
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:
Veja 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 variável 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. |
Os exemplos a seguir mostram nomes de arquivos formatados corretamente. Os 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 download o arquivo de amostra se desejar mais exemplos. Esse arquivo foi salvo com a variável .overwrite
extensão de arquivo. Abra-o com um editor de texto simples.
Considere as figuras abaixo para obter o processamento mais rápido/anterior de seus arquivos, bem como para as limitações de tamanho do arquivo ao enviar dados para um Audience Manager / Amazon S3 diretório.
Tipo de arquivo | Tamanho ideal | Tamanho máximo |
---|---|---|
Comprimido | 200-300 MB |
3 GB |
Descompactado | 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 102400 bytes. As linhas que excedem este limite são excluídas da transferência.