Guida per integrare con VTEX IO

Se il tuo eCommerce è sviluppato su VTEX IO, potrai sincronizzarlo con il tuo account Connectif in pochi minuti e iniziare a raccogliere dati sulle interazioni dei tuoi contatti sul sito web.

In questo articolo imparerai come integrare il tuo negozio VTEX IO con Connectif

 
Tempo di implementazione: 20 min.
Difficoltà: Bassa.
Quando utilizzarlo?: All'apertura del tuo account Connectif.

 

Passo 1. Download dell'applicazione

  1. Accedi al seguente link: Connectif su VTEX App Store.
  2. Clicca sul pulsante Ottieni App in alto a destra.

VTEX_IO_Integracion_-_2-min.png

  1. Effettua il login su VTEX IO.

VTEX_IO_Integracion_-_3.png

  1. Conferma l'ordine seguendo le istruzioni di VTEX.
  2. Clicca su Completa l'acquisto.

VTEX_IO_Integracion_-_4.png

 

Passo 2. Installazione del modulo

  1. Premi il pulsante Vai alla pagina di installazione.

VTEX_IO_Integracion_-_5.png

  1. Nella schermata successiva, rivedi i permessi richiesti dal modulo Connectif e clicca su Installa.

VTEX_IO_Integracion_-_6.png

 

Passo 3. Attivazione dell'App di VTEX

a. Requisiti preliminari

(In questa sezione verranno spiegati i passaggi per creare una Chiave di Applicazione, necessaria per attivare l'App VTEX di Connectif.)

  1. Nel tuo account VTEX, vai su "Configurazione dell'account > Configurazione dell'account > Ruoli utente" e clicca su Nuovo Ruolo.

VTEX_IO_Integracion_-_17.png

  1. Assegna i seguenti permessi al ruolo: 
    • Product Catalog > Content, Admin, Marketing, Configuration, Commercial, Miscellaneous, Reports, Marketplace, Collection.
    • Product License Manager > Services Access Control > Get account by identifier.
    • Product Checkout > CheckoutResources.
    • Product OMS > OMS Access > Change order workflow status, Notify payment, Notify invoice, View order, Notify refund, Order feed subscription, View store sales stats, List Orders.
    • Product Master Data > Generic resources, Application, Comment, Customized Search, Form, Import.
    • Product Dynamic Storage > Dynamic storage generic resources > Read only documents, Master Data administrator, Full access to all documents.
    • Product Dynamic Storage > Data entity > List data entity, Create data entity, Edit schema, View data entity details, Publish index.

VTEX_IO_Integracion_-_16.png

  1. Accedi a "Configurazione dell'account > Configurazione dell'account > Chiavi dell'applicazione" e clicca su  Aggiungi.

VTEX_IO_Integracion_-_18.png

  1. Nel pannello di creazione della nuova Chiave dell'Applicazione, clicca su  Aggiungi ruoli.

VTEX_IO_Integracion_-_19.png

  1. Assegna il nuovo ruolo configurato per Connectif.

VTEX_IO_Integracion_-_20.png

  1. Clicca su Salva.

VTEX_IO_Integracion_-_21.png

 

b. Attivazione dell'applicazione 

(In questa sezione verranno indicati i dati identificativi dell'account per attivare l'applicazione di Connectif su VTEX IO.)

  1. Accedi al tuo account Connectif e, nelle impostazioni del Negozio, in "Integrazioni > Piattaforme e-commerce", clicca su  Modifica su VTEX.

Integrazione con VTEX IO - 0-min.png

  1. Copia il Client ID e la Chiave Segreta.

Integrazione con VTEX IO - 1-min.png

  1. Vai al tuo account VTEX IO e accedi a "App installate > Connectif > Configurazione".
  2. Compila i campi con le seguenti informazioni:
  • Client ID: inserisci il valore di Identificatore del cliente del tuo account Connectif, disponibile in "Impostazioni Negozio > Piattaforme e-commerce > VTEX".
  • Private key: inserisci il valore della Chiave segreta del tuo account Connectif, disponibile in "Impostazioni Negozio > Piattaforme e-commerce > VTEX".
  • VTEX Key e VTEX Token: inserisci i valori corrispondenti ottenuti in Application Keys per il ruolo di Connectif.

VTEX_IO_Integracion_-_7.png

  1. (Opzionale) Seleziona i canali di vendita con cui desideri che Connectif sincronizzi gli acquisti. Per impostazione predefinita, verranno registrati tutti gli acquisti.
  2. Clicca su Attiva per salvare le modifiche.

 

c. Verifica dell'integrazione

(In questa sezione verrà verificata la configurazione dell'URL del negozio in Connectif.) 

  1. Accedi al tuo account Connectif.
  2. Nelle impostazioni del Negozio, vai su "Integrazioni > Piattaforme e-commerce" e, in VTEX IO, clicca su  Modifica.
  3. Controlla che il Dominio del Negozio corrisponda a un dominio pubblico e accessibile del tuo sito web.

Integrazione con VTEX IO - 5-min.png

  1. Nelle impostazioni del Negozio, vai su "Canali > Notifiche Web Push".
  2. Modifica la URL del ServiceWorker in modo che corrisponda a un dominio pubblico e accessibile del tuo negozio.

Integrazione con VTEX IO - 2-min.png

 

Passo 4. Configurazione di Connectif nella pagina di Checkout

(In questa sezione viene descritto come configurare il monitoraggio web su VTEX IO.)

 

VTEX IO ha una sezione di Checkout separata dal resto del negozio VTEX. Per permettere a Connectif di effettuare il monitoraggio web e visualizzare contenuti durante il processo di conferma dell'ordine, è necessario aggiungere manualmente un frammento di codice dal backoffice nella sezione di checkout.

  1. Accedi alla configurazione del tuo negozio VTEX, in "App installate > Connectif", e copia il frammento di codice di Checkout codice personalizzato.

VTEX_IO_Integracion_-_13.png

  1. Accedi a "Configurazione del negozio > Checkout" e clicca su  (Modifica).

VTEX_IO_Integracion_-_14.png

  1. Vai alla scheda Codice e modifica il file checkout6-custom.js, aggiungendo il codice copiato:

VTEX_IO_Integracion_-_15.png

 

 

Successo!
L'integrazione di Connectif con VTEX IO è completata.

  

Puoi verificare se l'integrazione di Connectif con VTEX IO è stata eseguita correttamente in questo articolo.

 


Domande frequenti

1. Come recuperare i carrelli abbandonati con l'URL di Recupero Carrello

(In questa sezione viene spiegato come funziona l'URL di Recupero Carrello per ottenere gli articoli associati a un carrello specifico).

Attraverso l'integrazione con VTEX IO, viene inviato a Connectif un URL di Recupero Carrello, ovvero un link per recuperare gli articoli correlati a quel carrello e che può essere utilizzato nei workflow e nei contenuti.

Per ottenere l'URL di recupero carrello tramite un workflow, è necessario utilizzare il nodo "Ottenere ultimo carrello" e "Abbandono carrello", e successivamente mappare le variabili nel contenuto da mostrare o inviare.

  • Scopri come funziona questo URL nei diversi CMS e come utilizzarlo in questo articolo

 

 


Continua a imparare!

Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: