Auf Squarespace installieren

Das Feld Code Injection Header ab dem Core-Plan. Squarespace Commerce läuft über dein eigenes Stripe, deshalb funktioniert die Attribution automatisch, sobald das Head-Skript eingebunden ist.

Die Installation auf Squarespace gehört zu den einfachsten unter den No-Code-Plattformen: Füge ein Skript in das Header-Feld von Code Injection ein und veröffentliche. Die einzige Hürde: Code Injection gibt es erst ab dem Core-Plan (der Einstiegsplan Basic bietet es nicht; die älteren Pläne Business und Commerce enthalten es ebenfalls). Bist du im Basic-Plan, mach zuerst ein Upgrade, sonst erscheint das Feld nicht in den Settings.

Das Head-Skript installieren

Squarespace-Admin > Settings > Advanced > Code Injection > Header.

Füge ein:

<!-- Rekomi tracking -->
<script async src="https://api.rekomi.com/api/v1/r/loader.js" data-program-id="YOUR_PROGRAM_ID" data-rkmi-email-capture="auto"></script>
<noscript>
  <img src="https://api.rekomi.com/api/v1/r/c.gif" width="1" height="1" alt="" referrerpolicy="no-referrer-when-downgrade" />
</noscript>

Klicke auf Save (oben links im Bereich Code Injection). Das Skript lädt jetzt auf jeder öffentlichen Squarespace-Seite.

Kopiere das Snippet mit deiner schon eingesetzten Programm-ID in Rekomi unter Einrichtung > Installieren. Rekomi erfasst eine E-Mail-Adresse, die ein vermittelter Besucher auf den Seiten, auf denen das Tag läuft, in ein beliebiges E-Mail- oder Textfeld tippt (Registrierung, Login, Checkout und andere Formulare), damit der Verkauf auch dann gutgeschrieben werden kann, wenn dein Checkout keine Empfehlung übergibt. Ohne Empfehlung wird nichts erfasst. Entferne das Attribut data-rkmi-email-capture, um das auszuschalten; explizite Aufrufe von Rekomi.convert() funktionieren weiterhin.

Die Einrichtungsanleitung für Squarespace in Rekomi mit dem schon ausgefüllten Tracking-Snippet

Squarespace 7.0 und 7.1

Der Pfad oben gilt für Squarespace 7.1 (der aktuelle Standard für neue Websites). Ältere 7.0-Websites haben eine andere Admin-Oberfläche, aber derselbe Pfad Settings > Advanced > Code Injection > Header führt zum selben Feld. Die Installation ist identisch.

Squarespace Commerce: die Grenzen kennen

Ist auf deiner Squarespace-Website das eingebaute Commerce-Modul aktiv, laufen Zahlungen über das Konto, das du im Squarespace-Admin unter Commerce > Payments gewählt hast (Stripe oder PayPal). So oder so sind diese Belastungen einfache Kartenzahlungen ohne Stripe-Rechnungen. Sie erreichen den Stripe-Weg von Rekomi also nicht von selbst, und die Rabattcodes von Squarespace gehören zu Squarespace selbst und erreichen Rekomi ebenfalls nie.

Für Commerce-Shops bleiben damit zwei praktikable Varianten:

Ein Backend-Relay. Betreibst du ein kleines Backend, abonniere Bestell-Webhooks über die Entwickler-API von Squarespace und leite jede bezahlte Bestellung an den S2S-Endpunkt weiter. Das Relay muss den Affiliate benennen, und der Squarespace-Checkout bietet keinen sauberen Weg, die Empfehlung durchzureichen. Das passt also zu Shops, die die Empfehlung vor dem Checkout selbst erfassen (zum Beispiel mit einem eigenen Formularschritt, der window.Rekomi.getReferral() beim Käufer speichert).
Provision für Leads statt für Verkäufe. Ist ein Relay nicht realistisch, betreibe eine Lead-Kampagne: Erfasse Anmeldungen mit window.Rekomi.convert({ email }) und zahle pro Lead. Siehe Lead-Tracking.

Ist deine Squarespace-Website eigentlich eine Marketing-Fläche vor Stripe Payment Links, nimm stattdessen den Weg über Gutscheincodes unten; er braucht kein Backend und ordnet sauber zu.

Externe Stripe Payment Links

Nutzt du Squarespace als Marketing-Website und bindest einen Stripe Payment Link als Button ein (statt Squarespace Commerce zu nutzen), ordne diese Verkäufe über Gutscheincodes pro Affiliate zu. Stripe hostet die Checkout-Seite des Payment Links, ein Skript auf deiner Squarespace-Website kann die Empfehlung also nicht durchreichen; der Code, den der Käufer einlöst, schreibt dem Affiliate den Verkauf gut, und auf deiner Website brauchst du keinen Code:

