انتقل إلى المحتوى

تصميم التذاكر في منشئ التذاكر

منشئ التذاكر في Apple Wallet هو مصمم مرئي في لوحة التحكم. يمكنك اختيار نمط للتذكرة، وملء العلامة التجارية، والحقول، والباركود، ومشاهدة معاينة حية، وإنشاء ملف .pkpass موقع—دون الحاجة إلى كتابة pass.json يدويًا.

إنشاء تذكرة

Anchor link to

في لوحة التحكم، اذهب إلى Campaigns → Apple Wallet وانقر على Create pass.

صفحة جميع التذاكر مع زر Create pass وأعمدة الجدول لاسم التذكرة والنمط والمستخدم وآخر تحديث

تكوين التذكرة

Anchor link to
  • من الصفر: ابدأ بتذكرة فارغة. اختر نمط التذكرة، ثم قم بتعيين الألوان والصور والحقول والباركود والخيارات الأخرى بنفسك في الأقسام أدناه.

  • من قالب: انقر على Load template، واختر تذكرة مدمجة في Select Template (بطاقة صعود، قسيمة، تذكرة حدث، عام، أو بطاقة متجر)، وأكد. يقوم النموذج بملء نمط التذكرة والألوان والصور وحقول التذكرة والباركود والمعلومات الأساسية مسبقًا. قم بتحرير أي قيمة أو تغيير النمط حسب الحاجة. يستبدل Pushwoosh معرفات الفريق ونوع التذكرة الخاصة بالقالب بقيم تطبيقك.

اختر نمط التذكرة

Anchor link to

تحت PASS STYLE، اختر واحدًا من أنماط تذاكر Apple Wallet الخمسة. يتحكم النمط في التخطيط ومناطق الحقول والصور المتاحة:

  • Boarding Pass
  • Coupon
  • Event Ticket
  • Store Card
  • Generic

إذا بدأت من الصفر، اختر النمط قبل إضافة الحقول والصور. تغيير النمط يعيد تعيين الحقول الخاصة بالنمط.

أضف اسم التذكرة ووصفها

Anchor link to

تحت BASIC INFORMATION، املأ ما يلي:

Pass Nameعنوان التذكرة، واسم المصدر المعروض في إشعارات التحديث.
Descriptionوصف قصير للتذكرة.
Logo Textنص يظهر بجانب الشعار (يستخدم عند عدم تحميل صورة للشعار).
قسم المعلومات الأساسية مع حقول Pass Name و Description و Logo Text

تعيين الألوان والصور

Anchor link to

الألوان

Anchor link to

تحت COLORS، قم بتعيين:

  • Background Color: خلفية التذكرة.
  • Foreground Color: النص الرئيسي والأيقونات على التذكرة.
  • Label Color: لون تسميات الحقول (على سبيل المثال، FROM، GATE).

لتعيين أو تغيير لون، انقر على حقله واختر لونًا في منتقي الألوان.

قسم الألوان مع حقول Background Color و Foreground Color و Label Color

الصور

Anchor link to

تحت IMAGES، قم بتحميل Icon و Logo (كلاهما مطلوب). تعتمد الصور الاختيارية على نمط التذكرة.

انقر على Choose file بجانب كل خانة صورة. قم بتحميل ملفات PNG أو JPEG. يقوم Pushwoosh بمعالجة كل صورة إلى الدقات التي تطلبها Apple (@1x, @2x, @3x) عند إنشاء التذكرة.

املأ حقول التذكرة

Anchor link to

تحت PASS FIELDS، أضف النص والقيم التي تظهر على التذكرة. تعتمد المجموعات التي تراها على نمط التذكرة:

  • Header fields (أعلى التذكرة): Boarding Pass, Event Ticket
  • Primary fields (المحتوى الرئيسي): جميع الأنماط
  • Secondary fields (معلومات داعمة): جميع الأنماط
  • Auxiliary fields (تفاصيل إضافية): جميع الأنماط
  • Back fields (الجانب الخلفي للتذكرة): جميع الأنماط

انقر على + Add Field في كل مجموعة تحتاجها.

لكل حقل، قم بتعيين:

Key (ID)معرف فريد للحقل (يتم إنشاؤه تلقائيًا).
Labelتسمية قصيرة على التذكرة (على سبيل المثال، FROM).
Valueالقيمة المعروضة على التذكرة (على سبيل المثال، SFO).
Change messageنص في إشعار التحديث عند تغيير هذه القيمة. يظهر فقط عند تغيير القيمة. استخدم %@ للقيمة الجديدة (على سبيل المثال، Gate changed to %@).
حقل التذكرة مع زر Format وخيارات التنسيق الموسعة لتنسيق القيمة ومحاذاة النص

على بطاقة الحقل، انقر على Format لإظهار خيارات التنسيق. انقر على X لإزالة الحقل.

خيارات التنسيق

