بطاقات Wallet

يمكن لـ Joryio إصدار بطاقات Apple Wallet وGoogle Wallet، مثل بطاقات الولاء والقسائم وتذاكر الفعاليات والبطاقات العامة، بعلامتك التجارية وباستخدام بيانات اعتماد Apple وGoogle الخاصة بك. أضف رابط Add to Wallet إلى أي رسالة، سواء كانت Email أو In-app أو SMS أو WhatsApp، فيحصل كل مستلم على بطاقته الشخصية. ويمكنك تحديث أي بطاقة صادرة من رحلة في أي وقت، فيُدفع التغيير مباشرةً إلى الجهاز.

كيف تعمل

بطاقة Wallet ليست رسالة؛ تمر بثلاث مراحل:

1. الإصدار - عندما ينقر المستلم رابط Add to Wallet، ينشئ Joryio بطاقة مخصصة ويوقّعها ببيانات اعتمادك. يحدث الإصدار عند النقر، لذلك يمكنك تضمين رابط لكل مستلم في أي رسالة من دون توقيع البطاقة وقت الإرسال.
2. التوزيع - يصل الرابط ضمن رسالة عادية، وتخضع هذه الرسالة لقواعد الموافقة وقوائم الحظر والوقت الهادئ وحدود التكرار الخاصة بقناتها.
3. التحديث - عند تغيير بطاقة جهة اتصال، مثل رصيد نقاط جديد، يُدفع التحديث إلى كل جهاز ثُبّتت عليه البطاقة: عبر Push في Apple أو Wallet API في Google. هذه التحديثات بين الأنظمة ولا تتطلب موافقة تسويقية، لكن بطاقة جهة اتصال محذوفة أو معلّمة بعدم التواصل تُلغى بدلاً من تحديثها.

1. ربط بيانات اعتمادك

انتقل إلى الإعدادات ← بطاقات Wallet وأضف حساب موفر. يسجل كل حساب من أنشأه ومن حدّثه آخر مرة.

Apple Wallet

تحتاج إلى حساب Apple Developer وشهادة Pass Type ID. توجد طريقتان لإضافتها:

• CSR ← شهادة (موصى به): ينشئ Joryio طلب توقيع CSR لتحميله إلى بوابة Apple Developer، ثم تحمّل شهادة Apple الصادرة بصيغة .cer إلى Joryio. لا يغادر المفتاح الخاص Joryio أبداً.
• رفع .p12: حمّل شهادة Pass Type ID موجودة تم تصديرها كملف .p12 مع كلمة مرورها.

أدخل Team ID وPass Type ID، مثل pass.com.yourcompany.loyalty، ومفتاح APNs لدفع تحديثات البطاقات. ينبهك Joryio عند اقتراب انتهاء الشهادة ويمنع الإصدار بعد انتهائها. استخدم تحديث الشهادة لتجديدها في الحساب نفسه.

Google Wallet

تحتاج إلى حساب خدمة في Google Cloud له دور Wallet Object Issuer، وإلى Issuer ID. حمّل JSON الخاص بحساب الخدمة وأدخل Issuer ID.

تُشفّر بيانات الاعتماد أثناء التخزين وتظهر مقنّعة بعد الحفظ، ويمكنك استبدالها في أي وقت.

2. إنشاء قالب بطاقة

في Brand Studio ← Wallet Templates، أنشئ قالباً من البداية أو ابدأ بـ نموذج من المعرض. تبقى المعلومات الأساسية، مثل الاسم والوصف والوسوم ونوع البطاقة وحساب Apple / Google، أعلى أداة الإنشاء. ينظم كل ما عدا ذلك في ثلاثة تبويبات:

• وجه البطاقة - الجانب الظاهر من البطاقة.
• ظهر البطاقة - الصفوف الظاهرة عند قلب البطاقة.
• الميزات - إمكانات على مستوى البطاقة، مثل الانتهاء والروابط العميقة والمواقع.

