الانتقال إلى المحتوى الرئيسي

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.

​
واش هو

ميلووتل ما راح يشارك حتى بايت واحد من عرض النطاق حتى المستخدم يوافق بشكل صريح، والمستخدم لازم يكون عنده دايما طريقة واضحة باش يقدر يلغي الموافقة. هذي شرط صارم من الـSDK وشرط صارم من كل سياسات متاجر المتصفح اللي تسمح بملحقات مبنية على ميلووتل.

​
علاش يهم

هذيك عرض النطاق تاع المستخدم. أي حاجة أقل من الموافقة الصريحة والقابلة للإلغاء تعتبر غير أخلاقية وسبب لحذفها من المتجر. الـSDK مصمم باش الطريق السهل يكون هو الطريق المتوافق. إذا تبعت التنفيذ الموصى به، ما تقدرش بالغلط تطلق نسخة تشتغل بلا موافقة.

​
كيفاش يخدم

في التثبيت الأول (وأي تحديث جديد يضيف ميلووتل) لازم توري المستخدم بيان غير قابل للإغلاق يشرح واش يدير ميلووتل، ومن بعد تسجل اختيارهم. من بعد، لازم يكون رابط الإعدادات قابل للوصول من مكان واضح في واجهة المستخدم تاعك باش يقدروا يغيروا رأيهم.
عندك زوج خيارات للتنفيذ:
  1. موصى به: افتح صفحة الاختيار المسبق لميلووتل مع generateAndOpenOptInLink(). نداء واحد للطريقة، متوافق بالكامل، يزيد من نسبة التحويل للاختيار.
  2. واجهة مستخدم مخصصة: صمم واجهة الموافقة الخاصة بك واستعمل optIn() / optOut() بنفسك.

​
واجهة الـAPI

الطريقةترجعاستعملها لـ
generateAndOpenOptInLink()Promise<void>افتح صفحة الاختيار المستضافة (الطريق الموصى به).
getOptInStatus()Promise<boolean>تحقق إذا كان المستخدم وافق بالفعل.
optIn()Promise<void>سجل الموافقة من واجهة المستخدم الخاصة بك.
optOut()Promise<void>ألغِ الموافقة من واجهة المستخدم الخاصة بك.
start()Promise<void>ابدأ في تقديم الطلبات بعد الموافقة.
generateSettingsLink()Promise<string>رابط لصفحة الإعدادات المستضافة باش المستخدمين يقدروا يغيروا اختيارهم لاحقًا.
كل الطرق قابلة للوصول من أي جزء من الملحق تاعك: نافذة منبثقة، سكريبت المحتوى، أو سكريبت الخلفية.

​
التنفيذ الموصى به

الدليل الكامل للتكامل موجود في بدايات المنصة السريعة. يوريوك وين تحط الـSDK، كيفاش تربطه بدورة حياة التثبيت/التحديث، وكيفاش تجربو: باختصار، بعد new Mellowtel(...) و initBackground(), ناد generateAndOpenOptInLink() من معالج التثبيت/التحديث تاعك. هذا هو.

​
واجهة مستخدم مخصصة

إذا حبيت تحكم كامل على واجهة الموافقة، سجل اختيار المستخدم في واجهة المستخدم الخاصة بك ومرره للـSDK: 
// المستخدم وافق
await mellowtel.optIn();
await mellowtel.start();

// المستخدم رفض أو لاحقًا ألغى
await mellowtel.optOut();

// تحقق من الحالة (مثلاً لعرض تبديل)
const hasOptedIn = await mellowtel.getOptInStatus();
أي واجهة مستخدم تبنيها لازم:
  1. تكون غير قابلة للإغلاق في التثبيت الأول.
  2. تكون الافتراضية على عدم الموافقة حتى المستخدم يوافق بنشاط.
  3. تكون قابلة لإعادة الفتح من مكان واضح في المنتج تاعك باش المستخدمين يقدروا يغيروا اختيارهم.

​
رابط الإعدادات

المستخدمين لازم دايما يكون عندهم طريقة سهلة باش يغيروا إعداداتهم. استعمل generateSettingsLink() باش تحصل على رابط لصفحة الإعدادات المستضافة وحطها في مكان دائم: النافذة المنبثقة تاعك، صفحة الخيارات، شاشة الحساب. 
const settingsUrl = await mellowtel.generateSettingsLink();

​
إعلان ميلووتل للمستخدمين الحاليين

إذا كنت تضيف ميلووتل لملحق عنده مستخدمين بالفعل، لازم تقولو لهم واش تبدل قبل ما تطلب الموافقة. نوفر لك نموذج إعلان جاهز للنسخ واللصق تقدر تعدله.

​
ذات صلة