Anchor link to
  • Value format: نص، تاريخ ووقت، أو رقم/عملة.
  • Text alignment: افتراضي (طبيعي)، يسار، وسط، أو يمين.
  • Data detectors (الحقول الخلفية فقط): تحويل أرقام الهواتف والروابط والعناوين وأحداث التقويم إلى محتوى قابل للنقر في الحقول الخلفية.

أضف باركود

Anchor link to

تحت BARCODE، اختر تنسيقًا وأدخل البيانات المراد تشفيرها:

  1. Barcode Format: اختر كيف يبدو الباركود ونوع الماسح الضوئي الذي يمكنه قراءته.
    • QR Code (موصى به): رمز مربع يمكن لمعظم الهواتف والماسحات الضوئية قراءته بسهولة. الأفضل للقسائم وبطاقات الولاء ومعظم التذاكر.
    • PDF417: باركود عريض يتكون من عدة صفوف من الخطوط. غالبًا ما يكون مطلوبًا لبطاقات صعود الطائرات أو وسائل النقل.
    • Aztec: رمز مربع مضغوط، مشابه لـ QR. شائع في تذاكر الأحداث والنقل.
    • Code 128: باركود كلاسيكي بخطوط عمودية. اختر هذا فقط إذا كان الماسح الضوئي أو نظام نقاط البيع لديك يتطلب باركود 1D.
  2. Barcode Message: القيمة المشفرة في الباركود (على سبيل المثال، رقم تذكرة أو عضوية).
  3. Alt Text (اختياري): نص يظهر أسفل الباركود على التذكرة.
قسم BARCODE مع قائمة منسدلة للتنسيق وحقل رسالة الباركود وحقل نص بديل اختياري

تعيين انتهاء الصلاحية والحالة

Anchor link to

تحت EXPIRATION & STATUS، تحكم في وقت عرض التذكرة، ومتى تنتهي صلاحيتها، وما إذا كانت لا تزال صالحة:

  • Relevant Date (متى تظهر التذكرة): التاريخ والوقت الذي قد تظهر فيه التذكرة على شاشة القفل.
  • Expiration Date (متى تنتهي صلاحية التذكرة): التاريخ والوقت الذي بعده تصبح التذكرة باهتة في Wallet.
  • Mark as Voided (إبطال هذه التذكرة): مربع اختيار لإبطال التذكرة بحيث لا تكون قابلة للاستخدام.
قسم انتهاء الصلاحية والحالة مع تاريخ الصلة وتاريخ انتهاء الصلاحية ومربع اختيار الإبطال

خيارات خاصة بالنمط ومتقدمة

Anchor link to
  • Transit type (Boarding Pass فقط): جوي، قطار، حافلة، قارب، أو عام.
  • Grouping identifier: تجميع التذاكر ذات الصلة معًا في Wallet.

الصلة المستندة إلى الموقع (اختياري)

Anchor link to

تحت LOCATION-BASED RELEVANCE، تظهر التذكرة عندما يكون المستخدم بالقرب من المواقع التي تضيفها. لكل موقع، قم بتعيين النص الذي يظهر على شاشة القفل عندما يكون المستخدم قريبًا. يمكنك إضافة ما يصل إلى 10 مواقع.

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

تتحكم max distance (بالمتر) في مدى قرب المستخدم المطلوب لكي تظل التذكرة ذات صلة.

قسم الصلة المستندة إلى الموقع مع خريطة وقائمة مواقع ونص شاشة القفل وحقل المسافة القصوى

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

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

أدخل User ID

Anchor link to

أدخل User ID الخاص بـ Pushwoosh للشخص الذي سيتلقى هذه التذكرة. يصدر Pushwoosh التذكرة لهذا المستخدم ويدرجها تحت USER في All passes.

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

Anchor link to

يتم تحديث معاينة حية أثناء التحرير، حتى تتمكن من رؤية كيف ستبدو التذكرة تقريبًا في Wallet.

للتحقق من التذكرة مقابل مواصفات Apple دون إنشائها، انقر على Validate pass. يقوم المنشئ بالإشارة إلى الصور المطلوبة المفقودة والمشاكل الأخرى.

إنشاء التذكرة

Anchor link to

اختر Generate. يقوم Pushwoosh بالتحقق من صحة التذكرة، ومعالجة الصور، وتوقيع الحزمة. يستغرق الإنشاء بضع ثوانٍ، وبعد ذلك تظهر التذكرة في قائمة التذاكر الخاصة بك.

لتحرير التذاكر (بما في ذلك التحديث حسب الرقم التسلسلي) وتنزيلها ومشاركتها وحذفها بعد الإنشاء، راجع إدارة التذاكر الحالية.

إدارة التذاكر عبر API

Anchor link to

كل ما يفعله منشئ التذاكر متاح أيضًا من خلال PassKit Designer API: إنشاء وتحديث وسرد وتنزيل وحذف التذاكر.