توجد معاينة مباشرة على اليمين مع تبديل الوجه / الظهر، ويتيح لك مفتاح Apple Wallet / Google Wallet تصميم كل منصة.

قيم الحقول والرمز الشريطي هي قوالب Liquid تُعرض لكل مستلم. على سبيل المثال، تعرض قيمة حقل أساسي {{ user.custom.points }} رصيد نقاط كل عميل. تستخدم المعاينة بيانات تجريبية؛ أما الرموز الحقيقية فتُحل لكل مستلم عند الإرسال.

وجه البطاقة

• التصميم - ألوان الخلفية والنص والتسميات، ونص الشعار والصور: الشعار والأيقونة والشريط والصورة الرئيسية. ويمكن لبطاقات Apple أيضاً إخفاء لمعان الشريط.
• الحقول - مجموعات الرأس والأساسية والثانوية والمساعدة، وكل منها يتضمن مفتاحاً وتسمية وقيمة. تضيف تذاكر الفعاليات معلومات الفعالية، مثل الاسم والمكان؛ وتضيف بطاقات Google العامة صفوف معلومات.
• الرمز الشريطي - QR أو PDF417 أو Aztec أو Code 128، مع القيمة المشفرة والنص البديل الاختياري.

ظهر البطاقة

يظهر الظهر عندما يقلب حامل البطاقة بطاقته. أضف أي عدد من الصفوف واسحب وأفلت لإعادة ترتيبها. يمكن أن يكون كل صف:

• رابطاً - يضم عنواناً ونص العرض وURL، ويظهر كرابط قابل للنقر على ظهر البطاقة، مثل رابط إدارة الحساب أو عرض الطلب.
• حقلاً نصياً - يضم عنواناً وقيمة، مثل الشروط أو تاريخ الانضمام أو ساعات الدعم.

تدعم جميع حقول الظهر رموز التخصيص، بما في ذلك نص عرض الرابط وURL الخاص به. لذلك يمكن أن يقود الرابط إلى وجهة خاصة بكل مستلم مثل https://example.com/orders/{{ user.custom.orderId }}.

الميزات

إمكانات على مستوى البطاقة لا تظهر كحقول على البطاقة.

انتهاء البطاقة - فعّلها لإلغاء تنشيط البطاقة تلقائياً بعد تاريخ ووقت تختارهما. يُفسَّر الوقت وفق المنطقة الزمنية لمساحة العمل.

تحذير

تُلغى البطاقات المنتهية ولا يمكن إعادة تنشيطها. لمنح جهة الاتصال بطاقة فعالة مجدداً، وزّع بطاقة جديدة.

الروابط العميقة للتطبيق - تتيح للبطاقة فتح تطبيقك من Wallet.

• Apple - App Store ID وLaunch URL. لا يُستخدم Launch URL إلا عند ضبط App Store ID.
• Google - Android Package Name وWeb App URL.

هذه إمكانات أصلية للبطاقة: يعرض تطبيق Wallet الرابط ويتعامل الجهاز مع الرابط العميق.

رسائل بحسب الموقع - اعرض رسالة على شاشة القفل عندما يكون حامل البطاقة على بعد يقارب 100 متر من موقع. أضف نقطة أو أكثر، لكل منها خط العرض وخط الطول ورسالة شاشة القفل. هذه ميزة أصلية للجهاز ولا تحتاج إلى Push notification.

على iPhone فقط

تُعد رسالة شاشة القفل ميزة في Apple Wallet على iPhone. يخزن Google Wallet الموقع، لكنه لا يعرض رسالة مخصصة ولا يضمن وصولها على Android. لاستخدام موثوق للسياج الجغرافي على Android، استخدم Push محفزاً بالموقع.

ملاحظة

تتوفر البطاقات المرتبطة، التي تثبّت البطاقات ذات الصلة معاً، وiBeacon، الذي يعرض رسالة قرب منارة Bluetooth، عبر التواصل مع الدعم.

