Show Menu
TÓPICOS×

Métodos de entrega para arquivos de metadados

Envie ou atualize arquivos de metadados enviando-os para um diretório especial do Amazon S3 para sua conta do Audience Manager. Consulte esta seção para obter informações sobre caminhos de entrega/diretório, tempos de processamento de arquivos e atualizações.

Sintaxe do caminho de entrega e exemplos

Os dados são armazenados em namespace separado para cada cliente em um diretório Amazon S3. O caminho do arquivo segue a sintaxe mostrada abaixo. Note, italics indicates a variable placeholder. Colchetes [ ] indicam parâmetros opcionais. Os outros elementos são constantes e não são alterados.
Sintaxe:
.../log_ingestion/pid=ID

do

AAM/dpid= 

d_src

/[meta|status]/ 

aayymmdd

_ ID 

pai_ ID 

filho

A tabela a seguir define cada um desses elementos em um caminho de entrega de arquivo.
Parâmetro de arquivo Descrição
.../log_ingestão/
Este é o início do caminho de armazenamento do diretório. Você receberá o caminho completo quando tudo estiver configurado.
pid=ID AAM
Esse par de valores chave que contém a ID do cliente do Audience Manager .
dpid= d_src
Esse par de valor-chave contém a ID da fonte de dados transmitida em uma chamada de evento. A ID da fonte de dados é o valor que vincula todo o conteúdo do arquivo aos dados reais aos quais ele pertence.
Por exemplo, digamos que você tenha um anúncio com a ID 123 e o nome "Advertiser Creative A". Como uma chamada de evento só passa na ID, é necessário incluir "Advertiser Creative A" no arquivo de metadados. A campanha e o anúncio pertencem a uma fonte de dados. A ID da fonte de dados é o que os vincula e permite associar com precisão o conteúdo do arquivo a uma ID enviada em uma chamada de evento. Consulte Como as IDs de chamada de evento determinam nomes de arquivo, conteúdo e caminhos de entrega.
  • meta
  • status
  • meta é um diretório de upload/armazenamento de arquivos.
  • status é um caminho para um diretório que contém informações de sucesso ou falha sobre seus arquivos processados. Depois que o arquivo for processado, você verá um arquivo .info com o título do carimbo de data e hora aaaammdd . Os arquivos de status contêm dados em um objeto JSON. Consulte Atualizações de status para arquivos de metadados.
ID _ filho_ aaaammdd _ parent
Este é o nome do arquivo. Consulte Nomear convenções para arquivos de metadados.
Exemplo de caminhos de upload e status
Para carregar um arquivo de metadados ou verificar seu status , os caminhos de arquivo serão semelhantes aos seguintes:
  • Caminho de upload: /log_ingestion/pid=1234/dpid=567/meta/20150827_1_2
  • Caminho do status de processamento: /log_ingestion/pid=1234/dpid=567/status/20150827.info .

Tempos e atualizações de processamento de arquivo

Os arquivos de metadados são processados quatro vezes por dia, em intervalos regulares.
Para atualizar seus registros de metadados, basta enviar um arquivo que contenha novas informações. Não é necessário enviar atualizações completas sempre.