Mellowtel Opt-In en Opt-Out Gebruikerstoestemming API Gids

Wat het is

Mellowtel zal geen enkele byte bandbreedte delen totdat de gebruiker expliciet heeft ingestemd, en de gebruiker moet altijd een duidelijke manier hebben om zich weer af te melden. Dit is een harde eis van de SDK en een harde eis van elk browserwinkelbeleid dat Mellowtel-gebaseerde extensies toestaat.

Waarom het belangrijk is

Het is de bandbreedte van de gebruiker. Alles minder dan expliciete, herroepbare toestemming is zowel onethisch als een reden voor verwijdering uit de winkel. De SDK is zo ontworpen dat het eenvoudige pad ook het conforme pad is. Als je de aanbevolen implementatie volgt, kun je niet per ongeluk een versie verzenden die zonder toestemming wordt geactiveerd.

Hoe het werkt

Bij de eerste installatie (en bij elke update die Mellowtel nieuw introduceert) moet je de gebruiker een niet-wegklikbare disclaimer tonen die uitlegt wat Mellowtel doet, en vervolgens hun keuze vastleggen. Vanaf dat moment moet een instellingenlink bereikbaar zijn vanaf een duidelijke plek in je UI, zodat ze van gedachten kunnen veranderen.

Je hebt twee implementatieopties:

Aanbevolen: open de vooraf gebouwde Mellowtel opt-in pagina met generateAndOpenOptInLink(). Eén methode-aanroep, volledig conform, maximaliseert opt-in conversie.
Aangepaste UI: bouw je eigen toestemmingsinterface en roep zelf optIn() / optOut() aan.

API-oppervlak

Methode	Retourneert	Gebruik het om
`generateAndOpenOptInLink()`	`Promise<void>`	Open de gehoste opt-in pagina (aanbevolen pad).
`getOptInStatus()`	`Promise<boolean>`	Controleer of de gebruiker al heeft ingestemd.
`optIn()`	`Promise<void>`	Leg toestemming vast vanuit je eigen UI.
`optOut()`	`Promise<void>`	Trek toestemming in vanuit je eigen UI.
`start()`	`Promise<void>`	Begin met het verwerken van verzoeken na opt-in.
`generateSettingsLink()`	`Promise<string>`	URL naar de gehoste instellingenpagina zodat gebruikers hun keuze later kunnen wijzigen.

Alle methoden zijn toegankelijk vanuit elk deel van je extensie: popup, inhoudsscript of achtergrondscript.

Aanbevolen implementatie

De volledige integratiehandleiding staat in de platform quickstarts. Ze laten zien waar je de SDK plaatst, hoe je het in de installatie-/updatecyclus integreert en hoe je het test:

Kort gezegd, na new Mellowtel(...) en initBackground(), roep generateAndOpenOptInLink() aan vanuit je installatie-/updatehandler. Dat is alles.

Aangepaste UI

Als je volledige controle wilt over de toestemmingsinterface, leg de keuze van de gebruiker vast in je eigen UI en stuur deze door naar de SDK:

// Gebruiker heeft ingestemd
await mellowtel.optIn();
await mellowtel.start();

// Gebruiker weigerde of trok later toestemming in
await mellowtel.optOut();

// Controleer status (bijv. om een schakelaar weer te geven)
const hasOptedIn = await mellowtel.getOptInStatus();

Welke UI je ook bouwt, het moet:

Niet-wegklikbaar zijn bij de eerste installatie.
Standaard op uitgeschakeld staan totdat de gebruiker actief instemt.
Opnieuw te openen zijn vanaf een duidelijke plek in je product zodat gebruikers hun keuze kunnen wijzigen.

Instellingenlink

Gebruikers moeten altijd een gemakkelijke manier hebben om hun instellingen te wijzigen. Gebruik generateSettingsLink() om een URL naar de gehoste instellingenpagina te krijgen en plaats deze ergens permanent: je popup, een optiepagin, een accountscherm.

const settingsUrl = await mellowtel.generateSettingsLink();

Mellowtel aankondigen aan bestaande gebruikers

Als je Mellowtel toevoegt aan een extensie die al gebruikers heeft, moet je hen vertellen wat er is veranderd voordat je om toestemming vraagt. We bieden een kopieer-en-plak aankondigingssjabloon die je kunt aanpassen.

Gerelateerd

Privacy: waar gebruikers daadwerkelijk mee instemmen om te delen.
Rate Limiting: hoe de SDK gebruikers beschermt die wel instemmen.

​Wat het is

​Waarom het belangrijk is

​Hoe het werkt

​API-oppervlak

​Aanbevolen implementatie

​Aangepaste UI

​Instellingenlink

​Mellowtel aankondigen aan bestaande gebruikers

​Gerelateerd