3. إضافة رابط Add to Wallet إلى رسالة

لا توجد رسالة Wallet مستقلة؛ أدرج الرابط في المكان الذي تكتب فيه رسالتك.

Email وIn-app، كتلة بالسحب والإفلات

في محرر Email أو In-app، اسحب كتلة Add to Wallet من لوحة الكتل إلى تصميمك. حدّدها ثم اختر قالب البطاقة والمنصة من لوحة الإعدادات اليمنى. تفتح أيقونة الترس على اللوحة خيار تكوين البطاقة…، حيث يمكنك ضبط تسمية المصدر/التتبع وتجاوزات القيمة لكل حقل مع معاينة مباشرة للبطاقة.

SMS وWhatsApp، التخصيص

نصوص SMS وWhatsApp عادية، لذا افتح + تخصيص واختر Add to Wallet. اختر القالب والمنصة وتسمية مصدر اختيارية وأي تجاوزات للحقول، وستظهر معاينة مباشرة للبطاقة. عند الإدراج، يُضاف رمز يتحول عند الإرسال إلى رابط تثبيت خاص بالمستلم، ويُختصر إلى /s/… كي لا يستهلك أجزاء SMS.

خيارات المنصة

• Apple Wallet - رابط خاص بأجهزة Apple.
• Google Wallet - رابط خاص بـ Google.
• مختلط، اكتشاف تلقائي - موصى به؛ يكتشف الرابط الجهاز: iOS إلى Apple وAndroid إلى Google، ويعرض صفحة هبوط بعلامتك التجارية على سطح المكتب أو الأجهزة غير المعروفة.

4. صفحة الهبوط العامة

تعرض الروابط المختلطة المفتوحة على سطح المكتب أو جهاز غير معروف صفحة هبوط بعلامتك التجارية تحتوي زري Add to Apple Wallet وSave to Google Wallet. تستخدم الصفحة علامة قالب البطاقة افتراضياً. خصصها لكل مساحة عمل من الإعدادات ← بطاقات Wallet ← صفحة هبوط التثبيت: العنوان والنص الثانوي والشعار ولون التمييز ولون الخلفية.

5. تجاوزات الحقول وتسميات المصدر

تتيح لك كتلة المحرر وأداة اختيار التخصيص ما يلي:

• تجاوز قيم الحقول لإرسال محدد، مثل رصيد ترويجي لمرة واحدة، من دون تعديل القالب المشترك. تبقي التجاوزات الفارغة القيمة الافتراضية للقالب.
• تعيين تسمية مصدر/تتبع، مثل summer_promo. عند تعيينها، تستبدل الإسناد التلقائي للحملة أو الرحلة لهذا الرابط في التقارير.

عند الإرسال من حملة أو رحلة بلا تسمية يدوية، تُنسب البطاقة تلقائياً إلى تلك الحملة أو الرحلة.

6. تحديث بطاقة من رحلة

في أداة بناء الرحلات، تعيد عقدة Update Wallet Pass إنشاء بطاقة جهة اتصال لقالب محدد وتدفع التحديث إلى جهازه؛ مثلاً: «عند الشراء، حدّث رصيد النقاط». لا ترسل العقدة رسالة تسويقية، لذلك لا تخضع للموافقة أو الوقت الهادئ، لكن بطاقة جهة اتصال محظورة أو محذوفة تُلغى بدلاً من تحديثها.

تعديل قالب بعد إصدار البطاقات: يحصل المستلمون الجدد، وكل من لم يضف البطاقة بعد، تلقائياً على القالب الحالي عند فتح الرابط في المرة التالية. أما من أضاف البطاقة بالفعل إلى Wallet فلا تتغير بطاقته إلا عند دفع تحديث بعقدة Update Wallet Pass؛ فتعديل القالب لا يعيد كتابة بطاقات الهواتف بصمت.

7. تتبع نشاط Wallet وتحليله

