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

A caixa de depósito genérica de feeds permite que vários tipos de feed sejam enviados para uma 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.

Aviso:este guia não se aplica aos produtos para comerciantes, serviços, ou caixas de depósito de disponibilidade. Ela só se aplica à caixa de depósito genérica.

(Consulte a seção Exportar feeds (de ponta a ponta) ou Feeds (iniciante) da documentação.)

Observação: você precisa ter aprovação para cada tipo de feed que vai fazer upload. Se você enviar um tipo de feed que não foi aprovado para a integração, ele não será processado. Se você não tiver certeza de qual feed se aplicam à sua integração, entre em contato com a Central de ações contato

Aviso: talvez seja necessário redefinir a chave SSH para ativar os uploads na caixa de depósito de feeds genéricos. Para isso, consulte a Configuração do feed do Portal do Google Partners (documentação).

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.

Observação:se você fizer um upload para a caixa de depósito genérica e não encontrar nenhuma entrada correspondente no Portal de parceiros que pode significar que seu descritor arquivo não foi enviado ou o nome do arquivo está incorreto. Para receber ajuda para depurar esse problema, entre em contato com seu contato da Central de ações.

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. O arquivo de descritor precisa ser enviado antes do conteúdo do feed e seguir estes requisitos de nomenclatura:

• Você precisa usar a extensão de arquivo .filesetdesc.json para o arquivo de descritor.
• Cada nome de arquivo de descritor precisa ser exclusivo e não pode ser reutilizado em uploads. Recomendamos incluir o carimbo de data/hora de geração e o nome do feed no nome do arquivo.
  • Exemplo: offers_1524606581.filesetdesc.json
• Cada arquivo de descritor precisa listar todos os arquivos de dados no feed mais recente para o nome do feed relevante.

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:

• reservewithgoogle.entity
• reservewithgoogle.action.v2

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"
  ]
}

Como estruturar o conteúdo do feed

Depois de fazer o upload do arquivo descritor, você fará 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 nome de arquivo de feed precisa ser exclusivo e não pode ser reutilizado em outros uploads. Recomendamos incluir o carimbo de data/hora de geração e o número do fragmento (ID incremental) no nome do arquivo.

• Exemplo: offer_1524606581_1.json

Tamanhos de arquivo e frequência de upload do feed

• O arquivo do feed precisa ter até 200 MB (após a compactação).
• Cada arquivo de dados descompactado precisa ter menos de 2 GB.
• A maioria das integrações só precisa 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 melhorar o desempenho, divida os dados uniformemente entre os fragmentos para que todos os arquivos de fragmento tenham um tamanho semelhante.
• 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 (acesse Histórico > Feeds) para acompanhar o progresso do processamento do feed.

Procure o name que você inseriu no arquivo de descritor na coluna "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.