إنشاء حملات بطاقات Wallet

تتيح لك حملة بطاقات Wallet (Wallet Pass Campaign) تصميم قالب واحد لبطاقة Apple Wallet أو Google Wallet، وإصداره لعدة مستخدمين، وإدارة التحديثات مركزيًا.

أنت تختار الحقول التي ستكون مشتركة (Shared) (لمزامنة التغييرات مع جميع أجهزة المستخدمين في وقت واحد) والتي ستكون شخصية (Personal) (للحفاظ على القيم الفريدة مثل الأسماء أو الباركود أو الأرصدة لكل مستخدم).

ملاحظة

حملة بطاقات Wallet (Wallet Pass Campaign) لا علاقة لها بحملة Customer Journey أو بإشعار الدفع. إنها أداة لإدارة قوالب البطاقات وإصدارها وتحديثاتها في الوقت الفعلي.

ما يمكنك فعله باستخدام حملات بطاقات Wallet

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

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

تستخدم الحملة نفس الإعداد لمرة واحدة الذي تستخدمه البطاقة المستقلة:

Apple Wallet:

• عضوية نشطة في برنامج مطوري Apple (Apple Developer Program)
• منصة iOS متصلة بالتطبيق
• شهادة توقيع البطاقة (Pass signing certificate) مرفوعة إلى Pushwoosh

Google Wallet:

• حساب مُصدر نشط في Google Pay & Wallet Console
• Google Wallet مُهيأ للتطبيق (معرف المُصدر “Issuer ID” ومفتاح حساب خدمة Google Cloud)

إنشاء حملة

لبدء إنشاء حملة، انتقل إلى Campaigns ← Wallet Passes ← Campaigns وانقر على Create campaign.

تعيين تفاصيل الحملة والمنصة

• Platform (المنصة): حدد Apple Wallet أو Google Wallet في أعلى الصفحة. هذا الخيار دائم للغملة.
• Campaign (الحملة): أدخل Name (اسم) وDescription (وصف) اختياري كمرجع داخلي لك. لن يظهر أي منهما على البطاقة.
• Pass format (تنسيق البطاقة): تحت Pass Style (لـ Apple) أو Pass Type (لـ Google)، اختر التخطيط لبطاقتك:
  • Apple Wallet: Boarding Pass, Coupon, Event Ticket, Store Card, Generic. انظر اختر نمط البطاقة.
  • Google Wallet: Generic, Offer, Loyalty card, Event ticket, Gift card, Flight, Transit. لا يمكن تغيير هذا بعد الإنشاء. انظر اختر نوع البطاقة.

تهيئة تصميم البطاقة والعلامة التجارية

قم بتهيئة الأقسام القياسية للبطاقة:

• Basic Information, Colors, and Barcode (المعلومات الأساسية والألوان والباركود): قم بتعيين عنوان البطاقة وألوان الخلفية والنص ونوع الباركود. للحصول على إرشادات مفصلة حول كل قسم، انظر تصميم البطاقات في منشئ بطاقات Apple Wallet أو تصميم بطاقات Google Wallet في منشئ البطاقات.
• Pass fields (حقول البطاقة): أضف الحقول التي يجب أن تظهر على البطاقة (انظر حقول بطاقة Apple Wallet أو حقول وتفاصيل Google Wallet).
• Expiration (انتهاء الصلاحية): قم بتعيين التواريخ وقواعد انتهاء الصلاحية ذات الصلة (انظر انتهاء صلاحية Apple Wallet أو انتهاء صلاحية Google Wallet).
• Locations (المواقع): قم بتعيين الصلة المستندة إلى الموقع (انظر مواقع Apple Wallet أو مواقع Google Wallet).

نصيحة

بالنسبة لـ Google Wallet، استخدم Who can save the pass (من يمكنه حفظ البطاقة) للتحكم فيما إذا كانت البطاقة مرتبطة بحساب Google واحد، أو جهاز واحد، أو يمكن الوصول إليها من قبل أي شخص لديه الرابط.

