Anleitung

Verbinden Sie Ihre WooCommerce-Site mit Casa Signals

Installieren Sie den WordPress-Connector von Casa Signals, generieren Sie den API-Schlüssel Ihrer Website, aktivieren Sie das Tracking und bestätigen Sie, dass WooCommerce-Ereignisse Ihr Dashboard erreichen.

10 bis 20 MinutenAktualisiert WooCommerce-Shop-Besitzer, WordPress-Administratoren und Support-Mitarbeiter helfen einem Kunden, seinen Shop zu verbinden.

Bevor Sie beginnen

  • Ein Casa Signals-Konto.
  • Ein WooCommerce-Shop, in dem Sie sich als WordPress-Administrator anmelden können.

Was Sie am Ende haben

  • In Casa Signals ist eine WordPress-Plugin-Verbindung für die richtige Site vorhanden.
  • Der Casa Signals API-Schlüssel wird in WordPress gespeichert.
  • Die Ereignisverfolgung ist im WordPress-Plugin aktiviert.
  • Neue WooCommerce-Ereignisse erscheinen in den Analysen, Kundenzeitplänen, Produktberichten und Flow-Triggern von Casa Signals.
  • Optionale historische Produkte, Benutzer und Bestellungen können importiert werden, ohne Live-Automatisierungen auszulösen.

So funktioniert die Verbindung

Casa Signals stellt über das WordPress-Plugin „Customer Event Sync for Casa Signals“ eine Verbindung zu WooCommerce her. Das Plugin verfolgt wichtige WordPress- und WooCommerce-Aktivitäten, stellt die Ereignisse in WordPress in die Warteschlange und sendet sie in Hintergrundstapeln an Casa Signals.

Die Verbindung wird mit einem standortspezifischen API-Schlüssel authentifiziert. Jede Casa Signals-Site hat ihren eigenen Schlüssel, daher muss der Schlüssel aus demselben Site-Datensatz stammen wie die WooCommerce-Domain, die Sie verbinden.

Tracking ist Opt-in. Die Installation des Plugins allein reicht nicht aus. Der API-Schlüssel muss gespeichert sein, die Site-Domain muss korrekt sein und „Ereignisverfolgung aktivieren“ muss aktiviert sein.

  • Casa Signals-Site existiert.
  • Das WordPress-Plugin ist installiert und aktiv.
  • API-Schlüssel wird in das Plugin eingefügt.
  • Die Ereignisverfolgung ist aktiviert.
  • Aktuelle Aktivität erscheint in Casa Signals.

1. Fügen Sie die WooCommerce-Site in Casa Signals hinzu

  1. Öffnen Sie das Casa Signals-Dashboard

    Melden Sie sich bei Casa Signals an und öffnen Sie das Dashboard. Wenn dies der erste Shop für das Konto ist, zeigt das Dashboard das Formular „Domäne hinzufügen“ an.

  2. Geben Sie den Geschäftsnamen ein

    Verwenden Sie einen Namen, den Ihr Team erkennt, zum Beispiel Beispielgeschäft. Dieser Name wird im gesamten Dashboard verwendet und kann in SMS-Vorschauen angezeigt werden, wenn keine genehmigte Absender-ID aktiv ist.

  3. Geben Sie die Webdomäne ein

    Geben Sie die kundenorientierte Live-Domain ein, zum Beispiel example.com. Geben Sie keinen Checkout-Pfad, Produktpfad, wp-admin-Pfad oder Tracking-Parameter an.

    Verwenden Sie dieselbe Domain, die Kunden zum Stöbern und Kaufen verwenden. Wenn der Shop von „www“ auf „nicht www“ umleitet oder umgekehrt, verwenden Sie die endgültige öffentliche Domain, die Casa Signals als Shop behandeln soll.

  4. Speichern Sie die Domäne

    Klicken Sie auf Domäne hinzufügen. Die Site-Karte wird im Dashboard mit Links für Analytics, Kunden, Produkte, Broadcasts, Flows und Einstellungen angezeigt.

