Wenn du nach Polar-Affiliate-Tracking suchst, bekommst du eine seltsame Mischung: eine Marke für Sportuhren, ein Analyse-Tool für Shopify und eine Handvoll Startseiten von Affiliate-Software, auf denen überall „works with Polar“ (funktioniert mit Polar) steht, ohne dass erklärt wird, wie. Beantworten wir also die eigentliche Frage. Polar.sh hat keine eingebaute Affiliate-Funktion, und Affiliate-Tracking auf Polar funktioniert so: Eine Empfehlungs-ID reist in den Checkout-Metadaten mit und wird aus den Webhooks von Polar wieder ausgelesen, sobald Geld fließt. Das ist der ganze Trick, und dieser Artikel geht die komplette Kette durch: was beim Klick passiert, wie die Empfehlung bis zum Checkout erhalten bleibt und welche Webhook-Ereignisse aus einem Verkauf eine Provision machen.
Ich sollte sagen, wo meine Interessen liegen: Ich habe die letzten paar Jahre damit verbracht, Rekomi zu bauen, eins der Tools, die dieses Tracking auf Polar übernehmen. Ich kenne diese Webhooks also so gut wie du deinen Weg zur Arbeit. Alles unten nennt bewusst die genauen Felder und Ereignisse. So kannst du jede Aussage in der Dokumentation von Polar selbst nachprüfen, und ich kann dich ehrlich nur dazu ermutigen.
Die Kette auf einen Blick:
Der Klick: Ein Tracking-Skript speichert die Empfehlungs-ID des Affiliates für 90 Tage im Browser des Besuchers und protokolliert den Klick auf dem Server.
Der Checkout: Die Empfehlung reist als
metadata.rekomi_ref(API-Checkouts) oder als Query-Parameterreference_id(Checkout-Links) zu Polar.Die Provision: Der Webhook
order.paidvon Polar trägt diese Metadaten bei jeder bezahlten Bestellung mit, bei Erstkäufen genauso wie bei Verlängerungen, und so wird der Verkauf automatisch dem richtigen Affiliate gutgeschrieben.
Hat Polar ein eingebautes Affiliate-Tracking?
Nein. Polar.sh bietet Checkout, Abrechnung und die Steuerabwicklung als Merchant of Record und hört bewusst genau dort auf: keine Empfehlungslinks, kein Provisionssystem, kein Dashboard für Affiliates. Stattdessen gibt dir Polar die zwei Zutaten, die jedes Tracking-Tool braucht: Metadatenfelder, die vom Checkout über die Bestellung bis zum Abonnement erhalten bleiben, und ein Webhook-System, das jede Zahlung meldet. Das ist tatsächlich eine hervorragende Grundlage, denn so kann die Attribution exakt sein, statt geschätzt zu werden.
Wenn du noch ein Tool auswählst: Einen ehrlichen Vergleich aller Optionen findest du in meinem Artikel zur besten Affiliate-Software für Polar.sh. In diesem Artikel geht es darum, was unter der Haube passiert, sobald eins davon läuft.
So wird aus einem Klick eine erfasste Empfehlung
Schritt für Schritt: Dein Affiliate teilt einen Link wie yoursite.com?via=alex. Ein kleines Skript auf deiner Marketing-Website (das von Rekomi ist buchstäblich eine Zeile in deinem <head>) macht in dem Moment, in dem die Seite lädt, zwei Dinge:
- Es speichert die Empfehlung im Browser. Der Slug
alexlandet mit einer Laufzeit von 90 Tagen im localStorage, dazu kommt ein First-Party-Cookie, wenn du eine eigene Tracking-Domain eingerichtet hast. Das Skript von Rekomi erkennt von Haus aus 19 Attributionsparameter (?via=,?ref=,?fpr=und die übrigen Dialekte der Branche), Links aus einem früheren Tool funktionieren nach einem Umzug also weiter. - Es protokolliert den Klick auf dem Server. Der Klick-Eintrag enthält den Referrer, die UTM-Parameter und optional eine Sub-ID, und genau damit lässt sich später die Frage eines Affiliates beantworten: „Welcher meiner Beiträge bringt eigentlich Conversions?“
Achte darauf, was noch nicht passiert ist: Polar war bisher gar nicht beteiligt. Der Klick existiert nur auf deiner Website und wartet. Spannend wird es bei der Übergabe.
So kommt die Empfehlung in den Checkout von Polar
Polar-Checkouts gibt es in zwei Varianten, und jede hat ihren eigenen Mechanismus, um die Empfehlung mitzunehmen.
Checkout-Links: der Trick mit reference_id
Die teilbaren Checkout-Links von Polar akzeptieren genau einen Query-Parameter pro Besucher: reference_id. Was du dort anhängst, landet in den Metadaten der erzeugten Checkout-Session. Ein Kaufen-Button, der auf buy.polar.sh/your-product?reference_id=alex zeigt, nimmt die Empfehlung also ganz unauffällig mit, und das Skript von Rekomi hängt sie automatisch an die Polar-Checkout-Links auf deiner Seite an. Ein einziges Script-Tag, und schon lassen sich die Verkäufe aus deinem Checkout ohne Code zuordnen!
API-Checkouts: Hinterleg die Metadaten selbst
Wenn du Checkouts auf dem Server mit POST /v1/checkouts anlegst, ergänzt du die Anfrage um ein Feld:
metadata: { rekomi_ref: window.Rekomi?.getReferral?.() }Das Frontend liest die gespeicherte Empfehlung aus, dein Backend gibt sie weiter, fertig. Und das ist der Teil am Design von Polar, den ich wirklich elegant finde: Checkout-Metadaten werden auf die daraus entstehende Bestellung und auf das Abonnement kopiert, und Verlängerungsbestellungen übernehmen die Metadaten des Abonnements. Hinterleg die Empfehlung einmal beim Checkout, und sie taucht bei jeder Zahlung auf, die dieses Abonnement jemals auslöst (Monat 1, Monat 14, egal).
Die Webhooks, die wirklich Geld bewegen
Das eine Geldereignis: order.paid. Es löst für jede Bestellung, die bezahlt wird, genau einmal aus, und sein Feld billing_reason sagt dir, warum: purchase (Einmalverkauf), subscription_create (erste Abbuchung), subscription_cycle (Verlängerung) oder subscription_update (Planwechsel). Ein Tracking-Tool, das auf dieses eine Ereignis hört, bekommt jeden Dollar mit.
Die Falle, die du vermeiden solltest: order.created. Es sieht verlockend aus, löst bei Verlängerungsbestellungen aber mit dem Status pending aus, bevor die Zahlung durchgeht. Schreibst du Provisionen auf Basis von order.created gut, bezahlst du Affiliates für Verlängerungen, die vielleicht nie eingezogen werden. Genau solche feinen Unterschiede trennen die Tracking-Tools auf Polar voneinander, und es lohnt sich sehr, jeden Anbieter zu fragen, an welchem Ereignis er die Gutschrift festmacht.
Die Nebendarsteller: subscription.created, canceled, uncanceled und revoked bilden den Lebenszyklus des Abonnements ab (sie bewegen kein Geld, aber an ihnen erkennt ein Dashboard, dass ein Kunde gekündigt hat), und refund.created / refund.updated steuern die Rückforderungen. Polar meldet jede Erstattung als eigenes Objekt mit eigenem Betrag, Teilerstattungen holen die Provision also anteilig zurück. Eine Erstattung von $12 auf eine Bestellung über $30 bei 25% Provision holt genau $3 zurück, und im Provisionsbuch des Affiliates steht, warum.
Noch ein Detail, das du kennen solltest: Erstattungsbeträge sind bei Polar Beträge vor Steuern, und auch Provisionen werden auf den Nettobetrag vor Steuern berechnet. Polar ist der Merchant of Record, deine Affiliates verdienen also am Verkauf, nie an der Mehrwertsteuer von irgendwem.
Wer die Gutschrift bekommt: die Rangfolge der Attribution
Wenn order.paid ankommt, ermittelt das Tool den Affiliate in einer festen Reihenfolge. Die Rangfolge von Rekomi auf Polar sieht so aus:
metadata.rekomi_ref: Die ausdrücklich hinterlegte Empfehlung gewinnt immer.reference_id: der Fallback für Checkout-Links. Wenn eine Markereference_idschon für ihre eigenen Bestell-IDs nutzt, wird ein Wert, der zu keinem Affiliate passt, einfach übergangen, ohne Schaden anzurichten.- Historie des Kunden: Wenn dieser Polar-Kunde schon einen zugeordneten Kauf hat, wird die neue Bestellung demselben Affiliate gutgeschrieben. Das ist das Netz, das Verlängerungen, Upgrades und Wiederholungskäufe auffängt, bei denen keine Metadaten mitgereist sind.
- Niemand: Der Verkauf wird ohne Zuordnung erfasst und wartet in einer Prüfliste, wo du ihn von Hand gutschreiben kannst, falls sich ein Affiliate meldet.
Was passiert, wenn zwei Affiliates denselben Besucher erreicht haben? Der letzte Klick gewinnt: Wenn jemand am Montag auf den Link von Alex und am Donnerstag auf den Link von Blair klickt, überschreibt die Empfehlung vom Donnerstag die vom Montag im Browser. Das ist der übliche Standard in der Branche, und mit ihm bleiben die Regeln so einfach, dass Affiliates ihnen vertrauen.
Was Polar-Affiliate-Tracking ehrlicherweise nicht kann
Jede Plattform hat ihre Grenzen, und ich erzähle sie dir lieber selbst, als dass du sie im dritten Monat entdeckst.
Es gibt keinen Webhook für Streitfälle. Polar sendet Webhooks für Erstattungen, hat aber überhaupt kein Ereignis für Rückbuchungen oder Streitfälle. Ein verlorener Streitfall ist also für jedes Tracking-Tool auf der Plattform unsichtbar. Das ist keine Grenze von Rekomi, sondern eine von Polar. Kommt eine Rückbuchung, erklärst du die Conversion von Hand für ungültig, und die Provision wird über denselben Prüfpfad zurückgeholt. In der Praxis sind Streitfälle bei den Entwickler-Tools, die auf Polar verkauft werden, selten, aber „selten“ heißt nicht „nie“, deshalb gehört es auf diese Seite.
Über Gutscheincodes lässt sich auf Polar kein Verkauf zuordnen. Auf manchen Plattformen kann ein Rabattcode selbst die Empfehlung sein (eine Influencerin sagt „nutz den Code ALEX10“, und der Verkauf wird Alex ganz ohne Klick gutgeschrieben). Die Bestellereignisse von Polar lassen das nicht zuverlässig zu, auf Polar wird eine reine Code-Aktion also bestenfalls über die Historie des Kunden zugeordnet. Wenn die Attribution über Codes für dein Programm zentral ist, ist das ein echter Punkt bei der Wahl deiner Checkout-Plattform.
Beim Gerätewechsel gelten die üblichen Naturgesetze. Die Empfehlung liegt in dem Browser, in dem geklickt wurde. Klickt jemand auf dem Handy und kauft auf dem Laptop, reisen die Metadaten nie mit, und nur die Historie des Kunden (oder der Affiliate, der dich um die Gutschrift bittet) rettet den Verkauf. Kein Tool auf irgendeiner Plattform löst das wirklich, ohne zu unheimlichen Methoden zu greifen, und bei einem, das das behauptet, wäre ich misstrauisch.
Was deine Affiliates sehen
Auf der Seite des Affiliates zeigt sich all diese Technik als Dashboard: Klicks, Empfehlungen, Conversions und ein laufendes Provisionsguthaben. Die Mechanik oben sorgt dafür, dass die wiederkehrenden Provisionen aufgehen, und ich liebe es, wie viel Arbeit dieses eine Metadatenfeld am Ende leistet. Ein Produkt für $30/Monat bringt dem Affiliate bei 25% jeden Monat $7.50, solange der Kunde bleibt, weil jede Bestellung mit subscription_cycle die ursprüngliche Empfehlung übernimmt. Zwölf Monate Kundenbindung machen aus einer einzigen geworbenen Anmeldung $90, und dein Affiliate musste nichts zweimal tun!
Wenn aus Provisionen Auszahlungen werden, übernimmt Rekomi die Geldbewegung selbst, in 130+ Ländern (Stripe Express in 41 Ländern, per Banküberweisung in 60 weiteren, per PayPal in 31 weiteren), Steuerformulare inklusive. Das sprengt den Rahmen dieses Artikels, steht aber in meiner Anleitung: So richtest du ein Affiliate-Programm auf Polar ein.
FAQ zum Polar-Affiliate-Tracking
Hat Polar.sh eine eigene Funktion für Affiliate-Programme?
Nein. Polar stellt Checkout-Metadaten und Webhooks bereit, und Tools von Drittanbietern bauen Tracking, Provisionen und Auszahlungen darauf auf.
Wie lange gilt das Attributionsfenster?
Bei Rekomi 90 Tage ab dem Klick. Die Empfehlung wird im Browser des Besuchers gespeichert, und jeder Kauf innerhalb dieses Fensters wird dem Affiliate zugeordnet.
Bringen Abo-Verlängerungen dem Affiliate weiter Provision?
Ja. Polar kopiert die Checkout-Metadaten auf das Abonnement, Verlängerungsbestellungen übernehmen sie, und jedes order.paid mit billing_reason: subscription_cycle wird dem ursprünglichen Affiliate gutgeschrieben. Selbst wenn Metadaten fehlen, sichert die Historie des Kunden das ab.
Was passiert mit der Provision, wenn ein Kunde eine Erstattung bekommt?
Die Provision wird automatisch zurückgeholt. Die Erstattungs-Webhooks von Polar melden jede Erstattung mit eigenem Betrag, eine volle Erstattung holt also alles zurück und eine Teilerstattung den entsprechenden Anteil.
Können Affiliates auf Polar Rabattcodes statt Links nutzen?
Nicht zuverlässig. Polar liefert in seinen Bestellereignissen kein verlässliches Signal, das einen Code mit einem Affiliate verbindet, Verkäufe nur über Codes werden also bestenfalls über die Historie des Kunden zugeordnet. Nutz auf Polar Links als wichtigsten Mechanismus.
Sieh dir die Kette einmal in Aktion an
Am schnellsten vertraust du einem Tracking-System, wenn du zusiehst, wie es einen Verkauf erfasst. Verbinde deine Polar-Organisation (die Polar-Integration braucht ein einziges Access Token), klick auf deinen eigenen Testlink, mach einen Checkout in der Sandbox und sieh zu, wie die Conversion mit dem Namen deines Test-Affiliates ankommt. Zehn Minuten, und du musst nie wieder mir oder sonst jemandem glauben, wie Polar-Affiliate-Tracking funktioniert: Du hast es selbst gesehen.