تعيين الحقول المشتركة والشخصية

في قسم Shared and personal fields (الحقول المشتركة والشخصية)، قم بتهيئة الحقول التي يتم تحديثها عالميًا عبر جميع البطاقات والتي تحتفظ بقيم فريدة لكل مستخدم. يتحكم هذا في ما يحدث عند تعديل الحملة لاحقًا: يتم تحديث الحقول المشتركة على كل بطاقة صادرة، بينما تظل الحقول الشخصية دون تغيير.

قم بتشغيل مفتاح Personal (شخصي) لأي حقل يجب أن يحتوي على قيم فريدة لكل مستخدم.

نوع الحقل	السلوك	أمثلة
مشترك (Shared)	يتم التحكم فيه بواسطة الحملة. يؤدي تحديث هذا الحقل إلى مزامنة القيمة الجديدة مع كل بطاقة على أجهزة المستخدمين.	تاريخ الحدث، رقم البوابة، عنوان المتجر، نسبة الخصم
شخصي (Personal)	فريد لكل مستخدم. لا تقوم الحملة بالكتابة فوق هذه القيم عند تحديثها.	اسم المستخدم، رقم المقعد، معرف العضوية، رصيد النقاط

يمكن أن تتضمن قيمة الحقل الشخصي عنصرًا نائبًا للوسم، {tag} أو {tag|format|fallback} (على سبيل المثال، {Seat}). يقوم Pushwoosh بملئه من وسم المستلم عند تقديم البطاقة. إذا لم يكن لدى المستلم قيمة لهذا الوسم، يستخدم Pushwoosh القيمة الاحتياطية من العنصر النائب، أو يترك الحقل فارغًا عندما لا يحتوي العنصر النائب على أي قيمة.

• الوسم فقط، لا شيء آخر، مثل {Seat}: لا يظهر الحقل في مربع حوار Issue pass (إصدار بطاقة).
• الوسم ممزوج بنص آخر، مثل Seat {Seat}، أو لا يوجد وسم على الإطلاق: يظهر الحقل كمدخل قابل للتعديل في مربع حوار Issue pass (إصدار بطاقة)، مملوء مسبقًا بتلك القيمة. لا يزال أي وسم بداخله يتم حله لكل مستلم عندما يقدم Pushwoosh البطاقة.

نصيحة

يتم تهيئة وتخصيص باركود البطاقة في قسم Barcode (الباركود). انظر باركود Apple Wallet أو باركود Google Wallet للحصول على التفاصيل.

تحميل صور الحملة

1. في قسم Campaign images (صور الحملة)، انقر على Choose an image (اختر صورة) بجوار خانة الصورة.
2. حدد صورة موجودة من متجر الوسائط (Media store) أو اسحب وأفلت ملفًا جديدًا لتحميله.
3. كرر العملية لكل خانة صورة متاحة:
   • Apple Wallet: Icon, Logo, Background, Footer, Strip, and Thumbnail (انظر صور Apple Wallet).
   • Google Wallet: Logo and Hero image.

ملاحظة

• يجب أن تكون الصور أقل من 10 ميغابايت و 25 ميغابكسل.
• Apple Wallet: على عكس البطاقة المستقلة، حيث يتم قفل الصور بعد الإنشاء، يصل تحديث صورة الحملة إلى كل بطاقة صادرة.
• Google Wallet: تتيح لك البطاقة المستقلة بالفعل تغيير شعارها وصورتها الرئيسية في أي وقت عبر Edit (تعديل). تعمل صورة الحملة بنفس الطريقة، باستثناء أن تعديلًا واحدًا يصل إلى كل بطاقة صادرة في وقت واحد بدلاً من بطاقة واحدة فقط.

معاينة وإنشاء الحملة

