بطاقة الولاء اللي تطلع لما تقرب من محلك: كيف يشتغل الموقع داخل Apple Wallet وGoogle Wallet وكيف تضبطه صحThe Loyalty Card That Shows Up When You Are Near the Shop: How Location Works in Apple Wallet and Google Wallet and How to Set It Up Right

المصطلحات

pass (بطاقة Wallet)

ملف صغير يحفظه العميل في Apple Wallet أو Google Wallet، فيه اسم المحل والنقاط أو الأختام والباركود.

locations في Apple Wallet

قائمة داخل البطاقة نفسها، فيها لحد عشر مواقع، لكل موقع خط عرض وخط طول وجملة قصيرة تظهر على شاشة القفل.

merchantLocations في Google Wallet

مواقع المحل اللي تضيفها للبطاقة في Google Wallet، لحد عشرة لكل class وعشرة لكل object.

relevantText

الجملة اللي تكتبها أنت وتظهر مع البطاقة على شاشة قفل الآيفون، مثل «فرعنا على بعد خطوات».

الخطوات

1. 1

   الخطوة 1

   افهم الفكرة قبل ما تضبط شي

   المحل مش هو اللي يرسل لك تنبيه لما تمر جنبه. المحل يكتب موقعه داخل البطاقة، وبعدها الجوال والـ Wallet يقررون متى البطاقة تكون مفيدة لك.

   في الآيفون، Apple تقول إن هذي الميزة هادية: البطاقة تطلع على شاشة القفل، بدون تنبيه وبدون صوت.

   في الأندرويد، Google Wallet يرسل تنبيه ثابت على شاشة القفل، ويختفي لما تبعد عن المكان.

   نصيحة: لا توعد عملاءك بتنبيه يرن في الآيفون، اللي يصير إن البطاقة تطلع على شاشة القفل.

2. 2

   الخطوة 2

   اكتب مواقع فروعك في بطاقة Apple Wallet

   في ملف pass.json أضف المفتاح locations. كل موقع فيه latitude وlongitude، واختياري altitude وrelevantText.

   الحد عشر مواقع للبطاقة. لو عندك فروع أكثر، Apple تنصح تبدأ بأهمها، وتحدّث البطاقة لما تريد تغيّر القائمة.

   بطاقات الولاء (store card) تتعامل مع الموقع بنطاق صغير، حسب دليل Apple القديم يعني تقريباً مية متر أو أقرب، وApple تقول إن المسافة الدقيقة تفصيل داخلي وممكن تتغير.

   برومبتبرومبت يجهز لك قائمة locations

   نسخ

   عندي محل اسمه [اسم المحل] وفروعه هذي: [اسم الفرع، العنوان، الإحداثيات إذا عندي]. جهز لي مصفوفة locations لملف pass.json في Apple Wallet، بحد أقصى عشر مواقع مرتبة من الأهم، ولكل موقع relevantText قصير ومفيد بالعربي يشرح ليش البطاقة مفيدة هنا، بدون أي خصم أو رقم أنا ما ذكرته.

3. 3

   الخطوة 3

   اختار maxDistance بس لو تريد نطاق أصغر

   المفتاح maxDistance بالأمتار، والنظام ياخذ الأصغر بين رقمك وبين المسافة الافتراضية.

   يعني ما تقدر تكبّر النطاق بهذا المفتاح، تقدر بس تصغّره. مفيد لو فرعك داخل مول وما تريد البطاقة تطلع في الموقف.

   نصيحة: Apple تطلب ما تحط مواقع غير صحيحة حتى تطلع البطاقة أكثر.

4. 4

   الخطوة 4

   اكتب relevantText يفيد العميل

   هذي الجملة هي اللي يشوفها العميل على شاشة القفل. مثال Apple نفسها: «Store nearby on 1st and Main».

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

   برومبتبرومبت لجمل شاشة القفل

   نسخ

   اكتب لي خمس جمل relevantText قصيرة بالعربي لبطاقة ولاء [نوع المحل] في [المنطقة]. كل جملة أقل من 40 حرف، تقول للعميل إن الفرع قريب أو تذكره بالأختام، بدون أي خصم أو رقم مش موجود في هذي المعلومات: [العروض الحقيقية عندي].

5. 5

   الخطوة 5

   أضف المواقع في Google Wallet

   في Google Wallet استخدم merchantLocations داخل الـ class أو الـ object، لحد عشرة في كل واحد، وتقدر تضيفها مع insert أو patch أو update.

   انتبه لفرقين: Google هو اللي يقرر المسافة وكم لازم العميل يبقى في المكان قبل التنبيه، وGoogle هو اللي يكتب نص التنبيه، مش أنت.

   والتنبيه يوصل بس للي مفعّل التنبيهات ومعطي تطبيق Google Wallet إذن الموقع الدقيق دائماً.

   developers.google.com

   

6. 6

   الخطوة 6

   جرب على جهاز حقيقي

   Apple تقول إن الـ Simulator ما يعرض البطاقات على شاشة القفل، فجرب على آيفون حقيقي وأنت واقف عند الفرع.

   وفي الأندرويد جرب بحساب مفعّل فيه إذن الموقع الدائم للـ Wallet، لأن بدونه ما يوصل تنبيه.

برومبتات جاهزة للنسخ

هذا ملف pass.json لبطاقة الولاء عندي: [الصق الملف]. راجعه وقل لي: كم موقع في locations، هل كل موقع فيه latitude وlongitude صحيحة الشكل، هل relevantText قصير وواضح، وهل في maxDistance وكم قيمته. لا تضيف أي حقل ما تعرف إنه موجود في توثيق Apple.