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.
Difficoltà: Bassa.
Quando utilizzarlo?: All'apertura del tuo account Connectif.
PASSO 1. Download dell'applicazione
- Accedi al seguente link: Connectif su VTEX App Store.
- Clicca sul pulsante Ottieni App in alto a destra.
- Effettua il login su VTEX IO.
- Conferma l'ordine seguendo le istruzioni di VTEX.
- Clicca su Completa l'acquisto.
PASSO 2. Installazione del modulo
- Premi il pulsante Vai alla pagina di installazione.
- Nella schermata successiva, rivedi i permessi richiesti dal modulo Connectif e clicca su Installa.
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.)
- Nel tuo account VTEX, vai su "Configurazione dell'account > Configurazione dell'account > Ruoli utente" e clicca su Nuovo Ruolo.
- 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.
- Accedi a "Configurazione dell'account > Configurazione dell'account > Chiavi dell'applicazione" e clicca su Aggiungi.
- Nel pannello di creazione della nuova Chiave dell'Applicazione, clicca su Aggiungi ruoli.
- Assegna il nuovo ruolo configurato per Connectif.
- Clicca su Salva.
b. Attivazione dell’applicazione
(In questa sezione verranno indicati i dati identificativi dell’account per attivare l’applicazione Connectif su VTEX IO.)
- Accedi al tuo account Connectif e, nelle impostazioni del Negozio, in "Integrazioni > Piattaforme di e‑commerce", fai clic su Modifica su VTEX.
- Copia il ID Cliente e la Chiave Segreta.
- Vai al tuo account VTEX IO e entra in "App installate > Connectif > Configurazione".
- Compila i campi con le seguenti informazioni:
- Client ID: inserisci il valore di Identificatore del cliente del tuo account Connectif, disponibile in "Impostazioni del negozio > Piattaforme di e‑commerce > VTEX".
- Private Key: inserisci il valore della Chiave Segreta del tuo account Connectif, disponibile in "Impostazioni del negozio > Piattaforme di e‑commerce > VTEX".
- VTEX Key e VTEX Token: inserisci i valori corrispondenti ottenuti in Application Keys per il ruolo Connectif.
- Opzionalmente:
- Seleziona i Canali di vendita con cui vuoi che Connectif sincronizzi gli acquisti. Per impostazione predefinita verranno registrati tutti gli acquisti.
- Regola la Dimensione dell’immagine da usare al momento di importare i prodotti in Connectif. Il valore predefinito è 300×300.
- Attiva il tracking e salva le modifiche.
c. Verifica dell'integrazione
(In questa sezione verrà verificata la configurazione dell'URL del negozio in Connectif.)
- Accedi al tuo account Connectif.
- Nelle impostazioni del Negozio, vai su "Integrazioni > Piattaforme e-commerce" e, in VTEX IO, clicca su Modifica.
- Controlla che il Dominio del Negozio corrisponda a un dominio pubblico e accessibile del tuo sito web.
- Nelle impostazioni del Negozio, vai su "Canali > Notifiche Web Push".
- Modifica la URL del ServiceWorker in modo che corrisponda a un dominio pubblico e accessibile del tuo negozio.
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.
- Accedi alla configurazione del tuo negozio VTEX, in "App installate > Connectif", e copia il frammento di codice di Checkout codice personalizzato.
- Accedi a "Configurazione del negozio > Checkout" e clicca su (Modifica).
- Vai alla scheda Codice e modifica il file checkout6-custom.js, aggiungendo il codice copiato:
Successo!
L'integrazione di Connectif con VTEX IO è completata.
Domande frequenti
1. Quali informazioni raccoglie Connectif tramite questa integrazione
a. Informazioni raccolte dai Contatti
Nelle integrazioni con VTEX IO, tramite eventi JavaScript di Connectif, vengono trasferite, per impostazione predefinita, alcune informazioni sui Contatti:
- _name
- _surname
Inoltre, tramite la sincronizzazione massiva giornaliera, vengono aggiornati questi campi:
- _birthdate
- _name
- _surname
- _mobilePhone
- _newsletterSubscriptionStatus
b. Informazioni raccolte dai Prodotti
Nelle integrazioni con VTEX IO, tramite eventi JavaScript di Connectif e la sincronizzazione giornaliera del catalogo, vengono raccolte, per impostazione predefinita, alcune informazioni sui Prodotti:
- productDetailUrl
- name
- brand
- productId
- imageUrl
- unitPrice
- unitPriceOriginal
- availability
- categories
- unitPriceWithoutVAT (solo con la sincronizzazione massiva giornaliera)
- publishedAt (solo con la sincronizzazione massiva giornaliera)
- inStockUnits (solo con la sincronizzazione massiva giornaliera)
c. Informazioni raccolte dagli Acquisti
Nelle integrazioni con VTEX IO, tramite eventi JavaScript di Connectif e la sincronizzazione tramite API, vengono raccolte, per impostazione predefinita, alcune informazioni sugli Acquisti:
- cartId
- purchaseDate
- purchaseId
- totalPrice
- totalQuantity
2. Come recuperare i carrelli abbandonati con la URL di Recupero Carrello
(In questa sezione si spiega come funziona la URL di Recupero Carrello per ottenere gli articoli associati a un carrello specifico).
Tramite l'integrazione con VTEX IO, viene inviata a Connectif una URL di Recupero Carrello, ovvero un link per recuperare gli articoli relativi a quel carrello che può essere utilizzato nei workflow e nei contenuti.
Per ottenere la URL di recupero carrello tramite un workflow, bisogna utilizzare il nodo "Ottieni ultimo carrello" e "All'abbandono del carrello", successivamente, deve essere mappata nelle variabili del contenuto da mostrare o inviare.
- Scopri come funziona questa URL nei diversi CMS e come utilizzarla in questo articolo.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account in Connectif, ti consigliamo di continuare con i seguenti articoli:
-
Onboarding, per acquisire familiarità con la nostra interfaccia.
-
Workflow iniziali, per implementare le tue prime strategie sull'account.
-
Integrazioni con sistemi esterni, per integrarti con Facebook, moduli e webhook del tuo sito.
-
Eventi che consumano Attività, per comprendere meglio il consumo del tuo account.