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

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

أنت تختار أي الحقول تكون [**مشتركة**](#set-shared-and-personal-fields) (لمزامنة التغييرات مع جميع أجهزة المستخدمين في وقت واحد) وأيها تكون [**شخصية**](#set-shared-and-personal-fields) (للحفاظ على القيم الفريدة مثل الأسماء أو الباركود أو الأرصدة لكل مستخدم).

<Aside type="note">
حملة بطاقات Wallet غير مرتبطة بحملة Customer Journey أو إشعار فوري. إنها أداة لإدارة قوالب البطاقات، وإصدارها، وتحديثات البطاقات في الوقت الفعلي.
</Aside>

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

*   تصميم بطاقة واحدة في حملة، بدلاً من إعداد كل بطاقة يدويًا في أداة إنشاء بطاقات [Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/) أو [Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/).
*   اختيار الحقول التي يتم تحديثها في كل مكان (مشتركة) والتي تظل خاصة بكل بطاقة (شخصية).
*   رؤية عدد البطاقات الصادرة التي سيؤثر عليها تعديل حقل ما قبل حفظه.
*   تجاوز حقل مشترك على بطاقة واحدة، ثم إعادة التحكم إلى الحملة لاحقًا.
*   إرفاق البطاقات الصادرة خارج الحملة لتبدأ في متابعة حقولها المشتركة.
*   تتبع مراجعات الحملة وحالة تسليم كل تحديث.

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

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

**Apple Wallet:**
*   عضوية نشطة في [برنامج مطوري Apple](https://developer.apple.com/programs/)
*   منصة [iOS](/ar/developer/first-steps/connect-messaging-services/ios-configuration/) متصلة بالتطبيق
*   [شهادة توقيع البطاقة](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/) مرفوعة إلى Pushwoosh

**Google Wallet:**
*   حساب مُصدر نشط في [Google Pay & Wallet Console](https://pay.google.com/business/console)
*   [Google Wallet مُكوَّن](/ar/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/) للتطبيق (معرف المُصدر ومفتاح حساب خدمة Google Cloud)

## إنشاء حملة

لبدء إنشاء حملة، انتقل إلى **الحملات ← بطاقات Wallet ← الحملات** وانقر على **إنشاء حملة**.

<img src="/wallet-pass-campaigns-1.webp" alt="قائمة الحملات الفارغة في بطاقات Wallet مع تمييز زر إنشاء حملة"/>

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

*   **المنصة:** حدد **Apple Wallet** أو **Google Wallet** في أعلى الصفحة. هذا الخيار دائم للحملة.
*   **الحملة:** أدخل **اسمًا** و**وصفًا** اختياريًا للرجوع إليه داخليًا. لن يظهر أي منهما على البطاقة.
*   **تنسيق البطاقة:** تحت **نمط البطاقة** (Apple) أو **نوع البطاقة** (Google)، اختر التخطيط لبطاقتك:
    *   **Apple Wallet:** بطاقة صعود، قسيمة، تذكرة حدث، بطاقة متجر، عامة. انظر [اختر نمط بطاقة](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#choose-a-pass-style).
    *   **Google Wallet:** عامة، عرض، بطاقة ولاء، تذكرة حدث، بطاقة هدايا، رحلة طيران، مواصلات. لا يمكن تغيير هذا بعد الإنشاء. انظر [اختر نوع بطاقة](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#choose-a-pass-type).

<img src="/wallet-pass-campaigns-2.webp" alt="نموذج إنشاء حملة جديدة يظهر حقول الاسم والوصف، ومحدد نمط البطاقة"/>

### تكوين تصميم البطاقة والعلامة التجارية

قم بتكوين الأقسام القياسية للبطاقة:

*   **المعلومات الأساسية، الألوان، والباركود:** قم بتعيين عنوان البطاقة، وألوان الخلفية والنص، ونوع الباركود. للحصول على إرشادات مفصلة حول كل قسم، انظر [تصميم البطاقات في أداة إنشاء بطاقات Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/) أو [تصميم بطاقات Google Wallet في أداة إنشاء البطاقات](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/).
*   **حقول البطاقة:** أضف الحقول التي يجب أن تظهر على البطاقة (انظر [حقول بطاقة Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#fill-in-pass-fields) أو [حقول وتفاصيل Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#fill-in-pass-fields)).
*   **انتهاء الصلاحية:** قم بتعيين التواريخ وقواعد انتهاء الصلاحية ذات الصلة (انظر [انتهاء صلاحية Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#set-expiration-and-status) أو [انتهاء صلاحية Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#expiration)).
*   **المواقع:** قم بتعيين الصلة المستندة إلى الموقع (انظر [مواقع Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#location-based-relevance-optional) أو [مواقع Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#add-locations-optional)).

<Aside type="tip">
بالنسبة لـ Google Wallet، استخدم **من يمكنه حفظ البطاقة** للتحكم فيما إذا كانت البطاقة مرتبطة بحساب Google واحد، أو جهاز واحد، أو يمكن الوصول إليها من قبل أي شخص لديه الرابط.
</Aside>

<span id="set-shared-and-personal-fields" />

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

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

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

<img src="/wallet-pass-campaigns-3.webp" alt="قسم تكوين الحقول المشتركة والشخصية مع مفاتيح التبديل الشخصية بجوار كل حقل"/>

| نوع الحقل <div style="width:120px"></div> | السلوك <div style="width:320px"></div> | أمثلة |
| :--- | :--- | :--- |
| **مشترك** | يتم التحكم فيه بواسطة الحملة. يؤدي تحديث هذا الحقل إلى مزامنة القيمة الجديدة مع كل بطاقة على أجهزة المستخدمين. | تاريخ الحدث، رقم البوابة، عنوان المتجر، نسبة الخصم |
| **شخصي** | فريد لكل مستخدم. لا تقوم الحملة بالكتابة فوق هذه القيم عند تحديثها. | اسم المستخدم، رقم المقعد، معرف العضوية، رصيد النقاط |

يمكن أن تتضمن قيمة الحقل الشخصي عنصرًا نائبًا للوسم، `{tag}` أو `{tag|format|fallback}` (على سبيل المثال، `{Seat}`). يقوم Pushwoosh بملئه من [وسم](/ar/product/audience-data-and-segmentation/user-data-tags/tags/) المستلم عند تقديمه للبطاقة. إذا لم يكن لدى المستلم قيمة لهذا الوسم، يستخدم Pushwoosh القيمة الاحتياطية من العنصر النائب، أو يترك الحقل فارغًا عندما لا يحتوي العنصر النائب على أي قيمة.

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

<Aside type="tip">
يتم تكوين وتخصيص باركود البطاقة في قسم **الباركود**. انظر [باركود Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#add-a-barcode) أو [باركود Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/pass-builder/#add-a-barcode) للحصول على التفاصيل.
</Aside>

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

1.  في قسم **صور الحملة**، انقر على **اختر صورة** بجوار خانة الصورة.
2.  حدد صورة موجودة من [متجر الوسائط](/ar/product/content/media-store/) الخاص بك أو اسحب وأفلت ملفًا جديدًا للتحميل.
3.  كرر العملية لكل خانة صورة متاحة:
    *   **Apple Wallet:** أيقونة، شعار، خلفية، تذييل، شريط، وصورة مصغرة (انظر [صور Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/pass-builder/#images)).
    *   **Google Wallet:** شعار وصورة رئيسية.

<img src="/wallet-pass-campaigns-4.webp" alt="قسم صور الحملة مع خانات تحميل للأيقونات والشعارات وصور البطاقات المخصصة"/>

<Aside type="note">
*   يجب أن تكون الصور أقل من 10 ميغابايت و 25 ميغابكسل.
*   **Apple Wallet:** على عكس البطاقة المستقلة، حيث يتم قفل الصور بعد الإنشاء، يصل تحديث صورة الحملة إلى كل بطاقة صادرة.
*   **Google Wallet:** تتيح لك البطاقة المستقلة بالفعل تغيير شعارها وصورتها الرئيسية في أي وقت عبر **تعديل**. تعمل صورة الحملة بنفس الطريقة، باستثناء أن تعديلًا واحدًا يصل إلى كل بطاقة صادرة مرة واحدة بدلاً من بطاقة واحدة فقط.
</Aside>

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

1.  تحقق من لوحة **معاينة كمستخدم** على اليمين لترى كيف تبدو البطاقة. يمكنك إدخال معرف مستخدم اختباري لمعاينة الحقول المخصصة.

<img src="/wallet-pass-campaigns-6.webp" alt="لوحة معاينة البطاقة الحية مع حقل معاينة كمستخدم وبطاقة رقمية معروضة"/>

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

يقوم Pushwoosh بإنشاء الحملة بحالة **مسودة** ويفتح مساحة العمل الخاصة بها، مع علامات التبويب **تصميم**، **بطاقات**، و**سجل**.

<Aside type="note">
إنشاء حملة يحفظ تصميم البطاقة فقط ولا يرسل البطاقات إلى المستخدمين. لتوزيع البطاقات على جمهورك، انتقل إلى [إصدار البطاقات للمستخدمين](#issue-passes-to-users).
</Aside>

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

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

1.  في علامة التبويب **بطاقات**، انقر على **إصدار بطاقة**.
2.  أدخل [معرف المستخدم](/ar/product/pushwoosh-knowledge-hub/users-userids/) الخاص بالمستلم في Pushwoosh.

<img src="/wallet-pass-campaigns-8.webp" alt="مربع حوار إصدار بطاقة مع حقل معرف مستخدم Pushwoosh وزر تأكيد إصدار البطاقة"/>

3.  انقر على **إصدار بطاقة** للتأكيد.

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

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

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

يقوم Pushwoosh بإنشاء البطاقة من التصميم الحالي للحملة ويدرجها في [**علامة تبويب البطاقات**](#passes-tab) وفي جدول **كل البطاقات** الخاص بالتطبيق ([Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/#view-and-manage-existing-passes) أو [Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)).

<Aside type="note" title="تسليم البطاقة إلى المستلم">
إصدار بطاقة ينشئ سجل البطاقة في Pushwoosh. لتسليمها إلى جهاز المستخدم، شارك رابط التثبيت:

1.  افتح قائمة إجراءات البطاقة في علامة التبويب **بطاقات** أو في **كل البطاقات**.
2.  حدد **نسخ رابط التثبيت** أو **رمز QR**. توفر بطاقات Apple Wallet أيضًا **تنزيل** لملف `.pkpass` الموقع.
3.  أرسل الرابط أو الملف إلى المستلم عبر إشعار فوري، بريد إلكتروني، رسالة نصية قصيرة، أو [Customer Journey](/ar/product/customer-journey/pushwoosh-journey-overview/).

لمزيد من الطرق لتوزيع البطاقات، انظر [مشاركة بطاقات Apple Wallet](/ar/product/messaging-channels/wallet-passes/apple-wallet/#share-the-pass-with-users-via-pushwoosh-channels) أو [مشاركة بطاقات Google Wallet](/ar/product/messaging-channels/wallet-passes/google-wallet/#share-the-pass-with-users-via-pushwoosh-channels).
</Aside>

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

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

1.  في علامة التبويب **بطاقات**، انقر على **إرفاق بطاقات**.
2.  ابحث عن البطاقات عن طريق معرف المستخدم، الرقم التسلسلي، أو الباركود.
3.  حدد البطاقات وقم بالتأكيد.

بمجرد إرفاقها:
*   تبدأ **الحقول المشتركة** في متابعة الحملة ويتم تحديثها كلما قمت بتغيير قالب البطاقة.
*   يتم الحفاظ على **القيم الشخصية** الموجودة بالفعل على البطاقة (مثل تفاصيل المستخدم أو الأرصدة الفريدة).

<Aside type="note" title="إرفاق البطاقات عبر API">
يمكنك أيضًا إرفاق البطاقات برمجيًا باستخدام طريقة `AttachPasses` API (حتى 500 رقم تسلسلي لكل طلب).

إذا تعذر إرفاق بطاقة، تُرجع واجهة برمجة التطبيقات السبب المحدد لهذا الرقم التسلسلي:
*   البطاقة مخصصة بالفعل لحملة أخرى.
*   نمط البطاقة لا يتطابق مع تنسيق الحملة.
*   البطاقة تفتقد إلى حقول الحملة المطلوبة.
*   الرقم التسلسلي غير موجود أو ينتمي إلى منصة مختلفة.
</Aside>

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

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

<img src="/wallet-pass-campaigns-11.webp" alt="رأس الحملة مع علامات تبويب التصميم والبطاقات والسجل، وعداد مراجعة، وقائمة منسدلة للحالة مضبوطة على مسودة"/>

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

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

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

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

### علامة تبويب التصميم

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

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

عندما تقوم بتعديل حقل مشترك أو استبدال صورة حملة والنقر على **حفظ التغييرات**، يعرض Pushwoosh مربع حوار تأكيد يوضح عدد البطاقات الصادرة التي سيتم تحديثها.

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

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

<Aside type="note">
التغييرات على معلومات البطاقة الأساسية، مثل الألوان أو نوع الباركود، والتغييرات التي يتم إجراؤها عندما لا يتم إصدار أي بطاقات بعد، يتم حفظها فورًا دون مربع حوار تأكيد. ينطبق تغيير المعلومات الأساسية على البطاقات الصادرة من الآن فصاعدًا. لدفعه إلى البطاقات الموجودة بالفعل مع المستخدمين، قم بتعديل حقل مشترك أو صورة وقم بتأكيد التحديث.
</Aside>

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

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

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

<img src="/wallet-pass-campaigns-13.webp" alt="شاشة تعديل البطاقة تظهر حقلاً من الحملة مع تمييز زر استخدام قيمة الحملة"/>

يمكنك تتبع البطاقات التي تحتوي على قيم مخصصة في [**علامة تبويب البطاقات**](#passes-tab) تحت عمود **التجاوزات**.

### علامة تبويب البطاقات

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

<img src="/wallet-pass-campaigns-7.webp" alt="علامة تبويب البطاقات تظهر جدول البطاقات الصادرة مع معرف المستخدم، والتجاوزات، والمراجعة، وأزرار الإجراءات"/>

استخدم مرشحات الجدول للعثور على بطاقات محددة:
*   **مع تجاوزات:** يعرض البطاقات التي تحتوي على حقل واحد على الأقل تم تعديله بشكل مخصص.
*   **خلف المراجعة:** يعرض البطاقات التي لم تتلق بعد آخر تحديث للحملة.

لإصدار بطاقات جديدة أو إرفاق بطاقات موجودة، انظر [إصدار البطاقات للمستخدمين](#issue-passes-to-users).

### علامة تبويب السجل

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

<img src="/wallet-pass-campaigns-10.webp" alt="علامة تبويب السجل تظهر القائمة الزمنية لمراجعات الحملة ومفاتيح الحقول المتغيرة"/>

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

*   **إلغاء:** يوقف إرسال التحديث إلى البطاقات التي لم يصلها بعد. تظل هذه البطاقات على مراجعتها السابقة.
*   **إعادة محاولة الفاشلة:** يعيد محاولة التسليم للبطاقات التي فشلت في التحديث (تم تمييزها كفاشلة بعد 5 محاولات).

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

## حذف حملة

افتح الحملة وانقر على **حذف الحملة** في أعلى يمين الصفحة.

<img src="/wallet-pass-campaigns-12.webp" alt="رأس مساحة عمل الحملة مع تمييز زر حذف الحملة في أعلى اليمين"/>

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