Integrazione Insider

I widget di personalizzazione, i caroselli di raccomandazioni, i flussi per i carrelli abbandonati e le campagne multicanale (notifiche web, email, SMS, WhatsApp, banner sul sito) di Insider leggono tutti dallo stesso catalogo prodotti. Senza un feed sincronizzato, Insider non dispone di nomi di prodotti, prezzi, immagini o disponibilità a magazzino da inserire in queste esperienze.

Fornire a Insider un catalogo pulito e correttamente mappato protegge anche il tuo Google Merchant Center e altri feed pubblicitari. Se il tuo team gestisce già un feed ottimizzato per Feedance per Google Merchant Center o Meta, in genere puoi riutilizzare gli stessi dati di prodotto di base, rimodellandoli nel formato previsto da Insider, anziché creare e gestire un'esportazione completamente separata.

La documentazione di Insider sull'integrazione del catalogo descrive la sincronizzazione in tempo reale (o programmata) come il meccanismo che mantiene il suo Smart Recommender operativo con dati aggiornati: man mano che il catalogo si aggiorna, Insider One rimuove automaticamente i prodotti esauriti dalle campagne e dai widget di raccomandazione, in modo che agli acquirenti non vengano mai mostrati articoli che non possono acquistare.

Insider non pubblica la logica di classificazione interna del suo motore di raccomandazione, quindi considerate questo come una garanzia di aggiornamento dei dati piuttosto che come una descrizione dell'algoritmo di personalizzazione stesso: mantenete il feed accurato e aggiornato e anche i consigli che ne derivano saranno accurati e aggiornati.

L'integrazione del catalogo prodotti di Insider (documentata nella sezione Metodologia di integrazione del catalogo prodotti basata su XML) accetta feed XML in uno dei tre formati supportati:

1. Formato XML Criteo — per i commercianti che già esportano un feed standardizzato da Criteo.
2. Formato XML di Google Merchant — la struttura comune dello spazio dei nomi `g:` utilizzata per Google Merchant Center, che il sistema di corrispondenza degli attributi del catalogo prodotti di Insider può mappare automaticamente ai propri attributi.
3. Formato XML personalizzato — una struttura definita dall'utente in cui si mappa manualmente ogni tag a un attributo Insider.

Insider supporta anche gli aggiornamenti del catalogo tramite le sue API di acquisizione/aggiornamento (basate su JSON) come alternativa all'XML. Insider non consente esplicitamente di utilizzare contemporaneamente il feed XML e l'integrazione API per lo stesso catalogo: è necessario scegliere un solo metodo.

Durante la configurazione nel pannello Insider (InOne), si specifica anche il nome del tag del prodotto (in genere item a meno che il tuo XML non utilizzi una terminologia diversa), le impostazioni locali e le valute presenti nel file: le integrazioni XML vengono configurate per ogni impostazione locale/negozio.

La documentazione degli attributi del catalogo prodotti di Insider descrive una serie di attributi predefiniti che vengono riconosciuti automaticamente quando il nome del campo e il tipo corrispondono, oltre al supporto per attributi completamente personalizzati definiti dall'utente. Lo stato di obbligatorietà varia a seconda del tipo di feed selezionato (vedi sotto), ma i campi principali sono:

La documentazione di Insider avverte che i prodotti privi di un attributo obbligatorio (come item_id or in_stock) vengono ignorati durante l'elaborazione anziché causare il fallimento dell'intero feed.

1. In Feedance, crea o seleziona il feed di prodotto che desideri inviare a Insider, mappando i dati di origine ai campi previsti da Insider: item_id, name, image_url, url, in_stock, oltre a price/original_price se utilizzerai un feed basato sui ricavi azionari.
2. Scegli Google Merchant XML come formato di output in Feedance se desideri che la corrispondenza automatica degli attributi di Insider funzioni con una mappatura manuale minima: in questo modo viene riutilizzata la stessa struttura di tag `g:` che molti team già utilizzano per Google Merchant Center.
3. Pubblica il feed e copia l'URL del feed Feedance risultante.
4. Nel pannello InOne di Insider, vai a Integrazione catalogo prodotti, scegli XML come metodo di integrazione, assegna un nome all'integrazione, seleziona Google Merchant (o Personalizzato) come formato e incolla l'URL del feed di Feedance come origine.
5. Imposta la lingua, il tag del prodotto (Insider predefinito item), periodo di sincronizzazione, valute applicabili e abilita il rilevamento delle scorte esaurite, se pertinente.
6. Se l'URL del tuo feed Feedance è protetto, aggiungi la coppia Chiave intestazione/Valore intestazione richiesta affinché Insider possa autenticarsi; altrimenti, assicurati che gli indirizzi IP di Insider siano nella lista bianca se il tuo hosting dispone di firewall/WAF/protezione anti-bot.
7. Mappa gli attributi personalizzati rimanenti, quindi conferma: Insider convaliderà il feed e segnalerà il numero di prodotti e la copertura degli attributi prima di attivarlo.

