# تصميم بطاقات Google Wallet في أداة إنشاء البطاقات

أداة إنشاء بطاقات Google Wallet هي مصمم مرئي في لوحة التحكم. يمكنك اختيار نوع البطاقة، وملء العلامة التجارية، والحقول، والباركود، ومشاهدة معاينة حية، وإنشاء البطاقة. عند إنشاء البطاقة، يقوم Pushwoosh بإنشاء كائن البطاقة في Google Wallet ويعيد رابط حفظ "إضافة إلى Google Wallet".

## إنشاء بطاقة

<Aside type="note" title="الإعداد مطلوب أولاً">
الأداة متاحة فقط بعد إعداد Google Wallet للتطبيق (معرّف المُصدر ومفتاح حساب الخدمة). إذا لم يتم إعداده بعد، فقم بإعداده أولاً: [إعداد بطاقة Google Wallet لنظام Android](/ar/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/).
</Aside> 

في لوحة التحكم، انتقل إلى **الحملات → بطاقات Wallet**، افتح علامة التبويب **Google Wallet**، وانقر على **إنشاء بطاقة**.

<img src="/google-wallet-passes-pass-builder-1.webp" alt="صفحة بطاقات Wallet مع فتح علامة التبويب Google Wallet وظهور زر إنشاء بطاقة"/>


## إعداد البطاقة

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

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

### اختر نوع البطاقة

تحت **نوع البطاقة**، اختر واحدًا من سبعة أنواع لبطاقات Google Wallet. يتحكم النوع في تصميم البطاقة والحقول المتاحة. تستخدم البطاقات المصنفة تصميم Google الأصلي. البطاقة العامة حرة الشكل.

* **عام:** بطاقة حرة الشكل من حقولك الخاصة.
* **عرض:** كوبونات وخصومات.
* **بطاقة ولاء:** بطاقات الولاء والعضوية.
* **تذكرة حدث:** تذاكر للأحداث.
* **بطاقة هدايا:** بطاقات الهدايا والبطاقات مسبقة الدفع.
* **رحلة طيران:** بطاقات الصعود إلى الطائرة.
* **مواصلات:** تذاكر القطارات والحافلات والترام والعبّارات.



### املأ حقول البطاقة

الحقول التي تراها تعتمد على نوع البطاقة. الحقول المطلوبة مميزة. الحقول الشائعة لكل نوع:

| نوع البطاقة <div style="width:140px"></div> | الحقول الرئيسية |
| :---- | :---- |
| **عام** | عنوان البطاقة*، رأس الصفحة*، رأس فرعي، حقول البطاقة |
| **عرض** | العنوان*، المزود*، التفاصيل، الشروط الدقيقة، قناة الاسترداد (في المتجر / عبر الإنترنت / كلاهما)، اسم المُصدر |
| **ولاء** | اسم البرنامج*، اسم العضو، معرف العضو، رصيد النقاط، تسمية النقاط، مستوى المكافآت، تسمية المستوى، اسم المُصدر |
| **تذكرة حدث** | اسم الحدث*، المكان، العنوان، تاريخ ووقت البدء/الانتهاء، حامل التذكرة، رقم التذكرة، النوع، القسم، الصف، المقعد، البوابة |
| **بطاقة هدايا** | اسم التاجر*، رقم البطاقة*، PIN، الرصيد + العملة |
| **رحلة طيران** | رمز IATA لشركة الطيران*، رقم الرحلة*، الأصل*، الوجهة*، المغادرة*، اسم الراكب*، وقت الصعود، المقعد، الدرجة، مجموعة الصعود، رمز التأكيد |
| **مواصلات** | نوع المواصلات* (حافلة / قطار / ترام / عبّارة / أخرى)، المشغل*، الراكب*، نوع الرحلة، مراحل الرحلة (الأصل*، الوجهة*، الأوقات، الرصيف، العربة، المقعد) |

\* مطلوب من قبل Google.

<Aside type="note" title="التواريخ والأوقات">
تستخدم معظم أنواع البطاقات معيار ISO 8601 مع إزاحة UTC (على سبيل المثال، `2026-07-01T19:30:00+02:00`). بطاقات الطيران استثناء: تتطلب Google أوقات المغادرة والصعود والوصول بالتوقيت **المحلي** للمطار **بدون** إزاحة (على سبيل المثال، `2026-09-01T06:30:00`).
</Aside>

<span id="personalize-pass-content" />

#### تخصيص محتوى البطاقة

