إصدار بطاقة Wallet

يقوم عنصر إصدار بطاقة Wallet بإنشاء بطاقة Apple Wallet أو Google Wallet للمسافر من حملة بطاقات Wallet. بعد تشغيله، يمكنك إدراج رابط التثبيت أو الحفظ في رسالة لاحقة في نفس الرحلة.

ملاحظة

هذا العنصر يصدر البطاقة فقط. لا يقوم بتسليمها للمستخدم. أضف عنصر إرسال إشعار Push أو إرسال بريد إلكتروني بعده لإرسال رابط التثبيت. انظر تسليم البطاقة للمسافر أدناه.

أمثلة على حالات الاستخدام

بطاقة صعود الطائرة بعد تسجيل الوصول

إصدار بطاقة صعود طائرة لـ Apple Wallet أو Google Wallet بمجرد تسجيل المسافر للوصول. قم بتخصيص المقعد والبوابة من حدث تسجيل الوصول، ثم أرسل رابط التثبيت عبر إشعار Push قبل المغادرة.

• المشغل: CheckInCompleted
• الحقول الشخصية: ربط Seat و Gate بسمات الحدث المطابقة
• التسليم: إرسال إشعار Push مع apple_install_link أو google_save_link

بطاقة ولاء عند التسجيل

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

• المشغل: LoyaltySignup
• الحقول الشخصية: ربط Points بسمة points الخاصة بالحدث
• التسليم: إرسال بريد إلكتروني مباشرة بعد ذلك، مع رابط الحفظ في رسالة الترحيب

تذكرة حدث بعد الشراء

إصدار تذكرة بمجرد إتمام المسافر لعملية شراء تذكرة. قم بتخصيص المقعد أو الصف من بيانات الطلب.

• المشغل: TicketPurchased
• الحقول الشخصية: ربط Seat و Row بسمات الطلب
• التسليم: بريد إلكتروني للتأكيد مع apple_install_link حتى يتمكن المسافر من إضافة التذكرة بنقرة واحدة

المتطلبات الأساسية

قبل إضافة هذا العنصر:

• حملة بطاقات Wallet: أنشئ على الأقل حملة بطاقات Wallet واحدة للتطبيق. يمكن لعنصر إصدار بطاقة Wallet إصدار بطاقات من حملة موجودة فقط. لا يمكنه تصميم واحدة.
• Apple Wallet: قم بتوصيل منصة iOS وأكمل إعداد بطاقة Apple Wallet للتطبيق. انظر أيضًا البدء مع بطاقات Apple Wallet.
• Google Wallet: قم بتهيئة Google Wallet لنظام Android للتطبيق. انظر أيضًا البدء مع بطاقات Google Wallet.

المتطلبات الكاملة للحملة لكلا المنصتين: متطلبات حملات بطاقات Wallet.

إضافة العنصر

1. اسحب عنصر إصدار بطاقة Wallet إلى لوحة العمل بعد الخطوة التي يجب أن تؤدي إلى الإصدار.
2. انقر نقرًا مزدوجًا على العنصر لفتح إعداداته.
3. أدخل اسمًا مميزًا في اسم الخطوة، على سبيل المثال بطاقة ولاء. ستستخدم هذا الاسم لاحقًا عند إدراج رابط البطاقة في عنصر إرسال إشعار Push أو إرسال بريد إلكتروني.
4. في حملة Apple Wallet و حملة Google Wallet، حدد حملة لأي من المنصتين، أو كليهما. تقبل كل قائمة منسدلة حملة واحدة. اترك القائمة المنسدلة فارغة لتخطي تلك المنصة.

نصيحة

يتيح تحديد كلا المنصتين لنفس خطوة الرحلة تغطية مسافري iPhone و Android في وقت واحد. تصدر كل منصة (أو تعيد استخدام، انظر الإدخالات المتكررة وشروط الإسقاط أدناه) بطاقتها الخاصة بشكل مستقل لنفس المسافر.

تسرد كلتا القائمتين المنسدلتين فقط حملات هذا التطبيق للمنصة المطابقة، مع استبعاد الحملات المؤرشفة بالفعل.

