Attribution über Gutscheincodes

Mit der Attribution über Gutscheincodes teilen deine Affiliates statt einer URL mit Klick-Tracking einen einlösbaren Code, im Grunde einen Empfehlungscode für den Checkout. Das ist praktisch, wenn:

• Dein Affiliate in seinem Podcast, Video oder Newsletter postet und das Publikum eher einen Code eintippt als zu klicken.
• Der Kunde direkt auf deine Website kommt (über die Suche oder weil er deine Marke kennt), aber im Stripe Checkout einen Code einlöst.
• Du in Stripe eine lückenlose Spur willst, die Umsatz einem bestimmten Affiliate zuordnet.

Rekomi legt den Stripe-Gutschein für dich an, erzeugt für jeden Affiliate einen eigenen Promotion-Code und schreibt den Verkauf dem richtigen Affiliate gut, sobald ein Kunde einen davon im Checkout einlöst. Bei Erstattungen wird die Provision automatisch zurückgeholt.

Die Attribution über Gutscheine funktioniert mit den Integrationen für Stripe, Shopify, Wix, BigCommerce und WooCommerce (in einem BigCommerce-Shop mit mehreren Storefronts funktioniert ein Code, der unter einer auf bestimmte Storefronts beschränkten Kampagne erzeugt wurde, nur auf diesen Storefronts). Die Codes sind echte Promotion-Codes oder Rabattcodes im jeweiligen Checkout, Kunden bekommen den Rabatt also wirklich. Stripe-Codes legst du in diesem Dashboard an; Codes für Shopify, Wix und BigCommerce legst du in der eingebetteten Rekomi-App im Shop-Admin an, und sie werden hier aufgelistet; WooCommerce-Codes legst du hier an, und das Plugin erstellt sie. Bei anderen Zahlungsanbietern (Paddle, Lemon Squeezy, Chargebee und den übrigen) und bei reinen Server-zu-Server-Setups ist die Funktion nicht verfügbar; dort erklärt der Gutscheinbereich der Kampagne in deinem Dashboard das, statt die Funktion anzubieten, und Affiliates verdienen weiter über ihre Links. Selbst erstellte Codes (Affiliates legen eigene Wunschcodes an) funktionieren auf jedem Anbieter mit Gutscheinfunktion.

So funktioniert es

1. Die Marke erstellt einen Kampagnen-Gutschein. Wähle einen Rabatt (% Rabatt oder fester Betrag in $), eine Laufzeit und optional eine maximale Zahl an Einlösungen und ein Ablaufdatum. Rekomi legt im Hintergrund den passenden Stripe-coupon an und speichert seine ID.
2. Die Marke erzeugt einen Code pro Affiliate. Klicke auf der Detailseite eines Affiliates im Tab Gutscheincodes auf „Erstellen“. Rekomi legt einen Stripe-promotion_code an, der auf den Kampagnen-Gutschein verweist und in den Metadaten mit der ID des Affiliates markiert ist.
3. Der Affiliate teilt den Code. Der Code erscheint unter /a/campaigns/{id}, wo er ihn kopieren kann. Optional lassen Marken Affiliates unter /a eigene Wunschcodes erzeugen: Jeder Kampagnen-Gutschein hat eine Selbstbedienungs-Einstellung mit drei Modi (niemand, alle freigegebenen Affiliates oder eine von dir gewählte Liste bestimmter Affiliates).
4. Der Kunde löst im Checkout ein. Stripe sendet invoice.paid oder customer.subscription.created mit dem eingebetteten Promotion-Code. Rekomi sieht das, schreibt den Verkauf dem zugehörigen Affiliate gut und erfasst eine Conversion mit attribution_method = "coupon".
5. Du siehst ihn wie jeden anderen Verkauf. Die Conversion landet automatisch in deinem Dashboard, in der Spalte Quelle als „Gutschein“ mit dem eingelösten Code markiert (zum Beispiel „Gutschein · SARAH20“), direkt neben Conversions über Links und Server-zu-Server. Du musst nichts einrichten: Gutschein-Conversions laufen nie unbemerkt durch. Dieselbe attribution_method (und der Code) steht in der REST-API, im CSV-Export (Spalten attribution_method + coupon_code) und im Webhook conversion.created, falls du Conversions mit deinen eigenen Systemen synchronisierst.
6. Erstattungen holen die Provision zurück. Eine vollständige Erstattung senkt die Zahl der Einlösungen des Affiliates und markiert die Conversion als erstattet; Teilerstattungen holen die Provision anteilig zurück, und die Einlösung zählt weiter.

Wann der Gutschein vor der Klick-Attribution gewinnt

Jeder Kampagnen-Gutschein hat den Schalter Overrides click attribution (im Dashboard „Gutschein überschreibt die Klick-Attribution“, standardmäßig an). Ist er an, schreibt eine Gutschein-Einlösung den Verkauf dem Affiliate des Gutscheins gut, auch wenn der Kunde zusätzlich auf den Tracking-Link eines anderen Affiliates geklickt hat. Nutze das, wenn:

