انتقل إلى المحتوى
أدلة المستخدمالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

إدارة موافقة المستخدم

تدعم Pushwoosh الامتثال للوائح الخصوصية (مثل GDPR و CCPA) من خلال السماح للمطورين بالتحكم في وقت بدء SDK للاتصال بخوادم Pushwoosh. يتيح ذلك ضمان عدم جمع أي بيانات قبل أن يمنح المستخدم موافقة صريحة.

نظرة عامة

Anchor link to

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

مع هذا الإعداد:

  • إذا منح المستخدم الموافقة، يتم تهيئة SDK ويبدأ في جمع البيانات.

  • إذا لم يمنح المستخدم الموافقة، يظل SDK غير نشط ولا يجمع أي بيانات.

  • إذا سحب المستخدم الموافقة لاحقًا، يوقف SDK جميع الأنشطة وينقطع الاتصال بالخوادم.

توفر Pushwoosh آليات لإدارة هذا التدفق في iOS و Android و Unity.

iOS

Anchor link to

تعطيل اتصال خادم SDK عند بدء التشغيل

Anchor link to

بشكل افتراضي، يتم تمكين الاتصال بـ SDK. لتعطيل جميع الاتصالات بخوادم Pushwoosh حتى يتم منح الموافقة صراحة من قبل المستخدم، أضف المفتاح التالي إلى ملف Info.plist الخاص بك:

<key>Pushwoosh_ALLOW_SERVER_COMMUNICATION</key>
<false/>

التحقق من حالة الاتصال

Anchor link to

استخدم الطرق التالية لتحديد ما إذا كان الاتصال مسموحًا به حاليًا:

import SwiftUI
import PushwooshFramework


var serverCommunicationAllowed = PWCoreServerCommunicationManager.sharedInstance.isServerCommunicationAllowed
print("isServerCommunicationAllowed: ", serverCommunicationAllowed)

تمكين اتصال SDK بعد الموافقة

Anchor link to

بمجرد أن يمنح المستخدم الموافقة، قم بتمكين الاتصال على النحو التالي:

import SwiftUI
import PushwooshFramework


Pushwoosh.sharedInstance().startServerCommunication()

التسجيل لإشعارات Push

Anchor link to

بمجرد تمكين الاتصال، قم بالتسجيل صراحة لإشعارات Push:

import SwiftUI
import PushwooshFramework


Pushwoosh.sharedInstance().registerForPushNotifications()

تعطيل الاتصال

Anchor link to

لإيقاف الاتصال بخوادم Pushwoosh (على سبيل المثال، إذا ألغى المستخدم الموافقة):

import SwiftUI
import PushwooshFramework


Pushwoosh.sharedInstance().stopServerCommunication()

Android

Anchor link to

تعطيل اتصال خادم SDK عند بدء التشغيل

Anchor link to

بشكل افتراضي، يتم تمكين الاتصال. لمنع إرسال أي بيانات إلى خوادم Pushwoosh حتى يتم الحصول على موافقة المستخدم، أضف ما يلي إلى ملف AndroidManifest.xml الخاص بك:

<meta-data
  android:name="com.pushwoosh.allow_server_communication"
  android:value="false" />

التحقق من حالة الاتصال

Anchor link to

استخدم الطرق التالية لتحديد ما إذا كان اتصال الخادم مسموحًا به حاليًا:

import com.pushwoosh.Pushwoosh;


boolean isCommunicationEnabled = Pushwoosh.getInstance().isServerCommunicationAllowed();
Log.d("Pushwoosh", "Communication enabled = " + isCommunicationEnabled);

تمكين اتصال SDK بعد الموافقة

Anchor link to

بمجرد أن يمنح المستخدم الموافقة، قم بتمكين الاتصال على النحو التالي:

import com.pushwoosh.Pushwoosh;


Pushwoosh.getInstance().startServerCommunication();

التسجيل لإشعارات Push

Anchor link to

