Übersicht
Ein Zugriffsrecht ist eine Erlaubnis, die Frisbii Media einem Kunden gewährt, wenn dieser ein Angebot kauft. Es teilt Deiner Website, App oder Deinem Content-Management-System mit, worauf der Kunde zugreifen darf - zum Beispiel auf Premium-Artikel oder eine E-Paper-Ausgabe.
Zugriffsrechte werden im Merchant Backend erstellt und müssen mindestens einem Angebot zugewiesen werden, bevor sie aktiv werden. Wenn ein Kunde einen Kauf abschließt, gewährt Frisbii Media die entsprechenden Zugriffsrechte zu seinem Konto. Dein externes System prüft dann diese Zugriffsrechte über die Frisbii Media API, um zu entscheiden, ob Inhalte angezeigt oder gesperrt werden sollen.
Hinweis
Die Zugriffsrechte müssen eingerichtet werden, bevor Du Deine Angebote erstellst. Sie sind ein notwendiger Bestandteil jedes Angebots im Merchant Backend.
Zugriffsrechte anlegen
Folgendermaßen vorgehen, um ein Zugriffsrecht zu erstellen:
In der Navigationsleiste Produkte → Zugriffsrechte anklicken.
Zugriffsrecht hinzufügen anklicken.
Die folgenden Felder ausfüllen:
Titel: Ein Name nur für den internen Gebrauch. Die Kunden sehen diesen Namen nicht.
Zugriffsrecht (uniqueID): Der eindeutige Bezeichner, der für die Erteilung und Überprüfung der Berechtigung in Deinem externen System verwendet wird. Zum Beispiel:
epaperoderarticle_plus. Die uniqueID muss für alle Zugriffsrechte in Deinem Konto eindeutig sein und wird mit Deinem CMS- oder Paywall-System geteilt - stimme diesen Wert mit Deinem technischen Team ab, bevor Du die Zugriffsrechte erstellst.Zusätzliche Daten für Drittsysteme (optional): Verwende dieses Feld, um zusätzliche Metadaten über die API an verbundene Systeme zu übermitteln, z. B. einen Produktcode oder eine Kategoriekennung, die Dein CMS für die korrekte Zuordnung des Zugriffsrechts benötigt.
Beschreibung (optional): Eine kurze Notiz, die beschreibt, was dieses Zugriffsrecht freischaltet. Zum Beispiel: "bietet Zugang zu Plus-Artikeln". Nützlich als interne Referenz bei der Verwaltung mehrerer Zugriffsrechte.
Wichtig
Benenne die uniqueID nicht um und ändere sie nicht, wenn es bereits aktive Abonnements gibt. Dein CMS oder Deine Paywall verwendet diese ID, um den Kundenzugang zu verifizieren - eine Änderung dieser ID führt dazu, dass die Verbindung für bestehende Abonnenten unterbrochen wird.
Beispiel
Ein Verlag möchte zwei verschiedene Arten von Inhalten verkaufen: Website-Artikel und eine E-Paper-Ausgabe. Er erstellt zwei Zugriffsrechte - Artikel und Epaper - und baut daraus drei separate Angebote:
Aus diesen zwei Zugriffsrechten können so flexibel drei Angebote erstellt werden:
Angebot 1: Zugriff zu exklusiven Artikeln auf einer Website, durch Zugriffsrecht articles
Angebot 2: Zugriff zur elektronischen Ausgabe eines Magazins, durch Zugriffsrecht epaper_access
Angebot 3: Kombinationspaket aus Angebot 1 und 2, durch beide Zugangsrechte - Artikel und Epaper
Wie Zugriffsrechte den Zugriff auf Inhalte steuern
Damit die Zugriffsrechte den Zugriff auf die Inhalte auf Deiner Website oder Anwendung kontrollieren können, müssen sie über die Frisbii Media API verifiziert werden.
Der Verifizierungsprozess funktioniert wie folgt:
Der Kunde meldet sich bei Deiner Website oder Anwendung an
Der Kunde versucht, auf geschützte Inhalte zuzugreifen (z. B. einen Premium-Artikel, eine E-Paper-Ausgabe oder ein exklusives Video)
Dein Paywall-System fragt die Frisbii Media API unter Verwendung der ID des Kunden und der eindeutigen ID des gewünschten Zugriffsrechts ab
API gibt den Zugriffsstatus zurück - ob der Kunde ein gültiges Zugriffsrecht hat
Inhalte werden auf der Grundlage der API-Antwort angezeigt oder gesperrt
Zugriffsrechte im Kundenkonto prüfen und verwalten
Sobald ein Kunde einen Kauf abgeschlossen hat, gewährt Frisbii Media die entsprechenden Zugriffsrechte zu seinem Konto. Du kannst diese Zugriffsrechte direkt im Kundenkonto im Merchant Backend anzeigen, bearbeiten und sperren - nützlich für die Fehlersuche bei Zugriffsproblemen oder die Durchführung manueller Anpassungen.
Im Kundenkonto zur Registerkarte Zugriffsrechte navigieren. Von dort aus kannst Du:
Prüfe, welche Zugriffsrechte derzeit für den Kunden aktiv sind, und überprüfe Details, wie die UniqueID, die Produkt-ID und den Ursprung jedes Zugriffsrechts.
Bearbeite oder lösche manuell hinzugefügte Zugriffsrechte (Typ: extern).
Sperre die Zugriffsrechte für einzelne Produkte und Zeitpässe direkt in dieser Registerkarte. Um ein Zugriffsrecht für ein Abonnement zu sperren, gehe stattdessen zur Detailansicht des Abonnements.