إصدار بطاقة المحفظة

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

ملاحظة

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

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

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

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

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

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

إضافة العنصر

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

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

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

نصيحة

يتيح لك تحديد المنصتين معًا أن تغطي نفس الخطوة مستخدمي iPhone وAndroid في آن واحد. تصدر كل منصة بطاقتها الخاصة لنفس المستخدم.

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

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

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

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

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

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

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

• حدث من الرحلة: قيمة من حدث سابق في الرحلة، بحيث يحصل كل مستخدم على قيمته الخاصة. تعرض القائمة المنسدلة أحداث الرحلة: تظهر خطوة الدخول أو الانتظار باسم الخطوة واسم الحدث، وتظهر خطوة API-based entry أو Webhook أو إصدار بطاقة المحفظة باسم الخطوة فقط. اختر الحدث، ثم Attribute، على سبيل المثال offer_code من حدث الدخول.

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

ملاحظة

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

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

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

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

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

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

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

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

2. في الرسالة، اكتب العنصر النائب بالأشرطة الرأسية، مثل {apple_install_link|regular|}. لا تستخدم {apple_install_link} بسيطًا. regular هو مُعدِّل تنسيق مطلوب يُدرج القيمة دون تعديل، لذا اتركه كما هو. راجع المحتوى الديناميكي أو قوالب Liquid للحصول على الصيغة الكاملة. في بريد إلكتروني، يمكنك استخدام العنصر النائب في سطر الموضوع أيضًا، وليس فقط في نص الرسالة.

3. فعّل Personalise message with event attributes.

4. في الجدول، حدد Overwrite placeholder بجانب العنصر النائب الخاص بك. يؤدي هذا إلى فتح القائمتين المنسدلتين Source event و Dynamic attribute.

5. في Source event، اختر خطوة إصدار بطاقة المحفظة الخاصة بك بواسطة Step Name الذي أعطيته لها، مثل Loyalty card.

6. في Dynamic attribute، اختر apple_install_link أو google_save_link بما يطابق العنصر النائب الذي استخدمته.

ملاحظة

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

لماذا لا يستطيع بعض المستخدمين فتح الرابط؟

يصدر العنصر بطاقة فقط للمنصات التي قمت بتكوينها، وليس لجهاز المستخدم الفعلي. إذا قمت بتكوين Apple Wallet فقط، لا يزال مستخدمو Android يتلقون الرسالة، لكن برابط لا يمكنهم استخدامه. إذا قمت بتكوين كلتا المنصتين، أدرج كلا الرابطين في الرسالة (“Add to Apple Wallet” و”Save to Google Wallet”)، أو قسّم الرحلة حسب المنصة قبل هذه الرسالة وأرسل كل رابط بشكل منفصل.

تتبع النتائج

تعرض لوحة العنصر عمليات الدخول والخروج. وبالنسبة للمستخدم الذي خرج، تعرض أيضًا السبب:

• لا يوجد User ID
• لم يتم إصدار بطاقة المحفظة
• خطأ داخلي، عندما لا تستجيب خدمة المحفظة في الوقت المناسب

المستخدمون الذين يمرون عبر العنصر دون خروج تكون بطاقتهم قد صدرت أو أُعيد استخدامها.

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

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

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

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