1. تحقق من لوحة Preview as user (معاينة كمستخدم) على اليمين لترى كيف تبدو البطاقة. يمكنك إدخال User ID اختباري لمعاينة الحقول المخصصة.

نصيحة

انقر على Validate pass (التحقق من البطاقة) للتحقق من التصميم مقابل متطلبات Apple أو Google قبل الحفظ، دون إنشاء الحملة بعد.

2. انقر على Create campaign (إنشاء حملة) في أسفل الصفحة.

يقوم Pushwoosh بإنشاء الحملة بحالة Draft (مسودة) ويفتح مساحة العمل الخاصة بها، مع علامات التبويب Design (تصميم)، Passes (بطاقات)، و History (سجل).

ملاحظة

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

إصدار البطاقات للمستخدمين

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

1. في علامة التبويب Passes (بطاقات)، انقر على Issue pass (إصدار بطاقة).
2. أدخل User ID الخاص بالمستلم في Pushwoosh.

3. انقر على Issue pass (إصدار بطاقة) للتأكيد.

اعتمادًا على كيفية تهيئة Personal fields (الحقول الشخصية)، يتعامل مربع الحوار معها على النحو التالي:

• Editable fields (الحقول القابلة للتعديل): تظهر بقيم افتراضية يمكنك تغييرها لهذا المستخدم.
• Tag placeholders (العناصر النائبة للوسوم) (مثل {Seat}): لا تظهر في مربع الحوار. يقوم Pushwoosh بملئها تلقائيًا من وسوم المستخدم.

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

يقوم Pushwoosh بإنشاء البطاقة من التصميم الحالي للحملة ويدرجها في علامة التبويب Passes (بطاقات) وفي جدول All passes (كل البطاقات) الخاص بالتطبيق (Apple Wallet أو Google Wallet).

تسليم البطاقة إلى المستلم

إصدار بطاقة ينشئ سجل البطاقة في Pushwoosh. لتسليمها إلى جهاز المستخدم، شارك رابط التثبيت:

1. افتح قائمة إجراءات البطاقة في علامة التبويب Passes (بطاقات) أو في All passes (كل البطاقات).
2. حدد Copy install link (نسخ رابط التثبيت) أو QR code (رمز الاستجابة السريعة). توفر بطاقات Apple Wallet أيضًا خيار Download (تنزيل) لملف .pkpass الموقع.
3. أرسل الرابط أو الملف إلى المستلم عبر الإشعارات، البريد الإلكتروني، الرسائل القصيرة، أو Customer Journey. لإصدار بطاقة وتسليم رابطها تلقائيًا أثناء تنقل المسافرين عبر رحلة، استخدم عنصر Issue Wallet Pass بدلاً من إصدارها هنا.

لمزيد من الطرق لتوزيع البطاقات، انظر مشاركة بطاقات Apple Wallet أو مشاركة بطاقات Google Wallet.

إرفاق بطاقة موجودة بحملة

يمكنك إرفاق بطاقات مستقلة (تم إنشاؤها خارج أي حملة) بحملة ما لتبدأ في تلقي التحديثات المشتركة.

1. في علامة التبويب Passes (بطاقات)، انقر على Attach passes (إرفاق بطاقات).
2. ابحث عن البطاقات بواسطة User ID أو الرقم التسلسلي أو الباركود.
3. حدد البطاقات وأكد.

بمجرد إرفاقها:

• تبدأ Shared fields (الحقول المشتركة) في اتباع الحملة ويتم تحديثها كلما قمت بتغيير قالب البطاقة.
• يتم الحفاظ على Personal values (القيم الشخصية) الموجودة بالفعل على البطاقة (مثل تفاصيل المستخدم أو الأرصدة الفريدة).

إرفاق البطاقات عبر API

يمكنك أيضًا إرفاق البطاقات برمجيًا باستخدام طريقة AttachPasses API (حتى 500 رقم تسلسلي لكل طلب).

