Utilizzare i feed per importare le entità in Adobe Target Recommendations. Le entità possono essere inviate tramite file CSV, il formato di feed Google Product Search e le classificazioni di prodotto Adobe Analytics.
Panoramica sui feed concept_D1E9C7347C5D4583AA69B02E79607890
I feed ti 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 merce venduta (Costo merce venduta, COGS) e così via.
I feed consentono inoltre 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 dal file 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 Target raccoglie dati utilizzando sia un feed di entità che una mbox, vincono i 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.
L’elenco dei feed ( Consigli > feed) fornisce informazioni su eventuali feed creati.
La pagina Feed contiene le colonne seguenti:
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.
Elementi: visualizza il numero di elementi presenti nel feed.
Pianificazione: visualizza la pianificazione di aggiornamento per il feed: Giornaliero, Settimanale, Every 2 Weeks o Mai.
Ultimo aggiornamento: visualizza la data e l’ora dell’ultimo aggiornamento del feed e il nome della persona che lo ha eseguito.
Fai clic sull’icona Personalizza tabella (
) per selezionare o deselezionare le colonne da visualizzare.
Fai clic sull’icona Informazioni (
) per visualizzare una scheda con la data dell’ultimo caricamento e l’URL del feed.
Fai clic sull’icona Altre azioni (
) per accedere alle azioni seguenti: Disattiva, Edit, Copia e Elimina.
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 di feed 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 di feed 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.
Tutti i dati caricati utilizzando il file .csv, il feed di prodotto Google o il feed di classificazione di prodotto Analytics sovrascrivono 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 sovrascrivere il valore esistente. 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 Google Product Search utilizza il formato Google anziché il formato CSV proprietario Adobe. È possibile riutilizzare un Google Product Feed esistente per importare i dati di prodotto in Recommendations.
NOTE
Non è necessario inviare i dati a Google. Puoi importare i tuoi dati e pianificare gli aggiornamenti, purché il file utilizzi i nomi di attributo predefiniti di Google.
Recommendations accetta i file xml, txt e tsv che seguono le specifiche del feed Google e utilizzano gli attributi definiti da Google. Specificare l’URL o il percorso FTP del feed in modo che il server Recommendations possa recuperare il file e generare il catalogo.
NOTE
Il server che ospita il feed Google deve consentire il metodo POST.
Considera i seguenti requisiti e limitazioni:
È ancora necessario un mbox per pagina di prodotto per visualizzare i consigli su tale pagina o tenere traccia delle visualizzazioni del prodotto per gli algoritmi basati sulla visualizzazione.
I feed Google non supportano più valori per un attributo personalizzato.
Il feed viene eseguito quando lo si salva e lo si attiva, quindi ogni giorno un’ora dopo rispetto al tempo di esecuzione iniziale.
L’esempio seguente mostra un feed Google Product Search in formato .xml:
Di seguito è riportato un codice di esempio per un file .tsv di feed 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 Adobe 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 classificazioni prodotto. 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 Target, fare clic su Recommendations > Feed > Create Feed.
(Condizionale) Se hai selezionato CSV o Feed prodotto Google, 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).
accordion
Impostazioni del server FTP supportate
FTP e FTPS devono essere impostati per FTP passivo.
Per FTPS, configura il server per accettare connessioni FTPS esplicite.
È 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.
+++
SFTP: immetti il nome host o l’indirizzo IP del server SFTP, la porta (impostazione predefinita: 22), il nome utente, la directory e il nome file. Per l’autenticazione, specifica una password, una chiave privata SSH o entrambe.
accordion
Impostazioni e limitazioni del server SFTP supportate
L’autenticazione utilizza una password, una chiave privata SSH o entrambe. È necessario specificarne almeno uno.
Il cliente genera e possiede la coppia di chiavi. Installa la chiave pubblica nel file authorized_keys dell’utente SFTP, quindi incolla la chiave privata in Target come testo PEM. I tipi di chiave accettati sono RSA, Ed25519 ed ECDSA, in formato PEM (-----BEGIN RSA PRIVATE KEY-----), PKCS#8 (-----BEGIN PRIVATE KEY-----) o OpenSSH (-----BEGIN OPENSSH PRIVATE KEY-----).
Le chiavi private protette da passphrase non sono supportate. Impossibile salvare un feed con una di esse.
Target memorizza la chiave privata crittografata e non la visualizza più. Per ruotarlo, modifica il feed e immetti il nuovo tasto.
Immettere un nome host o un indirizzo IP vuoto, senza il prefisso sftp://, la porta o il percorso. Utilizzare il campo Porta per una porta non predefinita.
La chiave host del server viene accettata alla prima connessione e non è necessario alcuno scambio di impronte digitali con Adobe.
SFTP è disponibile nell’interfaccia di Target e nell’API di Recommendations, ma non nell’interfaccia di amministrazione legacy di Recommendations Classic. Adobe non ospita un endpoint SFTP, utilizza un server ospitato dal cliente.
Il server SFTP deve essere raggiungibile da Internet e consentire connessioni in entrata dagli indirizzi di download di Adobe Target. L’elenco IP di produzione deve essere confermato dal team tecnico prima della pubblicazione di questo aggiornamento.
+++
URL: se selezioni URL, specifica l’URL.
(Condizionale) Se hai selezionato Classificazioni Analytics, scegli la suite di rapporti dal relativo elenco a discesa.
Fai clic sulla freccia Successivo per visualizzare le opzioni Pianifica.
Seleziona un’opzione di aggiornamento:
Giornaliero
Settimanale
Ogni 2 Settimane
Mai: 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.
Fai clic sulla freccia Successivo per visualizzare le opzioni Mappatura, quindi specifica come 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.
Fai clic su Salva.
Dopo aver creato o modificato un feed, questo viene eseguito immediatamente e quindi aggiornato in base alle impostazioni. Il feed deve essere sincronizzato, elaborato e indicizzato prima che i relativi dati siano disponibili. Controlla lo stato di Feed nell’elenco Feed per informazioni sull’avanzamento. L’elaborazione continua anche se chiudi Target.
Durante l’indicizzazione, i prodotti e le intestazioni dei feed vengono visualizzati prima dei singoli valori, per consentirti di cercare i prodotti e creare raccolte, esclusioni, progettazioni e attività prima del termine dell’indicizzazione.
Lo stato “Completato” indica che il file è stato trovato e analizzato correttamente. I dati sono disponibili in Recommendations solo dopo l’indicizzazione, che richiede tempo a seconda della dimensione del file. Gli errori possono essere dovuti a un URL o a informazioni FTP errati, a un file mancante o a 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
Sincronizzazione
I dettagli di configurazione dei feed vengono salvati in Target.
Sincronizzazione non riuscita
Impossibile salvare i dettagli di configurazione dei feed in Target. Riprova.
Nessuna esecuzione di feed
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.
In attesa di download
Target si sta preparando a scaricare il file di feed.
Download del file di feed
Target sta scaricando il file di feed.
Importazione elementi
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 le modifiche previste non vengono visualizzate, riprovare e aggiornare 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 Ricerca nel catalogo. In Ricerca nel catalogo è elencato uno stato separato che indica l’ultima volta che il catalogo ricercabile è stato aggiornato.
Importazione parziale non riuscita
In precedenza, quando non venivano caricate tutte le righe, il feed veniva comunque contrassegnato come completato. Pertanto, la creazione di una falsa impressione che tutte le righe siano state caricate come feed mostra l’esito positivo.
Ecco uno scenario del motivo per cui potresti riscontrare un’importazione di feed parziale:
Hai caricato un file di feed per l’ambiente di produzione, ad esempio 100 righe.
Il feed ha eseguito e caricato 80 di queste righe e ha rilasciato 20 righe a causa di formattazione errata, campo che ha superato i caratteri e così via.
Il feed è stato contrassegnato come riuscito nell’interfaccia utente, dando l’impressione che tutte le 100 righe siano state caricate.
Alcuni di questi 20 prodotti sono previsti nella consegna di un’attività, ma non si verifica.
A questo punto sei perplesso perché hai caricato il feed contenente i dettagli del prodotto per i prodotti in questione. Quando esegui una query tramite l’API di entità, che indica che non si trova nel backend, la query non viene visualizzata.
Per eliminare questa confusione, il messaggio viene migliorato per comunicare esattamente cosa è successo con il feed. Invece di contrassegnarlo come operazione riuscita, ora viene contrassegnato come importazione parziale non riuscita.
Impossibile indicizzare
L’operazione di indicizzazione non è riuscita. Riprova.
Server non trovato
Le posizioni FTP, SFTP o URL non sono valide o altrimenti non raggiungibili.
Per aggiornare un feed (ad esempio, per apportare modifiche alla configurazione del feed o al file di feed), aprilo, apporta le modifiche desiderate e fai clic su Salva.
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
I seguenti indicatori di stato dei feed vengono visualizzati nella colonna Stato:
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. L’indicatore di colore giallo viene visualizzato se, ad esempio, l’indice di una serie di feed da eseguire giornalmente non è stato completato sei ore dopo l’orario pianificato. 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.
