L’integrazione del catalogo XML di VTEX ti consente di sincronizzare il catalogo prodotti del tuo negozio VTEX con Connectif, generando un feed XML personalizzato. Questa integrazione consente di importare facilmente i tuoi prodotti in Connectif e sincronizzarli in massa.
In questo articolo imparerai come generare il tuo feed XML per VTEX e come sincronizzarlo con Connectif.
Difficoltà: Bassa.
Quando utilizzarlo: Quando attivi il tuo account in Connectif.
Prima di iniziare: requisiti
Per integrare il tuo catalogo XML di VTEX con Connectif, avrai bisogno di:
Accesso all’Admin di VTEX.
Permessi amministrativi per creare e gestire i template XML.
Una Collezione in VTEX che includa tutti i prodotti che desideri esportare nel feed XML (consulta la documentazione di VTEX per configurarla).
FASE 1. Configurazione dell’XML in VTEX
1.1. Creazione del template XML in VTEX
1. Accedi al pannello di amministrazione di VTEX, vai su "Configurazione del Negozio > Canali" e fai clic su Integrazione XML.
2. Fai clic su Nuovo XML.
3. In Tipo di XML, seleziona l’opzione Open XML (predefinito).
4. Assegna un Nome file per identificarlo.
5. Compila i seguenti campi:
In Tipo di codifica, seleziona l’opzione UTF-8 (predefinito).
In Collezione, seleziona la collezione di prodotti da elencare.
In Formato prezzi, seleziona l’opzione Predefinito.
In Separatore di categorie, seleziona l’opzione Google Shopping.
6. Spunta la casella Mostra prodotto con SKU standard.
1.2. Definizione dei campi del prodotto in VTEX
7. Nell’area relativa al Tag radice, compila le informazioni come mostrato nell’immagine seguente o come indicato nella documentazione ufficiale di VTEX.
8. Configura il template XML in modo che includa le informazioni sul prodotto come indicato nella tabella seguente:
| Campo in Connectif | Campo in VTEX | Campo in XML |
|---|---|---|
ID esterno del prodotto |
ID prodotto |
id |
Nome |
Nome SKU |
title |
Prezzo unitario |
Prezzo attuale dello SKU + Tasse |
sale_price_with_tax |
Prezzo unitario originale |
Prezzo attuale dello SKU + Tasse |
sale_price_with_tax |
Prezzo unitario senza tasse |
Prezzo attuale dello SKU |
sale_price |
URL di dettaglio |
Link |
link |
Categorie |
Dipartimento + Categoria |
g:product_type |
URL immagine |
Immagine |
image_link |
Descrizione |
Descrizione del prodotto |
description |
Disponibilità |
Disponibilità Google Shopping |
g:availability |
Marca |
Marca |
brand |
Questa tabella fornisce i riferimenti per completare le informazioni in VTEX:
- Campo in Connectif: è il nome del campo come appare nella Scheda Prodotto di Connectif.
- Campo in VTEX: è il nome che appare nell'interfaccia di VTEX come riferimento.
- Campo in XML: è l'informazione che devi includere nell'input di VTEX.
Ad esempio, per associare il campo ID esterno del prodotto di Connectif, in VTEX dovrai inserire "id" nell'area ID prodotto; per associare il campo Nome di Connectif, in VTEX dovrai inserire "title" nell'area Nome SKU.
9. Fai clic su Salva.
10. Una volta tutto pronto, l'XML avrà il seguente aspetto:
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<channel>
<item>
<id><![CDATA[ 1 ]]></id>
<title><![CDATA[ Product ]]></title>
<description><![CDATA[ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sollicitudin orci et dolor lobortis, nec elementum metus mattis. Vestibulum et commodo ante. ]]></description>
<g:product_type><![CDATA[ Level 1 > Level 2 > Level 3 > Level 4 ]]></g:product_type>
<brand><![CDATA[ Brand ]]></brand>
<link><![CDATA[ https://connectif.vtexcommercestable.com.br/product/p?idsku=13 ]]></link>
<image_link><![CDATA[ https://connectif.vteximg.com.br/arquivos/ids/155403_2 ]]></image_link>
<sale_price><![CDATA[ 6,00 ]]></sale_price>
<sale_price_with_tax><![CDATA[ 7,00 ]]></sale_price_with_tax>
<g:availability><![CDATA[ in stock ]]></g:availability>
</item>
</channel>
</rss>
1.3. Generazione dell'URL del Feed XML
11. Una volta salvato il modello, VTEX genererà il feed XML e, nella colonna URL, sarà disponibile l'URL pubblico, che avrà un aspetto simile al seguente:
https://{tuo-workspace}.vtexcommercestable.com.br/XMLData/{nome-del-tuo-template}.xml12. Accedi a tale URL da un browser e verifica che l'XML venga generato correttamente.
FASE 2. Sincronizzazione del feed XML con Connectif
13. Accedi al tuo Store Connectif, vai su "Ecommerce > Catalogo" e fai clic su Sincronizzazione prodotti.
14. Vai alla scheda Feed di prodotti e fai clic su Configura.
15. Nell'area Aggiungi feed di prodotti, aggiungi l'URL del feed di prodotti che hai appena creato.
16. Collega i parametri del tuo Feed XML con quelli della Scheda Prodotto di Connectif.
Se hai bisogno di ulteriori informazioni su come sincronizzare il tuo feed con Connectif, consulta questo articolo.
17. Una volta definita la configurazione della sincronizzazione, fai clic su Attiva per programmarla, oppure su Attiva e sincronizza ora per eseguire una sincronizzazione immediata e programmare la successiva secondo l'intervallo definito.
Successo!
Hai sincronizzato il tuo Catalogo XML VTEX con Connectif.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli:
Integrazione personalizzata per inviare dati, per inviare dati da Connectif a sistemi o applicazioni esterni.
Rilevare e reagire a link web creati fuori da Connectif, per rilevare e reagire ai clic su qualsiasi link del tuo sito.
Integrazione con Facebook e Instagram, per collegare il tuo account Facebook Ads a Connectif e iniziare a gestire il tuo pubblico.
Form integrati, per integrare in Connectif form già esistenti sul tuo sito.