Utilizzo del server SFTP generico

Il server SFTP del feed generico consente di caricare più tipi di feed su un singolo server SFTP per ambiente. Questa guida illustra come utilizzare il server SFTP generico e fornisce link alla guida appropriata per il rispettivo feed che intendi utilizzare.

Il server SFTP generico si basa su due caricamenti separati:

1. File descrittore: descrive il tipo di feed che caricherai
2. File del feed: i contenuti del feed effettivo

Strutturare il campo descrittore

Il file descrittore viene caricato per informare il nostro sistema del tipo di feed che stai caricando. In questo modo possiamo convalidare ed elaborare correttamente il feed. Il file descrittore deve essere caricato prima dei contenuti del feed e deve rispettare i seguenti requisiti di denominazione:

• Devi utilizzare l'estensione del file .filesetdesc.json per il file descrittore.
• Ogni nome file descrittore deve essere univoco e non può essere riutilizzato nei caricamenti. Ti consigliamo di includere nel nome file il timestamp di generazione e il nome del feed.
  • Esempio: offers_1524606581.filesetdesc.json
• Ogni file descrittore deve elencare tutti i file di dati nell'ultimo feed per il nome del feed pertinente.

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;
}

I valori possibili per il campo name includono:

Di seguito è riportato un esempio di file descrittore JSON per un feed di offerte con due shard:

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

Strutturare i contenuti del feed

Dopo aver caricato il file descrittore, caricherai tutti i file del feed per il tipo di dati del feed corrispondente al file di configurazione del feed denominato da il file descrittore. I nomi file e i percorsi (relativi all'interno del server SFTP) devono corrispondere esattamente a quelli inclusi nel data_file campo. Se manca un file, il nome non è corretto o è stato caricato in una posizione diversa, l'intero feed non verrà elaborato.

I contenuti di questi file di dati del feed devono essere conformi alla specifica pertinente di cui al feed specificato nel file descrittore.

Ogni nome file del feed deve essere univoco e non può essere riutilizzato nei caricamenti. Ti consigliamo di includere nel nome file il timestamp di generazione e il numero di shard (ID incrementale) .

• Esempio: offers_1524606581_1.json

Dimensioni dei file del feed e frequenza di caricamento

• Mantieni le dimensioni del file del feed al di sotto di 200 MB (dopo la compressione).
• Le dimensioni di ogni file di dati decompresso devono essere inferiori a 2 GB.
• La maggior parte delle integrazioni dovrà utilizzare un solo shard. Dovresti utilizzare il minor numero possibile di shard. È consentito un massimo di 1000 shard per feed.
• I singoli record inviati in uno shard non devono essere inviati con lo stesso numero di shard nei feed futuri.
• Per migliorare le prestazioni, distribuisci i dati in modo uniforme tra gli shard, in modo che le dimensioni di tutti i file degli shard siano simili.
• Se necessario, utilizza gzip per comprimere i feed. Tuttavia, esegui questa operazione per ogni shard del feed.

Risoluzione dei problemi e debug

Dopo aver caricato i file (descrittore e feed), vai al visualizzatore di importazione (documentazione) nel portale per i partner (vai a Importazione > Cronologia) per seguire l'avanzamento dell'importazione del feed.

Cerca il name che hai inserito nel file descrittore nella colonna "Nome feed" per trovare il feed.

Una volta importato il feed (lo stato è Success o Fail), puoi fare clic su la riga per visualizzare i dettagli degli errori e degli avvisi.