لإنشاء بطاقة Google Wallet تحتاج إلى أمرين: حساب مُصدِر (issuer) في Google Pay & Wallet Console، وأداة تبني البطاقة وتعيد إليك رابط Add to Google Wallet (أضِف إلى Google Wallet). في Pushwoosh تربط حساب المُصدِر مرة واحدة فقط عبر Issuer ID، دون الحاجة إلى مفتاح JSON. بعد ذلك يستطيع فريق التسويق تصميم البطاقات وتحديثها دون كتابة أي كود.
لقطات الشاشة في هذا الدليل مأخوذة من أداة إنشاء بطاقات Google Wallet في Pushwoosh، التي تُصدر كل بطاقة على معرّف المستخدم (User ID) نفسه المستخدم في الإشعارات الفورية والبريد الإلكتروني ورحلات العملاء. وبما أن Android يستحوذ على الحصة الأكبر من الهواتف في منطقة الشرق الأوسط وشمال أفريقيا، فإن Google Wallet هي المحفظة التي يصل إليها معظم عملائك على الأرجح.
ما تحتاجه قبل البدء
تصدر بطاقات Google Wallet من حساب مُصدِر، لا من تطبيق. وتُجري هذا الإعداد مرة واحدة لكل تطبيق.
-
حساب مُصدِر
في Google Pay & Wallet Console، أكمِل خطوات التسجيل في Google Wallet API. ستحصل على Issuer ID رقمي.
-
صلاحية الوصول لأداة البطاقات
في وحدة التحكم، افتح Users وادعُ حساب الخدمة الخاص بالأداة بمستوى الوصول Developer. حساب Pushwoosh هو
wallet-issuer@pushwoosh-wallet.iam.gserviceaccount.com. إذا تخطّيت هذه الخطوة فلن تتمكن أي أداة من إنشاء البطاقات أو تحديثها نيابةً عنك. -
مستخدم مشترك
يجب أن يكون شخص واحد على الأقل في قائمة Users الخاصة بالمُصدِر مستخدماً أيضاً في حساب Pushwoosh، وبالبريد الإلكتروني نفسه.
-
الوصول إلى بيئة الإنتاج
يبدأ المُصدِر الجديد في الوضع التجريبي (demo). اطلب الوصول إلى بيئة الإنتاج من وحدة التحكم قبل الإطلاق.
بعد ذلك، في Pushwoosh، انتقل إلى Settings ← Configure platforms، وافتح إعداد Google Wallet ضمن Android، وأدخل Issuer ID ثم انقر Apply. إذا كنت تُصدر بطاقات بالفعل عبر حساب خدمة خاص بك، يمكنك رفع مفتاح JSON الخاص به هناك بدلاً من ذلك. عندها تُفعَّل أداة الإنشاء لهذا التطبيق. الخطوات الكاملة موجودة في توثيق إعداد Google Wallet.
نصيحة واحدة من مرحلة الإعداد: اطلب الوصول إلى بيئة الإنتاج مبكراً، فهذه الخطوة تنتظر Google لا أنت. وإذا كنت تخطط لإطلاق البطاقات مع موسم رمضان أو الجمعة البيضاء، فاحسب وقت الانتظار هذا ضمن جدولك.
اختر نوعاً من 7 أنواع للبطاقات
يوفّر Google Wallet سبعة أنواع من البطاقات. اختر بعناية، لأن النوع يُثبَّت لحظة إنشاء البطاقة. لا يمكن تحويل بطاقة ولاء إلى عرض لاحقاً.
| نوع البطاقة | الاستخدام المعتاد | تنبيه التحديث من Google |
|---|---|---|
| Generic (عام) | العضويات والحجوزات وكل ما لا يناسب نوعاً آخر | لا |
| Offer (عرض) | القسائم والعروض الترويجية، مثل عروض العيد | لا |
| Loyalty (ولاء) | النقاط والأختام والمستويات | نعم |
| Event ticket (تذكرة فعالية) | الحفلات والمباريات والمؤتمرات | نعم |
| Gift card (بطاقة هدية) | رصيد مخزّن | لا |
| Flight (رحلة طيران) | بطاقات صعود الطائرة | نعم |
| Transit (نقل) | تذاكر القطارات والحافلات والعبّارات | لا |
العمود الأخير أهم مما يبدو. ترسل Google تنبيهها الخاص بالحقول المتغيّرة فقط في بطاقات الولاء وتذاكر الفعاليات ورحلات الطيران. أما الأنواع الأربعة الأخرى فتُحدَّث بصمت، ما لم ترفق إشعاراً مخصصاً بالتحديث عبر API أو حملة بطاقات.
أنشئ البطاقة بأداة مرئية
في Control Panel، انتقل إلى Campaigns ← Wallet Passes، وافتح تبويب All passes، واختر Google Wallet ثم انقر Create pass.
-
Pass type (نوع البطاقة)
اختر نوعاً من الأنواع السبعة ضمن Pass type.
-
Branding (الهوية البصرية)
أضِف الشعار وصورة الواجهة والألوان. الشعار إلزامي في بطاقات الولاء والنقل.
-
Fields (الحقول)
املأ النصوص. يمكنك إدراج وسوم المستخدم، مثل الاسم أو رصيد النقاط. يملؤها Pushwoosh عند إنشاء البطاقة ويحدّثها مع كل تحديث.
-
Barcode (الرمز الشريطي)
اختر QR أو PDF417 أو Aztec أو Code128 أو EAN-13، بما يتوافق مع الماسحات التي تستخدمها.
-
Locations (المواقع)
أضِف ما يصل إلى 10 مواقع إذا كانت البطاقة مرتبطة بمتاجرك أو مقرّاتك. تحدد Google نطاق المسافة.
-
Who can save (من يمكنه الحفظ)
حدّد من يُسمح له بإضافة البطاقة إلى Google Wallet. لا يمكن تغيير ذلك بعد إنشاء البطاقة.
كل بطاقة تنتمي إلى User ID واحد. هذا ما يتيح لك تحديثها لاحقاً واستهداف حاملها ضمن الشرائح. كل حقل موصوف في توثيق أداة إنشاء بطاقات Google Wallet.
احصل على رابط الحفظ وأضِف الزر
عندما تبدو البطاقة كما تريد، انقر Generate. ينشئ Pushwoosh كائن البطاقة في Google Wallet ويعطيك رابط حفظ. إنه رابط URL عادي يبدأ بـ pay.google.com/gp/v/save/. عند فتحه يُطلب من العميل حفظ البطاقة.
ضع الرابط خلف زر Add to Google Wallet الرسمي في البريد الإلكتروني أو الرسائل القصيرة أو الرسائل داخل التطبيق أو صفحة الويب، أو حوّله إلى رمز QR للمطبوعات. تتشدد Google في شكل هذا الزر، لذا استخدم الملف الرسمي.
حدّث البطاقة بعد حفظها
البطاقة المحفوظة ليست ملفاً ثابتاً. عدّلها في أداة الإنشاء أو عبر Google Wallet API، وستزامن Google التغيير مع كل جهاز حفظ عليه العميل البطاقة. مثال عملي: عدّل تاريخ صلاحية قسيمة عرض رمضان، فيظهر التاريخ الجديد على هواتف كل من حفظها.
يمكنك أيضاً إدارة حالتها. عند إبطال البطاقة (invalidate) تنتقل إلى Expired passes لدى العميل. وفعّلها (activate) إذا احتجت إليها مجدداً. وعند حذفها تُبطَل في Google وتُزال من Pushwoosh.
قيود يجب معرفتها قبل الإطلاق
الإشعارات مخصّصة للبطاقة فقط. تسمح Google بالإشعارات المتعلقة بالبطاقة. استخدامها لإرسال عروض ترويجية يخالف الإرشادات. كما تحدّ Google الإشعارات بثلاثة لكل بطاقة خلال 24 ساعة، وفي تذاكر الفعاليات ورحلات الطيران لا يصدر تنبيه التحديث إلا عندما يكون موعد البدء على بُعد أقل من 3 ساعات.
لا يمكنك دفع البطاقة إلى الهاتف. يحفظها العميل أولاً، من رابط أو رمز QR أو بريد إلكتروني أو رسالة قصيرة. بعدها فقط يمكن أن تصله التحديثات.
التوفر حسب الدولة. بطاقات Google Wallet لا تعمل في كل الدول. تحقّق من توفرها في أسواقك، سواء السعودية أو الإمارات أو مصر أو غيرها، قبل التخطيط للإطلاق.
Apple Wallet تحتاج بطاقة خاصة بها. تستخدم Apple وGoogle تنسيقين مختلفين للبطاقات (مقارنة بين المحفظتين)، لذا أنشئ نسخة Apple Wallet من البطاقة نفسها لعملاء iPhone.
أخطاء شائعة
اختيار النوع الخطأ هو الخطأ الأكثر كلفة. تختار فرق كثيرة Generic لأنه مرن، ثم تكتشف أن Google لا ترسل أبداً تنبيه تحديث خاصاً به. إذا كانت التنبيهات مهمة، فابدأ من الولاء أو تذكرة الفعالية أو رحلة الطيران.
الخطأ الثاني هو الإطلاق بينما لا يزال المُصدِر في الوضع التجريبي. الوصول إلى بيئة الإنتاج ينتظر Google، لا فريقك.
الخطأ الثالث هو رمز شريطي لا تستطيع نقاط البيع لديك قراءته. امسح بطاقة حقيقية بماسح حقيقي قبل أن تطبع رمز QR واحداً.
أطلق بطاقات Google Wallet أسرع مع Pushwoosh
يتصل Pushwoosh بحساب المُصدِر في Google Wallet مرة واحدة. ومن بعدها يصمّم فريقك البطاقات ويُصدرها ويحدّثها بأداة مرئية أو عبر API، وتبقى كل بطاقة على ملف العميل نفسه مع الإشعارات الفورية والرسائل داخل التطبيق والبريد الإلكتروني والرسائل القصيرة. ولفرق المؤسسات: Pushwoosh حاصل على شهادتي ISO 27001:2022 وSOC 2 Type 2، ومتوافق مع GDPR، ولديه مراكز بيانات في الاتحاد الأوروبي والولايات المتحدة.
إطلاق Google Wallet لا يتعلق حقاً بملف البطاقة. إنه يتعلق بامتلاك بطاقة يمكنك إبقاؤها محدّثة لكل عميل يحفظها.
