Issue Wallet Pass

استخدم عنصر Issue Wallet Pass لمنح المستخدمين بطاقة لـ Apple Wallet أو Google Wallet، مثل بطاقة ولاء أو تذكرة أو قسيمة. ينشئ العنصر بطاقة شخصية لكل مستخدم من Wallet Pass Campaign.

حالات الاستخدام

بطاقة صعود الطائرة بعد تسجيل الوصول: عندما يسجّل المستخدم وصوله، أصدر بطاقة صعود تحتوي على مقعده وبوابته، وأرسلها عبر push قبل الإقلاع.
بطاقة ولاء عند التسجيل: عندما ينضم شخص إلى برنامج المكافآت الخاص بك، أصدر بطاقة برصيد النقاط الأولي وأضفها إلى رسالة الترحيب. راجع كيفية إصدار بطاقة Wallet عند التسجيل للحصول على الشرح الكامل.
تذكرة فعالية بعد الشراء: بعد الشراء، أصدر تذكرة تحتوي على المقعد والصف، وأدرجها في تأكيد الطلب.
بطاقة عند دخول geozone متجر: عندما يدخل متسوق geozone الخاص بمتجر، أصدر بطاقة وأرسل رابطها فورًا عبر push. راجع كيفية إصدار بطاقة Wallet عند دخول geozone للحصول على الشرح الكامل.

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

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

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

إضافة العنصر

ستجد Issue Wallet Pass ضمن Channels في منشئ الرحلات. لتصميم البطاقة نفسها، راجع Wallet Pass Campaigns.

اسحب Issue Wallet Pass إلى لوحة العمل (canvas) عند النقطة التي يجب أن يحصل فيها المستخدمون على البطاقة.
انقر نقرًا مزدوجًا على العنصر لفتح إعداداته.
أدخل اسمًا مميزًا في Step Name، على سبيل المثال Loyalty card. ستستخدم هذا الاسم لاحقًا عند إدراج رابط البطاقة في عنصر Send Push أو Send Email.
في Apple Wallet campaign و Google Wallet campaign، حدد حملة لإحدى المنصتين أو كلتيهما. اترك القائمة المنسدلة فارغة لتخطي تلك المنصة.

Apple Wallet campaign مضبوطة على Coffee discount وGoogle Wallet campaign متروكة فارغة

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

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

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

ضمن Personal fields on the pass، ترى الحقول التي تحتاج إلى قيمة للحملة التي حددتها. هذه هي نفس الحقول التي تملؤها في مربع حوار الحملة Issue pass. إذا حددت حملة أخرى، تتغير القائمة لتطابقها.

الحقول التي تُعبأ تلقائيًا غير مدرجة:

العنصر النائب للعلامة (Tag placeholder): حقل مثل {Seat} يُعبأ من علامة المستخدم التي تحمل نفس الاسم.
الحقول المشتركة: نفس القيمة على كل بطاقة، تُضبط مرة واحدة في الحملة نفسها.

لكل حقل، اختر من أين تأتي قيمته:

Static value: نفس القيمة على كل بطاقة يصدرها هذا العنصر. على سبيل المثال، SUMMER2026 في حقل OFFER.

Personal fields on the pass مع ضبط OFFER على Static value وكتابة VALUE كـ SUMMER2026

Event from the journey: قيمة من حدث سابق في الرحلة، بحيث يحصل كل مستخدم على قيمته الخاصة. اختر الحدث، ثم Attribute، على سبيل المثال offer_code من حدث الدخول.

Personal fields on the pass مع ضبط OFFER على حدث Trigger entry وضبط Attribute على offer_code

عند تحديد حملات لكلتا المنصتين، تعرض القائمة الحقول من كليهما. الحقل الموجود في حملة واحدة فقط يُعبأ فقط في بطاقة تلك المنصة.

عند الانتهاء، انقر على Apply لحفظ إعدادات العنصر.

ماذا يحدث في هذه الخطوة

الحالة	ماذا يحدث
تم إصدار البطاقة	ينتقل المستخدم إلى العنصر التالي.
لدى المستخدم بالفعل بطاقة من هذه الحملة، على سبيل المثال بعد loop في الرحلة	يعيد العنصر استخدام تلك البطاقة بدلاً من إنشاء بطاقة جديدة، وينتقل المستخدم. لكل مستخدم بطاقة واحدة كحد أقصى لكل حملة.
ليس لدى المستخدم User ID	يخرج المستخدم من الرحلة. بشكل افتراضي، يستخدم SDK معرف HWID الخاص بالجهاز كـ User ID، لذا يحدث هذا في الغالب عندما يدخل المستخدم عبر API أو بحدث بدون User ID.
لا يمكن إصدار البطاقة، على سبيل المثال لأن الحملة حُذفت أو أُرشفت بعد إضافة العنصر	يخرج المستخدم من الرحلة.

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

إرسال رابط البطاقة

بعد Issue Wallet Pass، أضف push أو email برابط ينقر عليه المستخدم لإضافة البطاقة إلى محفظته. يتوفر الرابط فقط للمنصات التي حددتها في العنصر. استخدم apple_install_link لـ Apple Wallet و google_save_link لـ Google Wallet.

أضف عنصر Send Push أو Send Email بعد Issue Wallet Pass.
في الرسالة، اكتب العنصر النائب بالأشرطة الرأسية، مثل {apple_install_link|regular|}. لا تستخدم {apple_install_link} بسيطًا. regular هو مُعدِّل تنسيق مطلوب يُدرج القيمة دون تعديل، لذا اتركه كما هو. راجع المحتوى الديناميكي أو قوالب Liquid للحصول على الصيغة الكاملة. في Send Email، يمكنك استخدام العنصر النائب في سطر الموضوع أيضًا، وليس فقط في نص الرسالة.
فعّل Personalise message with event attributes.
في الجدول، حدد Overwrite placeholder بجانب العنصر النائب الخاص بك. يؤدي هذا إلى فتح القائمتين المنسدلتين Source event و Dynamic attribute.
في Source event، اختر خطوة Issue Wallet Pass الخاصة بك بواسطة Step Name الذي أعطيته لها، مثل Loyalty card.
في Dynamic attribute، اختر apple_install_link أو google_save_link بما يطابق العنصر النائب الذي استخدمته.

جدول Personalise message with event attributes يربط apple_install_link بخطوة Loyalty card

تتبع النتائج

تعرض لوحة العنصر عمليات الدخول والخروج، بما في ذلك سبب خروج المستخدم: No User ID أو Pass issuance failed. المستخدمون الذين يمرون عبر العنصر دون خروج تكون بطاقتهم قد صدرت أو أُعيد استخدامها. للتحقق من وصول الرابط إلى المستخدمين، راجع إحصائيات عنصر Send Push أو Send Email التالي.

الأرقام التسلسلية

لكل بطاقة صادرة رقم تسلسلي: apple_serial_number أو google_serial_number. استخدمه من أجل:

تسجيل البطاقة في نظام CRM أو أداة الدعم الخاصة بك باستخدام عنصر Data to app أو Webhook.
العثور على البطاقة في علامة التبويب Passes الخاصة بالحملة.
إرفاق البطاقة بحملة.