Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.mellowtel.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Was es ist

Mellowtel wird kein einziges Byte Bandbreite teilen, bis der Benutzer ausdrücklich zugestimmt hat, und der Benutzer muss immer eine offensichtliche Möglichkeit haben, sich wieder abzumelden. Dies ist eine strikte Anforderung des SDKs und eine strikte Anforderung jeder Browser-Store-Richtlinie, die Mellowtel-basierte Erweiterungen zulässt.

​
Warum es wichtig ist

Es ist die Bandbreite des Benutzers. Alles andere als eine ausdrückliche, widerrufbare Zustimmung ist sowohl unethisch als auch ein Grund für die Entfernung aus dem Store. Das SDK ist so konzipiert, dass der einfache Weg auch der konforme Weg ist. Wenn du die empfohlene Implementierung befolgst, kannst du nicht versehentlich eine Version veröffentlichen, die ohne Zustimmung aktiviert wird.

​
Wie es funktioniert

Bei der ersten Installation (und bei jedem Update, das Mellowtel neu einführt) musst du dem Benutzer einen nicht abweisbaren Hinweis anzeigen, der erklärt, was Mellowtel tut, und dann seine Wahl erfassen. Ab dann muss ein Einstellungslink von einem offensichtlichen Ort in deiner Benutzeroberfläche erreichbar sein, damit sie ihre Meinung ändern können.
Beispiel für einen Disclaimer
Du hast zwei Implementierungsoptionen:
  1. Empfohlen: Öffne die vorgefertigte Mellowtel-Opt-In-Seite mit generateAndOpenOptInLink(). Ein Methodenaufruf, vollständig konform, maximiert die Opt-In-Konversion.
  2. Benutzerdefinierte UI: Baue deine eigene Zustimmungsschnittstelle und rufe optIn() / optOut() selbst auf.

​
API-Oberfläche

MethodeRückgabewertVerwende es, um
generateAndOpenOptInLink()Promise<void>Öffne die gehostete Opt-In-Seite (empfohlener Weg).
getOptInStatus()Promise<boolean>Überprüfe, ob der Benutzer bereits zugestimmt hat.
optIn()Promise<void>Zustimmung aus deiner eigenen UI aufzeichnen.
optOut()Promise<void>Zustimmung aus deiner eigenen UI widerrufen.
start()Promise<void>Beginne mit der Bearbeitung von Anfragen nach Opt-In.
generateSettingsLink()Promise<string>URL zur gehosteten Einstellungsseite, damit Benutzer ihre Wahl später ändern können.
Alle Methoden sind von jedem Teil deiner Erweiterung aus zugänglich: Popup, Inhaltsskript oder Hintergrundskript.

​
Empfohlene Implementierung

Die vollständige Integrationsanleitung befindet sich in den Plattform-Schnellstarts. Sie zeigen, wo das SDK platziert werden soll, wie es in den Installations-/Update-Lebenszyklus integriert wird und wie es getestet wird: Kurz gesagt, nach new Mellowtel(...) und initBackground(), rufe generateAndOpenOptInLink() von deinem Installations-/Update-Handler auf. Das war’s.

​
Benutzerdefinierte UI

Wenn du die volle Kontrolle über die Zustimmungsschnittstelle haben möchtest, erfasse die Wahl des Benutzers in deiner eigenen UI und leite sie an das SDK weiter: 
// Benutzer hat zugestimmt
await mellowtel.optIn();
await mellowtel.start();

// Benutzer hat abgelehnt oder später widerrufen
await mellowtel.optOut();

// Status überprüfen (z.B. um einen Schalter anzuzeigen)
const hasOptedIn = await mellowtel.getOptInStatus();
Welche UI du auch immer baust, sie muss:
  1. Bei der ersten Installation nicht abweisbar sein.
  2. Standardmäßig auf abgemeldet sein, bis der Benutzer aktiv zustimmt.
  3. Von einem offensichtlichen Ort in deinem Produkt aus wieder geöffnet werden können, damit Benutzer ihre Wahl ändern können.
Benutzer müssen immer eine einfache Möglichkeit haben, ihre Einstellungen zu ändern. Verwende generateSettingsLink(), um eine URL zur gehosteten Einstellungsseite zu erhalten, und platziere sie an einem dauerhaften Ort: deinem Popup, einer Optionsseite, einem Kontobildschirm. 
const settingsUrl = await mellowtel.generateSettingsLink();

​
Ankündigung von Mellowtel an bestehende Benutzer

Wenn du Mellowtel zu einer Erweiterung hinzufügst, die bereits Benutzer hat, musst du ihnen mitteilen, was sich geändert hat, bevor du um Zustimmung bittest. Wir stellen eine Kopiervorlage für Ankündigungen zur Verfügung, die du anpassen kannst.

​
Verwandte Themen

  • Datenschutz: was Benutzer tatsächlich zu teilen zustimmen.
  • Rate Limiting: wie das SDK Benutzer schützt, die zustimmen.