إعدادات App Inbox المسبقة

إعدادات App Inbox المسبقة تتيح لك إعادة استخدام نفس رسالة الـ inbox في إرسالات Inbox لمرة واحدة وفي عنصر journey الخاص بـ App Inbox، حتى لا تُعيد إنشاء التخطيط والنص والوسائط لكل حملة. ومن الصفحة نفسها، يمكنك تقسيم الـ inbox في التطبيق إلى علامات تبويب.

متطلبات SDK

تتطلب تخطيطات البطاقات إصدارات SDK التالية في التطبيق:

• Web: Web SDK 3.75.0.
• Android: Android SDK 6.12.0 مع الوحدة pushwoosh-inbox-ui.
• iOS: iOS SDK 7.0.40 أو أحدث مع الوحدة PushwooshInboxKit.

يتطلب تخطيط Carousel إصدار iOS SDK 7.1.2 أو أحدث. مع إصدار أقدم من SDK، تصل الرسالة رغم ذلك لكنها تُعرض بدون التخطيط.

إنشاء إعداد App Inbox مسبق

1. اذهب إلى Content > Inbox content.
2. انقر على Create.

3. انقر على اسم الإعداد المسبق بجانب Inbox content: في الأعلى لإعادة تسميته.

إضافة لغات

يمكنك إنشاء نفس الإعداد المسبق بعدة لغات، بنفس طريقة إعدادات push المسبقة:

1. اكتب أولاً محتوى اللغة الافتراضية.
2. انقر على أيقونة + بجانب Default language.
3. اختر اللغات التي تحتاجها.

اختيار نوع التخطيط

في Layout type، اختر كيف تبدو البطاقة في قائمة الـ inbox. يستخدم كل خيار مزيجًا مختلفًا من الوسائط والنص:

• Classic: أيقونة صغيرة بجانب Title وMessage. بدون صورة كبيرة.
• Captioned: صورة كبيرة واحدة مع Title وMessage تحتها.
• Banner: صورة بعرض كامل فقط. بدون Title أو Message في القائمة.
• Carousel: عدة صور يمكن للمستخدم التمرير بينها. Title وMessage مشتركان، بالإضافة إلى تعليق اختياري على كل شريحة.

Classic

Classic هو صف القائمة المدمج: أيقونة على اليسار، Title وMessage بجانبها.

1. عيّن Title وMessage للنص في قائمة الـ inbox.
2. عيّن Icon URL على عنوان URL، أو اختر صورة من مساحة تخزين الوسائط. استخدم نسبة العرض إلى الارتفاع 1:1 عندما يمكنك ذلك.

Captioned

Captioned هو صورة رئيسية واحدة مع نص تحتها.

1. عيّن Title وMessage.
2. عيّن Image URL على عنوان URL، أو اختر صورة من مساحة تخزين الوسائط. استخدم نسبة العرض إلى الارتفاع 1:2 عندما يمكنك ذلك.

Banner

Banner تخطيط من صورة فقط: صورة بعرض كامل بدون Title أو Message. عيّن Image URL فقط (عنوان URL أو مساحة تخزين الوسائط). استخدم نسبة العرض إلى الارتفاع 1:2 عندما يمكنك ذلك.

Carousel

Carousel هو بطاقة متعددة الصور: يمرر المستخدم بين الشرائح. ينطبق Title وMessage على البطاقة بأكملها، ويمكن أن يكون لكل شريحة Caption خاصة بها.

1. عيّن Title وMessage.
2. في Media، عيّن Image URL لكل شريحة.
3. اختياريًا: عيّن Caption على كل شريحة.
4. لإضافة شريحة أخرى، انقر على Add image.

ملاحظة

في جميع التخطيطات، استخدم JPG أو JPEG أو PNG للصور. GIF غير مدعوم.

التحقق من صيغة Liquid

إذا كنت تستخدم Liquid templates في الرسالة، انقر على Validate Liquid Syntax للتحقق من وجود أخطاء في الصيغة قبل الحفظ.

إضافة بيانات مخصصة

استخدم البيانات المخصصة عندما يحتاج التطبيق إلى أكثر من نص الـ inbox المرئي، على سبيل المثال لفتح شاشة، أو تمرير معرّف حملة، أو تشغيل منطق بعد أن يفتح المستخدم الرسالة. يرسل Pushwoosh JSON هذا إلى الـ SDK مع الرسالة، بنفس طريقة Custom Data في إعدادات push المسبقة.

انقر على Insert JSON وأدخل كائن JSON يحتوي على أزواج مفتاح-قيمة.

معاينة

تحقق من المعاينة المسماة App inbox (مع عدد الرسائل غير المقروءة) لترى كيف تبدو الرسالة في قائمة الـ inbox. بدّل بين علامات التبويب iOS وAndroid وWeb للتحقق من كل منصة.

