Utilizzare i feed per importare le entità in Adobe Target Recommendations. Le entità possono essere inviate tramite file CSV, il formato feed di Google Product Search e le classificazioni di prodotto Adobe Analytics.
Panoramica sui feed concept_D1E9C7347C5D4583AA69B02E79607890
I feed consentono di trasmettere Entità o di aumentare i dati mbox con informazioni non disponibili nella pagina o per le quali l'invio diretto dalla pagina non è sicuro, ad esempio margine, costo del venduto e così via.
I feed consentono di passare informazioni dettagliate sull'elemento in Recommendations, ad esempio ID prodotto, categoria, nome, messaggio e altri attributi.
Dal file di classificazioni di prodotto Target o da quello di Google Product Search puoi selezionare le colonne che desideri inviare al server Recommendations.
Questi dati su ciascun elemento possono quindi essere utilizzati per:
Visualizza valori nelle progettazioni
Definire le regole di inclusione dei criteri
Ordinare gli elementi in diverse raccolte
Applicare esclusioni ai consigli
Le descrizioni degli elementi possono essere trasmesse in Target tramite feed o mbox. Se i dati vengono raccolti sia da un feed di entità sia da una mbox, viene data priorità ai dati più recenti. Solitamente i dati più recenti provengono da una mbox, in quanto questa viene visualizzata più spesso. Nel raro caso in cui i dati del feed di entità e i dati della mbox vengano inviati contemporaneamente, verranno utilizzati i secondi.
Nome: nome del feed specificato durante la creazione. Per modificare il nome di un feed, dovrai modificare il feed stesso. Quando salvi il feed con il nuovo nome, il feed viene aggiornato.
Pianificazione: visualizza la pianificazione di aggiornamento per il feed: Daily, Weekly, Every 2 Weeks o Never.
Elementi: visualizza il numero di elementi presenti nel feed.
Ultimo aggiornamento: visualizza la data e l’ora dell’ultimo aggiornamento del feed e il nome della persona che lo ha eseguito. Se il feed Last Updated riporta la dicitura "indefinito", il feed proviene da Recommendations Classic e non può essere modificato in Target Premium Recommendations.
Fai clic sull’icona Informazioni per visualizzare una scheda che mostra la data dell’ultimo caricamento e l’URL del feed.
Fare clic sull'icona con i puntini di sospensione per accedere alle azioni seguenti: Deactivate, Edit, Copy e Delete.
IMPORTANT
Le entità e gli attributi di entità caricati scadono dopo 61 giorni. Ciò significa che:
Il feed deve essere eseguito almeno una volta al mese per garantire che il contenuto del catalogo non scada.
La rimozione di un elemento dal file di feed non ne comporta la rimozione dal catalogo. Per rimuovere l'elemento dal catalogo, eliminarlo manualmente tramite l'interfaccia utente o l'API Target. In alternativa, modificare gli attributi dell'articolo (ad esempio l'inventario) per assicurarsi che l'articolo sia escluso dal corrispettivo.
Tipi di Source
Le entità possono essere inviate tramite file CSV, il formato feed di Google Product Search e le classificazioni di prodotto Adobe Analytics.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
È possibile creare un file .csv utilizzando il formato di caricamento CSV proprietario Adobe. Nel file sono contenute informazioni sulla visualizzazione degli attributi riservati e personalizzati per i prodotti. Per caricare attributi specifici nell’implementazione, sostituisci CustomN nella riga di intestazione con il nome dell’attributo che desideri utilizzare. Nell’esempio di seguito, entity.Custom1 è stato sostituito da: entity.availability. Successivamente, puoi utilizzare il metodo di caricamento collettivo per caricare il file nel server della funzionalità Recommendations.
L’utilizzo del formato .csv presenta i seguenti vantaggi rispetto al formato feed di Google:
Il formato .csv non richiede mappature di campi.
Il formato .csv supporta attributi con più valori (vedi l’esempio di seguito).
Il formato .csv supporta fino a 100 attributi personalizzati. Se ti servono più di 100 attributi personalizzati, puoi specificarne un altro set con un secondo file di feed.
Utilizza il metodo di caricamento in blocco per inviare informazioni di visualizzazione se non disponi di mbox sulla pagina o se desideri integrare le informazioni di visualizzazione con elementi non disponibili sul sito. Ad esempio, puoi inviare informazioni di inventario non pubblicate sul sito.
Qualsiasi dato caricato utilizzando il file .csv, il feed di prodotto Google o il feed di classificazione di prodotto Analytics sovrascrive il valore dell’attributo dell’entità esistente nel database. Se invii informazioni sul prezzo tramite richieste mbox e poi invii diversi valori prezzo nel file, questi valori sovrascrivono quelli impostati con la richiesta mbox. Fa eccezione l’attributo dell’entità categoryId dove i valori della categoria vengono aggiunti invece di essere sovrascritti fino al limite di 250 caratteri.
IMPORTANT
Non racchiudere i valori tra virgolette doppie (") nel file .csv, a meno che queste non siano intenzionali. Se racchiudi i valori tra virgolette doppie, devi racchiuderli in un altro insieme di virgolette doppie. In caso contrario, il feed dei consigli non verrà caricato correttamente.
Ad esempio, la sintassi seguente non è corretta:
"Apples "Bananas" Grapes"",
La sintassi corretta è:
"Apples ""Bananas"" Grapes""",
NOTE
Non è possibile sovrascrivere un valore esistente con un valore vuoto. Passa un altro valore al suo posto per sovrascriverlo. Nel caso di un prezzo di vendita, una soluzione comune è quella di passare un "NULL" effettivo o qualche altro messaggio. Puoi quindi scrivere una regola di modello per escludere gli elementi con tale valore.
Il prodotto è disponibile nell’interfaccia di amministrazione circa due ore dopo il corretto caricamento della relativa entità.
Di seguito è riportato un codice di esempio per un file .csv:
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
Google section_8EFA98B5BC064140B3F74534AA93AFFF
Il tipo di feed di Google Product Search utilizza il formato di Google. Diverso dal formato di caricamento CSV proprietario Adobe.
Se disponi di un feed di prodotto Google, puoi utilizzarlo come file di importazione.
NOTE
Non è necessario utilizzare i dati di Google. Recommendations utilizza lo stesso formato di Google. Puoi utilizzare questo metodo per caricare qualsiasi dato a tua disposizione e utilizzare le funzioni di pianificazione disponibili. Tuttavia, quando imposti il file dovrai mantenere i nomi degli attributi predefiniti di Google.
La maggior parte dei retailer carica i prodotti in Google, quindi quando un visitatore utilizza la funzione di ricerca dei prodotti di Google, i suoi prodotti vengono visualizzati. Recommendations segue esattamente le specifiche di Google per i feed di entità. I feed di entità possono essere inviati a Recommendations tramite .xml, .txt o .tsv e possono utilizzare gli attributi definiti da Google. È possibile cercare i risultati nelle pagine di Google Shopping.
NOTE
È necessario consentire il metodo POST sul server che ospita il contenuto del feed di Google.
Poiché Recommendations utenti configurano già feed .xml o .txt da inviare a Google tramite URL o FTP, i feed di entità accettano tali dati di prodotto e li utilizzano per creare il catalogo dei consigli. Specifica la posizione di tale feed per fare in modo che il server dei consigli recuperi i dati.
Se utilizzi Google Product Search per il caricamento del feed di entità, è comunque necessario disporre di una mbox per pagina di prodotto nella pagina se desideri mostrare i consigli o tenere traccia delle visualizzazioni di prodotto per la distribuzione dell’algoritmo in base alle visualizzazioni.
I feed di Google non supportano valori multipli per un attributo personalizzato.
Il feed viene eseguito al momento del salvataggio e dell’attivazione. Viene eseguito al momento del salvataggio del feed, quindi ogni giorno un’ora dopo.
Di seguito è riportato il codice di esempio per un file feed .xml di Google Product Search:
Di seguito è riportato il codice di esempio per un file feed .tsv di Google Product Search:
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
Analytics classificazioni prodotto section_79E430D2C75443BEBC9AA0916A337E0A
La classificazione di prodotto Analytics è l'unica classificazione disponibile per i consigli. Per ulteriori informazioni su questo file di classificazione, vedere Informazioni sulle classificazioni nella Guida ai componenti di Analytics. È possibile che non tutte le informazioni necessarie per i consigli siano disponibili nell’implementazione corrente. Per aggiungere elementi al file delle classificazioni, consulta quindi questa guida utente.
IMPORTANT
Prima di importare i dati dell'entità in Recommendations utilizzando le classificazioni di prodotto Analytics, è opportuno tenere presente che questo non è il metodo preferito.
In particolare, tieni conto dei seguenti aspetti:
Gli aggiornamenti agli attributi di entità subiscono un ritardo aggiuntivo fino a 24 ore.
Target supporta solo Product Classifications. Lo SKU del prodotto Analytics deve essere mappato allo stesso livello di Recommendations entity.id. Le classificazioni Analytics personalizzate possono essere progettate utilizzando Adobe Consulting Services. Per qualsiasi domanda, contatta il tuo Account Manager.
Creazione di un feed steps
Crea un feed per inserire le informazioni sui prodotti o i servizi in Recommendations.
Dall'interfaccia di Target, fare clic su Recommendations > Feeds > Create Feed.
(Condizionale) Se hai selezionato CSV o Google Product Feed, specifica il percorso in cui il feed è accessibile.
FTP: se hai selezionato FTP, indica le informazioni relative al server FTP, le credenziali di accesso, il nome del file e la directory FTP. Per caricamenti più sicuri, puoi utilizzare l’FTP con SSL (FTPS).
Impostazioni del server FTP supportate:
FTP e FTPS devono essere impostati per FTP passivo.
Per FTPS, configura il server per accettare connessioni FTPS esplicite.
SFTP non è supportato.
È possibile specificare manualmente una porta su cui avviare la connessione (ad esempio, ftp://ftp.yoursite.com:2121). Se non specifichi una porta, viene usata la porta FTP o FTPS predefinita.
URL: se selezioni URL, specifica l'URL.
(Condizionale) Se hai selezionato Analytics Classifications, scegli la suite di rapporti dall'elenco a discesa.
Fare clic sulla freccia Next per visualizzare le opzioni Schedule.
Seleziona un’opzione di aggiornamento:
Daily
Weekly
Every 2 Weeks
Never: non pianificare un aggiornamento. Scegli questa opzione se non desideri eseguire il feed.
Specifica l’ora in cui desideri eseguire il feed.
Questa opzione si basa sul fuso orario utilizzato nel browser. Se desideri utilizzare l’orario di un fuso orario diverso, dovrai calcolarlo in base al tuo fuso orario attuale.
Fare clic sulla freccia Next per visualizzare le opzioni Mapping, quindi specificare come si desidera mappare i dati alle definizioni Target.
(Facoltativo) Se desideri che il feed appartenga a un ambiente (gruppo di host), seleziona il gruppo di host.
Per impostazione predefinita, il feed appartiene a tutti i gruppi di host. Gli elementi contenuti in questo feed saranno quindi sempre disponibili, in qualsiasi ambiente. Per ulteriori informazioni, consulta Host.
Fare clic su Save.
Dopo aver creato o modificato un feed, questo viene eseguito immediatamente. Il feed viene quindi aggiornato in base ai parametri impostati. La disponibilità delle informazioni richiede del tempo. Innanzitutto, prima di essere pubblicato e reso disponibile, il feed deve essere sincronizzato, elaborato e indicizzato. Lo stato corrente viene visualizzato in Stato feed nell'elenco dei feed. È possibile chiudere Target prima del completamento del processo; questo continuerà ad essere in esecuzione.
Durante l’indicizzazione, prodotti e intestazioni dei feed vengono visualizzati prima dell’effettiva indicizzazione dei singoli valori. Questo consente di cercare e visualizzare i prodotti in modo da poter creare raccolte, esclusioni, progettazioni e attività prima che l’indicizzazione sia stata completata.
Lo stato “Completato” indica che il file è stato trovato e analizzato correttamente. Le informazioni non sono disponibili per l’utilizzo all’interno di Recommendations finché il file non viene indicizzato, operazione che può richiedere un po’ di tempo, a seconda della dimensione del file. Se il processo non riesce, significa che il file non è stato trovato. Ad esempio, hai utilizzato un URL errato o informazioni FTP errate oppure si è verificato un errore di analisi.
Stati e indicatori dei feed concept_E475986720D1400999868B3DFD14A7A0
Informazioni sui possibili stati dei feed e sui relativi indicatori.
Stato dei feed status
Di seguito sono riportati gli stati possibili per un feed:
Stato
Descrizione
Syncing
I dettagli di configurazione dei feed vengono salvati in Target.
Sync Failed
Impossibile salvare i dettagli di configurazione dei feed in Target. Riprova.
No Feed Run
Hai creato un feed che non è stato pianificato (la frequenza è impostata su Mai).
Pianificato per data e ora
Il feed non è stato eseguito, ma è pianificato per essere eseguito alla data e all’ora specificate.
Waiting for Download
Target si sta preparando a scaricare il file di feed.
Downloading Feed File
Target sta scaricando il file di feed.
Importing Items
Target sta importando elementi dal file di feed.
Feed importato correttamente alle ora
Target ha importato il file di feed nel proprio sistema di distribuzione dei contenuti. Le modifiche apportate agli attributi degli elementi sono state inserite nel sistema di distribuzione dei contenuti e presto saranno applicate ai consigli consegnati. Se non visualizzi le modifiche previste, riprova e aggiorna la pagina contenente i consigli. Note:
Se le modifiche apportate agli attributi di un elemento ne determinano l’esclusione dai consigli, tale esclusione viene applicata immediatamente. Se un elemento è stato aggiunto di recente, oppure se a causa delle modifiche apportate agli attributi un elemento non viene più escluso dai consigli, questo verrà applicato al successivo aggiornamento dell'algoritmo, che si verifica entro 24 ore.
Quando viene visualizzato questo stato, è possibile che gli aggiornamenti non siano ancora visibili nell'interfaccia utente di Catalog Search. In Catalog Search è elencato uno stato separato che indica l'ultimo aggiornamento del catalogo ricercabile.
Failed to Index
L’operazione di indicizzazione non è riuscita. Riprova.
Server Not Found
I percorsi FTP o URL non sono validi o sono irraggiungibili.
Per aggiornare un feed, ad esempio per apportare modifiche alla configurazione del feed o al file di feed, aprirlo, apportare le modifiche desiderate e fare clic su Save.
IMPORTANT
Le entità caricate scadono dopo 61 giorni. Significa che il file di feed deve essere caricato almeno ogni 60 giorni per evitare un’interruzione delle attività di Consigli. Se un elemento non è incluso in un file di feed (o in un altro metodo di aggiornamento entità) almeno una volta ogni 60 giorni, Target deduce che l'elemento non è più rilevante e lo rimuove dal catalogo.
Indicatori di stato dei feed section_3C8A236C5CB84C769A9E9E36B8BFABA4
Nella colonna Status vengono visualizzati i seguenti indicatori di stato del feed:
Indicatore di stato
Descrizione
Indicatore di stato verde
Quando l’indicizzazione del feed viene terminata con successo, viene visualizzato un indicatore di stato verde.
Indicatore di stato giallo
Quando un feed o l’indice di un feed viene ritardato del 25% rispetto alla sua frequenza, viene visualizzato un indicatore di stato giallo. Ad esempio, viene visualizzato un punto giallo per una serie di feed da eseguire giornalmente se l’indice non è stato completato sei ore dopo l’ora pianificata. Nota: una volta che lo stato del feed è "In attesa della coda indice", i valori appena aggiornati sono disponibili nell’elaborazione della consegna e dei criteri.
Indicatore di stato bianco
Quando un feed non è pianificato, viene visualizzato un indicatore di stato bianco a indicare che il feed non è ancora stato eseguito.
Indicatore di stato rosso
Se il feed non riesce a caricare i dati sul server, viene visualizzato un indicatore di stato rosso.
Prendi in considerazione gli esempi seguenti:
Esempio 1:
Primo giorno: i processi di alimentazione giornalieri sono effettuati alle 9.00 PST.
Giorno 2: sono le 15.30 e il feed non viene eseguito da ieri alle 09.00.
Lo stato visualizzato sarà giallo, perché l’indice doveva essere eseguito circa 6 ore e 30 minuti fa. 6 ore e 30 minuti + 24 ore rappresentano il 127% della finestra del feed.
Esempio 2:
1 gennaio: processi di feed mensili alle 9:00 PST.
3 febbraio: sono le 10:00 e il feed non viene eseguito da un mese, un giorno e un’ora.
Lo stato visualizzato sarà giallo, perché l’indice doveva essere eseguito circa un giorno e un’ora fa. Anche se questo rappresenta solo l’1,03% delle impostazioni di frequenza [(31 + (1/25))/30 = 1,03%], il ritardo massimo di un giorno è stato superato.
Video di formazione
I video seguenti contengono ulteriori informazioni sui concetti descritti in questo articolo.
