Що це таке
Mellowtel не буде ділитися жодним байтом пропускної здатності, поки користувач явно не підключиться, і користувач завжди повинен мати очевидний спосіб відключитися. Це жорстка вимога SDK та жорстка вимога кожної політики магазину браузера, яка дозволяє розширення на основі Mellowtel.Чому це важливо
Це пропускна здатність користувача. Будь-яка згода, яка не є явною та відкликаною, є як неетичною, так і підставою для видалення з магазину. SDK розроблено так, щоб простий шлях також був відповідним. Якщо ти дотримуєшся рекомендованої реалізації, ти не зможеш випадково випустити версію, яка активується без згоди.Як це працює
При першій установці (і при будь-якому оновленні, яке вперше вводить Mellowtel) ти повинен показати користувачеві не закривається відмову від відповідальності, яка пояснює, що робить Mellowtel, а потім зафіксувати їх вибір. Відтоді посилання на налаштування повинно бути доступним з якогось очевидного місця у твоєму інтерфейсі, щоб вони могли змінити своє рішення.
- Рекомендовано: відкрити попередньо створену сторінку підключення Mellowtel за допомогою
generateAndOpenOptInLink(). Один виклик методу, повністю відповідний, максимізує конверсію підключення. - Користувацький інтерфейс: створити власну поверхню згоди та викликати
optIn()/optOut()самостійно.
API поверхня
| Метод | Повертає | Використовуй для |
|---|---|---|
generateAndOpenOptInLink() | Promise<void> | Відкрити розміщену сторінку підключення (рекомендований шлях). |
getOptInStatus() | Promise<boolean> | Перевірити, чи вже користувач підключився. |
optIn() | Promise<void> | Зафіксувати згоду з твого власного інтерфейсу. |
optOut() | Promise<void> | Відкликати згоду з твого власного інтерфейсу. |
start() | Promise<void> | Почати обслуговування запитів після підключення. |
generateSettingsLink() | Promise<string> | URL до розміщеної сторінки налаштувань, щоб користувачі могли змінити свій вибір пізніше. |
Рекомендована реалізація
Повний посібник з інтеграції знаходиться у швидких стартових посібниках платформи. Вони показують, де розмістити SDK, як підключити його до життєвого циклу встановлення/оновлення та як його тестувати:- Швидкий старт для плагінів браузера
- Швидкий старт для настільних додатків
- Швидкий старт для вебсайтів
- Швидкий старт для мобільних додатків
new Mellowtel(...) та initBackground(), виклич generateAndOpenOptInLink() з твого обробника встановлення/оновлення. Це все.
Користувацький інтерфейс
Якщо ти хочеш повністю контролювати поверхню згоди, зафіксуй вибір користувача у своєму інтерфейсі та передай його до SDK:- Бути не закривається при першій установці.
- За замовчуванням бути відключеним, поки користувач активно не погодиться.
- Бути повторно відкривається з якогось очевидного місця у твоєму продукті, щоб користувачі могли змінити свій вибір.
Посилання на налаштування
Користувачі завжди повинні мати легкий спосіб змінити свої налаштування. ВикористовуйgenerateSettingsLink(), щоб отримати URL до розміщеної сторінки налаштувань і розмісти його десь постійно: у твоєму спливаючому вікні, на сторінці опцій, на екрані облікового запису.
Оголошення Mellowtel для існуючих користувачів
Якщо ти додаєш Mellowtel до розширення, яке вже має користувачів, ти повинен повідомити їм, що змінилося, перш ніж запитувати згоду. Ми надаємо шаблон оголошення для копіювання та вставки, який ти можеш адаптувати.Пов’язані
- Конфіденційність: що користувачі фактично погоджуються ділитися.
- Обмеження швидкості: як SDK захищає користувачів, які підключилися.