Como usar a caixa de depósito de feed genérico

A caixa de depósito de feed genérico permite que vários tipos de feed sejam enviados para um uma única caixa de depósito por ambiente. Neste guia, vamos mostrar como usar Caixa de depósito genérica e forneça links para o guia apropriado das respectivas que você planeja usar.

A caixa de depósito genérica depende de dois uploads separados:

1. Arquivo descritor: descreve o tipo de feed que você receberá fazendo upload
2. Arquivos de feed: o conteúdo do feed real.

Como estruturar o campo do descritor

O arquivo descritor é enviado para informar ao nosso sistema qual tipo de feed você estão sendo enviados. Isso nos permite validar e processar o feed corretamente. A deve ser enviado antes do conteúdo do feed e seguir estes requisitos de nomenclatura:

• Usar a extensão de arquivo .filesetdesc.json
• Cada nome de arquivo de descritor precisa ser exclusivo e não pode ser reutilizado em uploads. Qa recomendamos incluir o carimbo de data/hora da geração no nome do arquivo.
  • Exemplo: offer_1524606581.filesetdesc.json

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

Os valores possíveis para o campo name incluem:

Um exemplo de arquivo descritor JSON para um feed de ofertas com dois fragmentos é disponíveis abaixo:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

Estruturar o conteúdo do feed

Depois de fazer upload do arquivo descritor, você vai fazer o upload de todos os arquivos de feed para o tipo de dados do feed correspondente ao arquivo de configuração do feed nomeado por seu arquivo descritor. Os nomes de arquivos e locais dos caminhos (relativos dentro caixa de depósito) deve corresponder exatamente ao que foi incluído no data_file. Se algum arquivo estiver ausente, nomeado incorretamente ou for enviado para um local diferente, todo o feed será processados.

O conteúdo desses arquivos de dados de feed deve estar em conformidade com as especificações relevantes de o feed que foi especificado no arquivo descritor.

Cada arquivo de feed precisa ser exclusivo e não pode ser reutilizado em uploads. Recomendamos incluindo o carimbo de data/hora da geração e o número do fragmento (ID incremental) no nome do arquivo.

• Exemplo: offer_1524606581_1.json

Tamanhos dos arquivos do feed e frequência de uploads

• O arquivo de feed precisa ter menos de 200 MB (após a compactação).
• A maioria das integrações só precisará usar um único fragmento. Você deve usar como o máximo possível de fragmentos. Há um máximo de 1.000 fragmentos por feed.
• Os registros individuais enviados em um fragmento não precisam ser enviados no mesmo em feeds futuros.
• Para um melhor desempenho, divida os dados uniformemente entre os fragmentos, para tornar os arquivos de fragmento com tamanhos semelhantes.
• Se necessário, use o gzip para compactar os feeds. No entanto, faça isso para cada um fragmento de feed individual.

Solução de problemas e depuração

Após fazer o upload dos seus arquivos (descritores e de feed), vá para a Painel de histórico de feeds (documentação) no Portal de parceiros (navegue até Histórico > Feeds) para acompanhar o progresso do processamento do seu feed.

Procure o name que você inseriu no arquivo descritor em "Nome do feed". para encontrar seu feed.

Depois que o feed for processado (status Success ou Fail), clique em sua linha para ver os detalhes dos erros e avisos.