Piano Plug-in

Die Business Plattform piano.io entwickelt u. a. Werkzeuge zum intelligenten Management von Abonnements und Abonnent:innen. Für das PEIQ PORTAL gibt es ein generisches Plug-in zum Anschluss dieser Plattform. Damit ist es möglich, über piano die Customer Journey für Paid Content-Abonnements und Newsletter-Abonnements abzubilden und zu steuern.

Funktionalitäten des piano Plug-ins

Anbindung einer externen Abonnentenverwaltung zur Abbildung einer automatisierten Akquisition und Verwaltung von Abonnent:innen und Zahlungsdaten
Integration des Registrierungs- und Login-Workflow von piano
Erreichen der My-Account-Komponente von piano über die Account-Einstellungen des PEIQ PORTALs

Inhaltsverzeichnis

1 Allgemeine Beschreibung
2 Account-Einstellungen
- 2.1 Passwort wiederherstellen
- 2.2 Workflow
3 Ausspielen der Lesebeschränkung
4 Verwandte Seiten

Allgemeine Beschreibung

Die Schnittstelle zu piano ist eine SSO Schnittstelle, basierend auf OAuth 2.0, zur piano Nutzerdatenbank piano ID. Dabei ist die Nutzerdatenbank von piano führend. Das bedeutet, dass der Registrierungs- und Login-Workflow von PEIQ für diese Schnittstelle abgeschalten und durch den piano Workflow ersetzt wird. Alle Benutzer:innen – Leser:innen und Redakteur:innen – melden sich über diesen Workflow an. Nach der Anmeldung wird der oder die Benutzer:in auf die Startseite oder auf den jeweiligen Inhalt, auf welchem er bzw. sie sich befindet weitergeleitet und ist automatisch auch bei piano eingeloggt. Beim Abmelden über das Benutzermenü wird der bzw. die Benutzer:in aus beiden Systemen ausgeloggt.

Die Berechtigung zum Lesen von https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/68125893 wird in piano gesteuert. Nach der Registrierung wird dem bzw. der Benutzer:in im PORTAL eine Default-Berechtigungsgruppe zugewiesen, die von berechtigten Benutzer:innen über die Administration & Moderation frei definiert werden kann.

Account-Einstellungen

Zur Bearbeitung der Benutzer:innen- und Abodaten wird die My-Account-Komponente von piano genutzt, welche über die Account-Einstellungen des PEIQ PORTALs per Link erreichbar ist. Dadurch erhalten Abonnent:innen im PORTAL Zugriff auf ihre Abos und Transaktionen, die in der piano Nutzerdatenbank verwaltet werden, und können hierüber ihre persönlichen Daten und Abo-Daten jederzeit ändern.

Account-Einstellungen der My-Account-Komponente von piano

Ändert ein:e Benutzer:in seine bzw. ihre Angaben, wird ein Relogin angestoßen (optional – muss explizit aktiviert werden). Dadurch, dass der bzw. die Benutzer:in ausgeloggt wird und sich erneut einloggen muss, wird die Änderung direkt umgesetzt.

Bei dem Versuch, auf die Account-Einstellungen im nicht angemeldeten Zustand zuzugreifen, erscheint die Login-Maske von piano mit der Aufforderung zur Anmeldung.

Passwort wiederherstellen

Damit auch Abonnent:innen die Passwort-vergessen-Funktion im PORTAL nutzen können, wird über ein JavaScript ein piano-Template bereitgestellt, über welches der bzw. die Benutzer:in sein bzw. ihr Passwort wiederherstellen kann.

^{Overlay für Passwort wiederherstellen}

Workflow

Loggt sich ein:e Benutzer:in über die Login-Maske von piano (erreichbar über das Conversion-Element der Paywall oder das Benutzer-Icon in der Navigation) ein, wird geprüft, ob der oder die Benutzer:in bereits im PORTAL angemeldet ist. Nach erfolgter Anmeldung wird der oder die Benutzer:in automatisch auch bei piano eingeloggt. Dadurch erhält der oder die Benutzer:in auch direkten Zugriff auf Premium Inhalte.

Während die Schnittstelle zur Nutzerbank piano ID im Backend implementiert ist, werden die restlichen Tools von piano entweder clientseitig via JavaScript in das PORTAL Frontend eingebaut oder direkt in piano mit ID verknüpft.