إرسال رسالة اختبار

للتحقق من الرسالة على جهاز حقيقي قبل استخدام الإعداد المسبق، أرسلها إلى أجهزة الاختبار الخاصة بك.

ملاحظة

إذا كانت موافقة المحتوى مفعّلة لحسابك، فسيكون اختبار رسالة صندوق الوارد مخفيًا.

1. انقر على اختبار رسالة صندوق الوارد أسفل المعاينة.
2. في اختبار محتوى صندوق الوارد، تحقق من عدد أجهزة التطبيق المحددة للاختبار.
3. انقر على إرسال.

يُرسل الاختبار إلى جميع أجهزة الاختبار الخاصة بالتطبيق، أيًا كانت علامة تبويب المنصة المحددة في المعاينة. ويستخدم المحتوى كما هو في المحرر، لذا لا تحتاج إلى حفظ الإعداد المسبق أولًا. لا تحتوي رسالة الاختبار على إجراء عند النقر، لأن الإجراءات تُحدد عند إرسال الرسالة.

حفظ

انقر على Save بجانب اسم الإعداد المسبق لتخزينه. تظهر الإعدادات المسبقة المحفوظة ضمن Content > Inbox content. استخدمها في رسائل Inbox لمرة واحدة وفي عنصر journey الخاص بـ App Inbox.

حذف الإعدادات المسبقة

لحذف عدة إعدادات مسبقة دفعة واحدة:

1. انتقل إلى Content > Inbox content.
2. انقر فوق إجراءات جماعية ← حذف….
3. حدد الإعدادات المسبقة.
4. انقر فوق زر حذف أعلى القائمة.

يتم تخطي الإعدادات المسبقة المستخدمة في journeys. لا يمكن استعادة الإعدادات المسبقة المحذوفة.

إعداد علامات تبويب الـ inbox

تقسّم علامات تبويب الـ inbox صندوق الوارد في التطبيق إلى ثلاثة مواضيع كحد أقصى، مثل Offers وNews. تُعرض الرسائل على النحو التالي:

• الرسالة المرسلة إلى علامة تبويب تظهر في تلك العلامة وفي All.
• الرسالة المرسلة بدون علامة تبويب تظهر في All فقط.
• إلى أن تضيف علامة تبويب، يكون الـ inbox قائمة واحدة.

ملاحظة

تظهر علامات التبويب في الـ inbox الخاص بـ iOS SDK 7.3.0 وAndroid SDK 6.17.0 أو أحدث. لا يحتوي الـ inbox في Web SDK على علامات تبويب.

إضافة علامة تبويب

أضف علامة التبويب في إعدادات Inbox tabs. يمكن أن يحتوي التطبيق على ما يصل إلى ثلاث علامات تبويب إلى جانب All.

1. انتقل إلى Content > Inbox content.
2. انقر على Inbox tabs.
3. انقر على Add tab.
4. في Title، أدخل اسم علامة التبويب، بحد أقصى 32 حرفًا.
5. لترجمة الاسم، أضف لغات في محدد اللغة أعلى Title وأدخل الاسم لكل منها.
6. انقر على Save.

إذا لم تكن هناك ترجمة للغة المستخدم، يرى المستخدم الاسم Default.

تُنشئ أول علامة تبويب تضيفها أيضًا All، الموسومة بـ Shows all messages. تبقى All في المقدمة، ويمكنك تعديل عنوانها لكن لا يمكنك نقلها أو حذفها.

لاختيار علامة تبويب لرسالة، راجع رسائل Inbox لمرة واحدة وعنصر journey الخاص بـ App Inbox.

تغيير علامات التبويب أو إعادة ترتيبها أو حذفها

استخدم صف علامة التبويب لتغييرها:

• لإعادة تسمية علامة تبويب أو تغيير ترجماتها، افتح قائمة الإجراءات (⋮) في صفها وانقر على Edit.
• لتغيير الترتيب، انقر على السهم لأعلى أو لأسفل في صف علامة التبويب.
• لحذف علامة تبويب، افتح قائمة الإجراءات (⋮) في صفها، وانقر على Delete…، ثم أكّد الحذف. تبقى الرسائل الموجودة بالفعل في علامة التبويب في الـ inbox وتظهر في All فقط. لا يمكن استعادة علامة التبويب المحذوفة. إذا حذفت آخر علامة تبويب إلى جانب All، تُحذف All أيضًا، ويعود الـ inbox قائمة واحدة.

تنبيه

قبل حذف علامة تبويب، اختر علامة تبويب أخرى في كل journey يستخدمها فيه عنصر App Inbox. لا يتحقق Pushwoosh مما إذا كانت علامة التبويب قيد الاستخدام، ولا يمكن لعنصر App Inbox المضبوط على علامة تبويب محذوفة إرسال رسالته.