كل بطاقة مرتبطة بـ [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/) واحد. استخدم العناصر النائبة للوسوم لعرض بيانات فريدة لذلك المستخدم، على سبيل المثال رصيد النقاط على بطاقة ولاء أو اسم المستلم على بطاقة هدايا. أصدر بطاقة واحدة لكل User ID حتى يحصل كل مستلم على قيمه الخاصة. 

لإدراج عنصر نائب للوسم:

1. بجانب حقل نصي مدعوم (على سبيل المثال، **التاجر**، **عنوان البطاقة**، أو **رأس الصفحة**)، انقر على `{}` لإدراج وسم.
2. في **TAG**، حدد [الوسم](/ar/product/audience-data-and-segmentation/user-data-tags/tags/) لإدراجه في الحقل.
3. في **FORMAT**، اختر كيفية عرض قيمة الوسم: **كما هي** (استخدم القيمة المخزنة)، **عدد صحيح** (تقريب إلى أقرب عدد صحيح)، **سعر (0.00)** (عرض منزلتين عشريتين)، أو **تكبير الحرف الأول** (تكبير الحرف الأول).
4. في **FALLBACK**، أدخل نصًا اختياريًا لعرضه عندما لا يكون لدى المستلم قيمة للوسم.
5. انقر على **إدراج**.

<img src="/google-wallet-passes-pass-builder-2.webp" alt="حقل بطاقة مع فتح مربع حوار إدراج وسم، يظهر خيارات الوسم والتنسيق والبديل"/>

يقوم Pushwoosh بملء قيم الوسوم عند إنشاء البطاقة ويقوم بتحديثها مع كل تحديث.


### تعيين المظهر

تحت **المظهر**، قم بتكوين الألوان والصور ومن يمكنه حفظ البطاقة وتاريخ انتهاء الصلاحية.

#### الألوان

أدخل رمزًا سداسيًا عشريًا في **لون الخلفية**، على سبيل المثال `#FFFFFF` للأبيض. قم بتضمين `#` البادئة وستة أحرف.

#### الصور

<Aside type="caution" title="استضف الصور على عنوان URL عام ببروتوكول HTTPS">
لا يقوم Google Wallet بتخزين شعارك أو صورتك الرئيسية. استضف كل ملف على **عنوان URL عام ببروتوكول HTTPS** يظل متصلاً بالإنترنت ويمكن الوصول إليه، ثم الصق الرابط في أداة إنشاء البطاقات. إذا تعطل عنوان URL أو تمت إزالة الملف، تتوقف الصورة عن التحميل على البطاقة.
</Aside>

الصق رابط HTTPS عام في **عنوان URL للشعار**. مطلوب لبطاقات الولاء والمواصلات.

اختياريًا، الصق رابطًا في **عنوان URL للصورة الرئيسية** لافتة عريضة أسفل تفاصيل البطاقة على الوجه الأمامي للبطاقة. الحجم الموصى به هو 1032×336 بكسل.

<img src="/google-wallet-passes-pass-builder-3.webp" alt="قسم المظهر مع حقول لون الخلفية، وعنوان URL للشعار، وعنوان URL للصورة الرئيسية، ومن يمكنه حفظ البطاقة، وتاريخ انتهاء الصلاحية"/>