Dies betrifft folgende Tools:

VX: In VX werden in piano Abos erstellt und gemanaged sowie Content-Präferenzen von Benutzer:innen gespeichert. Das dient als Basis, um dynamische Paywalls auszuspielen.
- Nähere Informationen hierzu unter: https://docs.piano.io/product/vx/
Composer: Mit Composer werden die dynamischen Paywalls von piano gesteuert. Im PORTAL ist das Premium-Feature so eingestellt, dass der Text vollständig lesbar ist. piano übernimmt via VX und Composer an der Stelle die Selektion von Inhalten. Die Ausspielung der dynamischen Paywalls erfolgt über eine clientseitige JavaScript-Einbindung.
- Nähere Informationen hierzu unter: https://docs.piano.io/product/composer/

Die Verwendung des Premium-Features von PEIQ wird beibehalten. Das Plug-in gibt diese Eigenschaft bei gesetzter Markierung “Premium Content” an piano weiter.

tp.push(['setTags', ['premium']]);

ESP: Mit dem ESP ist ein personalisierter Newsletter Versand möglich. Das ESP ist nicht direkt mit dem PORTAL verknüpft, sondern wird in piano selbst mit ID verknüpft. Die Conversion Teaser hierfür werden via HTML-Kurations- / Targetingslots im PORTAL angeteasert. Sie können bei Bedarf auch fest im PORTAL eingebaut werden.
- Nähere Informationen hierzu unter: https://docs.piano.io/product/esp
Ad-Block Detection: Mit dem AdBlock Detector erscheint bei eingeschaltetem AdBlocker ein Hinweis, dass dieser bitte ausgeschaltet werden soll, um den Content der Seite sehen zu können. Die Integration des Ad-Block Detectors erfolgt mit einem eigenen Skript. Das Skript muss erst in piano selbst generiert werden, um es anschließend einbinden zu können.
- Nähere Informationen hierzu unter: https://docs.piano.io/enabling-ad-block-detection/

//Sample Code
<script>
    document.cookie = "__adblocker=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/";
    var setNptTechAdblockerCookie = function(adblocker) {
        var d = new Date();
        d.setTime(d.getTime() + 60 * 5 * 1000);
        document.cookie = "__adblocker=" + (adblocker ? "true" : "false") + "; expires=" + d.toUTCString() + "; path=/";
    };
    var script = document.createElement("script");
    script.setAttribute("async", true);
    script.setAttribute("src", "//www.npttech.com/advertising.js");
    script.setAttribute("onerror", "setNptTechAdblockerCookie(true);");
    document.getElementsByTagName("head")[0].appendChild(script);
</script>

Ausspielen der Lesebeschränkung

Da die Lesebeschränkung von piano nur im Front-End der Seite stattfindet, ist es für digitalaffine Benutzer:innen möglich, diese zu umgehen. Um die Umgehung zu erschweren wurde für das PEIQ PORTAL eine Funktion gebaut, die im piano Backend (Composer) für nicht-Leseberechtigte Benutzer:innen ausgeführt werden kann.

Die Ausführung der JavaScript-Funktion führt zu folgendem Workflow:

Über das PEIQ PORTAL wird der Artikeltext zunächst vollständig ausgespielt - unabhängig davon, ob die Lesebeschränkung automatisch nach den definierten algorithmischen Einstellungen des PEIQ PORTAL oder manuell von dem oder der Benutzer:in gesetzt wird. Damit piano.io die gesetzte Markierung erkennt, wird der Text in zwei DIVs <data-premium-teaser> (Text vor der Leseschranke) und <data-content-text> (Text nach der Leseschranke) aufgeteilt. Diese können dann mittels HTML-Selektoren von der piano Plattform separat angesprochen und mit der dynamischen piano-Paywall bespielt werden.

Konkret wird für Benutzer:innen, die keine Berechtigung zum Lesen des Inhalts haben, per Javascript die Funktion window.pianoRC() aufgerufen, welche im PORTAL dazu führt, dass der Inhalt in <data-content-text> geleert wird. Im piano Backend kann nach dem Aufruf der Funktion das nun leere Div <data-content-text> dann mittels jquery Selektor ( $('[data-content-text]') ) mit dem HTML Template für die Paywall befüllt werden.