Utilizzare la casella personale del feed generico

La casella personale del feed generico consente di caricare più tipi di feed in un un'unica casella personale per ambiente. In questa guida viene illustrato come utilizzare casella personale generica e fornire link alla guida appropriata per il rispettivo che intendi utilizzare.

di Gemini Advanced.

La casella personale generica si basa su due caricamenti separati:

  1. File descrittore: descrive il tipo di feed che utilizzerai caricamento in corso
  2. File del feed: i contenuti del feed effettivo.
di Gemini Advanced.

Strutturazione del campo Descriptor

Il file del descrittore viene caricato per informare il nostro sistema del tipo di feed che desideri in fase di caricamento. In questo modo possiamo convalidare ed elaborare correttamente il feed. La descrittore deve essere caricato prima dei contenuti del feed e deve rispettare le questi requisiti di denominazione:

  • Utilizza l'estensione del file .filesetdesc.json
  • Ogni nome file descrittore deve essere univoco e non può essere riutilizzato in più caricamenti. Me 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:

  • reservewithgoogle.conversion_data

Un esempio di file descrittore JSON per un feed di offerte con due shard è disponibili di seguito:

{
  "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 del descrittore, caricherai tutti i file del feed per il tipo di dati del feed corrispondente al file di configurazione del feed denominato il tuo file descrittore. I nomi dei file e le posizioni dei percorsi (relativi all'interno dei Dropbox) deve corrispondere esattamente a quanto incluso nel campo data_file. Se manca un file, se è stato denominato in modo errato o in un'altra località, l'intero feed non verrà elaborati.

I contenuti di questi file di dati del feed devono essere conformi alle specifiche pertinenti di specificato nel file descrittore.

Ogni nome file del feed deve essere univoco e non può essere riutilizzato in più caricamenti. I nostri suggerimenti inclusi il timestamp di generazione e il numero di shard (ID incrementale) nel nome del file.

  • 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 usare come il minor numero di shard possibile. È previsto un massimo di 1000 shard per feed.
  • Non è necessario inviare i singoli record inviati in uno shard nello stesso numero di shard nei feed futuri.
  • Per ottenere prestazioni migliori, suddividi i dati in modo uniforme tra gli shard, in modo da e dei file shard di dimensioni simili.
  • Se necessario, utilizza gzip per comprimere i feed. Tuttavia, devi farlo per ogni uno shard del feed.

Risoluzione dei problemi e debug

Dopo aver caricato i file (descrittori e file del feed), vai alla sezione Dashboard della cronologia del feed (documentazione) sul Portale partner (vai a Cronologia > Feed) per seguire l'avanzamento dell'importazione del feed.

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

Dopo aver importato il feed (lo stato è Success o Fail), puoi fare clic della riga corrispondente per vedere i dettagli degli errori e degli avvisi.