# البدء باستخدام بطاقات Apple Wallet

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

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

## ما يمكنك فعله ببطاقات Apple Wallet

مع بطاقات Apple Wallet في Pushwoosh، يمكنك:

*   تصميم البطاقات بشكل مرئي بالألوان، والحقول، والشعار، وصورة الشريط، والباركود، دون كتابة `pass.json` يدويًا.
*   إنشاء بطاقات ولاء، وكوبونات، وتذاكر فعاليات، وبطاقات صعود إلى الطائرة، وبطاقات متاجر عامة.
*   توزيع البطاقات على المستخدمين كملف `.pkpass`، أو رابط تثبيت، أو رمز QR.
*   تحديث محتوى البطاقة وتسليم التغييرات إلى الأجهزة التي أضافت البطاقة.
*   الوصول إلى حاملي البطاقات بإشعار فوري لمرة واحدة، أو تحديث للبطاقة، أو Customer Journey. انظر [مراسلة حاملي بطاقات Apple Wallet](/ar/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

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

<Aside type="caution" icon="setting" title="مطلوب مساعدة المطور">
يتطلب إصدار بطاقات Apple Wallet حساب مطور Apple وشهادات توقيع. شارك هذا القسم مع فريق المطورين لديك لإكمال الإعداد لمرة واحدة.
</Aside>

قبل تصميم بطاقتك الأولى، تأكد مما يلي:

*   **برنامج مطوري Apple:** تحتاج إلى عضوية نشطة لتسجيل معرفات نوع البطاقة (Pass Type IDs) وإنشاء شهادات التوقيع. [سجل أو أدر حسابك](https://developer.apple.com/programs/)
*   **منصة iOS:** يجب أن يكون تطبيقك متصلاً بمنصة iOS في Pushwoosh قبل أن تتمكن من إضافة شهادة توقيع البطاقة. [إعداد iOS](/ar/developer/first-steps/connect-messaging-services/ios-configuration/)

## ابدأ العمل مع بطاقات Apple Wallet

بعد استيفاء [المتطلبات الأساسية](#prerequisites)، اتبع هذا التدفق:

<Steps>

1.  **تكوين بطاقات Wallet في Pushwoosh**

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

    [كيفية إعداد شهادة التوقيع](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2.  **تصميم البطاقة**

    في [منشئ البطاقات (pass builder)](/ar/product/messaging-channels/apple-wallet-passes/pass-builder/)، اختر نمط البطاقة، وحدد الحقول والعلامة التجارية، وتحقق من المعاينة المباشرة.

3.  **إنشاء ملف `.pkpass` موقع**

    بمجرد إنشاء البطاقة والتحقق من صحتها، في [منشئ البطاقات (pass builder)](/ar/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass)، حدد **Generate**. يقوم Pushwoosh بإعداد الصور بالدقة المطلوبة ويوقع الملف بشهادتك.

4.  **توزيع البطاقة**

    أرسل للمستخدمين ملف `.pkpass`، أو رابط التثبيت، أو رمز QR. انظر [مشاركة البطاقة مع المستخدمين عبر قنوات Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). عندما يضيف المستخدمون البطاقة إلى Wallet، يسجل جهازهم للحصول على التحديثات المستقبلية.

5.  **تحديث محتوى البطاقة**

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

6.  **مراسلة حاملي البطاقات**

    بمجرد أن يضيف المستخدمون البطاقة إلى Wallet، يمكنك الوصول إليهم بإشعار فوري لمرة واحدة، أو تحديث للبطاقة، أو Customer Journey آلي.

    [مراسلة حاملي بطاقات Apple Wallet](/ar/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## عرض وإدارة البطاقات الحالية

في لوحة التحكم، انتقل إلى **Campaigns → Wallet Passes** وافتح علامة التبويب **Apple Wallet**. يسرد جدول **All passes** كل بطاقة للتطبيق، بما في ذلك اسمها، ونمطها، و [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/) المرتبط بها، وتاريخ ووقت آخر تحديث لها.

في قائمة البطاقات، افتح قائمة الإجراءات (⋮) للقيام بما يلي:

*   **Edit:** تغيير اسم البطاقة ووصفها، وقيم الحقول وتسمياتها، وتغيير الرسائل، والألوان، ورسالة الباركود، وانتهاء الصلاحية والحالة، والمواقع. يظل نمط البطاقة والصور مقفلة بعد الإنشاء. عند الحفظ، يتلقى كل جهاز أضاف البطاقة التحديث.

<Aside type="note" title="يتم تسليم التحديثات كإشعارات صامتة">
عندما تحفظ تغييرًا، يقوم Pushwoosh بإعادة توقيع البطاقة وإشعار كل جهاز مسجل بإشعار خالٍ من المحتوى. يقوم iOS بجلب الإصدار الجديد من تلقاء نفسه - لا يلزم إعادة التثبيت.
</Aside>

*   **Download:** تنزيل ملف `.pkpass` الموقع.
*   **QR code:** عرض رمز QR للتثبيت يمكن للمستخدمين مسحه ضوئيًا لإضافة البطاقة إلى Wallet وتسجيل أجهزتهم للتحديثات. في هذه النافذة، يمكنك أيضًا استخدام **Copy install link** أسفل رمز QR.
*   **Copy install link:** نسخ رابط التثبيت لمشاركة البطاقة في قنوات المراسلة الخاصة بك. [تعرف على المزيد](#share-the-pass-with-users-via-pushwoosh-channels).
*   **Send message:** فتح محرر الإشعارات الفورية لمرة واحدة لمراسلة حاملي البطاقات. عند فتحه من القائمة، فإنه يستهدف مالك البطاقة بواسطة [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/). انظر [مراسلة حاملي بطاقات Apple Wallet](/ar/product/messaging-channels/apple-wallet-passes/message-pass-holders/) لجميع طرق الوصول إليهم.
*   **Delete:** إزالة البطاقة. تتوقف النسخ المثبتة بالفعل على الأجهزة عن تلقي التحديثات وتصبح غير صالحة عند تحديثها التالي.

## مشاركة البطاقة مع المستخدمين عبر قنوات Pushwoosh

رابط التثبيت الذي تنسخه في المنشئ (**Copy install link**) هو رابط URL عادي. يؤدي فتحه على iPhone إلى إضافة البطاقة إلى Apple Wallet. يمكنك استخدام هذا الرابط في نفس قنوات Pushwoosh التي تستخدمها بالفعل للوصول إلى جمهورك:

*   **Email:** أضف الرابط إلى زر أو رابط نصي في [محرر البريد الإلكتروني (email editor)](/ar/product/content/email-content/drag-and-drop-email-editor/)، على سبيل المثال، دعوة للعمل "Add to Apple Wallet".
*   **Push notifications:** قم بتعيين الرابط كـ [إجراء فتح (open action)](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) للإشعار بحيث يؤدي النقر عليه إلى فتح البطاقة.
*   **SMS:** قم بتضمين الرابط في [محتوى الرسائل القصيرة (SMS content)](/ar/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content).

<Aside type="note" title="رابط واحد لكل بطاقة">
كل رابط تثبيت مرتبط ببطاقة واحدة (يحمل الرقم التسلسلي والرمز المميز لتلك البطاقة)، لذا يعمل رابط واحد لبطاقة واحدة مشتركة، وهو أمر مفيد لكوبون مشترك أو تذكرة حدث. لمنح كل مستلم بطاقته الخاصة، قم بإنشاء بطاقة لكل مستخدم باستخدام [PassKit API](/ar/developer/api-reference/apple-wallet-passkit-api/) وأرسل لكل مستخدم رابطه الخاص. يتم تثبيت بطاقات Wallet على أجهزة Apple فقط - iPhone و Apple Watch.
</Aside>

## إدارة البطاقات عبر واجهة برمجة التطبيقات (API)

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

<LinkCard title="واجهة برمجة تطبيقات Apple Wallet PassKit" href="/developer/api-reference/apple-wallet-passkit-api/" />

## عرض حاملي البطاقات في User Explorer

عندما يضيف مستخدم بطاقتك إلى Wallet، يسردها Pushwoosh في علامة التبويب **Devices and platforms** في [User Explorer](/ar/product/audience-data-and-segmentation/user-explorer/).

1.  اذهب إلى **Audience → User Explorer** وافتح ملف تعريف المستخدم.
2.  افتح علامة التبويب **Devices and platforms**.
3.  حدد **Apple Wallet** في الشريط الجانبي.

في ملف تعريف المنصة، يمكنك مراجعة:

*   **حالة الاشتراك:** على سبيل المثال، **SUBSCRIBED**
*   **معرف المنصة:** معرف البطاقة المعروض تحت اسم المنصة
*   **البيانات الوصفية:** **First subscription**، و **Timezone**، وحقول أخرى عند توفرها
*   **العلامات (Tags):** علامات المنصة، بما في ذلك أي علامات قمت بتعيينها عند إصدار البطاقة

[تعرف على المزيد](/ar/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)