La casella personale del feed generico consente di caricare più tipi di feed in una singola casella personale per ambiente. Questa guida illustra come utilizzare la casella personale Generica e fornisce i link alla guida appropriata per il rispettivo feed che intendi utilizzare.
(Consulta la sezione Esportazione dei feed (end-to-end) o Feed (guida iniziale) della documentazione.La casella personale Generico si basa sulla presenza di due caricamenti separati:
- File descrittore: descrive il tipo di feed che caricherai
- File del feed: i contenuti del feed effettivo.
Strutturare il campo del descrittore
Il file descrittore viene caricato per informare il nostro sistema sul 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 questi requisiti di denominazione:
- Utilizzare l'estensione del file .filesetdesc.json
- Ogni nome file descrittore deve essere univoco e non può essere riutilizzato in più caricamenti. Ti consigliamo di includere il timestamp di generazione nel nome del file.
- Esempio: offers_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;
}
I valori possibili per il campo name includono:
Di seguito è disponibile un file descrittore JSON di esempio per un feed di offerte con due shard:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
Strutturazione dei contenuti del feed
Dopo aver caricato il file descrittore, dovrai caricare tutti i file del feed per il tipo di dati del feed corrispondente al file di configurazione del feed denominato dal file descrittore. I nomi dei file e le posizioni del percorso (relativi all'interno della casella personale) devono corrispondere esattamente a quanto incluso nel campo data_file. Se un file non è presente, ha un nome errato o è caricato in un'altra posizione, l'intero feed non verrà elaborato.
I contenuti di questi file di dati del feed devono essere conformi alle specifiche pertinenti del feed specificate nel file descrittore.
Ogni nome file del feed deve essere univoco e non può essere riutilizzato per più 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).
- La maggior parte delle integrazioni dovrà utilizzare un solo shard. Dovresti utilizzare il minor numero di shard possibile. Esiste un massimo di 1000 shard per feed.
- I singoli record inviati in uno shard non devono essere inviati nello stesso numero di shard nei feed futuri.
- Per migliorare le prestazioni, suddividi i dati in modo uniforme tra gli shard in modo da rendere tutti i file simili di dimensioni simili.
- Se necessario, utilizza gzip per comprimere i feed. Tuttavia, ripeti l'operazione per ogni singolo shard del feed.
Risoluzione dei problemi e debug
Dopo aver caricato i file (descrittori e file del feed), accedi alla dashboard della cronologia dei feed (documentazione) sul Portale partner (vai a Cronologia > Feed) per seguire l'avanzamento dell'importazione del feed.
Per trovare il feed, cerca il name che hai inserito nel file descrittore nella colonna "Nome feed".
Dopo aver importato il feed (lo stato è Success o Fail), puoi fare clic sulla relativa riga per visualizzare i dettagli degli errori e degli avvisi.