Feed di contenuti

Un feed di contenuti è un file che contiene il  catalogo dei contenuti del tuo sito multimediale (tutti i tuoi articoli, con i relativi metadati). Offre consigli sui contenuti, servizi di targeting comportamentale in base alle proprietà degli articoli e molto altro ancora.

Puoi avere un solo feed di contenuti per ogni sito multimediale Dynamic Yield. Usa i seguenti passaggi per creare, caricare e sincronizzare un feed di contenuti su Dynamic Yield. 

Creazione di un file di feed di contenuti

Prima di caricare e sincronizzare un feed di contenuti con Dynamic Yield, devi assicurarti che il file del feed sia conforme ai requisiti di dimensione, formato e contenuto.

I feed di contenuto possono essere in formato CSV, JSON o XML. Tuttavia, se il feed contiene più di 200.000 articoli devono essere in formato CSV. Può essere memorizzato in qualsiasi URL o cartella locale.

Struttura del feed di contenuti

Il feed di contenuti deve includere le informazioni di base sugli articoli (ID, titolo, URL, ora di pubblicazione, tipo di post e relative categorie). Nella tabella seguente è riportato l'elenco degli attributi obbligatori con le relative istruzioni dettagliate (formato, limitazioni e così via):

Colonne personalizzate

Puoi anche aggiungere al feed altre colonne, fino a 30 in più, per descrivere i tuoi articoli. Queste potranno essere utilizzate in seguito per il targeting (ad esempio, se aggiungi la colonna "soggetto", puoi usarla per indirizzare gli utenti che amano leggere su un argomento particolare, come la pallacanestro), il punteggio di affinità (ad esempio, puoi includere l'affinità del soggetto nell'algoritmo di raccomandazione dell'affinità) o l'impostazione di valori diversi per diverse lingue (ad esempio, puoi mostrare un nome tradotto per i clienti che visitano il sito dalla Francia).

Linee guida:

• I valori delle proprietà personalizzate devono essere stringhe, fino a 1.000 caratteri, senza caratteri speciali.
• I nomi delle colonne personalizzate non possono iniziare con '_id'
.
• Non puoi avere una colonna personalizzata denominata 'sku'. Se includi una colonna con questo nome, il feed viene considerato non valido.
• Dopo aver aggiunto una colonna, non la potrai rimuovere. Puoi smettere di o restituire valori vuoti, ma la colonna andrà inclusa in qualsiasi sincronizzazione futura. 

Supporto multilingue

For technical details, see Multi-language Support nella nostra Documentazione per sviluppatori.

Per supportare più lingue, puoi specificare valori diversi per diverse lingue per qualsiasi campo. Usa il formato “lng:<codice lingua>:<nome colonna>”: “<valore>”. Per esempio, se desideri avere una traduzione per il nome di un prodotto, devi creare due righe per il prodotto, come segue:

"lng:en_EN:nome":"Pantaloni bianchi"
"lng:de_DE:nome":"weiße Hosen"

Il codice della lingua deve corrispondere al nome utilizzato nel contesto della pagina. Per ulteriori informazioni, consulta il Contesto della pagina. Il codice della lingua può avere fino a due simboli (_) o (-) tra i valori. Per esempio: "lng:en_EN_X".

Poiché queste colonne sono facoltative, i valori vuoti non generano errori o avvisi.

Se lavori con più lingue, puoi creare un totale di 300 colonne (incluse tutte le colonne obbligatorie, personalizzate e tradotte).

Per capire come indirizzare le campagne in base alle impostazioni locali di un utente (utilizzando l'attributo "lng"), consulta l'articolo Supporto multilingue .

Sincronizzazione di un feed di contenuti 

1. Se il file del feed contiene più di 20.000 articoli, contatta il tuo Customer Success Manager per abilitare il caricamento del feed.
2. Vai a Risorse/strong › Feed di dati. Tieni presente che puoi creare un solo feed di contenuti per ogni account.
3. Se non disponi di feed di dati, inizia da qui e fai clic su Nuovo feed:
   
   Quindi seleziona Feed di contenuti:
   
   Se disponi già di altri feed, nella pagina Feed di dati, fai clic su Crea nuovo, quindi seleziona Feed di contenuti dal menu a discesa.
4. Specifica il nome del feed e aggiungi note o etichette, se lo desideri.
5. Specifica la fonte del feed caricando il file del feed o specificando un collegamento URL che punta alla posizione in cui è archiviato il file. Se utilizzi l'autenticazione HTTP, aggiungi il nome utente e la password all'URL del feed, come segue http://user:password@url.

   Puoi combinare più file o fonti in un unico feed. Fai clic su Aggiungi un'altra fonte per specificare più di un file. 

   

   Puoi usare una funzione parser per controllare come vengono uniti i due file di feed, come mostrato nell'esempio seguente:

   analisi della funzione(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     restituisce combinedFeeds;
   }

6. Puoi specificare la frequenza con cui il file viene sincronizzato con Dynamic Yield espandendo le  Impostazioni avanzate. Più grande è il feed, meno frequentemente ti è consentito sincronizzarlo.    
   
   In alternativa , puoi utilizzare un'API per aggiornare il feed su richiesta. Questa opzione ti consente aggiungere, eliminare o modificare intere righe o valori nel tuo feed di dati e sincronizzarlo più velocemente con Dynamic Yield. Tuttavia, questo metodo richiede una configurazione avanzata e un supporto tecnico. Per maggiori informazioni, contatta il tuo Customer Success Manager.

7. Modifica del file di feed utilizzando una funzione parser

   Se le colonne e i valori nel tuo file feed non dovessero soddisfare i requisiti sopra indicati, oppure è necessaria qualche altra modifica per duplicarli, spostarli o rinomarne valori e campi, puoi modificare il feed utilizzando una funzione parser creata in JavaScript. Le funzioni parser sono supportate solo per feed di dati fino a 200.000 articoli.

   Le funzioni parser sono necessarie per i feed XML in modo da poter convertire i feed in un array all'interno di un JSON.
   
   Per aggiungere una funzione parser, vai su Impostazioni avanzate › Funzione parser e inserisci il tuo codice.

   Esempio: analisi di un feed XML 

   Le funzioni parser sono necessarie per i feed XML in modo da poter convertire i feed in un array all'interno di un JSON.

   function parser(data){
    var products = data.items[0].item;
    return products.map(function(item){
    var newFeedRow = {};
    for(var column in item){
    newFeedRow[column] = item[column][0];
    }
    return newFeedRow;
    });
   }

   Esempio: combinazione di due feed

   Puoi utilizzare una funzione parser per combinare due feed di prodotto in un unico feed.

   function parse(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     return combinedFeeds;
   }

8. Puoi visualizzare un'anteprima di un massimo di 100 voci del tuo feed, inclusi eventuali errori o avvisi facendo clic su Anteprima. Fai clic su Salva e attiva per procedere oppure su Annulla per tornare indietro. 
   
   
9. La durata del processo di sincronizzazione dipende dal numero di articoli presenti nel tuo feed. La sincronizzazione richiede in genere solo pochi minuti se hai meno di 250.000 articoli nel feed.  Man mano che i feed diventano più grandi, in genere la sincronizzazione richiede circa 30 minuti per ogni 500.000 articoli nel tuo feed. Se il tempo di sincronizzazione è un problema, contatta il tuo Customer Success Manager per scoprire come utilizzare un'API per aggiornare, invece, il feed su richiesta al posto delle sincronizzazioni periodiche.

Convalida dello stato di sincronizzazione

Puoi verificare che il feed si stia sincronizzando correttamente in qualsiasi momento:  

1. Vai a Risorse › Feed di dati.
2. Nella colonna Ultimo tentativo di sincronizzazione , dovresti vedere l'icona Feed di dati sincronizzato  e una data recente. Se l'icona dovesse indicare un errore o un avviso, puoi scaricare il registro per maggiori dettagli.
3. Nella colonna  Azioni , fai clic sull'icona Visualizza . Verifica che tutte le colonne obbligatorie e tutte le colonne personalizzate che hai aggiunto esistano e contengano i dati corretti.