يُسجل كل تفاعل مع Wallet في الخط الزمني لجهة الاتصال، وهو متاح للتقسيم ومحفزات الرحلات:

الحدث	متى يحدث
pass.issued	عند إصدار بطاقة لجهة الاتصال
pass.downloaded	عند فتح رابط التثبيت
pass.installed	عند إضافة البطاقة إلى Wallet على جهاز
pass.updated / pass.update_pushed	عند تغيير البطاقة ودفعها إلى الأجهزة
pass.removed	عند إزالة البطاقة من Wallet
pass.scanned	عند مسح الرمز الشريطي للبطاقة أو استرداده
pass.voided	عند إلغاء البطاقة

افتح جهة اتصال وانتقل إلى تبويب Wallet لرؤية بطاقاتها الصادرة وحالتها وسجلها. وللتقارير المجمعة، انتقل إلى التحليلات ← تحليلات Wallet لرؤية مسار التبنّي، issued ← downloaded ← scanned، ومعدلات التثبيت والمسح والاحتفاظ، مقسمة حسب المصدر أو المنصة أو القالب.

إشارة التثبيت في Apple وGoogle

يُطلق pass.installed في Apple عندما يسجل الجهاز البطاقة، وفي Google عبر معاودة الحفظ أو الحذف من Wallet. أضف مصدراً إلى روابطك لمقارنة القنوات في المسار.

التقسيم حسب نشاط Wallet

أنشئ شرائح باستخدام فلتر الحدث المعتاد؛ مثلاً: «نفّذ pass.installed عندما تكون platform = apple»، أو «نفّذ pass.scanned مرتين أو أكثر خلال آخر 30 يوماً». يمكنك التصفية بخصائص الحدث مثل platform وpassTemplateId وsource. يظهر حدث Wallet في أداة الاختيار بعد رصده مرة واحدة على الأقل.

الأسئلة الشائعة: متى تُنشأ بطاقة جديدة؟

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

إذا أرسلت تذكيراً، هل ستصبح لدى جهة الاتصال بطاقتان؟ لا. يستخدم التذكير البطاقة نفسها ورابط Add to Wallet نفسه. تؤدي إضافتها مجدداً إلى تحديث البطاقة الموجودة في Wallet فقط.

ماذا لو أرسلت البطاقة نفسها عبر SMS وEmail؟ تظل بطاقة واحدة؛ يشير الرابطان إلى البطاقة نفسها لجهة الاتصال تلك.

كيف أمنح جهة اتصال بطاقتين مختلفتين؟ أنشئ قالبين. القالب الواحد يساوي نوع بطاقة واحد وبطاقة فعالة واحدة لكل جهة اتصال.

عدّلت القالب، لماذا لم تتغير بطاقة صادرة بالفعل؟ لا تتحدث البطاقة الموجودة على الهاتف إلا عبر عقدة Update Wallet Pass أو عند إضافتها مجدداً. أما البطاقات التي لم تُضف بعد فتلتقط التغيير تلقائياً؛ راجع «تعديل قالب بعد إصدار البطاقات» أعلاه.

ملاحظات

• لا تحتوي البطاقة نفسها على رابط إلغاء اشتراك؛ إزالة البطاقة هي إجراء إزالة من Wallet الأصلي، الذي يسجل pass.removed.
• بطاقة واحدة لكل جهة اتصال + قالب. تمتلك جهة الاتصال بطاقة فعالة واحدة لكل قالب؛ فتستخدمها التذكيرات وإعادات الإرسال والبطاقة نفسها في SMS وEmail من دون إنشاء تكرار. تُسجل الحملة أو الرحلة للإسناد فقط، لا لتحديد الهوية. استخدم قالباً مختلفاً لبطاقة ثانية مميزة.
• يؤدي طلب محو البيانات DSR إلى إلغاء بطاقات جهة الاتصال وحذف ملفات البطاقات المخزنة.