Se il tuo eCommerce è sviluppato in VTEX IO, potrai sincronizzarlo con il tuo account Connectif in pochi minuti e iniziare a raccogliere dati di interazione dei tuoi contatti sul sito web.
In questo articolo imparerai come integrare il tuo negozio VTEX IO con Connectif.
Difficoltà: Bassa.
Quando usarlo?: 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.
3. Effettua il login in VTEX IO.
4. Conferma l'ordine seguendo le istruzioni di VTEX.
5. Clicca su Completa acquisto.
PASSO 2. Installazione del modulo
6. Premi il pulsante Vai alla pagina di installazione.
7. Nella schermata successiva, verifica i permessi necessari del modulo Connectif e clicca su Installa.
PASSO 3. Attivazione dell'App VTEX
a. Requisiti preliminari
(In questa sezione verranno spiegati i passaggi per creare una Chiave applicazione, necessaria per attivare l'App VTEX di Connectif.)
8. Nel tuo account VTEX, vai su "Impostazioni account > Impostazioni account > Ruoli utente" e clicca su Nuovo Ruolo.
9. 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.
Product Logistics > Logistics full access, Logistics viewer, Logistics inventory full access, Logistics inventory read only.
10. Vai su "Impostazioni account > Impostazioni account > Chiavi applicazione" e clicca su Aggiungi.
11. Nel pannello di creazione della nuova Chiave applicazione, clicca su Aggiungi ruoli.
12. Assegna il nuovo ruolo configurato per Connectif.
13. Clicca su Salva.
b. Attivazione dell'applicazione
(In questa sezione verranno indicati i dati identificativi dell'account per attivare l'app Connectif in VTEX IO.)
14. Accedi al tuo account Connectif e, nelle impostazioni del Negozio, in "Integrazioni > Piattaforme e-commerce", clicca su Modifica su VTEX.
15. Copia il ID Cliente e la Chiave Segreta.
16. Vai al tuo account VTEX IO e entra in "App installate > Connectif > Configurazione".
17. Compila i campi con le seguenti informazioni:
- Client ID: inserisci il valore di Identificatore cliente del tuo account Connectif, disponibile in "Impostazioni Negozio > Piattaforme e-commerce > VTEX".
- Private key: inserisci il valore di 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 Connectif.
18. Facoltativamente:
- Seleziona i Canali di vendita con cui desideri che Connectif sincronizzi gli acquisti. Per default verranno registrati tutti gli acquisti.
- Regola la Dimensione immagine che verrà usata quando i prodotti vengono importati in Connectif. Il valore predefinito è 300x300.
19. Attiva il tracking e salva le modifiche.
c. Verifica dell'integrazione
(In questa sezione verrà controllata la configurazione dell'URL del negozio in Connectif.)
20. Vai al tuo account Connectif.
21. Nelle impostazioni del Negozio, vai su "Integrazioni > Piattaforme e-commerce" e su VTEX IO clicca su Modifica.
22. Controlla che il Dominio del Negozio corrisponda a un dominio pubblico e accessibile del tuo sito web.
23. Nelle impostazioni del Negozio, vai su "Canali > Notifiche Web Push".
24. 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 tracciamento web in VTEX IO.)
VTEX IO ha una sezione Checkout separata dal resto del negozio VTEX. Affinché Connectif possa effettuare il tracciamento web e mostrare contenuti durante il processo di conferma ordine, è necessario aggiungere manualmente un frammento di script di Connectif nel Checkout.
25. Accedi alla configurazione del tuo negozio VTEX, in "App installate Connectif", e copia il frammento di codice di Checkout codice personalizzato.
La configurazione del codice dipende dal tipo di Checkout utilizzato dal tuo negozio. Segui solo i passaggi di Checkout o Checkout UI Custom, a seconda della tua configurazione.
a. Configurazione con Checkout
(In questa sezione configurerai lo script di Connectif se il tuo negozio usa Checkout).
26. Accedi a "Impostazioni negozio > Checkout" e clicca su (Modifica).
27. Vai alla scheda Codice e modifica il file checkout6-custom.js, aggiungendo il codice copiato:
b. Configurazione con Checkout UI Custom
(In questa sezione configurerai lo script di Connectif se il tuo negozio usa Checkout UI Custom).
28. Accedi a “Impostazioni negozio > Checkout UI Custom > JavaScript”.
29. Aggiungi il frammento di codice di Connectif che hai copiato in precedenza.
30. Clicca su PUBBLICA per pubblicare le modifiche.
Successo!
L'integrazione di Connectif con VTEX IO è ora pronta.
Puoi verificare se hai completato correttamente l'integrazione di Connectif con VTEX IO in questo articolo.
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 sincronizzazione tramite API, vengono raccolte per impostazione predefinita alcune informazioni sugli Acquisti:
- cartId
- purchaseDate
- purchaseId
- totalPrice
- totalQuantity
2. Come recuperare 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, cioè un link per recuperare gli articoli relativi a quel carrello, che può essere utilizzato in workflow e contenuti.
Per ottenere l'URL di recupero carrello tramite un workflow, deve essere fatto tramite il nodo "Ottieni ultimo carrello" e "Al momento dell'abbandono del carrello", successivamente mappato nelle variabili del contenuto da mostrare o inviare.
- Scopri come funziona questo URL nei diversi CMS e come usarlo in questo articolo.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli:
Onboarding, per acquisire dimestichezza con la nostra interfaccia.
Workflow iniziali, per implementare le tue prime strategie nell'account.
Integrazioni con sistemi esterni, per integrarti con Facebook, moduli e webhook del tuo sito web.
Eventi che consumano Attività, per comprendere meglio il consumo del tuo account.