كيفية إضافة الربط العميق في إشعارات دفع التطبيق باستخدام PushEngage

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

يرشدك هذا الدليل خلال إعداد الروابط العميقة باستخدام لوحة تحكم PushEngage لكل من Android و iOS.

قبل البدء

تأكد من تثبيت PushEngage ويعمل في تطبيق الهاتف المحمول الخاص بك (Android، iOS، Flutter، أو React Native). إذا لم تقم بذلك بعد، فاتبع دليل الإعداد لمنصتك:

دليل إعداد Flutter

دليل إعداد iOS

دليل إعداد React Native

جهز رابط URL الخاص بالرابط العميق. هذا هو عنوان URL أو مخطط URI الذي يستخدمه تطبيقك لفتح شاشة معينة (على سبيل المثال: myapp://products/123 أو https://yourapp.com/offers).

ما هو الرابط العميق؟

الرابط العميق هو عنوان URL خاص يشير إلى صفحة أو شاشة معينة داخل تطبيق الهاتف المحمول الخاص بك. عندما ينقر المستخدم على إشعار دفع برابط عميق، يتم توجيهه مباشرة إلى تلك الشاشة بدلاً من مجرد الصفحة الرئيسية للتطبيق.

أمثلة:

• myapp://orders/456 : يفتح الطلب رقم 456 في التطبيق
• https://yourstore.com/sale : يفتح صفحة تخفيضات داخل التطبيق
• app://www.yourapp.com/trigger : يفتح شاشة سير عمل معينة

إضافة الروابط العميقة عبر لوحة تحكم PushEngage

لإشعارات دفع تطبيقات Android

1. قم بتسجيل الدخول إلى لوحة تحكم PushEngage الخاصة بك.
2. انتقل إلى App Push » Create Campaign.
3. حدد Android كمنصة.
4. املأ العنوان والرسالة لإشعارك.
5. مرر لأسفل إلى حقل Deep Link.
6. أدخل عنوان URL للرابط العميق الخاص بك (على سبيل المثال: myapp://products/123).
7. انقر فوق Send / Schedule لإرسال الإشعار.

لإشعارات دفع تطبيقات iOS

1. قم بتسجيل الدخول إلى لوحة تحكم PushEngage الخاصة بك.
2. انتقل إلى App Push » Create Campaign.
3. حدد iOS كمنصة.
4. املأ العنوان والرسالة لإشعارك.
5. مرر لأسفل إلى حقل Deep Link.
6. أدخل عنوان URL للرابط العميق الخاص بك (على سبيل المثال: myapp://offers/summer-sale).
7. انقر فوق Send / Schedule لإرسال الإشعار.

إذا لم يتم تعيين رابط عميق على iOS، فإن النقر على الإشعار سيفتح التطبيق ببساطة. يرجى ملاحظة أن حدود الأحرف للروابط العميقة يمكن أن تصل إلى 1600 حرف في كل من Android و iOS.

معالجة الروابط العميقة في كود تطبيقك

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

Flutter

PushEngage.deepLinkStream.listen((data) {
  String? deepLink = data?['deepLink'];
  if (deepLink == null) return;
  Uri uri = Uri.parse(deepLink);
  if (uri.path == '/offers') {
    Navigator.pushNamed(context, '/offers');
  }
});

أيضًا، تأكد من تعيين PushEngageAutoHandleDeeplinkURL على NO في ملف Info.plist الخاص بنظام iOS إذا كنت تريد أن يتعامل تطبيقك مع التوجيه بنفسه.

React Native

PushEngage.onValueChanged((data) => {
  const { deepLink } = data;
  // Navigate based on the deep link value
  if (deepLink === '/orders') {
    navigation.navigate('Orders');
  }
});

iOS (Swift)

PushEngage.setNotificationOpenHandler { result in
  let deepLink = result.notificationAction.actionID
  // Route the user to the correct screen
}

تلميح: بالنسبة لنظام iOS، إذا قمت بتعيين PushEngageAutoHandleDeeplinkURL إلى YES في ملف Info.plist الخاص بك، فسيقوم SDK بفتح أي عناوين URL للروابط العميقة HTTP أو HTTPS تلقائيًا في المتصفح. قم بتعيينه إلى NO إذا كنت ترغب في معالجة التوجيه داخل تطبيقك.

Android (Intent Filter)

بالنسبة لنظام Android، أضف فلتر نوايا في ملف AndroidManifest.xml الخاص بك حتى يتمكن التطبيق من استقبال عناوين URL للروابط العميقة:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:scheme="myapp" android:host="www.yourapp.com" />
</intent-filter>

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

إذا واجهت أي مشاكل، يرجى الاتصال بنا بالنقر هنا. سيسعد فريق الدعم لدينا بمساعدتك.