Guida pratica
Collega il tuo sito WooCommerce a Casa Signals
Installa il connettore WordPress di Casa Signals, genera la chiave API del tuo sito, abilita il monitoraggio e conferma che gli eventi WooCommerce stanno raggiungendo la tua dashboard.
Prima di iniziare
- Un conto Casa Signals.
- Un negozio WooCommerce a cui puoi accedere come amministratore di WordPress.
Cosa avrai al termine
- Esiste una connessione al plugin WordPress in Casa Signals per il sito corretto.
- La chiave API Casa Signals viene salvata in WordPress.
- Il monitoraggio degli eventi è abilitato nel plugin WordPress.
- I nuovi eventi WooCommerce iniziano a comparire nelle analisi di Casa Signals, nelle tempistiche dei clienti, nei report sui prodotti e negli attivatori di flusso.
- È possibile importare prodotti storici, utenti e ordini opzionali senza attivare automazioni in tempo reale.
Come funziona la connessione
Casa Signals si connette a WooCommerce tramite il plugin WordPress Customer Event Sync for Casa Signals. Il plugin tiene traccia delle attività importanti di WordPress e WooCommerce, mette in coda gli eventi all'interno di WordPress e li invia a Casa Signals in batch in background.
La connessione viene autenticata con una chiave API specifica del sito. Ogni sito Casa Signals ha la propria chiave, quindi la chiave deve provenire dallo stesso record del sito del dominio WooCommerce che stai connettendo.
Il monitoraggio è attivabile. L'installazione del plugin da sola non è sufficiente. La chiave API deve essere salvata, il dominio del sito deve essere corretto e l'opzione Abilita tracciamento eventi deve essere attivata.
- Il sito Casa Signals esiste.
- Il plugin WordPress è installato e attivo.
- viene incollata nel plug-in.
- Il monitoraggio degli eventi è abilitato.
- L'attività recente viene visualizzata in Casa Signals.
1. Aggiungi il sito WooCommerce in Casa Signals
Apri la dashboard di Casa Signals
Accedi a Casa Signals e apri la dashboard. Se questo è il primo negozio nell'account, la dashboard mostrerà il modulo Aggiungi dominio.
Inserisci il nome del negozio
Utilizza un nome che il tuo team riconoscerà, ad esempio Negozio di esempio. Questo nome viene utilizzato in tutta la dashboard e può essere visualizzato nelle anteprime SMS quando non è attivo alcun ID mittente approvato.
Inserisci il dominio web
Inserisci il dominio attivo rivolto al cliente, ad esempio example.com. Non includere un percorso di pagamento, un percorso del prodotto, un percorso wp-admin o parametri di monitoraggio.
Utilizza lo stesso dominio utilizzato dai clienti per navigare e acquistare. Se il negozio reindirizza da www a non www o viceversa, utilizza il dominio pubblico finale che desideri che Casa Signals consideri come negozio.
Salva il dominio
Fai clic su Aggiungi dominio. La scheda del sito verrà visualizzata nel dashboard con i collegamenti ad Analisi, Clienti, Prodotti, Trasmissioni, Flussi e Impostazioni.
2. Genera la chiave API del plugin WordPress
Apri le impostazioni del sito
Dalla dashboard di Casa Signals, apri la scheda del sito per il negozio WooCommerce e fai clic su Impostazioni.
Trova il pannello dei plugin WordPress
In Impostazioni, cerca la sezione Connessione denominata WordPress Plugin. Questo pannello mostra se il negozio è connesso, ti consente di generare o rigenerare la chiave API e include il download del plug-in.
Genera la chiave
Fai clic su Genera chiave. Casa Signals crea una nuova chiave API per questo sito. Se una chiave esiste già e si fa clic su Rigenera chiave, la vecchia chiave attiva per quel sito verrà sostituita.
Copia la chiave
Fai clic su Copia e mantieni la chiave pronta per WordPress. Trattalo come una password. Chiunque abbia la chiave può inviare eventi per quel sito Casa Signals.
- La chiave copiata proviene dallo stesso sito Casa Signals del negozio WooCommerce.
- Lo stato del sito mostra Connesso oppure è visibile una chiave API.
- L'utente non ha copiato una chiave da un altro dominio.
3. Scarica e installa il plugin WordPress
Scarica il connettore
Nello stesso pannello dei plugin di WordPress, fai clic su Scarica plugin. Il file si chiama customer-event-sync-casa-signals.zip.
Caricalo su WordPress
In WordPress, vai su Plugin -> Aggiungi nuovo plugin -> Carica plugin. Scegli customer-event-sync-casa-signals.zip, quindi fai clic su Installa ora.
Attiva il plugin
Dopo che WordPress ha installato il plugin, fai clic su Attiva plugin. Il nome del plugin è Customer Event Sync for Casa Signals.
Apri le impostazioni del plugin
Dalla schermata Plugin WordPress, fai clic sul collegamento Impostazioni sotto Customer Event Sync for Casa Signals.
4. Configura il plugin in WordPress
Incolla la chiave API
Nel campo Chiave API, incolla la chiave copiata da Casa Signals. Se una chiave è già salvata, WordPress mostra un segnaposto mascherato in modo che la chiave reale non venga esposta nel modulo delle impostazioni.
Conferma il dominio del sito
In Dominio sito, inserisci lo stesso dominio che è stato salvato in Casa Signals. Questo è il modo in cui gli eventi in arrivo vengono ricollegati al sito corretto.
Abilita il monitoraggio degli eventi
Selezionare Abilita tracciamento eventi. Il plug-in non traccia né invia eventi del cliente finché questa opzione non viene abilitata.
Salva modifiche
Fai clic su Salva modifiche. Da questo momento in poi, il plugin può impostare cookie di sessione e visitatori proprietari, mettere in coda i clienti e memorizzare eventi localmente e inviarli a Casa Signals in background.
- Abilita il monitoraggio degli eventi è selezionato.
- è presente.
- Il dominio del sito corrisponde al sito Casa Signals.
- WooCommerce è attivo.
5. Testare la connessione
Crea un nuovo evento cliente
Apri la vetrina in una finestra del browser privata o in un browser diverso. Visualizza un prodotto, aggiungilo al carrello, visualizza il carrello, quindi avvia il pagamento.
Se possibile, inserisci un indirizzo email e un numero di telefono al momento del pagamento. I flussi SMS dei clienti necessitano di un numero di telefono sull'evento e i flussi di posta elettronica necessitano di un indirizzo di posta elettronica.
Ritorno a Casa Signals
Apri la dashboard del sito in Casa Signals. La nuova attività può apparire nelle analisi, nelle tempistiche dei clienti, nelle analisi dei prodotti e nell'attività del sito in tempo reale.
Attendi la consegna in background
Il plugin mette in coda gli eventi localmente e li invia utilizzando l'elaborazione in background di WordPress. Un breve ritardo è normale, soprattutto se il sito ha poco traffico o WP-Cron viene eseguito solo quando vengono visitate le pagine.
Controlla il pannello di debug di WordPress, se necessario
Se gli eventi non vengono visualizzati, torna alle impostazioni del plugin WordPress, abilita la modalità Debug, salva, esegui un'altra azione della vetrina, quindi controlla la coda di monitoraggio e l'ultima risposta API in background nella pagina delle impostazioni.
6. Opzionale: importare dati storici
Dopo che la connessione live funziona, gli amministratori di WordPress possono aprire Strumenti -> Importazione di Casa Signals per importare i dati del catalogo, dell'utente e dell'ordine esistenti.
Le importazioni sono progettate per essere idempotenti, quindi eseguire nuovamente un'importazione non dovrebbe duplicare gli stessi record cronologici. Gli eventi dell'ordine storico sono contrassegnati come backfill e non attivano flussi di SMS o e-mail.
- Configura prima la chiave API.
- Abilita prima il monitoraggio degli eventi.
- Esegui importazioni di prodotti, utenti e ordini quando il negozio ha abbastanza tempo per elaborarli.
- Non utilizzare lo strumento di importazione come test di eventi dal vivo perché gli eventi importati saltano intenzionalmente le automazioni.
Ciò che Casa Signals inizia a monitorare
Una volta abilitato, il plug-in può monitorare visualizzazioni di prodotti, ricerche di prodotti, visualizzazioni di carrello, eventi di aggiunta al carrello, eventi di rimozione dal carrello, modifiche della quantità del carrello, avvio del pagamento, acquisizione dei contatti di pagamento, aggiornamenti dell'indirizzo di pagamento, metodi di pagamento e spedizione selezionati, inserimento dell'ordine, pagamenti riusciti, pagamenti non riusciti, rimborsi, cancellazioni, attività di coupon, registrazioni di account, accessi, disconnessioni, reimpostazione della password, aggiornamenti dell'account, abbonamenti, invio di moduli, attribuzione e stato del sito.
Casa Signals utilizza questi eventi per analisi, tempistiche dei clienti, reporting sui prodotti, trasmissioni, trigger di flusso, controlli di soppressione e attribuzione di recupero delle entrate.
Migliori pratiche dopo la connessione
- Effettua un vero acquisto di prova o un test di pagamento nella normale modalità di test del gateway di pagamento WooCommerce, se disponibile.
- Mantieni privata la chiave API e rigenerala se è stata condivisa all'esterno del tuo team.
- Controlla Analytics dopo il primo giorno per verificare l'arrivo degli eventi relativi a prodotto, carrello, pagamento e ordine.
- Aggiungi un indirizzo email del dominio principale in Impostazioni prima di utilizzare flussi o trasmissioni email.
- Richiedi un ID mittente SMS se desideri che i messaggi SMS dei clienti mostrino il nome del tuo marchio invece del mittente predefinito.
- Crea un flusso di abbandono del carrello solo dopo che gli eventi di aggiunta al carrello o di pagamento sono visibili.
Risoluzione dei problemi
Nessun evento viene visualizzato in Casa Signals dopo la configurazione.
- Conferma che l'opzione Abilita tracciamento eventi è selezionata in WordPress.
- Conferma che la chiave API sia salvata in WordPress e provenga dal sito Casa Signals corretto.
- Conferma che il campo Dominio sito in WordPress corrisponda al dominio salvato in Casa Signals.
- Visita la vetrina e crea un nuovo evento dopo aver salvato le impostazioni. L'attività cronologica precedente alla configurazione non verrà visualizzata a meno che non venga importata.
- Assicurati che WP-Cron sia in esecuzione. Il connettore invia eventi in coda in batch in background.
Il plugin è installato ma non ci sono dati.
- La sola installazione del plugin non abilita il tracciamento. Apri le impostazioni del plugin dalla schermata Plugin di WordPress, incolla la chiave API, inserisci il dominio del sito, seleziona Abilita il monitoraggio degli eventi e salva.
- Se il negozio utilizza plugin aggressivi per la sicurezza, la memorizzazione nella cache o per la disabilitazione del cron, consenti il cron di WordPress e le richieste HTTPS in uscita verso casasignals.com.
Gli eventi sono in ritardo.
- È previsto un breve ritardo poiché il plug-in accoda gli eventi localmente e invia batch in background.
- Se gli eventi rimangono bloccati, abilita la modalità Debug e controlla il conteggio della coda di tracciamento e l'ultima risposta API in background.
- Se DISABLE_WP_CRON è abilitato, configura un processo cron del server reale per WordPress cron.
Gli eventi vengono visualizzati nel sito sbagliato.
- La chiave API di WordPress probabilmente proviene da un sito Casa Signals diverso oppure il valore del dominio del sito non corrisponde al sito desiderato.
- Genera una nuova chiave dal sito corretto nelle Impostazioni di Casa Signals, incollala in WordPress, conferma il dominio del sito e salva.
I flussi SMS del cliente non vengono inviati dopo la connessione.
- La connessione potrebbe funzionare, ma i flussi SMS del cliente richiedono anche un numero di telefono del cliente sull'evento attivante.
- Controlla che il flusso sia attivo, abbia crediti disponibili e non venga soppresso perché il pagamento è andato a buon fine durante il ritardo.
- Ricorda che un destinatario che ha annullato l'iscrizione agli SMS per il negozio verrà saltato.
L'importazione è stata completata ma nessuna automazione è stata attivata.
- È previsto. Lo strumento di importazione contrassegna gli eventi storici come backfill e Casa Signals salta l'esecuzione del flusso e il contrassegno di ripristino per tali eventi importati.
- Utilizza una nuova azione della vetrina live per testare le automazioni.
FAQ per gli agenti di supporto
Dove trovo la chiave API di Casa Signals?
In Casa Signals, apri lo store, vai su Impostazioni, quindi trova il pannello di connessione del plugin WordPress. Fare clic su Genera chiave o Rigenera chiave, quindi su Copia.
Dove sono le impostazioni del plugin WordPress?
In WordPress, vai su Plugin, trova Customer Event Sync for Casa Signals e fai clic su Impostazioni.
Il plugin invia automaticamente i vecchi ordini?
No. Il connettore live invia nuovi eventi dopo che il monitoraggio è abilitato. Prodotti storici, utenti e ordini possono essere importati da Strumenti -> Importazione Casa Signals.
L'importazione di vecchi ordini attiverà flussi di SMS o email?
No. Gli eventi di importazione sono contrassegnati come backfill. Casa Signals salta l'automazione del flusso e l'attribuzione del recupero per gli eventi recuperati.