OpportunitiesEntities
Docs
    Ring Platform

    Dezentralisierte selbstbauende Zukunft

    Anmelden
    Entities
    Opportunities
    Store
    Docs
    Plattformkonzepte
    RING ÖkonomieSonoratek LLCGlobaler ImpactKI trifft Web3
    Loslegen
    SchnellstartKalkulatorRoadmap
    Datenschutz|Kontakt
    v1.106.26|Sonoratek LLC

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Multi-Vendor-Store
    Membership
    Seitenvorhang
    Entities
    Opportunities
    Echtzeit-Messaging
    News-Modul
    Mitglieder-Blogs
    Benachrichtigungen
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Seitenvorhang

    Der Seitenvorhang ist ein schmales Banner (etwa 10% der Bildschirmhöhe), das erscheint, wenn ein Besucher aufhört zu scrollen. Es zeigt eines von zwei Angeboten: Zum Startbildschirm hinzufügen für die App oder ein Produkt, das ein Händler bewerben möchte. Auf Newsartikeln und Beiträgen im Mitgliederblog kann ein aus dem Vorhang hinzugefügtes Produkt dem Autor der Seite eine Provision einbringen, wenn der Käufer später bezahlt.

    Nutze die Tabs Founder / Developer in der Seitenleiste der Dokumentation, um diese Seite zu filtern. Gemeinsame Abschnitte gelten für beide Zielgruppen.

    Status (2026-10-26): In Layer 1 ausgeliefert und pro Klon über den Block curtain in ring-config.json konfigurierbar. Die Warteschlange berücksichtigt jetzt frühere Ablehnungen, sodass ein Besucher, der Heute nicht gewählt hat, dasselbe Banner auf der nächsten Seite nicht erneut sieht.

    Ohne VorhangMit Vorhang
    Installationshinweise hängen vom Browser abRing bietet Zum Startbildschirm hinzufügen selbst an, einmal pro Richtlinienfenster
    Autoren verdienen nichts an erwähnten ProduktenAutoren erhalten zusätzliches Guthaben auf bezahlte Warenkörbe, die auf ihrer Seite begonnen haben
    Händler zahlen anderswo für WerbungHändler schalten ein Produkt frei und legen eine Autorenprovision von 1% bis 10% fest

    Warum das für deine Community wichtig ist

    Autoren bringen Leser, Händler wollen Käufer. Der Vorhang verbindet beide ohne separates Werbesystem. Ein Händler markiert ein Produkt, ein Autor verlinkt es oder schreibt über dasselbe Thema, und wenn ein Leser es kauft, wird der Autor mit Plattformguthaben belohnt. Die Auszahlung an den Händler sinkt nicht: Die Provision wird als zusätzliches Guthaben ausgegeben.

    News

    Auf Artikelseiten erscheinen die Produktangebote.

    Mitgliederblog

    Mitgliederbeiträge erhalten dieselben Produktangebote und Autorenprovision.

    Shop

    Händler schalten die Vorhang-Werbung im Produktformular ein.

    Typische Szenarien

    • Eine Food-Bloggerin verlinkt den Honig eines Hofs in einem Artikel. Leser sehen den Honig im Vorhang, tippen auf In den Warenkorb und bezahlen innerhalb von 30 Tagen. Die Bloggerin erhält 5% dieser Position als Guthaben.

    Konfiguration

    ring-config.template.json liefert diese Standardwerte. Überschreibe beliebige Schlüssel in der ring-config.json deines Klons. Die Werte liest getCurtainPolicy() in lib/ring-config-core.ts, validiert werden sie von parseCurtainPolicy in features/curtain/lib/policy.ts.

    SchlüsselStandardErlaubte Werte
    curtain.enabledtruefalse schaltet alle Angebote ab
    curtain.productSourcepage_then_poolpage_then_pool, page_only, pool_only
    curtain.maxImpressionsPerDay51 bis 50 pro Angebot und UTC-Tag
    curtain.notTodayHours241 bis 168

    Wie Angebote ausgewählt werden

    Related documentation

    Multi-Vendor Store

    Abhängigkeit: Produkte, Warenkorb und bezahlte Bestellungen, die die Provision auslösen.

    News Module

    Gleicher Ablauf: Artikelseiten mit Produktangeboten.

    Member Blogs

    Gleicher Ablauf: Mitgliederbeiträge zeigen dieselben Angebote.

    Credit Rewards

    Siehe auch: Guthaben-Belohnungen, die für die Provision aktiviert sein müssen.

    Referral Codes (Refcodes)

    1. Docs
    2. /Funktionen
    3. /Seitenvorhang

    Aktualisiert 26. Okt. 20265 Min. Anhören

    Seitenvorhang

    Der Seitenvorhang ist ein schmales Banner (etwa 10% der Bildschirmhöhe), das erscheint, wenn ein Besucher aufhört zu scrollen. Es zeigt eines von zwei Angeboten: Zum Startbildschirm hinzufügen für die App oder ein Produkt, das ein Händler bewerben möchte. Auf Newsartikeln und Beiträgen im Mitgliederblog kann ein aus dem Vorhang hinzugefügtes Produkt dem Autor der Seite eine Provision einbringen, wenn der Käufer später bezahlt.

    Nutze die Tabs Founder / Developer in der Seitenleiste der Dokumentation, um diese Seite zu filtern. Gemeinsame Abschnitte gelten für beide Zielgruppen.

    Status (2026-10-26): In Layer 1 ausgeliefert und pro Klon über den Block curtain in ring-config.json konfigurierbar. Die Warteschlange berücksichtigt jetzt frühere Ablehnungen, sodass ein Besucher, der Heute nicht gewählt hat, dasselbe Banner auf der nächsten Seite nicht erneut sieht.

    Ohne VorhangMit Vorhang
    Installationshinweise hängen vom Browser abRing bietet Zum Startbildschirm hinzufügen selbst an, einmal pro Richtlinienfenster
    Autoren verdienen nichts an erwähnten ProduktenAutoren erhalten zusätzliches Guthaben auf bezahlte Warenkörbe, die auf ihrer Seite begonnen haben
    Händler zahlen anderswo für WerbungHändler schalten ein Produkt frei und legen eine Autorenprovision von 1% bis 10% fest

    Warum das für deine Community wichtig ist

    Autoren bringen Leser, Händler wollen Käufer. Der Vorhang verbindet beide ohne separates Werbesystem. Ein Händler markiert ein Produkt, ein Autor verlinkt es oder schreibt über dasselbe Thema, und wenn ein Leser es kauft, wird der Autor mit Plattformguthaben belohnt. Die Auszahlung an den Händler sinkt nicht: Die Provision wird als zusätzliches Guthaben ausgegeben.

    News

    Auf Artikelseiten erscheinen die Produktangebote.

    Mitgliederblog

    Mitgliederbeiträge erhalten dieselben Produktangebote und Autorenprovision.

    Shop

    Händler schalten die Vorhang-Werbung im Produktformular ein.

    Typische Szenarien

    • Eine Food-Bloggerin verlinkt den Honig eines Hofs in einem Artikel. Leser sehen den Honig im Vorhang, tippen auf In den Warenkorb und bezahlen innerhalb von 30 Tagen. Die Bloggerin erhält 5% dieser Position als Guthaben.

    Konfiguration

    ring-config.template.json liefert diese Standardwerte. Überschreibe beliebige Schlüssel in der ring-config.json deines Klons. Die Werte liest getCurtainPolicy() in lib/ring-config-core.ts, validiert werden sie von parseCurtainPolicy in features/curtain/lib/policy.ts.

    SchlüsselStandardErlaubte Werte
    curtain.enabledtruefalse schaltet alle Angebote ab
    curtain.productSourcepage_then_poolpage_then_pool, page_only, pool_only
    curtain.maxImpressionsPerDay51 bis 50 pro Angebot und UTC-Tag
    curtain.notTodayHours241 bis 168

    Wie Angebote ausgewählt werden

    Related documentation

    Multi-Vendor Store

    Abhängigkeit: Produkte, Warenkorb und bezahlte Bestellungen, die die Provision auslösen.

    News Module

    Gleicher Ablauf: Artikelseiten mit Produktangeboten.

    Member Blogs

    Gleicher Ablauf: Mitgliederbeiträge zeigen dieselben Angebote.

    Credit Rewards

    Siehe auch: Guthaben-Belohnungen, die für die Provision aktiviert sein müssen.

    Referral Codes (Refcodes)

    1. Docs
    2. /Funktionen
    3. /Seitenvorhang

    Aktualisiert 26. Okt. 20265 Min. Anhören

    Seitenvorhang

    Der Seitenvorhang ist ein schmales Banner (etwa 10% der Bildschirmhöhe), das erscheint, wenn ein Besucher aufhört zu scrollen. Es zeigt eines von zwei Angeboten: Zum Startbildschirm hinzufügen für die App oder ein Produkt, das ein Händler bewerben möchte. Auf Newsartikeln und Beiträgen im Mitgliederblog kann ein aus dem Vorhang hinzugefügtes Produkt dem Autor der Seite eine Provision einbringen, wenn der Käufer später bezahlt.

    Nutze die Tabs Founder / Developer in der Seitenleiste der Dokumentation, um diese Seite zu filtern. Gemeinsame Abschnitte gelten für beide Zielgruppen.

    Status (2026-10-26): In Layer 1 ausgeliefert und pro Klon über den Block curtain in ring-config.json konfigurierbar. Die Warteschlange berücksichtigt jetzt frühere Ablehnungen, sodass ein Besucher, der Heute nicht gewählt hat, dasselbe Banner auf der nächsten Seite nicht erneut sieht.

    Ohne VorhangMit Vorhang
    Installationshinweise hängen vom Browser abRing bietet Zum Startbildschirm hinzufügen selbst an, einmal pro Richtlinienfenster
    Autoren verdienen nichts an erwähnten ProduktenAutoren erhalten zusätzliches Guthaben auf bezahlte Warenkörbe, die auf ihrer Seite begonnen haben
    Händler zahlen anderswo für WerbungHändler schalten ein Produkt frei und legen eine Autorenprovision von 1% bis 10% fest

    Warum das für deine Community wichtig ist

    Autoren bringen Leser, Händler wollen Käufer. Der Vorhang verbindet beide ohne separates Werbesystem. Ein Händler markiert ein Produkt, ein Autor verlinkt es oder schreibt über dasselbe Thema, und wenn ein Leser es kauft, wird der Autor mit Plattformguthaben belohnt. Die Auszahlung an den Händler sinkt nicht: Die Provision wird als zusätzliches Guthaben ausgegeben.

    News

    Auf Artikelseiten erscheinen die Produktangebote.

    Mitgliederblog

    Mitgliederbeiträge erhalten dieselben Produktangebote und Autorenprovision.

    Shop

    Händler schalten die Vorhang-Werbung im Produktformular ein.

    Typische Szenarien

    • Eine Food-Bloggerin verlinkt den Honig eines Hofs in einem Artikel. Leser sehen den Honig im Vorhang, tippen auf In den Warenkorb und bezahlen innerhalb von 30 Tagen. Die Bloggerin erhält 5% dieser Position als Guthaben.

    Konfiguration

    ring-config.template.json liefert diese Standardwerte. Überschreibe beliebige Schlüssel in der ring-config.json deines Klons. Die Werte liest getCurtainPolicy() in lib/ring-config-core.ts, validiert werden sie von parseCurtainPolicy in features/curtain/lib/policy.ts.

    SchlüsselStandardErlaubte Werte
    curtain.enabledtruefalse schaltet alle Angebote ab
    curtain.productSourcepage_then_poolpage_then_pool, page_only, pool_only
    curtain.maxImpressionsPerDay51 bis 50 pro Angebot und UTC-Tag
    curtain.notTodayHours241 bis 168

    Wie Angebote ausgewählt werden

    Related documentation

    Multi-Vendor Store

    Abhängigkeit: Produkte, Warenkorb und bezahlte Bestellungen, die die Provision auslösen.

    News Module

    Gleicher Ablauf: Artikelseiten mit Produktangeboten.

    Member Blogs

    Gleicher Ablauf: Mitgliederbeiträge zeigen dieselben Angebote.

    Credit Rewards

    Siehe auch: Guthaben-Belohnungen, die für die Provision aktiviert sein müssen.

    Referral Codes (Refcodes)

    1. Docs
    2. /Funktionen
    3. /Seitenvorhang

    Aktualisiert 26. Okt. 20265 Min. Anhören

  1. Ein neuer Besucher am Handy liest drei Seiten. Auf einer davon bietet der Vorhang Zum Startbildschirm hinzufügen an. Er tippt auf Heute nicht und sieht es 24 Stunden lang nicht wieder.
  2. Ein Leser tippt bei einem Produkt auf Nicht für mich. Dieses Produkt erscheint ihm nie wieder.
  3. Vom Artikel zur Autorenprovision

    Wo du die Ergebnisse siehst

    • Händler: Die Einnahmenseite zeigt einen 7-Tage-Trichter des Vorhangs: gezeigt, erneut gezeigt, CTA, heute nicht, nicht für mich, weggescrollt, bezahlt und ausgegebenes Guthaben.
    • Autoren: My News (/my-news) zeigt denselben 7-Tage-Trichter für die eigenen Seiten plus verdientes Vorhang-Guthaben.
    • Betreiber: Die Admin-Analyseseite zeigt denselben Trichter für den ganzen Klon, neben der aktiven Vorhang-Richtlinie.

    requestCurtainDrop in features/curtain/actions.ts liefert bis zu drei Angebote (CURTAIN_QUEUE_MAX):

    1. Wird komplett übersprungen, wenn die Richtlinie aus ist oder der Pfad mit /admin, /login, /register, /auth, /vendor oder /store/checkout beginnt.
    2. Produktangebote nur auf Seiten, die über CurtainPageProvider eine newsArticleId übergeben (Newsartikel und Beiträge im Mitgliederblog). Der Artikel muss veröffentlicht und für den Betrachter laut canViewNewsArticle sichtbar sein.
    3. Seitenprodukte sind /store/<id>-Links im Artikeltext. Poolprodukte sind aktive Produkte mit curtainAdvertiseEnabled. Jedes muss beworben, aktiv und mit Preis versehen sein, darf kein eigenes Händlerprodukt des Betrachters sein und nicht unterdrückt sein.
    4. Sortierung: zuerst verlinkte Produkte, dann Themenüberschneidung mit Kategorie und Tags des Artikels, dann weniger Einblendungen heute.
    5. Ein freier Platz wird mit Zum Startbildschirm hinzufügen gefüllt, wenn der Browser nicht schon die installierte App ausführt.

    curtain-host.tsx zeigt die Warteschlange an und wendet canShowOffer auf jedes Element an. Das behebt das Wiederauftauchen geschlossener Banner.

    Reaktionen der Besucher

    ReaktionWirkung
    CTAIn den Warenkorb (Produkt) oder Installationshinweis (A2HS)
    Heute nichtUnterdrückt für notTodayHours ab jetzt
    Nicht für michFür dieses Angebot dauerhaft unterdrückt
    WegscrollenWird protokolliert, keine Unterdrückung

    Einstellungen liegen in localStorage (ring_curtain_prefs) und für angemeldete Mitglieder zusätzlich in der Tabelle curtain_preferences (Migration 050, Teil von schema.sql) über syncCurtainPrefs.

    Attribution und Provision

    • Jedes Produktangebot trägt ein HMAC-offerToken aus features/curtain/lib/offer-token.ts, signiert mit AUTH_SECRET. Es verknüpft Angebot, Produkt, Autor und Artikel.
    • CTA-Kontakte werden im Cookie ring_curtain_attr und im Speicher gehalten (30-Tage-Fenster, höchstens 12 Kontakte).
    • Der Checkout behält nur Kontakte, die verifyCurtainTouches bestehen. Autor und Prozentsatz stammen aus dem Token und dem aktuellen Produkt, nie aus dem Browser.
    • Nach der Zahlung schreibt mintCurtainAuthorCommission in features/curtain/services/commission.ts dem Autor Guthaben gut: Zwischensumme der Position mal Prozentsatz des Produkts (1 bis 10, Standard 5). Eigenkäufe, der Werber der Bestellung und Duplikate werden übersprungen, und es läuft nur, wenn Guthaben-Belohnungen aktiviert sind.
    • Die Ereignisse curtain_shown, curtain_response, curtain_cta, curtain_suppress und curtain_paid speisen getCurtainFunnel in features/analytics/lib/curtain-analytics.ts.

    Freischaltung durch Händler

    Das Produktformular des Händlers enthält AdvertiseProductWidget (features/curtain/components/advertise-product-widget.tsx). Es schreibt curtainAdvertise: { enabled, commissionPercent } und curtainAdvertiseEnabled in das Produkt. Ein Produkt ohne Preis kann nicht beworben werden.

    Häufige Fragen

    Auswirkung

    Geht die Provision von der Auszahlung des Händlers ab?

    Nein. Es ist zusätzliches Guthaben für den Autor, verbucht mit der Quelle curtain_author.

    Migration

    Brauche ich eine Migration?

    Nicht bei einer Neuinstallation. Bestehende Datenbanken brauchen 050_curtain_offers.sql für curtain_preferences und den Analyse-Index.

    Betrieb

    Wie schalte ich den Vorhang für einen Klon ab?

    Setze "curtain": { "enabled": false } in der ring-config.json dieses Klons und baue neu.

    Siehe auch: Empfehlungsattribution mit demselben 30-Tage-Fenster.

  4. Ein neuer Besucher am Handy liest drei Seiten. Auf einer davon bietet der Vorhang Zum Startbildschirm hinzufügen an. Er tippt auf Heute nicht und sieht es 24 Stunden lang nicht wieder.
  5. Ein Leser tippt bei einem Produkt auf Nicht für mich. Dieses Produkt erscheint ihm nie wieder.
  6. Vom Artikel zur Autorenprovision

    Wo du die Ergebnisse siehst

    • Händler: Die Einnahmenseite zeigt einen 7-Tage-Trichter des Vorhangs: gezeigt, erneut gezeigt, CTA, heute nicht, nicht für mich, weggescrollt, bezahlt und ausgegebenes Guthaben.
    • Autoren: My News (/my-news) zeigt denselben 7-Tage-Trichter für die eigenen Seiten plus verdientes Vorhang-Guthaben.
    • Betreiber: Die Admin-Analyseseite zeigt denselben Trichter für den ganzen Klon, neben der aktiven Vorhang-Richtlinie.

    requestCurtainDrop in features/curtain/actions.ts liefert bis zu drei Angebote (CURTAIN_QUEUE_MAX):

    1. Wird komplett übersprungen, wenn die Richtlinie aus ist oder der Pfad mit /admin, /login, /register, /auth, /vendor oder /store/checkout beginnt.
    2. Produktangebote nur auf Seiten, die über CurtainPageProvider eine newsArticleId übergeben (Newsartikel und Beiträge im Mitgliederblog). Der Artikel muss veröffentlicht und für den Betrachter laut canViewNewsArticle sichtbar sein.
    3. Seitenprodukte sind /store/<id>-Links im Artikeltext. Poolprodukte sind aktive Produkte mit curtainAdvertiseEnabled. Jedes muss beworben, aktiv und mit Preis versehen sein, darf kein eigenes Händlerprodukt des Betrachters sein und nicht unterdrückt sein.
    4. Sortierung: zuerst verlinkte Produkte, dann Themenüberschneidung mit Kategorie und Tags des Artikels, dann weniger Einblendungen heute.
    5. Ein freier Platz wird mit Zum Startbildschirm hinzufügen gefüllt, wenn der Browser nicht schon die installierte App ausführt.

    curtain-host.tsx zeigt die Warteschlange an und wendet canShowOffer auf jedes Element an. Das behebt das Wiederauftauchen geschlossener Banner.

    Reaktionen der Besucher

    ReaktionWirkung
    CTAIn den Warenkorb (Produkt) oder Installationshinweis (A2HS)
    Heute nichtUnterdrückt für notTodayHours ab jetzt
    Nicht für michFür dieses Angebot dauerhaft unterdrückt
    WegscrollenWird protokolliert, keine Unterdrückung

    Einstellungen liegen in localStorage (ring_curtain_prefs) und für angemeldete Mitglieder zusätzlich in der Tabelle curtain_preferences (Migration 050, Teil von schema.sql) über syncCurtainPrefs.

    Attribution und Provision

    • Jedes Produktangebot trägt ein HMAC-offerToken aus features/curtain/lib/offer-token.ts, signiert mit AUTH_SECRET. Es verknüpft Angebot, Produkt, Autor und Artikel.
    • CTA-Kontakte werden im Cookie ring_curtain_attr und im Speicher gehalten (30-Tage-Fenster, höchstens 12 Kontakte).
    • Der Checkout behält nur Kontakte, die verifyCurtainTouches bestehen. Autor und Prozentsatz stammen aus dem Token und dem aktuellen Produkt, nie aus dem Browser.
    • Nach der Zahlung schreibt mintCurtainAuthorCommission in features/curtain/services/commission.ts dem Autor Guthaben gut: Zwischensumme der Position mal Prozentsatz des Produkts (1 bis 10, Standard 5). Eigenkäufe, der Werber der Bestellung und Duplikate werden übersprungen, und es läuft nur, wenn Guthaben-Belohnungen aktiviert sind.
    • Die Ereignisse curtain_shown, curtain_response, curtain_cta, curtain_suppress und curtain_paid speisen getCurtainFunnel in features/analytics/lib/curtain-analytics.ts.

    Freischaltung durch Händler

    Das Produktformular des Händlers enthält AdvertiseProductWidget (features/curtain/components/advertise-product-widget.tsx). Es schreibt curtainAdvertise: { enabled, commissionPercent } und curtainAdvertiseEnabled in das Produkt. Ein Produkt ohne Preis kann nicht beworben werden.

    Häufige Fragen

    Auswirkung

    Geht die Provision von der Auszahlung des Händlers ab?

    Nein. Es ist zusätzliches Guthaben für den Autor, verbucht mit der Quelle curtain_author.

    Migration

    Brauche ich eine Migration?

    Nicht bei einer Neuinstallation. Bestehende Datenbanken brauchen 050_curtain_offers.sql für curtain_preferences und den Analyse-Index.

    Betrieb

    Wie schalte ich den Vorhang für einen Klon ab?

    Setze "curtain": { "enabled": false } in der ring-config.json dieses Klons und baue neu.

    Siehe auch: Empfehlungsattribution mit demselben 30-Tage-Fenster.

  7. Ein neuer Besucher am Handy liest drei Seiten. Auf einer davon bietet der Vorhang Zum Startbildschirm hinzufügen an. Er tippt auf Heute nicht und sieht es 24 Stunden lang nicht wieder.
  8. Ein Leser tippt bei einem Produkt auf Nicht für mich. Dieses Produkt erscheint ihm nie wieder.
  9. Vom Artikel zur Autorenprovision

    Wo du die Ergebnisse siehst

    • Händler: Die Einnahmenseite zeigt einen 7-Tage-Trichter des Vorhangs: gezeigt, erneut gezeigt, CTA, heute nicht, nicht für mich, weggescrollt, bezahlt und ausgegebenes Guthaben.
    • Autoren: My News (/my-news) zeigt denselben 7-Tage-Trichter für die eigenen Seiten plus verdientes Vorhang-Guthaben.
    • Betreiber: Die Admin-Analyseseite zeigt denselben Trichter für den ganzen Klon, neben der aktiven Vorhang-Richtlinie.

    requestCurtainDrop in features/curtain/actions.ts liefert bis zu drei Angebote (CURTAIN_QUEUE_MAX):

    1. Wird komplett übersprungen, wenn die Richtlinie aus ist oder der Pfad mit /admin, /login, /register, /auth, /vendor oder /store/checkout beginnt.
    2. Produktangebote nur auf Seiten, die über CurtainPageProvider eine newsArticleId übergeben (Newsartikel und Beiträge im Mitgliederblog). Der Artikel muss veröffentlicht und für den Betrachter laut canViewNewsArticle sichtbar sein.
    3. Seitenprodukte sind /store/<id>-Links im Artikeltext. Poolprodukte sind aktive Produkte mit curtainAdvertiseEnabled. Jedes muss beworben, aktiv und mit Preis versehen sein, darf kein eigenes Händlerprodukt des Betrachters sein und nicht unterdrückt sein.
    4. Sortierung: zuerst verlinkte Produkte, dann Themenüberschneidung mit Kategorie und Tags des Artikels, dann weniger Einblendungen heute.
    5. Ein freier Platz wird mit Zum Startbildschirm hinzufügen gefüllt, wenn der Browser nicht schon die installierte App ausführt.

    curtain-host.tsx zeigt die Warteschlange an und wendet canShowOffer auf jedes Element an. Das behebt das Wiederauftauchen geschlossener Banner.

    Reaktionen der Besucher

    ReaktionWirkung
    CTAIn den Warenkorb (Produkt) oder Installationshinweis (A2HS)
    Heute nichtUnterdrückt für notTodayHours ab jetzt
    Nicht für michFür dieses Angebot dauerhaft unterdrückt
    WegscrollenWird protokolliert, keine Unterdrückung

    Einstellungen liegen in localStorage (ring_curtain_prefs) und für angemeldete Mitglieder zusätzlich in der Tabelle curtain_preferences (Migration 050, Teil von schema.sql) über syncCurtainPrefs.

    Attribution und Provision

    • Jedes Produktangebot trägt ein HMAC-offerToken aus features/curtain/lib/offer-token.ts, signiert mit AUTH_SECRET. Es verknüpft Angebot, Produkt, Autor und Artikel.
    • CTA-Kontakte werden im Cookie ring_curtain_attr und im Speicher gehalten (30-Tage-Fenster, höchstens 12 Kontakte).
    • Der Checkout behält nur Kontakte, die verifyCurtainTouches bestehen. Autor und Prozentsatz stammen aus dem Token und dem aktuellen Produkt, nie aus dem Browser.
    • Nach der Zahlung schreibt mintCurtainAuthorCommission in features/curtain/services/commission.ts dem Autor Guthaben gut: Zwischensumme der Position mal Prozentsatz des Produkts (1 bis 10, Standard 5). Eigenkäufe, der Werber der Bestellung und Duplikate werden übersprungen, und es läuft nur, wenn Guthaben-Belohnungen aktiviert sind.
    • Die Ereignisse curtain_shown, curtain_response, curtain_cta, curtain_suppress und curtain_paid speisen getCurtainFunnel in features/analytics/lib/curtain-analytics.ts.

    Freischaltung durch Händler

    Das Produktformular des Händlers enthält AdvertiseProductWidget (features/curtain/components/advertise-product-widget.tsx). Es schreibt curtainAdvertise: { enabled, commissionPercent } und curtainAdvertiseEnabled in das Produkt. Ein Produkt ohne Preis kann nicht beworben werden.

    Häufige Fragen

    Auswirkung

    Geht die Provision von der Auszahlung des Händlers ab?

    Nein. Es ist zusätzliches Guthaben für den Autor, verbucht mit der Quelle curtain_author.

    Migration

    Brauche ich eine Migration?

    Nicht bei einer Neuinstallation. Bestehende Datenbanken brauchen 050_curtain_offers.sql für curtain_preferences und den Analyse-Index.

    Betrieb

    Wie schalte ich den Vorhang für einen Klon ab?

    Setze "curtain": { "enabled": false } in der ring-config.json dieses Klons und baue neu.

    Siehe auch: Empfehlungsattribution mit demselben 30-Tage-Fenster.