إذا تعذر إرفاق بطاقة، فإن الـ API يعيد السبب المحدد لهذا الرقم التسلسلي:

• البطاقة مخصصة بالفعل لحملة أخرى.
• نمط البطاقة لا يتطابق مع تنسيق الحملة.
• البطاقة تفتقد إلى حقول الحملة المطلوبة.
• الرقم التسلسلي غير موجود أو ينتمي إلى منصة مختلفة.

إدارة حملة موجودة

فتح حملة تم إنشاؤها من Campaigns ← Wallet Passes ← Campaigns يعرض حالتها، وعداد المراجعات، ومعاينة حية للبطاقة، وثلاث علامات تبويب رئيسية: Design (تصميم)، Passes (بطاقات)، و History (سجل).

تغيير حالة الحملة

استخدم الحالة لتتبع وضع كل حملة: لا تزال قيد التصميم، أو تصدر بطاقات بنشاط، أو تم الانتهاء منها وأرشفتها.

لتغيير الحالة، حدد خيارًا من القائمة المنسدلة Status (الحالة) في رأس الحملة. يتم حفظ التغيير فورًا دون خطوة تأكيد منفصلة:

• Draft (مسودة) أو Active (نشطة): يسمح لك بإصدار بطاقات جديدة، وإرفاق بطاقات موجودة، ودفع تحديثات التصميم.
• Archived (مؤرشفة): يوقف إصدار البطاقات الجديدة. لا يمكنك إصدار أو إرفاق بطاقات أثناء أرشفة الحملة، لكن البطاقات الصادرة مسبقًا تستمر في العمل وتلقي التحديثات المشتركة.

علامة التبويب Design (تصميم)

في علامة التبويب Design (تصميم)، يمكنك تحديث قالب البطاقة، وتغيير الألوان، وتعديل الحقول المشتركة والشخصية، أو تحميل صور حملة جديدة.

تحديث التصميم ودفع التغييرات إلى البطاقات

يؤدي تعديل أي مما يلي والنقر على Save changes (حفظ التغييرات) إلى عرض مربع حوار تأكيد يوضح عدد البطاقات الصادرة التي سيتم تحديثها:

• المعلومات الأساسية، الألوان، أو نوع الباركود
• انتهاء الصلاحية أو المواقع
• حقل مشترك
• صورة حملة

قم بتأكيد التحديث:

• إذا لم يكن لدى أي بطاقات تجاوزات: انقر على Update (تحديث) لدفع التغييرات إلى جميع البطاقات الصادرة.
• إذا كان لدى بعض البطاقات تجاوزات: اختر ما إذا كنت تريد تحديث البطاقات القياسية فقط (مع الحفاظ على تجاوزات المستخدم) أو الكتابة فوق جميع البطاقات.

يؤدي تأكيد التحديث إلى زيادة عداد مراجعة الحملة (على سبيل المثال، إلى Revision 2 (المراجعة 2)) ومزامنة التغييرات تلقائيًا مع أجهزة المستخدمين.

ملاحظة

يتم حفظ التعديل الذي يتم إجراؤه عندما لا تكون هناك بطاقات صادرة على الفور دون مربع حوار تأكيد، لأنه لا توجد بطاقات موجودة لتحديثها.

تجاوز حقل مشترك على بطاقة فردية

إذا كنت بحاجة إلى تخصيص حقل مشترك لمستخدم معين، فقم بتعديل هذا الحقل مباشرة على بطاقته الفردية (من علامة التبويب Passes (بطاقات) أو All passes (كل البطاقات)):

• إنشاء تجاوز: يؤدي حفظ قيمة مخصصة على بطاقة فردية إلى فصل هذا الحقل عن التحديثات على مستوى الحملة. ستتخطى التحديثات المستقبلية للحملة هذه البطاقة لهذا الحقل المحدد.
• إزالة تجاوز: لاستعادة التحكم من الحملة، قم بتعديل البطاقة وانقر على Use the campaign value (استخدام قيمة الحملة) بجوار الحقل الذي تم تجاوزه.

