Squarespace-Bestellungen und Erstattungen, jeweils mit dem Besuch des Käufers verknüpft.

01Was Tally liest

• Jede bezahlte Bestellung mit dem Datum, an dem sie aufgegeben wurde, gezählt als Gesamtsumme abzüglich Steuer: Versand bleibt drin, Rabatte sind schon abgezogen, und der Betrag wird centgenau in der Währung des Shops gelesen.
• Jede Erstattung an ihrem Tag, aus den Transaktionen der Bestellung, mit dem Steueranteil der Bestellung, da Squarespace bei einer Erstattung keine Steuer erfasst.
• Die letzten 365 Tage, sobald du verbindest, danach jede neue Bestellung binnen Sekunden über ein Webhook-Abonnement, wenn der Shop mit einem Klick verbunden ist.
• Ein Abgleich, der jede seit dem letzten Mal geänderte Bestellung liest: alle 30 Minuten bei einer Verbindung mit einem Klick, alle 10 bei einem API-Schlüssel, der keine Benachrichtigungen bekommt.
• Nur, was die Zahlen brauchen: Beträge, Datumsangaben, Zahlungsstatus sowie Hashes der Kunden-E-Mail und der Bestellnummer. Namen, Adressen, Telefonnummern, Positionen, Formularantworten und Notizen werden nie gespeichert.

02Wie ein Verkauf seinen Besuch findet

• BestellstatusseiteDie Zeilen von Tally in den Feldern „Order Status Page“ und „Order Confirmation Page“ von Code Injection senden die Bestellnummer, sobald der Käufer nach dem Checkout dort landet. Sie wird beim Eintreffen gehasht und der Bestellung zugeordnet. Hohe Sicherheit.
• E-MailOhne diese Zeilen verknüpft die Kunden-E-Mail der Bestellung, gehasht, sobald sie gelesen wird, den Verkauf, wenn deine Website tally('identify') mit dieser Adresse aufgerufen hat. Mittlere Sicherheit.
• ErstattungenEine Erstattung übernimmt die Verknüpfung der Squarespace-Bestellung, deren Geld sie zurückgibt.

03Was es nicht lesen kann

04Verbinden

1. Öffne auf der Seite „Integrations“ deiner Website Squarespace und wähle „Connect with Squarespace“, dann „Continue to Squarespace“. Melde dich als Inhaber oder Administrator der Website an, wähle die Website und klicke auf der Bestätigungsseite von Squarespace auf „Allow“.
2. Die Bestätigungsseite fragt nach Lesezugriff auf Bestellungen und Transaktionen, offline, damit Tally auch zwischen deinen Besuchen weiterliest. Die letzten 365 Tage kommen herein, und ein Webhook-Abonnement bringt danach jede Bestellung.
3. Oder erstelle einen API-Schlüssel: in Squarespace unter „Settings“, „Developer Tools“, „Developer API Keys“, mit „Orders“ und „Transactions“ nur lesend, und füge ihn im selben Bereich ein.
4. Öffne in Squarespace „Pages“, „Custom Code“, „Code Injection“. Füge das Snippet in „Header“ ein und die Bestellstatus-Zeilen unten in beide Felder, „Order Status Page“ und „Order Confirmation Page“.
5. Prüfe es abgemeldet in einem privaten Fenster: Ein angemeldeter Inhaber landet im Editor und sieht den Shop nie als Besucher.

Was der API-Schlüssel braucht

Tally verlangt einen API-Schlüssel, der nur das kann, und prüft jede Berechtigung beim Einfügen mit einem echten Aufruf, sodass eine fehlende genannt wird:

So erstellst du ihn: Anleitung von Squarespace.

Die Zeilen für die Bestellstatusseite (die Felder Order Status Page und Order Confirmation Page)

{.if firstPageView}
<script>
  window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
  String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
    tally('squarespace_order', { order: order });
  });
</script>
{.end}

05Fragen

• Ändert Tally etwas in meinem Shop?

  Nein. Tally liest Bestellungen und ihre Transaktionen und legt ein Webhook-Abonnement an, damit neue Bestellungen ankommen; eine Bestellung ändert es nie. Der Code in Code Injection zählt nur Besuche und sendet die Bestellnummer von der Bestellstatusseite.

• Warum dieselben Zeilen in zwei Felder für Bestellseiten einfügen?

  Squarespace schickt Käufer von physischen Produkten, Downloads und Dienstleistungen auf seine Bestellstatusseite und Käufer von Geschenkkarten, Abos und Mitgliedschaften auf seine Bestellbestätigungsseite. Mit den Zeilen in beiden lässt sich jede Art von Bestellung mit ihrem Besuch verknüpfen.

• Soll ich mit einem Klick oder mit einem API-Schlüssel verbinden?

  Mit einem Klick, wenn möglich. Squarespace gewährt Webhooks nur Apps, daher sieht eine Verbindung mit einem Klick jede neue Bestellung binnen Sekunden, während die Bestellungen eines Schlüssels alle 10 Minuten ankommen. Beide importieren die letzten 365 Tage und verknüpfen Bestellungen auf dieselbe Weise.

• Werden Testbestellungen gezählt?

  Nein. Eine Bestellung, die aufgegeben wird, während der Checkout der Website im Testmodus ist, ist kein Verkauf und bleibt aus dem Umsatz draußen. Die erste verknüpfte Bestellung, die du unter „Sales“ siehst, ist eine echte.

• Wie trenne ich Tally von meinem Shop?

  Im Bereich „Extensions“ von Squarespace unter „Connected extensions“ oder auf der Seite „Integrations“ von Tally; die bereits importierten Bestellungen bleiben, mit ihren Belegen. Trennst du in Tally, verschwindet es nicht aus der Liste von Squarespace, also trenne es dort ebenfalls.