<Aside type="tip" title="عناوين URL لمتجر الوسائط">
يمكنك لصق عنوان URL لصورة عامة من [متجر الوسائط](/ar/product/content/media-store/)، بما في ذلك [متغير](/ar/product/content/media-store/#create-image-variants) بحجم مناسب للموضع.

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

#### من يمكنه حفظ البطاقة

في **من يمكنه حفظ البطاقة**، حدد من يمكنه إضافة البطاقة إلى Google Wallet:

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

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

#### انتهاء الصلاحية

قم بتعيين **تاريخ انتهاء الصلاحية** إلى الوقت الذي يجب أن تنتهي فيه صلاحية البطاقة من قبل Google، أو اتركه فارغًا لعدم وجود تاريخ انتهاء.

### إضافة باركود

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

1. **التنسيق:** اختر كيف يبدو الباركود ونوع الماسح الضوئي الذي يمكنه قراءته.
   * **QR_CODE:** رمز مربع يمكن لمعظم الهواتف والماسحات الضوئية قراءته بسهولة. الأفضل لمعظم البطاقات.
   * **PDF_417:** باركود عريض مكون من عدة صفوف من الخطوط. غالبًا ما يكون مطلوبًا لبطاقات الصعود إلى الطائرة.
   * **AZTEC:** رمز مربع مضغوط، مشابه لـ QR. شائع في تذاكر الأحداث والمواصلات.
   * **CODE_128** / **EAN_13:** باركود أحادي البعد. اختر هذه فقط إذا كان الماسح الضوئي أو نظام نقاط البيع (POS) يتطلبها.
2. **القيمة:** البيانات المشفرة في الباركود (على سبيل المثال، رقم تذكرة أو عضوية). لاستخدام قيمة فريدة لكل مستخدم، انقر على `{}` بجانب الحقل وأدرج [عنصر نائب للوسم](#personalize-pass-content).
3. **نص بديل:** نص يظهر أسفل الباركود على البطاقة.

<img src="/google-wallet-passes-pass-builder-5.webp" alt="قسم الباركود مع حقول التنسيق والقيمة والنص البديل"/>

### إضافة حقول تفاصيل وروابط

على الوجه الأمامي للبطاقة، يرى المستخدمون البطاقة الرئيسية. عندما يفتحون تفاصيل البطاقة (الوجه الخلفي)، يمكنهم قراءة أقسام إضافية والنقر على الروابط التي تضيفها هنا.

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

<img src="/google-wallet-passes-pass-builder-6.webp" alt="أقسام الوحدات النصية والروابط مع حقول الرأس والنص وعنوان URL والوصف"/>

### إضافة رابط تطبيق *(اختياري)*

تحت **رابط التطبيق**، أضف زرًا على الوجه الأمامي للبطاقة يفتح صفحة ويب أو تطبيق Android الخاص بك عند النقر عليه. يمكنك تعيين **URL**، أو **اسم حزمة Android**، أو كليهما.

إذا قمت بتعيين عنوان URL فقط، فسيفتح الزر عنوان الويب هذا على أي جهاز. إذا قمت بتعيين اسم حزمة فقط، فسيعمل الزر على أجهزة Android التي تم تثبيت التطبيق عليها، مع عدم وجود بديل ويب.

<img src="/google-wallet-passes-pass-builder-4.webp" alt="قسم رابط التطبيق مع حقول عنوان URL واسم حزمة Android"/>

### إضافة مواقع *(اختياري)*

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

يمكنك إضافة ما يصل إلى **10** مواقع، يتم تعيين كل منها بخط العرض وخط الطول.

<img
  src="/google-wallet-passes-pass-builder-7.webp"
  alt="قسم المواقع مع حقول خط العرض وخط الطول لإضافة نقاط اهتمام"
  style={{ maxWidth: "480px", width: "100%", height: "auto" }}
/>

<Aside type="note" title="المواقع على Google Wallet">
يتحكم Google في نصف قطر السياج الجغرافي ويقرر متى يظهر الإشعار. لا يمكنك تعيين مسافة قصوى لكل موقع.
</Aside>

### أدخل User ID

أدخل [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related) الخاص بـ Pushwoosh للشخص الذي سيتلقى هذه البطاقة. 

يقوم Pushwoosh بإصدار البطاقة لذلك المستخدم ويدرجها تحت **المستخدم** في [**جميع البطاقات**](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes).

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

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

<Aside type="note" title="قد تختلف المعاينة على الجهاز">
المعاينة تقريبية. تستخدم البطاقات المصنفة تصميم Google الأصلي، لذا قد تبدو البطاقة مختلفة على جهاز حقيقي. الباركود المعروض هو عنصر نائب.
</Aside>

للتحقق من البطاقة مقابل متطلبات Google دون إنشائها، انقر على **التحقق من الصحة**. تقوم الأداة بتمييز الحقول المطلوبة المفقودة والمشكلات الأخرى.

## إنشاء البطاقة

انقر على **إنشاء**. يقوم Pushwoosh بالتحقق من البطاقة وإنشائها في Google Wallet. ستحصل على رابط حفظ **إضافة إلى Google Wallet** لمشاركته مع المستخدمين. في غضون ثوانٍ قليلة، تظهر البطاقة في [**جميع البطاقات**](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes).

لتحرير البطاقات والحصول على رابط الحفظ وإبطالها وحذفها بعد الإنشاء، راجع [إدارة البطاقات الحالية](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes).

## إدارة البطاقات عبر API

كل ما تفعله أداة إنشاء البطاقات متاح أيضًا من خلال [Google Wallet API](/ar/developer/api-reference/google-wallet-api/): إنشاء البطاقات وتحديثها وإدراجها والحصول على رابط حفظ وتعيين الحالة وحذفها.

<LinkCard title="Google Wallet API" href="/developer/api-reference/google-wallet-api/" />