Integrazione Klaviyo: configurazione e aiuto

1. Carica e installa lo ZIP mprklaviyo in Moduli > "Module Manager".
2. Fai clic su "Configure" per aprire Impostazioni Klaviyo.
3. Copia la tua chiave API pubblica di Klaviyo, chiamata anche Site ID, in Chiave API pubblica. Il suggerimento del campo indica "Klaviyo > Settings > API Keys".
4. Controlla l’ID del servizio di consenso e gli interruttori degli eventi.
5. Attiva "Enable Klaviyo" e fai clic su Salva.
6. In una nuova sessione del browser cliente, concedi il consenso marketing pertinente e visita una pagina prodotto.
7. Aggiungi un prodotto e completa un ordine di prova. Controlla gli eventi in arrivo su Klaviyo.

Usa il Site ID pubblico. Non ti serve una chiave API privata di Klaviyo per questa integrazione sul sito.

Le pagine "Integrity", licenza, assistenza e aggiornamenti del modulo sono disponibili accanto alla configurazione. Un avviso di impostazioni richieste segnala una chiave pubblica mancante.

Il modulo si avvia tramite displayHeader. Il gestore attuale di displayBeforeBodyClosingTag non restituisce markup di tracciamento. Il template contiene una configurazione pubblica di instradamento. I dati di cliente, carrello e ordine vengono ottenuti da un endpoint di tracciamento privato e non memorizzabile nella cache dopo controlli in tempo reale.

Il runtime controlla attivazione, account, host del negozio, policy di uscita, consenso marketing e marcatori interni dei dipendenti prima di caricare:

https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=YOUR_SITE_ID

L’identificazione richiede anche il consenso corrispondente e una sessione cliente autenticata. Quando consentito, invia $email, $first_name e $last_name. Il solo accesso non sostituisce il consenso.

Il modulo non iscrive i contatti newsletter a una lista Klaviyo e non importa clienti e ordini storici. Configura campagne, segmenti e flussi in Klaviyo in base agli eventi ricevuti.

Le aggiunte al carrello vengono acquisite tramite actionBeforeCartUpdateQty e actionCartSave. Il browser consuma i record di aggiunta in sospeso. La semplice apertura del carrello non è più l’attivazione dell’evento. I controlli su consenso acquisito, destinazione e revoca si applicano alle aggiunte in coda.

La conferma d’ordine usa displayOrderConfirmation e una ricevuta vincolata all’acquirente. Gli ordini annullati/in errore vengono ignorati. Un registro impedisce ammissioni ripetute per lo stesso negozio, destinazione e ordine. Per le prove usa un nuovo ordine anziché ricaricare ripetutamente una vecchia conferma.

Se ti serve un override del tema, il percorso del template di avvio è:

themes/your-theme/modules/mprklaviyo/views/templates/hook/tracking.tpl

Il template attuale delega a JavaScript e all’endpoint privato. Conserva gli attributi dei dati e i riferimenti agli script se lo personalizzi.

• Nessuno script: controlla "Enable Klaviyo", Chiave API pubblica, l’hook displayHeader, il consenso e i marcatori dei dipendenti.
• Nessuna identificazione: controlla l’accesso del cliente e il consenso corrispondente. Una visita anonima non fornisce l’identità del cliente.
• Nessuna visualizzazione prodotto: controlla "Track Viewed Product", lo stato attivo del prodotto e il suo ID.
• Nessun evento carrello: aggiungi un articolo dopo il consenso in una sessione cliente. Se necessario controlla la richiesta privata di tracciamento e le tabelle degli eventi carrello tramite "Integrity".
• Nessun evento di acquisto: controlla "Track Purchase", l’hook nativo di conferma, la sessione dell’acquirente, l’URL sicuro di conferma e lo stato dell’ordine.
• Richiesta esterna bloccata: controlla gli strumenti di privacy del browser e gli errori di rete. Non usare un browser del back office contrassegnato come unica prova.

Disattiva "Enable Klaviyo" e salva per interrompere il tracciamento di questo modulo. Disinstalla tramite "Module Manager" per rimuovere il menu e la configurazione. Il metodo di disinstallazione non elimina esplicitamente le tabelle degli eventi. Non richiede la cancellazione di profili o eventi già inviati a Klaviyo.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.