Insider consente di configurare l'intervallo di sincronizzazione da 1 ora a 5 giorni durante la configurazione dell'integrazione XML. La documentazione di Insider specifica che le modifiche al catalogo vengono applicate al ciclo di sincronizzazione successivo, non istantaneamente. Pertanto, se per le vendite lampo o per le scorte a rapida rotazione è fondamentale disporre di informazioni in tempo reale su stock e prezzi, è consigliabile scegliere l'intervallo più breve supportato dalla pianificazione di generazione del feed di Feedance, anziché presumere che le modifiche vengano propagate immediatamente.

Insider mostra lo stato di integrazione delle superfici tramite gli stati di convalida visualizzati nel pannello InOne: Attivo, Passivo, Convalida in sospeso, Pronto per l'attivazione, Convalida non riuscita ed Errore di sistema. Le cause documentate da tenere d'occhio sono:

• Attributi obbligatori mancanti — prodotti mancanti item_id, name, o in_stock (o altri campi richiesti dal tipo di feed scelto) vengono ignorati silenziosamente durante l'elaborazione, anziché bloccare l'intero feed.
• URL del feed bloccato da firewall/WAF/protezione anti-bot — se il tuo hosting protegge l'URL XML con restrizioni IP o rilevamento di bot, le richieste di recupero di Insider falliranno a meno che gli IP di Insider non siano esplicitamente inseriti nella lista bianca.
• Nome dell'etichetta del prodotto non corrispondente — se il tuo XML non utilizza item Se durante la configurazione non imposti il ​​nome del tag corretto per il prodotto, Insider non sarà in grado di analizzare i singoli prodotti.
• Esecuzione simultanea dell'integrazione XML e API — Insider consente un solo metodo di integrazione del catalogo attivo alla volta; l'attivazione di entrambi non è supportata.

Si tratta di pratiche generali di igiene dei mangimi, non di requisiti specifici per gli Insider:

• mantenere in_stock e i campi relativi ai prezzi aggiornati in base all'intervallo di sincronizzazione: la pertinenza dei consigli e delle campagne dipende direttamente dall'attualità di questi dati.
• Scegli il tipo di feed (basato su fatturato, disponibilità, data di pubblicazione o data di inizio/fine) che meglio si adatta al tuo modello di business, anziché utilizzare quello generico per l'e-commerce, poiché Insider utilizza il tipo di feed per determinare quale dimensione influenza il filtraggio dei consigli.
• Se possibile, riutilizza un feed in formato Google Merchant in modo che la corrispondenza automatica degli attributi di Insider si occupi della mappatura.
• Popola attributi opzionali come category, brande group_code Anche se non sono obbligatori, in genere migliorano l'efficacia della personalizzazione e del raggruppamento delle varianti a valle.

Posso utilizzare sia un feed XML che l'integrazione API per il mio catalogo prodotti Insider?
No. Insider consente di avere attivo un solo metodo di integrazione alla volta per un determinato catalogo: XML o API.

Insider supporta direttamente i feed nel formato di Google Merchant Center?
Sì. Il sistema di corrispondenza degli attributi del catalogo prodotti di Insider è progettato per riconoscere automaticamente la struttura standard del tag `g:` di Google Merchant, che è uno dei tre formati XML supportati insieme a Criteo e Custom.

Quanto velocemente verranno visualizzate le variazioni di prezzo o di disponibilità su Insider dopo l'aggiornamento del feed?
La sincronizzazione avviene alla velocità impostata dall'intervallo configurato, che può variare da 1 ora a 5 giorni: le modifiche vengono applicate al ciclo di sincronizzazione successivo, non immediatamente.

Quali sono i dati minimi richiesti a Insider per accettare un prodotto?
Come minimo, un valido item_id, namee i campi richiesti dal tipo di feed selezionato (ad esempio in_stock (per i tipi di feed con gestione delle scorte). I prodotti che non presentano questi parametri vengono ignorati anziché causare il fallimento dell'intero feed.