Squarespace verbinden und seine Bestellungen mit Besuchen verknüpfen

01Mit einem Klick verbinden

1. 1

   Öffne auf der Seite Integrations deiner Website Squarespace und klicke auf Connect with Squarespace.

2. 2

   Tally zeigt, was es bekommt: deine Bestellungen und ihre Transaktionen, nur lesend, und ein Webhook-Abonnement. Eine Bestellung wird nie geändert. Klicke auf Continue to Squarespace.

3. 3

   Squarespace bittet dich, dich als Inhaber oder Administrator der Website anzumelden und die Website zu wählen. Seine Bestätigungsseite fragt, ob Tally deine Bestellungen und Transaktionen lesen darf, offline, damit es auch in deiner Abwesenheit weiterliest. Klicke auf Allow.

4. 4

   Du bist zurück auf Integrations: Squarespace is connected, und ein Jahr an Bestellungen wird importiert, Erstattungen inklusive.

Ab dann kommt jede neue Bestellung binnen Sekunden an, über das Webhook-Abonnement. Alle 30 Minuten liest Tally außerdem die geänderten Bestellungen, sodass auch eine ankommt, die eine Benachrichtigung verpasst hat.

02Oder per API-Schlüssel verbinden

1. 1

   Einen API-Schlüssel in Squarespace erstellen

   Ein API-Schlüssel funktioniert in den Tarifen Core, Plus, Advanced und Commerce Advanced. Öffne in Squarespace Settings › Developer Tools › Developer API Keys, wähle „Generate Key“ und gib ihm nur diese Berechtigungen (Anleitung von Squarespace):

   Berechtigung	Zugriff	Wozu
   Orders	Lesen	Jede bezahlte Bestellung: Gesamtbetrag und Steuer sowie die E-Mail des Kunden (sofort gehasht, nie gespeichert). Namen und Adressen werden nie gespeichert.
   Transactions	Lesen	Wann jede Erstattung erfolgte und wie viel sie zurückgab.

   „Read Only“ für beide. Squarespace gibt Webhooks nur Apps, die mit einem Klick verbunden sind, mit einem Schlüssel liest Tally neue Bestellungen also alle 10 Minuten. Lösche den Schlüssel jederzeit an derselben Stelle.

2. 2

   Den API-Schlüssel einfügen

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

   • API key: Wird einmal angezeigt, beim Erstellen des Schlüssels. Tally speichert ihn verschlüsselt und zeigt ihn nie wieder an.

   Klicke dann auf Connect Squarespace.

3. 3

   Tally prüft den Zugang und importiert das letzte Jahr

   Der Schlüssel wird an deiner Website geprüft, die letzten 365 Tage werden importiert, Erstattungen inklusive, und danach werden neue und geänderte Bestellungen alle 10 Minuten gelesen. Um jede Bestellung mit dem Besuch ihres Käufers zu verknüpfen, füge das Snippet von Tally in Pages › Custom Code › Code Injection ein: das Tag in „Header“ und die Bestellstatus-Zeilen aus Coverage and fixes in die Felder „Order Status Page“ und „Order Confirmation Page“.

03Den Code in Code Injection einfügen

Squarespace führt in einem Shop keinen App-Code aus, daher kommt der Code von Hand hinein. Öffne in Squarespace Pages › Custom Code › Code Injection (früher unter Developer Tools). Squarespace bietet Code Injection in den Tarifen Core, Plus und Advanced und einigen älteren an, nicht in Basic oder Personal.

Header

Das Snippet, damit jede Seite des Shops ihre Besuche zählt:

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

Order Status Page und Order Confirmation Page

Diese Zeilen, in beide Felder. Squarespace zeigt nach dem Checkout die Bestellstatusseite für physische Produkte, Downloads und Dienstleistungen und die Bestellbestätigungsseite für Geschenkgutscheine, Abos und Mitgliedschaften. Es setzt {orderId} mit der Bestellnummer ein, und die Zeilen senden sie:

{.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}

Der Besuch des Käufers auf dieser Seite verknüpft die Bestellung mit ihm: hohe Sicherheit. {.if firstPageView} verhindert, dass ein späterer Besuch der Seite, über den Link in der E-Mail, noch einmal zählt. Ohne diese Zeilen wird eine Bestellung über ihre E-Mail verknüpft, wenn deine Website identify mit der Adresse des Käufers aufruft, mit mittlerer Sicherheit (Ziele und identify).

04Was als Verkauf zählt

• Eine Bestellung zählt, sobald sie bezahlt ist, zum Zeitpunkt ihrer Aufgabe: ihr Gesamtbetrag ohne Steuer, mit Versand und bereits abgezogenen Rabatten, in der Währung der Bestellung.
• Jede Erstattung zählt zu dem Zeitpunkt, an dem sie erfolgte, gelesen aus den Transaktionen der Bestellung, mit dem Steueranteil der Bestellung.

05Was gespeichert wird

Von jeder Bestellung behält Tally die Beträge, Daten und den Zahlungsstatus sowie zwei Hashes: einen der E-Mail des Kunden und einen der Bestellnummer. Die Nummer von der Bestellstatusseite wird beim Eintreffen gehasht, sodass nur der Hash gespeichert wird. Namen, Adressen, Telefonnummern, Bestellpositionen, Formularantworten und Notizen werden nie gespeichert.

06Verbindung trennen

• In Squarespace: Trenne Tally im Bereich Extensions, unter Connected extensions.
• In Tally: Trenne die Verbindung auf der Seite Integrations. Tally löscht sein Webhook-Abonnement und vergisst seinen Zugang, aber Squarespace führt es weiter unter Connected extensions, bis du es auch dort trennst. Einen selbst erstellten Schlüssel löschst du in Squarespace.
• So oder so bleiben die bereits importierten Bestellungen erhalten, mit ihren Belegen.

07Prüfen, ob es geklappt hat

08Wenn deine eigenen Besuche nicht erscheinen

Angemeldet bei Squarespace landet der Inhaber einer Website im Editor und sieht den Shop nie als Besucher, diese Besuche zählen also nicht. Teste in einem privaten Fenster, abgemeldet und nach Eingabe des Website-Passworts, falls es eins gibt.