ملاحظة

لا تزال حملة المسودة مدرجة وتصدر بطاقات تمامًا مثل حملة نشطة، لذا فإن تبديل حملة من حالة المسودة ليس شرطًا أساسيًا هنا.

تعبئة الحقول الشخصية

تحت الحقول الشخصية على البطاقة، قم بتعيين قيمة لكل حقل يظهر.

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

لكل حقل، افتح القائمة المنسدلة للقيمة واختر أحد الخيارات التالية:

• قيمة ثابتة: اكتب قيمة واحدة لكل مسافر يصل إلى هذا العنصر. على سبيل المثال، اكتب SUMMER2026 في حقل OFFER بحيث تحمل كل بطاقة يصدرها هذا العنصر نفس الرمز الترويجي.

• حدث من وقت سابق في مسار المسافر عبر الرحلة. ثم اختر سمة لسحب قيمة الحقل منها. على سبيل المثال، اختر حدث الدخول وسمته offer_code لملء حقل OFFER بقيمة خاصة بكل مسافر بدلاً من قيمة واحدة للجميع. يقرأ Pushwoosh تلك السمة من بيانات حدث المسافر الخاصة عند تشغيل هذا العنصر، بحيث تحصل بطاقة كل مسافر على قيمتها الخاصة.

ملاحظة

نوعان من الحقول غير مدرجين هنا، لأنهما لا يحتاجان إلى إدخال منك:

• حقل مكتوب فقط كـ {Seat} يملأ نفسه لكل مسافر تلقائيًا.
• تحمل الحقول المشتركة للحملة نفس القيمة على كل بطاقة. تقوم بتعيين تلك القيمة مرة واحدة، في الحملة نفسها.

مع تحديد حملات لكلا المنصتين، تعرض القائمة حقولًا من كليهما. يتم ملء الحقل الذي تمتلكه حملة واحدة فقط لبطاقة تلك المنصة فقط.

ملاحظة

إذا لم يتم إطلاق الحدث المصدر أبدًا لمسافر، أو كانت السمة فارغة، تستخدم البطاقة قيمة الحملة الخاصة بذلك الحقل بدلاً من ذلك، والتي تم تعيينها في تعيين الحقول المشتركة والشخصية. لا يتم إسقاط المسافر.

عند الانتهاء، انقر فوق تطبيق لحفظ إعدادات العنصر.

الإدخالات المتكررة وشروط الإسقاط

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

يقوم عنصر إصدار بطاقة Wallet بإسقاط المسافر، دون إعادة محاولة تلقائية، في حالتين:

• لا يمتلك المسافر معرف مستخدم (User ID) على الإطلاق، ولا حتى معرف الجهاز الافتراضي HWID الذي تقوم جلسة SDK العادية بتعيينه تلقائيًا. يحدث هذا عندما يدخل المسافر الرحلة بدون واحد، على سبيل المثال من خلال الدخول المستند إلى API أو حمولة حدث لا تحتوي على حقل User ID.
• فشل إصدار البطاقة لحملة مهيأة، على سبيل المثال لأنه تم حذفها أو أرشفتها بعد إضافة العنصر. عند تهيئة كلا المنصتين، تتم محاولة Apple أولاً. إذا فشلت، يتم إسقاط المسافر قبل محاولة Google على الإطلاق، لذلك لا تحدث نتيجة جزئية أبدًا.

انظر لا يوجد معرف مستخدم (User ID) و فشل إصدار البطاقة لمعرفة ما يجب التحقق منه.

تسليم البطاقة للمسافر

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

السمة	المنصة	يحتوي على
apple_install_link	Apple Wallet	عنوان URL لتثبيت البطاقة
google_save_link	Google Wallet	عنوان URL لحفظ البطاقة

تتوفر فقط السمة الخاصة بالمنصة (المنصات) التي قمت بتهيئتها على العنصر.

تنبيه

