Handleiding
Verbind uw WooCommerce-site met Casa Signals
Installeer de Casa Signals WordPress-connector, genereer de API-sleutel van uw site, schakel tracking in en bevestig dat WooCommerce-evenementen uw dashboard bereiken.
Voordat je begint
- Een Casa Signals-account.
- Een WooCommerce-winkel waar u zich kunt aanmelden als WordPress-beheerder.
Wat je hebt wanneer je klaar bent
- Er bestaat een WordPress Plugin-verbinding in Casa Signals voor de juiste site.
- De Casa Signals API-sleutel wordt opgeslagen in WordPress.
- Het bijhouden van gebeurtenissen is ingeschakeld in de WordPress-plug-in.
- Nieuwe WooCommerce-evenementen verschijnen in de analyses van Casa Signals, klanttijdlijnen, productrapporten en stroomtriggers.
- Optionele historische producten, gebruikers en bestellingen kunnen worden geïmporteerd zonder live automatiseringen te activeren.
Hoe de verbinding werkt
Casa Signals maakt verbinding met WooCommerce via de WordPress-plug-in Customer Event Sync for Casa Signals. De plug-in houdt belangrijke WordPress- en WooCommerce-activiteiten bij, zet de gebeurtenissen in WordPress in de wachtrij en stuurt ze in achtergrondbatches naar Casa Signals.
De verbinding wordt geverifieerd met een sitespecifieke API-sleutel. Elke Casa Signals-site heeft zijn eigen sleutel, dus de sleutel moet afkomstig zijn van hetzelfde siterecord als het WooCommerce-domein dat u verbindt.
Bijhouden is opt-in. Het installeren van de plug-in op zichzelf is niet voldoende. De API-sleutel moet worden opgeslagen, het sitedomein moet correct zijn en Gebeurtenistracking inschakelen moet zijn ingeschakeld.
- Casa Signals-site bestaat.
- WordPress-plug-in is geïnstalleerd en actief.
- API-sleutel is in de plug-in geplakt.
- Gebeurtenistracking is ingeschakeld.
- Recente activiteit verschijnt in Casa Signals.
1. Voeg de WooCommerce-site toe aan Casa Signals
Open het Casa Signals-dashboard
Log in bij Casa Signals en open het dashboard. Als dit de eerste winkel in het account is, toont het dashboard het formulier Domein toevoegen.
Voer de winkelnaam in
Gebruik een naam die uw team herkent, bijvoorbeeld Voorbeeldwinkel. Deze naam wordt overal in het dashboard gebruikt en kan in SMS-voorbeelden verschijnen als er geen goedgekeurde afzender-ID actief is.
Voer het webdomein in
Voer het live klantgerichte domein in, bijvoorbeeld example.com. Voeg geen afrekenpad, productpad, wp-admin-pad of trackingparameters toe.
Gebruik hetzelfde domein dat klanten gebruiken om te browsen en te kopen. Als de winkel omleidt van www naar niet-www, of andersom, gebruik dan het uiteindelijke publieke domein dat Casa Signals als de winkel wil behandelen.
Sla het domein op
Klik op Domein toevoegen. De sitekaart verschijnt in het dashboard met links voor Analytics, Klanten, Producten, Uitzendingen, Stromen en Instellingen.
2. Genereer de API-sleutel voor de WordPress-plug-in
Open de site-instellingen
Open vanuit het Casa Signals-dashboard de sitekaart voor de WooCommerce-winkel en klik op Instellingen.
Zoek het WordPress Plugin-paneel
Zoek in Instellingen naar het gedeelte Verbinding met de naam WordPress Plugin. Dit paneel laat zien of de winkel is verbonden, laat u de API-sleutel genereren of opnieuw genereren en bevat het downloaden van de plug-in.
Genereer de sleutel
Klik op Sleutel genereren. Casa Signals maakt een nieuwe API-sleutel voor deze site. Als er al een sleutel bestaat en u op Sleutel opnieuw genereren klikt, wordt de oude actieve sleutel voor die site vervangen.
Kopieer de sleutel
Klik op Kopiëren en houd de sleutel gereed voor WordPress. Behandel het als een wachtwoord. Iedereen met de sleutel kan evenementen indienen voor die Casa Signals-site.
- De gekopieerde sleutel kwam van dezelfde Casa Signals-site als de WooCommerce-winkel.
- De sitestatus geeft Verbonden weer of er is een API-sleutel zichtbaar.
- De gebruiker heeft geen sleutel uit een ander domein gekopieerd.
3. Download en installeer de WordPress-plug-in
Download de connector
Klik in hetzelfde WordPress Plugin-paneel op Plugin downloaden. Het bestand heet customer-event-sync-casa-signals.zip.
Upload het naar WordPress
Ga in WordPress naar Plug-ins -> Nieuwe plug-in toevoegen -> Plug-in uploaden. Kies customer-event-sync-casa-signals.zip en klik vervolgens op Nu installeren.
Activeer de plug-in
Nadat WordPress de plug-in heeft geïnstalleerd, klikt u op Plug-in activeren. De naam van de plug-in is Customer Event Sync for Casa Signals.
Open de plug-ininstellingen
Klik in het scherm WordPress-plug-ins op de link Instellingen onder Customer Event Sync for Casa Signals.
4. Configureer de plug-in in WordPress
Plak de API-sleutel
Plak in het veld API-sleutel de sleutel die is gekopieerd uit Casa Signals. Als er al een sleutel is opgeslagen, toont WordPress een gemaskeerde tijdelijke aanduiding, zodat de echte sleutel niet zichtbaar is in het instellingenformulier.
Bevestig het sitedomein
Voer bij Sitedomein hetzelfde domein in dat is opgeslagen in Casa Signals. Zo worden inkomende evenementen teruggelinkt naar de juiste site.
Schakel het volgen van gebeurtenissen in
Vink Gebeurtenistracking inschakelen aan. De plug-in volgt of verzendt geen klantgebeurtenissen totdat deze optie is ingeschakeld.
Wijzigingen opslaan
Klik op Wijzigingen opslaan. Vanaf dit punt kan de plug-in first-party bezoekers- en sessiecookies instellen, klant- en winkelevenementen lokaal in de wachtrij plaatsen en deze op de achtergrond naar Casa Signals sturen.
- Gebeurtenistracking inschakelen is aangevinkt.
- API-sleutel is aanwezig.
- Sitedomein komt overeen met de Casa Signals-site.
- WooCommerce is actief.
5. Test de verbinding
Creëer een nieuw klantevenement
Open de winkel in een privébrowservenster of een andere browser. Bekijk een product, voeg het toe aan de winkelwagen, bekijk de winkelwagen en start vervolgens met afrekenen.
Voer indien mogelijk een e-mailadres en telefoonnummer in bij het afrekenen. Sms-stromen van klanten hebben een telefoonnummer voor de gebeurtenis nodig, en e-mailstromen hebben een e-mailadres nodig.
Terug naar Casa Signalsn
Open het sitedashboard in Casa Signals. Nieuwe activiteit kan verschijnen in analyses, klanttijdlijnen, productanalyses en live site-activiteit.
Wacht op levering op de achtergrond
De plug-in plaatst gebeurtenissen lokaal in de wachtrij en verzendt deze met behulp van WordPress-achtergrondverwerking. Een korte vertraging is normaal, vooral als de site weinig verkeer heeft of als WP-Cron alleen draait wanneer pagina's worden bezocht.
Controleer indien nodig het WordPress-foutopsporingspaneel
Als gebeurtenissen niet verschijnen, ga dan terug naar de instellingen van de WordPress-plug-in, schakel de foutopsporingsmodus in, sla op, voer nog een storefront-actie uit en inspecteer vervolgens de trackingwachtrij en de laatste achtergrond-API-reactie op de instellingenpagina.
6. Optioneel: historische gegevens importeren
Nadat de liveverbinding werkt, kunnen WordPress-beheerders Extra -> Casa Signals Import openen om bestaande catalogus-, gebruikers- en bestelgegevens te importeren.
Importeren is ontworpen om idempotent te zijn, dus het opnieuw uitvoeren van een import mag niet dezelfde historische records dupliceren. Historische ordergebeurtenissen worden gemarkeerd als aanvulling en activeren geen sms- of e-mailstromen.
- Configureer eerst de API-sleutel.
- Schakel eerst het bijhouden van gebeurtenissen in.
- Importeer producten, gebruikers en bestellingen wanneer de winkel voldoende tijd heeft om ze te verwerken.
- Gebruik de importtool niet als test voor live-evenementen, omdat geïmporteerde evenementen opzettelijk automatiseringen overslaan.
Wat Casa Signals begint te volgen
Eenmaal ingeschakeld, kan de plug-in productweergaven, productzoekopdrachten, winkelwagenweergaven, gebeurtenissen in het winkelwagentje, gebeurtenissen uit het winkelwagentje verwijderen, wijzigingen in het aantal winkelwagentjes, het begin van het afrekenen, het vastleggen van afrekencontacten, updates van het afrekenadres, geselecteerde betalings- en verzendmethoden, het plaatsen van bestellingen, succesvolle betalingen, mislukte betalingen, terugbetalingen, annuleringen, couponactiviteit, accountregistraties, logins, uitlogingen, wachtwoordresets, accountupdates, abonnementen, formulierinzendingen, attributie en sitestatus volgen.
Casa Signals gebruikt deze gebeurtenissen voor analyses, klanttijdlijnen, productrapportage, uitzendingen, stroomtriggers, onderdrukkingscontroles en toekenning van inkomstenherstel.
Beste praktijken na verbinding
- Maak een echte testaankoop of betalingstest in uw normale WooCommerce-betalingsgateway-testmodus, indien beschikbaar.
- Houd de API-sleutel privé en genereer deze opnieuw als deze buiten uw team is gedeeld.
- Controleer Analytics na de eerste dag om te bevestigen dat er product-, winkelwagen-, afreken- en bestelgebeurtenissen aankomen.
- Voeg een e-mailadres van het hoofddomein toe in Instellingen voordat u e-mailstromen of uitzendingen gebruikt.
- Vraag een sms-afzender-ID aan als u wilt dat sms-berichten van klanten uw merknaam weergeven in plaats van de standaardafzender.
- Creëer alleen een stroom voor het verlaten van een winkelwagentje nadat de gebeurtenissen voor toevoegen aan winkelwagentje of afrekenen zichtbaar zijn.
Probleemoplossing
Er verschijnen geen evenementen in Casa Signals na het instellen.
- Bevestigen dat het bijhouden van gebeurtenissen is ingeschakeld in WordPress.
- Bevestig dat de API-sleutel is opgeslagen in WordPress en afkomstig is van de juiste Casa Signals-site.
- Bevestig dat het veld Sitedomein in WordPress overeenkomt met het domein dat is opgeslagen in Casa Signals.
- Bezoek de winkel en maak een nieuw evenement aan nadat je de instellingen hebt opgeslagen. Historische activiteiten van vóór de installatie worden alleen weergegeven als ze worden geïmporteerd.
- Zorg ervoor dat WP-Cron actief is. De connector verzendt gebeurtenissen in de wachtrij in achtergrondbatches.
De plug-in is geïnstalleerd, maar er zijn geen gegevens.
- Het installeren van de plug-in alleen maakt tracking niet mogelijk. Open de plugin-instellingen vanuit het WordPress Plugins-scherm, plak de API-sleutel, voer het sitedomein in, vink Gebeurtenistracking inschakelen aan en sla op.
- Als de winkel agressieve beveiliging, caching of cron-uitschakelende plug-ins gebruikt, sta dan WordPress cron- en uitgaande HTTPS-verzoeken aan casasignals.com toe.
Evenementen zijn vertraagd.
- Er wordt een korte vertraging verwacht omdat de plug-in gebeurtenissen lokaal in de wachtrij plaatst en achtergrondbatches verzendt.
- Als gebeurtenissen vast blijven zitten, schakelt u de foutopsporingsmodus in en controleert u het aantal trackingwachtrijen en de laatste achtergrond-API-reactie.
- Als DISABLE_WP_CRON is ingeschakeld, configureer dan een echte server-cron-taak voor WordPress cron.
Evenementen worden op de verkeerde site weergegeven.
- De WordPress API-sleutel is waarschijnlijk afkomstig van een andere Casa Signals-site, of de sitedomeinwaarde komt niet overeen met de bedoelde site.
- Genereer een nieuwe sleutel van de juiste site in Casa Signals-instellingen, plak deze in WordPress, bevestig het sitedomein en sla op.
Klant-sms-stromen worden niet verzonden na verbinding.
- De verbinding werkt mogelijk, maar sms-stromen van klanten vereisen ook een telefoonnummer van de klant bij de triggerende gebeurtenis.
- Controleer of de stroom actief is, er tegoeden beschikbaar zijn en niet wordt onderdrukt omdat de betaling is gelukt tijdens de vertraging.
- Houd er rekening mee dat een ontvanger die zich heeft afgemeld voor sms voor de winkel, wordt overgeslagen.
De import is voltooid, maar er zijn geen automatiseringen geactiveerd.
- Dat wordt verwacht. De importtool markeert historische gebeurtenissen als aanvulling, en Casa Signals slaat de stroomuitvoering en herstelmarkering voor die geïmporteerde gebeurtenissen over.
- Gebruik een nieuwe live storefront-actie om automatiseringen te testen.
FAQ voor supportmedewerkers
Waar vind ik de Casa Signals API-sleutel?
Open in Casa Signals de winkel, ga naar Instellingen en zoek vervolgens het WordPress Plugin-verbindingspaneel. Klik op Sleutel genereren of Sleutel opnieuw genereren en vervolgens op Kopiëren.
Waar zijn de instellingen van de WordPress-plug-in?
Ga in WordPress naar Plug-ins, zoek Customer Event Sync for Casa Signals en klik op Instellingen.
Verstuurt de plug-in automatisch oude bestellingen?
Nee. De live connector verzendt nieuwe gebeurtenissen nadat tracking is ingeschakeld. Historische producten, gebruikers en bestellingen kunnen worden geïmporteerd via Tools -> Casa Signals Import.
Zal het importeren van oude bestellingen sms- of e-mailstromen activeren?
Nee. Importgebeurtenissen worden gemarkeerd als aanvulling. Casa Signals slaat stroomautomatisering en hersteltoeschrijving voor aangevulde gebeurtenissen over.