بعد تمكين الاتصال، قم بالتسجيل صراحة لإشعارات Push:

import com.pushwoosh.Pushwoosh;


Pushwoosh.getInstance().registerForPushNotifications();

تعطيل الاتصال

Anchor link to

لإيقاف الاتصال بخوادم Pushwoosh (على سبيل المثال، إذا ألغى المستخدم الموافقة):

import com.pushwoosh.Pushwoosh;


Pushwoosh.getInstance().stopServerCommunication();

Unity

Anchor link to

تعطيل اتصال خادم SDK عند بدء التشغيل

Anchor link to

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

Android

أضف ما يلي إلى مشروع Unity الخاص بك في AndroidManifest.xml:

 <meta-data android:name="com.pushwoosh.allow_server_communication" android:value="false" />

iOS

عدّل Info.plist:

<key>Pushwoosh_ALLOW_SERVER_COMMUNICATION</key>
<false/>

ملاحظة: يجب عليك تمكين الاتصال قبل استدعاء RegisterForPushNotifications.

التحقق من حالة الاتصال

Anchor link to

استخدم الطريقة التالية للتحقق مما إذا كان اتصال الخادم مسموحًا به حاليًا:

bool enabled = Pushwoosh.Instance.IsCommunicationEnabled();

تمكين اتصال SDK بعد الموافقة

Anchor link to

لتمكين الاتصال بعد الموافقة:

Pushwoosh.Instance.SetCommunicationEnabled(true);

التسجيل لإشعارات Push

Anchor link to

بمجرد تمكين الاتصال، يمكنك تسجيل الجهاز لإشعارات Push:

Pushwoosh.Instance.RegisterForPushNotifications();

تعطيل الاتصال

Anchor link to

لإيقاف الاتصال بخوادم Pushwoosh (على سبيل المثال، إذا ألغى المستخدم الموافقة):

Pushwoosh.Instance.SetCommunicationEnabled(false);

Web Push

Anchor link to

تعطيل الاشتراك التلقائي عند بدء التشغيل

Anchor link to

بشكل افتراضي، يعرض Pushwoosh SDK مطالبة الاشتراك الأصلية بمجرد تهيئته. لمنع SDK من عرض مطالبة الاشتراك تلقائيًا عند التهيئة، قم بتعيين المعلمة communicationEnabled إلى false في استدعاء init.

<script type="text/javascript" src="//cdn.pushwoosh.com/webpush/v3/pushwoosh-web-notifications.js" async></script>
<script type="text/javascript">
  var Pushwoosh = Pushwoosh || [];
  Pushwoosh.push(['init', {
    // other initialization parameters...
    communicationEnabled: false, // Disable communication to prevent automatic subscription prompts
  }]);
</script>

تمكين الاشتراك بعد الموافقة

Anchor link to

بمجرد تعطيل الاشتراك التلقائي، يمكنك مطالبة المستخدم بالاشتراك في أي وقت. عندما يوافق المستخدم على تلقي إشعارات Push (على سبيل المثال، بالنقر فوق زر “Subscribe” على واجهة المستخدم المخصصة الخاصة بك)، يمكنك تمكين الاتصال عن طريق استدعاء طريقة setCommunicationEnabled. يؤدي استدعاء Pushwoosh.setCommunicationEnabled(true) إلى تمكين الاتصال بخدمات Pushwoosh. بمجرد تمكينه، سيستمر SDK في عرض مطالبة إذن المتصفح الأصلية.

Pushwoosh.setCommunicationEnabled(true)
  .then(() => {
    console.log('User is subscribed to push notifications.');
  })
  .catch((error) => {
    console.error('Error subscribing user:', error);
  });

تعطيل الاتصال

Anchor link to

لإيقاف الاتصال بخدمات Pushwoosh (على سبيل المثال، إذا ألغى المستخدم الموافقة)، استدعِ setCommunicationEnabled مع false.

Pushwoosh.setCommunicationEnabled(false);