Bearbeite in Stripe den Payment Link und schalte Allow promotion codes ein.
Öffne in Rekomi den Tab Gutscheincodes deiner Kampagne und erstelle den Gutschein (den Rabatt, den Käufer bekommen). Dann bekommt jeder Affiliate seinen eigenen Code: Erstelle ihn auf der Detailseite des Affiliates, oder lass Affiliates ihren Code selbst auf der Kampagnenseite in ihrem Portal anfordern.
Affiliates teilen deinen Payment Link mit schon eingetragenem Code, sodass Käufer mit bereits angewendetem Rabatt im Checkout landen: https://buy.stripe.com/your-link?prefilled_promo_code=THEIRCODE

Wenn der Käufer bezahlt, liefert Stripe den Verkauf über deine Stripe-Verbindung an Rekomi, und der eingelöste Code benennt den Affiliate. Die ganze Anleitung findest du unter Auf Stripe installieren.

Gut zu wissen

Der Core-Plan ist Pflicht. Websites im Basic-Plan können keinen eigenen Code einbinden. Den Menüpunkt Code Injection gibt es dort einfach nicht. Mach ein Upgrade auf Core oder höher (die älteren Pläne Business und Commerce enthalten es ebenfalls) oder nutze eine andere Plattform.

Code Injection läuft auf jeder Seite. Header-Code wird in das globale Template eingefügt und lädt deshalb auf jeder Seite, die Squarespace ausliefert. Eine Konfiguration pro Seite ist nicht nötig.

Websiteweiter Header oder Code Injection pro Seite. Squarespace bietet auf einzelnen Seiten auch ein eigenes Feld für Code Injection (Page settings > Advanced). Installiere Rekomi dort nicht, denn dann läuft es nur auf dieser einen Seite. Nutze für die websiteweite Installation immer den Pfad Settings > Advanced > Code Injection > Header.

Das Stripe in Squarespace ist echtes Stripe. Mach dir keine Sorgen, dass Squarespace die Integration versteckt: Wenn ein Käufer bezahlt, geht die Belastung auf dein Stripe-Konto, und es löst den Webhook an Rekomi ganz normal aus. Der übliche Stripe-Weg für die Attribution funktioniert.

Einsendungen über eigene Formulare (ohne Commerce). Sammelst du Leads über den nativen Form Block von Squarespace (nicht über den Commerce-Checkout), läuft der Lead nicht über Stripe und löst keinen Stripe-Webhook aus. Provisionen für Leads sind eine eigene Funktion: Unter Lead-Tracking steht, wie window.Rekomi.convert({ email }) einen vermittelten Lead erfasst (keinen Verkauf). Für echte Käufe nutzt du Squarespace Commerce mit Stripe oder Gutscheincodes pro Affiliate wie oben beschrieben.

Fehlerbehebung

Der Menüpunkt Code Injection fehlt. Du bist in einem Plan ohne Code Injection (dem Einstiegsplan Basic). Mach ein Upgrade auf Core oder höher.

Das Skript steht in Code Injection, aber nicht im Quelltext der Live-Website. Lade die Seite hart neu (Cmd+Shift+R). Squarespace liefert standardmäßig im CDN zwischengespeichertes HTML aus; nach dem Speichern kann es ein paar Minuten dauern, bis das Skript erscheint.

Bestellungen aus Squarespace Commerce werden nicht zugeordnet. Prüfe, ob dein Stripe-Konto unter Commerce > Payments verbunden ist und ob Stripe in Rekomi unter Einrichtung > Zahlungsanbieter verbinden verbunden ist, damit seine Webhook-Ereignisse Rekomi erreichen.

Ein Verkauf über einen Payment Link wurde abgeschlossen, aber nicht zugeordnet. Entweder sind Promotion-Codes für den Payment Link nicht eingeschaltet, oder der Käufer hat ohne Code eines Affiliates bezahlt. Schalte in Stripe Allow promotion codes ein, prüfe, ob der Affiliate die Version des Links mit ?prefilled_promo_code= geteilt hat, und ob der eingelöste Code einer ist, den Rekomi für diesen Affiliate angelegt hat.

Checkout-Tracking ohne Code und ohne Stripe
Auf Stripe installieren: die Muster für die Attribution mit Stripe Commerce und Payment Links
Squarespace-Dokumentation: Code Injection