يمكنك تتبع البطاقات التي تحتوي على قيم مخصصة في علامة التبويب Passes (بطاقات) تحت عمود Overrides (التجاوزات).

علامة التبويب Passes (بطاقات)

تسرد علامة التبويب Passes (بطاقات) كل بطاقة صادرة عن الحملة، بما في ذلك رقمها التسلسلي، ومعرف المستخدم المستلم، والتجاوزات النشطة، والمراجعة الحالية، وتاريخ آخر تحديث.

استخدم مرشحات الجدول للعثور على بطاقات محددة:

• With overrides (مع تجاوزات): يعرض البطاقات التي تحتوي على حقل واحد على الأقل تم تعديله بشكل مخصص.
• Behind the revision (متأخرة عن المراجعة): يعرض البطاقات التي لم تتلق بعد آخر تحديث للحملة.

لإصدار بطاقات جديدة أو إرفاق بطاقات موجودة، انظر إصدار البطاقات للمستخدمين.

افتح قائمة إجراءات الصف (⋮) لإدارة تلك البطاقة:

• Edit (تعديل): افتح البطاقة في صفحة التعديل الخاصة بمنصتها لتغيير الحقول الشخصية أو تجاوز حقل مشترك.
• Download (تنزيل): في حملات Apple Wallet، قم بتنزيل ملف .pkpass الموقع. لا تظهر حملات Google Wallet هذا الخيار، حيث لا يوجد في Google Wallet ملف مكافئ قابل للتنزيل.
• Send message (إرسال رسالة): افتح منشئ الإشعارات لمرة واحدة لمراسلة مستلم البطاقة بواسطة User ID. انظر مراسلة حاملي بطاقات Wallet لجميع الطرق للوصول إليهم.
• QR code (رمز الاستجابة السريعة): أظهر رمز استجابة سريعة للتثبيت يمكن للمستخدمين مسحه ضوئيًا لإضافة البطاقة وتسجيل أجهزتهم للتحديثات.
• Copy install link (نسخ رابط التثبيت): انسخ عنوان URL للتثبيت لمشاركة البطاقة في قنوات المراسلة الخاصة بك.
• Delete (حذف): قم بإزالة البطاقة. لا يمكن التراجع عن هذا الإجراء. في Apple Wallet، تتوقف النسخ المثبتة بالفعل عن تلقي التحديثات وتصبح غير صالحة عند تحديثها التالي. في Google Wallet، لا تسمح Google بإزالة بطاقة محفوظة بالفعل على جهاز بالقوة، لذا تصبح غير صالحة وتنتقل إلى Expired passes (البطاقات منتهية الصلاحية) للمستخدم بينما يزيل Pushwoosh سجلها. لا يؤدي حذف بطاقة هنا إلى حذف الحملة أو أي بطاقة أخرى صادرة.

علامة التبويب History (سجل)

تسرد علامة التبويب History (سجل) جميع مراجعات الحملة بترتيب زمني، وتوضح الحقول التي تم تعديلها في كل إصدار.

تظهر حالة تسليم آخر تحديث أسفل علامات التبويب:

• Cancel (إلغاء): يوقف إرسال التحديث إلى البطاقات التي لم يصل إليها بعد. تظل هذه البطاقات على مراجعتها السابقة.
• Retry failed (إعادة محاولة الفاشلة): يعيد محاولة التسليم للبطاقات التي فشل تحديثها (تُوضع علامة فشل بعد 5 محاولات).

بمجرد حفظ مراجعة جديدة، لم يعد من الممكن إعادة محاولة التحديثات الأقدم أو إلغاؤها.

حذف حملة

افتح الحملة وانقر على Delete campaign (حذف الحملة) في أعلى يمين الصفحة.

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