2. Generieren Sie den WordPress-Plugin-API-Schlüssel

  1. Öffnen Sie die Site-Einstellungen

    Öffnen Sie im Casa Signals-Dashboard die Site-Karte für den WooCommerce-Shop und klicken Sie auf Einstellungen.

  2. Suchen Sie das WordPress-Plugin-Panel

    Suchen Sie in den Einstellungen nach dem Abschnitt „Verbindung“ mit dem Namen „WordPress Plugin“. In diesem Bereich wird angezeigt, ob der Store verbunden ist, Sie können den API-Schlüssel generieren oder neu generieren und der Plugin-Download wird angezeigt.

  3. Generieren Sie den Schlüssel

    Klicken Sie auf Schlüssel generieren. Casa Signals erstellt einen neuen API-Schlüssel für diese Site. Wenn bereits ein Schlüssel vorhanden ist und Sie auf Schlüssel neu generieren klicken, wird der alte aktive Schlüssel für diese Site ersetzt.

  4. Kopieren Sie den Schlüssel

    Klicken Sie auf „Kopieren“ und halten Sie den Schlüssel für WordPress bereit. Behandeln Sie es wie ein Passwort. Jeder mit dem Schlüssel kann Ereignisse für diese Casa Signals-Site einreichen.

    • Der kopierte Schlüssel stammte von derselben Casa Signals-Site wie der WooCommerce-Shop.
    • Der Site-Status zeigt „Verbunden“ oder ein API-Schlüssel ist sichtbar.
    • Der Benutzer hat keinen Schlüssel von einer anderen Domäne kopiert.

3. Laden Sie das WordPress-Plugin herunter und installieren Sie es

  1. Laden Sie den Connector herunter

    Klicken Sie im selben WordPress-Plugin-Bereich auf Plugin herunterladen. Die Datei heißt customer-event-sync-casa-signals.zip.

  2. Laden Sie es auf WordPress hoch

    Gehen Sie in WordPress zu Plugins -> Neues Plugin hinzufügen -> Plugin hochladen. Wählen Sie customer-event-sync-casa-signals.zip und klicken Sie dann auf Jetzt installieren.

  3. Aktivieren Sie das Plugin

    Nachdem WordPress das Plugin installiert hat, klicken Sie auf Plugin aktivieren. Der Plugin-Name ist Customer Event Sync for Casa Signals.

  4. Öffnen Sie die Plugin-Einstellungen

    Klicken Sie im Bildschirm „WordPress-Plugins“ auf den Link „Einstellungen“ unter „Kundenereignissynchronisierung für Casa Signals“.

4. Konfigurieren Sie das Plugin in WordPress

  1. Fügen Sie den API-Schlüssel ein

    Fügen Sie im Feld API-Schlüssel den von Casa Signals kopierten Schlüssel ein. Wenn ein Schlüssel bereits gespeichert ist, zeigt WordPress einen maskierten Platzhalter an, sodass der echte Schlüssel nicht im Einstellungsformular angezeigt wird.

  2. Bestätigen Sie die Site-Domain

    Geben Sie unter Site-Domäne dieselbe Domäne ein, die in Casa Signals gespeichert wurde. Auf diese Weise werden eingehende Ereignisse mit der richtigen Site verknüpft.

  3. Ereignisverfolgung aktivieren

    Markieren Sie „Ereignisverfolgung aktivieren“. Das Plugin verfolgt oder sendet keine Kundenereignisse, bis diese Option aktiviert ist.

  4. Änderungen speichern

    Klicken Sie auf „Änderungen speichern“. Ab diesem Zeitpunkt kann das Plugin First-Party-Besucher- und Sitzungscookies setzen, Kunden- und Store-Events lokal in die Warteschlange stellen und diese im Hintergrund an Casa Signals senden.

    • Ereignisverfolgung aktivieren ist aktiviert.
    • API-Schlüssel ist vorhanden.
    • Site-Domain stimmt mit der Casa Signals-Site überein.
    • WooCommerce ist aktiv.