يصدر العنصر بطاقة فقط للمنصة (المنصات) التي قمت بتهيئتها، وليس بناءً على جهاز المسافر الفعلي. لا يزال المسافر على المنصة الأخرى ينتقل إلى المخرج الافتراضي، ولكن برابط لا يمكنه استخدامه. قم بتهيئة كل من Apple Wallet و Google Wallet إذا كان جمهورك يستخدم كلا المنصتين.

1. أضف عنصر إرسال إشعار Push أو إرسال بريد إلكتروني بعد إصدار بطاقة Wallet.
2. في نص الرسالة، اكتب العنصر النائب لرابط التثبيت مع أشرطة عمودية، على سبيل المثال {apple_install_link|regular|}. لا تستخدم {apple_install_link} عادي. انظر المحتوى الديناميكي أو قوالب Liquid للحصول على الصيغة الكاملة.
3. قم بتشغيل تخصيص الرسالة بسمات الحدث.
4. في الجدول، حدد مربع الكتابة فوق العنصر النائب بجوار العنصر النائب الخاص بك. تظل القوائم المنسدلة الحدث المصدر و السمة الديناميكية معطلة حتى تفعل ذلك.
5. في الحدث المصدر، اختر خطوة إصدار بطاقة Wallet الخاصة بك عن طريق اسم الخطوة الذي أعطيته لها، على سبيل المثال بطاقة ولاء.
6. في السمة الديناميكية، اختر apple_install_link أو google_save_link لمطابقة العنصر النائب الذي استخدمته.

ملاحظة

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

تحتوي كل بطاقة صادرة أيضًا على رقم تسلسلي (apple_serial_number أو google_serial_number في سياق النقطة). قم بتمريره إلى أنظمتك الخاصة باستخدام عنصر بيانات إلى التطبيق أو Webhook، على سبيل المثال لتسجيله في أداة CRM أو أداة دعم. للعثور على البطاقة المطابقة في Pushwoosh برقمها التسلسلي، استخدم علامة تبويب البطاقات في حملة بطاقات Wallet أو واجهة برمجة التطبيقات AttachPasses، عندما تحتاج إلى إرفاق بطاقة مستقلة بحملة.

تنبيه

تعرض لوحة العنصر الإدخالات والتسربات، بما في ذلك سبب تسرب المسافر: لا يوجد معرف مستخدم (User ID) أو فشل إصدار البطاقة. لمعرفة عدد البطاقات التي تم إصدارها بالفعل، تحقق من إحصائيات عنصر إرسال إشعار Push أو إرسال بريد إلكتروني التالي.

سيناريو مثال: عرض ولاء لمقهى

يريد مقهى الترحيب بكل عضو ولاء جديد ببطاقة خصم يمكنهم إضافتها إلى محفظة هواتفهم.

1. أنشئ الحدث CoffeeClubJoined وتأكد من أنه يتضمن سمة لعرض الترحيب، على سبيل المثال offer_code. تعرف على المزيد حول إنشاء الأحداث
2. قم بتعيين هذا الحدث كمشغل للرحلة، بحيث يدخل كل عضو جديد بمجرد انضمامه.

3. أضف إصدار بطاقة Wallet بعد المشغل.
4. قم بتسميته بطاقة ولاء.
5. حدد حملة الولاء، على سبيل المثال خصم القهوة، لـ حملة Apple Wallet (و حملة Google Wallet أيضًا، إذا كنت تدعم Android).
6. تحت الحقول الشخصية على البطاقة، قم بتعيين OFFER إلى حدث دخول المشغل.
7. اختر offer_code كـ سمة.

8. أضف عنصر إرسال بريد إلكتروني مباشرة بعد إصدار بطاقة Wallet.
9. قم بتخصيصه بـ apple_install_link (أو google_save_link) بحيث يتضمن البريد الإلكتروني الترحيبي رابطًا بنقرة واحدة لإضافة البطاقة.

عند إطلاق CoffeeClubJoined، يدخل المسافر الرحلة، ويصدر عنصر إصدار بطاقة Wallet بطاقته مع offer_code الخاص بذلك الحدث، ويرسل عنصر إرسال بريد إلكتروني رسالة الترحيب مع رابط إضافتها.