• Affiliates, die mit Codes arbeiten (Influencer, Podcast-Hosts), sich gegen allgemeinen Website-Traffic durchsetzen sollen.
• Du einen eindeutigen, nachvollziehbaren Attributionsweg ohne Unklarheiten durch Cookies willst.
• Deine Affiliates Kaufinteresse über Audio und Video wecken, wo kaum jemand klickt.

Schalte ihn aus, wenn:

• Klick-Tracking dein Hauptkanal ist und Codes zweitrangig sind.
• Du Abläufe mit mehreren Affiliate-Kontakten hast, bei denen der erste Klick gewinnen soll und der Gutschein eher ein Dankeschön fürs Einlösen ist.

Mehrere Codes pro Affiliate

Du kannst für einen Affiliate so viele Codes erzeugen, wie du willst. Alle laufen in den Statistiken desselben Affiliates zusammen; jeder Code hat seinen eigenen Einlösungszähler. Nützlich für:

• Aktionsspezifische Codes (SARAH-BLACKFRIDAY und SARAH-SPRING).
• A/B-Tests von Texten („Probier SARAH20“ gegen „Probier SARAHSPRING“).
• Varianten, die der Affiliate unter seinem Namen nutzt, ohne dass die Attribution verloren geht.

Gutschein auf bestimmte Produkte beschränken

Standardmäßig rabattiert ein Kampagnen-Gutschein die ganze Bestellung. Du kannst ihn stattdessen auf bestimmte Produkte beschränken, dann gelten Rabatt (und Attribution) nur für diese Positionen.

Bei Stripe nutzt du im Dialog zum Erstellen des Gutscheins „Auf bestimmte Produkte beschränken“: Eine Auswahl listet deine aktiven Stripe-Produkte (Name, Bild und ID) mit Suche, du wählst also aus, statt zu tippen. Die Auswahl zeigt deine 100 neuesten aktiven Produkte. Bei größeren Katalogen, oder wenn dir das lieber ist, nimmt „Stattdessen Produkt-IDs einfügen“ kommagetrennte prod_...-IDs an, und die API nutzt dasselbe Feld productRefs (siehe Tracking über Gutscheincodes). In einem Shopify-Shop nutzt du „Auf Produkte beschränken“, wenn du in der Rekomi-App in deinem Shopify-Admin ein Gutscheinangebot erstellst: Wähle die Produkte mit Shopifys eigener Produktauswahl, und jeder Code, der unter diesem Angebot erzeugt wird, übernimmt diese Beschränkung.

Plan

Gutscheine stehen jeder Marke im Dashboard zur Verfügung. Die Verwaltung von Gutscheinen über die öffentliche API erfordert einen bezahlten Plan (Starter oder höher). In der Testphase (14 Tage kostenlos in jedem Plan) kannst du alles nutzen.

Was in Stripe angelegt wird

Für jeden Kampagnen-Gutschein legt Rekomi an:

• Einen Stripe-coupon mit dem gewählten Rabatt, optional redeem_by (Ablaufdatum) und metadata.rekomi_campaign_coupon_id passend zur ID des Rekomi-Eintrags.

Für jeden Gutschein pro Affiliate legt Rekomi an:

• Einen Stripe-promotion_code, der am Kampagnen-Gutschein hängt, mit dem Code, den du angegeben hast (oder einem von uns erzeugten), optional max_redemptions vom übergeordneten Gutschein übernommen und metadata.rekomi_affiliate_coupon_id passend zur ID des Rekomi-Eintrags.

Wenn du einen Rekomi-Eintrag löschst, deaktiviert oder löscht Rekomi das Stripe-Objekt nach bestem Bemühen. Maßgeblich für die Attribution ist der Rekomi-Eintrag.

API-Zugriff