5. Testen Sie die Verbindung

  1. Erstellen Sie ein neues Kundenevent

    Öffnen Sie die Storefront in einem privaten Browserfenster oder einem anderen Browser. Sehen Sie sich ein Produkt an, legen Sie es in den Warenkorb, sehen Sie sich den Warenkorb an und starten Sie dann den Checkout.

    Geben Sie beim Bezahlvorgang nach Möglichkeit eine E-Mail-Adresse und eine Telefonnummer ein. Kunden-SMS-Flows benötigen eine Telefonnummer für die Veranstaltung und E-Mail-Flows benötigen eine E-Mail-Adresse.

  2. Rückkehr zu Casa Signals

    Öffnen Sie das Site-Dashboard in Casa Signals. Neue Aktivitäten können in Analysen, Kundenzeitplänen, Produktanalysen und Live-Site-Aktivitäten erscheinen.

  3. Warten Sie auf die Hintergrundzustellung

    Das Plugin stellt Ereignisse lokal in die Warteschlange und sendet sie mithilfe der WordPress-Hintergrundverarbeitung. Eine kurze Verzögerung ist normal, insbesondere wenn die Website wenig Verkehr hat oder WP-Cron nur ausgeführt wird, wenn Seiten besucht werden.

  4. Überprüfen Sie bei Bedarf das WordPress-Debug-Panel

    Wenn keine Ereignisse angezeigt werden, kehren Sie zu den WordPress-Plugin-Einstellungen zurück, aktivieren Sie den Debug-Modus, speichern Sie, führen Sie eine weitere Storefront-Aktion aus und überprüfen Sie dann die Tracking-Warteschlange und die letzte Hintergrund-API-Antwort auf der Einstellungsseite.

6. Optional: Historische Daten importieren

Nachdem die Live-Verbindung funktioniert, können WordPress-Administratoren Tools -> Casa Signals Import öffnen, um vorhandene Katalog-, Benutzer- und Bestelldaten zu importieren.

Importe sind idempotent konzipiert, daher sollten beim erneuten Ausführen eines Imports nicht dieselben historischen Datensätze dupliziert werden. Historische Bestellereignisse werden als Backfill markiert und lösen keine SMS- oder E-Mail-Verläufe aus.

  • Konfigurieren Sie zuerst den API-Schlüssel.
  • Aktivieren Sie zuerst die Ereignisverfolgung.
  • Führen Sie Produkt-, Benutzer- und Bestellimporte durch, wenn das Geschäft genügend Zeit hat, sie zu verarbeiten.
  • Verwenden Sie das Importtool nicht als Live-Event-Test, da importierte Events absichtlich Automatisierungen überspringen.

Was Casa Signals mit der Verfolgung beginnt

Sobald das Plugin aktiviert ist, kann es Produktansichten, Produktsuchen, Warenkorbansichten, Ereignisse zum Hinzufügen zum Warenkorb, Ereignisse zum Entfernen aus dem Warenkorb, Änderungen der Warenkorbmenge, Checkout-Starts, Checkout-Kontakterfassung, Checkout-Adressaktualisierungen, ausgewählte Zahlungs- und Versandmethoden, Auftragserteilung, erfolgreiche Zahlungen, fehlgeschlagene Zahlungen, Rückerstattungen, Stornierungen, Couponaktivitäten, Kontoregistrierungen, Anmeldungen, Abmeldungen, Passwort-Resets, Kontoaktualisierungen, Abonnements, Formularübermittlungen, Zuordnung und Website-Zustand verfolgen.

Casa Signals nutzt diese Ereignisse für Analysen, Kundenzeitpläne, Produktberichte, Sendungen, Flow-Trigger, Unterdrückungsprüfungen und Umsatzrückgewinnungszuordnung.

Best Practices nach dem Herstellen der Verbindung

  • Führen Sie einen echten Testkauf oder Zahlungstest in Ihrem normalen WooCommerce-Zahlungsgateway-Testmodus durch, sofern verfügbar.
  • Halten Sie den API-Schlüssel privat und generieren Sie ihn neu, wenn er außerhalb Ihres Teams geteilt wurde.
  • Überprüfen Sie Analytics nach dem ersten Tag, um zu bestätigen, dass Produkt-, Warenkorb-, Checkout- und Bestellereignisse eintreffen.
  • Fügen Sie in den Einstellungen eine E-Mail-Adresse der Hauptdomäne hinzu, bevor Sie E-Mail-Flows oder Broadcasts verwenden.
  • Fordern Sie eine SMS-Absender-ID an, wenn Sie möchten, dass Kunden-SMS-Nachrichten Ihren Markennamen anstelle des Standardabsenders anzeigen.
  • Erstellen Sie einen Ablauf zum Abbruch des Einkaufswagens nur, nachdem Add-to-Cart- oder Checkout-Ereignisse sichtbar sind.

Fehlerbehebung

