Guia de Consentimento de Usuário Opt-In e Opt-Out da Mellowtel

O que é

A Mellowtel não compartilhará um único byte de largura de banda até que o usuário tenha optado explicitamente por participar, e o usuário deve sempre ter uma maneira óbvia de optar por sair novamente. Este é um requisito rigoroso do SDK e um requisito rigoroso de todas as políticas de lojas de navegadores que permitem extensões baseadas na Mellowtel.

Por que é importante

É a largura de banda do usuário. Qualquer coisa menos que um consentimento explícito e revogável é tanto antiético quanto motivo para remoção da loja. O SDK é projetado para que o caminho fácil seja também o caminho conforme. Se você seguir a implementação recomendada, não poderá acidentalmente lançar uma versão que ative sem consentimento.

Como funciona

Na primeira instalação (e em qualquer atualização que introduza a Mellowtel), você deve mostrar ao usuário um aviso não descartável que explique o que a Mellowtel faz, e então capturar sua escolha. A partir de então, um link de configurações deve ser acessível de algum lugar óbvio na sua UI para que eles possam mudar de ideia.

Você tem duas opções de implementação:

Recomendado: abra a página de opt-in pré-construída da Mellowtel com generateAndOpenOptInLink(). Uma chamada de método, totalmente conforme, maximiza a conversão de opt-in.
UI Personalizada: construa sua própria interface de consentimento e chame optIn() / optOut() você mesmo.

Superfície da API

Método	Retorna	Use para
`generateAndOpenOptInLink()`	`Promise<void>`	Abrir a página de opt-in hospedada (caminho recomendado).
`getOptInStatus()`	`Promise<boolean>`	Verificar se o usuário já optou por participar.
`optIn()`	`Promise<void>`	Registrar consentimento a partir da sua própria UI.
`optOut()`	`Promise<void>`	Revogar consentimento a partir da sua própria UI.
`start()`	`Promise<void>`	Começar a atender solicitações após o opt-in.
`generateSettingsLink()`	`Promise<string>`	URL para a página de configurações hospedada para que os usuários possam mudar sua escolha posteriormente.

Todos os métodos são acessíveis de qualquer parte da sua extensão: popup, script de conteúdo ou script de fundo.

Implementação recomendada

O guia completo de integração está nos quickstarts da plataforma. Eles mostram onde colocar o SDK, como integrá-lo no ciclo de vida de instalação/atualização e como testá-lo:

Em resumo, após new Mellowtel(...) e initBackground(), chame generateAndOpenOptInLink() do seu manipulador de instalação/atualização. É isso.

UI Personalizada

Se você quiser controle total sobre a interface de consentimento, capture a escolha do usuário na sua própria UI e encaminhe para o SDK:

// Usuário concordou
await mellowtel.optIn();
await mellowtel.start();

// Usuário recusou ou revogou posteriormente
await mellowtel.optOut();

// Verificar status (por exemplo, para renderizar um toggle)
const hasOptedIn = await mellowtel.getOptInStatus();

Qualquer UI que você construir deve:

Ser não descartável na primeira instalação.
Padrão para optado fora até que o usuário ativamente concorde.
Ser reaberta de algum lugar óbvio no seu produto para que os usuários possam mudar sua escolha.

Link de configurações

Os usuários devem sempre ter uma maneira fácil de mudar suas configurações. Use generateSettingsLink() para obter uma URL para a página de configurações hospedada e coloque-a em algum lugar persistente: seu popup, uma página de opções, uma tela de conta.

const settingsUrl = await mellowtel.generateSettingsLink();

Anunciando a Mellowtel para usuários existentes

Se você estiver adicionando a Mellowtel a uma extensão que já tem usuários, você precisa informá-los sobre o que mudou antes de pedir consentimento. Nós fornecemos um modelo de anúncio para copiar e colar que você pode adaptar.

Relacionados

Privacidade: o que os usuários estão realmente concordando em compartilhar.
Limitação de Taxa: como o SDK protege os usuários que optam por participar.

​O que é

​Por que é importante

​Como funciona

​Superfície da API

​Implementação recomendada

​UI Personalizada

​Link de configurações

​Anunciando a Mellowtel para usuários existentes

​Relacionados