Die Gutschein-Endpunkte sind in der Entwicklerreferenz dokumentiert. Sowohl /api/campaigns/{programId}/coupons als auch /api/affiliates/{affiliateId}/coupons stehen unter /api/v1/* für Aufrufe der öffentlichen API mit rk_live_*-Schlüsseln bereit.

Selbstbedienung für Affiliates

Jeder Kampagnen-Gutschein hat einen Selbstbedienungsmodus, der festlegt, wer eigene Codes erzeugen darf:

• Alle freigegebenen Affiliates (der Standard für neue Gutscheine, die im Dashboard oder in der Shopify-App erstellt werden): Jeder, der in der Kampagne freigegeben ist, kann unter /a/campaigns/{id} eigene Wunschcodes erzeugen. Genau darum geht es bei der Selbstbedienung: Du legst das Angebot fest, Affiliates kümmern sich selbst um ihre Codes.
• Niemand: Nur du erzeugst Codes, auf der Detailseite des Affiliates. (Das bleibt der Standard für API-Aufrufe, die das Feld weglassen, damit bestehende Integrationen sich weiter genauso verhalten.)
• Bestimmte Affiliates: eine Liste, die du im Dashboard oder in der Shopify-App auswählst; entfernst du einen Affiliate aus der Liste, werden die Codes widerrufen, die er erzeugt hat.

Codes müssen weiterhin ^[A-Z0-9_-]{3,32}$ erfüllen und innerhalb der Marke eindeutig sein. Selbstbedienung ist nützlich für Influencer-Programme, in denen jeder Creator seinen persönlichen Markennamen selbst bestimmt, oder für Abläufe, in denen du nicht jeden neuen Code selbst freigeben willst. Du kannst den Modus jederzeit ändern; bereits erzeugte Codes funktionieren weiter, solange du sie nicht widerrufst.

Provisionssätze pro Gutschein

Ein Kampagnen-Gutschein kann einen eigenen Provisionssatz haben. Wenn du bei einem Gutschein „Codes aus diesem Gutschein bringen“ ausfüllst, zahlt jeder Verkauf mit einem seiner Codes diesen Satz statt des Kampagnensatzes (und statt jedes Satzes pro Affiliate, pro Gruppe, pro Stufe oder pro Produkt). Null ist eine echte Einstellung: „Codes bringen keine Provision“ ist der Weg, einen reinen Rabattcode zu betreiben, zum Beispiel einen Black-Friday-Code, der keine Provision zahlen soll.

Zwei ehrliche Details:

• Der Satz gilt für Verkäufe mit dem Code. Teilt derselbe Affiliate stattdessen seinen Tracking-Link, zahlen Verkäufe über den Link nach der normalen Rangfolge der Kampagne.
• Bei Abonnements hängt Stripe den Code an jede Rechnung, die er rabattiert. Ein „once“-Gutschein zahlt den Gutscheinsatz auf die erste Rechnung; Verlängerungen (die den Rabatt nicht mehr tragen) fallen auf die Rangfolge der Kampagne zurück. „Forever“-Gutscheine und noch laufende „repeating“-Gutscheine zahlen den Gutscheinsatz weiter auf jede rabattierte Rechnung.

Affiliate-Wahl: Jeder Affiliate wählt seine Aufteilung

Manche Programme geben Botschaftern einen festen Vorteil und überlassen jedem selbst, wie er ihn nutzt: den ganzen Rabatt an sein Publikum verschenken oder ihn teilen und eine Provision behalten. Der Schalter Affiliate-Wahl im Dialog zum Erstellen eines Gutscheins macht genau das. Du legst 2 bis 4 Optionen fest, jede ein Paar aus Rabatt für Käufer und Provision für den Affiliate, zum Beispiel:

• Option A: Käufer bekommen 10% Rabatt, der Affiliate verdient nichts (die Geschenk-Option).
• Option B: Käufer bekommen 5% Rabatt, der Affiliate verdient 5% pro Verkauf.

Wenn ein Affiliate seinen Code erstellt, wählt er eine Option. Die Wahl bestimmt sowohl den Rabatt für seine Käufer als auch, was sein Code ihm einbringt, und jeder Code zeigt seine eigenen Konditionen („5% Rabatt · bringt dir 5% pro Verkauf“). Der Dialog zeigt dir vorab genau die Optionen, die Affiliates sehen werden, erzeugt aus deinen Zahlen, sodass niemand den Text schreiben oder Korrektur lesen muss.

Wenn ein Affiliate seinen Code erstellt, erscheinen dieselben Optionen in seinem Ablauf zum Erstellen:

Gut zu wissen:

• Gutscheine mit Auswahl erlauben standardmäßig 5 Codes pro Affiliate (in den Einstellungen des Gutscheins anpassbar, auch bis hinunter auf 1). Jeder Code bleibt bei der Option, mit der er erstellt wurde, und jeder Verkauf zahlt nach dem Code, der verwendet wurde; frühere Verkäufe behalten den Satz, unter dem sie verdient wurden.
• Optionen lassen sich nach dem Erstellen nicht mehr ändern, genau wie der Rabatt selbst. Um sie zu ändern, archivierst du den Gutschein und erstellst einen neuen.
• Bei Abonnements gilt dieselbe Regel für Verlängerungen wie oben: Die gewählte Aufteilung zahlt auf die Rechnungen, die der Code rabattiert. Ein „once“-Gutschein zahlt sie auf die erste Rechnung; Verlängerungen fallen auf den üblichen Satz des Affiliates zurück.
• Sowohl der Satz pro Gutschein als auch die Optionen funktionieren auf jedem Anbieter mit Gutscheinfunktion. Die Seitenleiste der App in Stripe bietet Gutscheine mit Auswahl noch nicht an; erzeuge sie im Dashboard oder lass Affiliates sie selbst erstellen.

Siehe auch

• Sub-Affiliate-Recruiting: die andere Netzwerkfunktion für Affiliates, ein zweistufiges Programm mit einer begrenzten Override-Provision auf die normale Provision, nur eine Rekrutierungsebene. Funktioniert parallel zur Attribution über Gutscheine; die Override-Provision greift unabhängig davon, ob der zugrunde liegende Verkauf über einen Klick oder einen Gutschein zugeordnet wurde.
• Provisionssätze pro Produkt: Lege für bestimmte Produkte eine andere Provision fest, zusätzlich zur Attribution über Gutscheine.