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

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

مع Pushwoosh، يمكنك تصميم بطاقة في Control Panel، وإرسالها إلى المستخدمين، وتحديث البطاقة في أي وقت. تتم مزامنة التغييرات تلقائيًا على كل جهاز تم حفظ البطاقة عليه.

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

*   تصميم البطاقات في [منشئ البطاقات](/ar/product/messaging-channels/google-wallet-passes/pass-builder/)
*   مشاركة رابط الحفظ أو رمز QR مع المستخدمين
*   تحديث البطاقات في أي وقت. تقوم Google بمزامنة التغييرات على كل جهاز محفوظ
*   [مراسلة حاملي البطاقات](/ar/product/messaging-channels/google-wallet-passes/message-pass-holders/) برسالة push لمرة واحدة، أو إشعار تحديث البطاقة، أو Customer Journey

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

*   حساب مُصدر في [Google Pay & Wallet Console](https://pay.google.com/business/console)
*   مشروع Google Cloud مع مفتاح حساب خدمة

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

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

<Steps>

1.  **تكوين Google Wallet في Pushwoosh**

    اطلب من فريق المطورين لديك توصيل Google Wallet بتطبيقك في Pushwoosh.

    [كيفية إعداد Google Wallet](/ar/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

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

    افتح منشئ البطاقات في **Campaigns → Wallet Passes**، واختر نوع البطاقة، وأضف علامتك التجارية والحقول، وتحقق من المعاينة المباشرة.

    [تصميم بطاقات Google Wallet في منشئ البطاقات](/ar/product/messaging-channels/google-wallet-passes/pass-builder/)

3.  **إنشاء البطاقة**

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

4.  **إرسال البطاقة إلى المستخدمين**

    شارك رابط الحفظ أو رمز QR من **All passes**. انظر [مشاركة البطاقة مع المستخدمين عبر قنوات Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). لإرسال بطاقة إلى كل مستخدم على نطاق واسع، يمكن لفريق المطورين لديك استخدام [Google Wallet API](/ar/developer/api-reference/google-wallet-api/).

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

    في [**All passes**](#view-and-manage-existing-passes)، انقر على **Edit** على البطاقة، أو قم بتحديثها من خلال [Google Wallet API](/ar/developer/api-reference/google-wallet-api/). عند الحفظ، تقوم Google بتسليم التحديث إلى كل جهاز قام بحفظ البطاقة. لا يحتاج المستخدمون إلى حفظها مرة أخرى.

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

    بمجرد أن يحفظ المستخدمون البطاقة، يمكنك الوصول إليهم برسالة push لمرة واحدة أو Customer Journey آلية.

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

</Steps>

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

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

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

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

<Aside type="note" title="تحديثات البطاقات والإشعارات">
عندما تحفظ التغييرات، يتم تحديث البطاقة على كل جهاز قام بحفظها. إذا تم تمكين **Notify about changed fields** (ممكّن افتراضيًا)، ترسل Google أيضًا إشعار Android إلى حاملي البطاقات.

الإشعارات مدعومة لبطاقات **loyalty**، و**event ticket**، و**flight**. تقوم Google بإنشاء نص الإشعار تلقائيًا بناءً على الحقول التي تم تغييرها. بالنسبة لبطاقات الفعاليات والرحلات الجوية، لا يتم إطلاق الإشعارات إلا إذا بقي أقل من 3 ساعات حتى وقت البدء، وتضع Google حدًا أقصى لها بـ 3 إشعارات لكل بطاقة كل 24 ساعة.

لإرسال رسالتك الخاصة إلى حاملي البطاقات، انظر [مراسلة حاملي بطاقات Google Wallet](/ar/product/messaging-channels/google-wallet-passes/message-pass-holders/).
</Aside>

*   **Send message:** افتح مؤلف One-Time Push لمراسلة حاملي البطاقات. انظر [مراسلة حاملي بطاقات Google Wallet](/ar/product/messaging-channels/google-wallet-passes/message-pass-holders/) لجميع طرق الوصول إليهم.
*   **QR code:** عرض رمز QR الذي يشفّر رابط حفظ البطاقة. يقوم المستخدمون بمسحه لحفظ البطاقة في Google Wallet وتسجيل أجهزتهم للتحديثات.
*   **Copy install link:** نسخ رابط حفظ البطاقة لمشاركته في قنوات المراسلة الخاصة بك. [اعرف المزيد](#share-the-pass-with-users-via-pushwoosh-channels).
*   **Invalidate:** تعيين بطاقة نشطة إلى غير نشطة. تنتقل البطاقة إلى قسم **Expired passes** للمستخدم في Google Wallet. يبقى السجل في Pushwoosh.
*   **Activate:** إعادة تعيين بطاقة غير نشطة إلى نشطة. يظهر هذا الخيار في قائمة الإجراءات فقط عندما تكون البطاقة غير نشطة. يستعيد البطاقة في Google Wallet.
*   **Delete:** إبطال البطاقة في Google وإزالة سجلها في Pushwoosh. لا تسمح Google بإزالة بطاقة محفوظة بالفعل على جهاز بالقوة. تصبح غير صالحة وتنتقل إلى **Expired passes**.

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

رابط **Add to Google Wallet** هو URL عادي (`https://pay.google.com/gp/v/save/...`). يؤدي فتحه على جهاز إلى مطالبة المستخدم بحفظ البطاقة في Google Wallet. يمكنك استخدام هذا الرابط في نفس قنوات Pushwoosh التي تستخدمها بالفعل للوصول إلى جمهورك:

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

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

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

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

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

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

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

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

*   **Subscription status:** على سبيل المثال، **SUBSCRIBED**
*   **Platform identifier:** معرّف البطاقة المعروض تحت اسم المنصة
*   **Metadata:** **First subscription**، و**Timezone**، وحقول أخرى عند توفرها
*   **Tags:** علامات المنصة، بما في ذلك أي علامات قمت بتعيينها عند إصدار البطاقة

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