WooCommerce verbinden und jede Bestellung mit ihrem Besuch verknüpfen

01Mit einem Klick verbinden

1. 1

   Öffne auf der Seite Integrations deiner Website WooCommerce. Gib unter Connect in one click die Adresse deines Shops ein und klicke auf Approve in WooCommerce.

2. 2

   Tally zeigt, was es bekommt: Es liest deine Bestellungen und Erstattungen, legt zwei Webhooks an und ändert nie eine Bestellung. Klicke auf Continue to WooCommerce.

3. 3

   WooCommerce öffnet sich in deinem Shop und zeigt Tally would like to connect to your store. Melde dich an, falls es fragt (als Administrator oder Shop-Manager), und klicke auf Approve.

4. 4

   Du bist zurück auf Integrations: WooCommerce is connected, und die letzten 365 Tage werden importiert.

Mit dem WordPress-Plugin in deinem Shop startet seine Schaltfläche Connect WooCommerce to Tally dieselbe Freigabe.

02Oder per REST-API-Schlüssel verbinden

1. 1

   Einen REST-API-Schlüssel in WooCommerce erstellen

   Tally liest nur deine Bestellungen und Erstattungen; das Einzige, was es schreibt, sind seine eigenen zwei Webhooks. Öffne in deinem WordPress-Admin WooCommerce › Settings › Advanced › REST API und wähle „Add key“: Wähle deinen Benutzer, setze „Permissions“ auf „Read/Write“ und erstelle den Schlüssel (Anleitung von WooCommerce). Mehr tut Tally damit nicht:

   Berechtigung	Zugriff	Wozu
   Orders	Lesen	Jede bezahlte Bestellung: Betrag und Steuer sowie die E-Mail des Kunden (sofort gehasht, nie gespeichert). Namen und Adressen werden nie gespeichert.
   Refunds	Lesen	Wann jede Erstattung erfolgte und wie viel Steuer sie zurückgab.
   Webhooks	Schreiben	Tally legt seine eigenen zwei Webhooks an (Bestellung erstellt, Bestellung aktualisiert), damit Verkäufe binnen Sekunden ankommen. Sonst schreibt es nichts.

   „Read/Write“ dient nur dem Anlegen der Webhooks: Tally ändert nie eine Bestellung. Widerrufe den Schlüssel jederzeit an derselben Stelle.

2. 2

   Den REST-API-Schlüssel einfügen

   Öffne auf der Seite Integrations deiner Website (oder im Schritt Payments, wenn du eine Website hinzufügst) WooCommerce und fülle aus:

   • Store address: So, wie sie im Browser steht. WooCommerce nimmt Schlüssel nur über HTTPS an.
   • Consumer key: Wird einmal angezeigt, zusammen mit dem Secret, wenn der Schlüssel erstellt wird. Tally speichert beide verschlüsselt und zeigt sie nie wieder an.
   • Consumer secret: Es beginnt mit cs_.

   Klicke dann auf Connect WooCommerce.

3. 3

   Tally prüft den Zugang und importiert das letzte Jahr

   Der Schlüssel wird an deinem Shop geprüft, zwei eigene Webhooks kommen hinzu, damit neue Bestellungen sofort ankommen, und die letzten 365 Tage werden importiert, Erstattungen inklusive. Alle 30 Minuten werden außerdem die geänderten Bestellungen gelesen, sodass keine Zustellung verloren geht, die WooCommerce nicht ausführen konnte. Mit dem Snippet von Tally im Shop verknüpft die Seite „Bestellung erhalten“ jede Bestellung mit dem Besuch ihres Käufers.

03Was Tally liest und speichert

• Zwei Webhooks, order.created und order.updated (der auch bei Erstattungen auslöst), bringen neue Bestellungen binnen Sekunden. Alle 30 Minuten liest Tally außerdem die geänderten Bestellungen und schaltet einen deaktivierten Webhook wieder ein: WooCommerce wiederholt nie eine Zustellung und deaktiviert einen Webhook nach fünf Fehlschlägen in Folge.
• Eine Bestellung ist ein Verkauf, sobald sie bezahlt ist: in Bearbeitung, abgeschlossen, erstattet oder mit Zahlungsdatum. Ausstehende, zurückgestellte und fehlgeschlagene Bestellungen sind keine Verkäufe. Ihr Betrag ist der Gesamtbetrag ohne Steuer, in der Währung der Bestellung; jede Erstattung zählt zu ihrem eigenen Zeitpunkt.
• Was von einer Bestellung gespeichert wird: Beträge, Daten, Status, die IDs der Erstattungen, die Besucher-ID und Hashes des Bestellschlüssels und der Rechnungs-E-Mail. Namen, Adressen, Telefonnummern, IP-Adressen und Bestellpositionen werden nie gespeichert.
• Verlängerungsbestellungen aus WooCommerce Subscriptions sind Bestellungen wie alle anderen: Jede ist ein Verkauf, verknüpft über ihren eigenen Nachweis.

04Jede Bestellung mit ihrem Besuch verknüpfen

Setze das Snippet auf jede Seite des Shops, auch auf die Seite „Bestellung erhalten“ (im Header deines Themes oder über ein Plugin, das Code in den Head jeder Seite einfügt). Wenn ein Käufer auf dieser Seite landet, wird die Bestellung mit seinem Besuch verknüpft, ohne dass du WooCommerce etwas hinzufügen musst. Das funktioniert in jedem Modus, auch ohne Cookies.

<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

Für Käufer, die diese Seite nie erreichen (ein Gateway, das sie nicht zurückschickt), speichere die Besucher-ID beim Checkout an der Bestellung. Diese Zeilen funktionieren im klassischen wie im Block-Checkout:

// Your theme's functions.php, or a code snippets plugin: saves the visitor's id on the
// order at checkout, for buyers who never reach the order-received page.
function tally_save_visitor_id( $order ) {
    $id = isset( $_COOKIE['_tally_vid'] ) ? $_COOKIE['_tally_vid'] : '';
    if ( preg_match( '/^[A-Za-z0-9_-]{8,64}$/', $id ) ) {
        $order->update_meta_data( 'tally_visitor_id', $id );
    }
}
add_action( 'woocommerce_checkout_create_order', 'tally_save_visitor_id' );
add_action( 'woocommerce_store_api_checkout_update_order_meta', 'tally_save_visitor_id' );

05Verbindung trennen

Trenne die Verbindung auf der Seite Integrations: Tally entfernt seine Webhooks aus dem Shop, und die bereits importierten Bestellungen bleiben, mit ihren Belegen. Den REST-API-Schlüssel selbst kann es nicht löschen, widerrufe ihn also unter WooCommerce › Settings › Advanced › REST API.

06Prüfen, ob es geklappt hat

07Was nicht gelesen wird