Nach der Einrichtung werden in Casa Signals keine Ereignisse angezeigt.

  • Bestätigen Sie, dass „Ereignisverfolgung aktivieren“ in WordPress aktiviert ist.
  • Bestätigen Sie, dass der API-Schlüssel in WordPress gespeichert ist und von der richtigen Casa Signals-Site stammt.
  • Bestätigen Sie, dass das Feld „Site-Domain“ in WordPress mit der in Casa Signals gespeicherten Domain übereinstimmt.
  • Besuchen Sie die Storefront und erstellen Sie nach dem Speichern der Einstellungen ein neues Event. Historische Aktivitäten vor der Einrichtung werden nur angezeigt, wenn sie importiert werden.
  • Stellen Sie sicher, dass WP-Cron ausgeführt wird. Der Connector sendet Ereignisse in der Warteschlange in Hintergrundstapeln.

Das Plugin ist installiert, aber es sind keine Daten vorhanden.

  • Durch die Installation des Plugins allein ist kein Tracking möglich. Öffnen Sie die Plugin-Einstellungen im WordPress-Plugin-Bildschirm, fügen Sie den API-Schlüssel ein, geben Sie die Site-Domain ein, markieren Sie Ereignisverfolgung aktivieren und speichern Sie.
  • Wenn der Shop aggressive Sicherheits-, Caching- oder Cron-deaktivierende Plugins verwendet, lassen Sie WordPress-Cron- und ausgehende HTTPS-Anfragen an casasignals.com zu.

Ereignisse sind verzögert.

  • Eine kurze Verzögerung wird erwartet, da das Plugin Ereignisse lokal in die Warteschlange stellt und Hintergrundstapel sendet.
  • Wenn Ereignisse weiterhin hängen bleiben, aktivieren Sie den Debug-Modus und überprüfen Sie die Anzahl der Tracking-Warteschlangen und die letzte Hintergrund-API-Antwort.
  • Wenn DISABLE_WP_CRON aktiviert ist, konfigurieren Sie einen echten Server-Cron-Job für WordPress-Cron.

Ereignisse werden auf der falschen Website angezeigt.

  • Der WordPress-API-Schlüssel stammt wahrscheinlich von einer anderen Casa Signals-Site, oder der Site-Domain-Wert stimmt nicht mit der beabsichtigten Site überein.
  • Generieren Sie in den Casa Signals-Einstellungen einen neuen Schlüssel von der richtigen Site, fügen Sie ihn in WordPress ein, bestätigen Sie die Site-Domain und speichern Sie.

Kunden-SMS-Flüsse werden nach der Verbindung nicht gesendet.

  • Die Verbindung funktioniert möglicherweise, aber Kunden-SMS-Flows erfordern beim auslösenden Ereignis auch eine Kundentelefonnummer.
  • Überprüfen Sie, ob der Fluss aktiv ist, über Guthaben verfügt und nicht unterdrückt wird, weil die Zahlung während der Verzögerung erfolgreich war.
  • Denken Sie daran, dass ein Empfänger, der sich von der SMS für den Shop abgemeldet hat, übersprungen wird.

Der Import wurde abgeschlossen, aber es wurden keine Automatisierungen ausgelöst.

  • Das wird erwartet. Das Importtool markiert historische Ereignisse als Backfill und Casa Signals überspringt die Flow-Ausführungs- und Wiederherstellungsmarkierung für diese importierten Ereignisse.
  • Verwenden Sie eine neue Live-Storefront-Aktion, um Automatisierungen zu testen.

FAQ für Supportmitarbeiter

Wo finde ich den Casa Signals API-Schlüssel?

Öffnen Sie in Casa Signals den Store, gehen Sie zu Einstellungen und suchen Sie dann das WordPress-Plugin-Verbindungsfeld. Klicken Sie auf Schlüssel generieren oder Schlüssel neu generieren und dann auf Kopieren.

Wo sind die WordPress-Plugin-Einstellungen?

Gehen Sie in WordPress zu „Plugins“, suchen Sie nach „Customer Event Sync for Casa Signals“ und klicken Sie auf „Einstellungen“.

Versendet das Plugin alte Bestellungen automatisch?

Nein. Der Live-Connector sendet neue Ereignisse, nachdem die Nachverfolgung aktiviert wurde. Historische Produkte, Benutzer und Bestellungen können über Extras -> Casa Signals Import importiert werden.

Wird der Import alter Bestellungen SMS- oder E-Mail-Verläufe auslösen?

Nein. Importereignisse werden als Backfill markiert. Casa Signals überspringt die Flussautomatisierung und Wiederherstellungszuordnung für Backfill-Ereignisse.