التحقُّق من صحة عنوان الدفع في التجارة الإلكترونية

الهدف

يوضّح هذا المستند طرقًا للجمع بين ميزة "الإكمال التلقائي" لـ "المكان" و"واجهة برمجة التطبيقات للتحقّق من صحة العنوان"1 و"خرائط Google" في صفحة الدفع عبر التجارة الإلكترونية، وذلك بغرض تسجيل عناوين عالية الجودة.

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

تنصح Google بالتعرّف على ما يلي:

  • وثائق مطوّري برامج JavaScript Place Autocomplete (الإكمال التلقائي).
    • يمكنك فهم آلية عمل ميزة الإكمال التلقائي للأماكن وخيارات التنفيذ من منظور تقني.
  • دليل تنفيذ عملية الدفع للإكمال التلقائي لـ الإكمال التلقائي.
    • أمثلة على أفضل ممارسات تنفيذ ميزة "الإكمال التلقائي" في صفحة الدفع عبر التجارة الإلكترونية
  • مستندات منتجات Addressالتحقق API، مع التركيز على إنشاء منطق التحقق من الصحة.
    • يمكنك فهم طريقة عمل واجهة برمجة تطبيقات التحقّق من صحة العنوان من الناحية الفنية، ومراجعة الإشارات التي تحدّد جودة العنوان.

ما المقصود بإثبات صحة العنوان؟

واجهة برمجة التطبيقات للتحقق من صحة العنوان هي خدمة تقبل عنوانًا. يحدد مكونات العنوان ويتحقق من صحتها. كما أنه يوحّد العنوان البريدي ويعثر على أفضل إحداثيات خطوط الطول والعرض المعروفة له. يمكنك بشكل اختياري تفعيل نظام دعم دقة الترميز (CASSTM) للعناوين الجغرافية في الولايات المتحدة وبورتوريكو.

لماذا تحتاج إلى التحقّق من العنوان عند الدفع؟

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

توجيه العملاء إلى إدخال العنوان بسرعة ودقة:
تعمل ميزة "الإكمال التلقائي" على تسريع عملية إدخال العنوان والحدّ من أخطاء الإدخال، ما يتيح للعملاء التنقّل بسهولة خلال عملية الدفع. من خلال ميزة "التحقّق من صحة العنوان"، يتم تقديم ملاحظات حول جودة العنوان بشكل عام، وإجراء تصحيحات مثل أخطاء التوحيد والإملاء، وتحسين البيانات الوصفية، مثل تقديم مؤشر سكني أو تجاري (متوفّر في مناطق محددة.)

نظرة عامة حول خطوات التنفيذ

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

  1. استخدِم الإكمال التلقائي للأماكن لالتقاط العنوان مبدئيًا.
  2. استخدِم واجهة برمجة تطبيقات التحقّق من صحة العنوان لتأكيد العنوان الذي تم إدخاله.
  3. يجب عرض موقع العنوان الجغرافي الذي تم إدخاله على الخريطة لمنح العملاء الثقة في عملية التسليم.

بعد ذلك، سنتعمق في كل خطوة على حدة.

الخطوة الأولى: تدفق إدخال العنوان - باستخدام خدمة الإكمال التلقائي للأماكن

نفِّذ Place Autocomplete باستخدام واجهة برمجة تطبيقات JavaScript في السطر الأول من نموذج إدخال العنوان.

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

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

في ما يلي مثال على الطريقة التي قد يظهر بها هذا التدفّق، باستخدام حقل إدخال واحد:

صورة

الخطوة 2: استخدام واجهة برمجة تطبيقات التحقّق من صحة العناوين للتحقّق من صحة العناوين

بعد أن يُدخل المستخدم العنوان، تنصحك Google بالاتصال بـ واجهة برمجة تطبيقات التحقق من صحة العنوان عند الدفع للتأكد من صلاحية العنوان واكتماله. شغِّل استدعاء لواجهة برمجة تطبيقات التحقق من صحة العنوان، عند نقر المستخدم على الزر "التالي" أو "متابعة" في نموذج العنوان. يؤدي هذا الزر غالبًا إلى صفحة الدفع.

تنصح Google باستخدام ميزة التحقّق من صحة العناوين في كل معاملة.

يوضِّح مخطّط التدفق التالي مثالاً على الدمج التام بين الأطراف لواجهة برمجة التطبيقات للتحقّق من صحة العنوان ضمن عملية الدفع:

صورة

يناقش هذا المستند سيناريوهات قبول العنوان لاحقًا.

الخطوة 3: تقديم التأكيد المرئي

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

يمكن عرض الخريطة أثناء عملية الدفع، أو إرسالها في رسالة تأكيد المعاملة. ويمكن إنجاز كلتا حالات الاستخدام هذه باستخدام واجهات برمجة التطبيقات التالية.

توفر واجهة برمجة تطبيقات JavaScript للخرائط خريطة تفاعلية لعرض الموقع الجغرافي للمستخدم. تسمح Maps Static API بتضمين الصور في صفحة الويب أو في مرحلة لاحقة من رسالة إلكترونية.

معلومات تفصيلية - سيناريوهات قبول العناوين

يمكن تصنيف إجابات التحقّق من صحة العناوين في ثلاثة سيناريوهات رئيسية:

  • حلّ المشكلة: العنوان منخفض الجودة. يجب طلب المزيد من المعلومات.
  • تأكيد: العنوان عالي الجودة، ولكن يحتوي على تغييرات من العنوان الذي تم إدخاله. يمكنك طلب التأكيد.
  • قبول: العنوان عالي الجودة. ويمكنك قبول العنوان المقدَّم.

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

إصلاح

صورة

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

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

يمكنك أيضًا تمييز أخطاء سطر العنوان المحددة باستخدام الإشارات التي يتم عرضها على مستوى addressComponents. يظهر مثال على ذلك في لقطة الشاشة على اليمين.

تأكيد

صورة

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

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

استخدام نموذج بيني لعرض المعلومات للعميل، مع تفعيل ثلاثة خيارات للمتابعة:

  1. أكِّد العنوان على أنّه تم إرجاعه من خلال واجهة برمجة التطبيقات، وتستمر عملية الدفع باستخدام العنوان المصحَّح.
  2. حدِّد العنوان على النحو الذي تم إدخاله في الأصل، مع تجاهل التصحيح من واجهة برمجة تطبيقات التحقُّق من صحة العنوان. يمكن أن تستمر عملية الدفع كالمعتاد، ويمكن وضع علامة على الطلب لمراجعته قبل أن تشحنه، في حال السماح بذلك.
  3. يلغي العميل النموذج أو يتراجع عنه لإعادته إلى مرحلة إدخال العنوان في عملية الدفع، حيث يمكنه إعادة إدخال العنوان من نقطة الصفر، لبدء العملية من جديد.

يظهر مثال على ذلك في لقطة الشاشة على اليسار.

قبول

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

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

ننصح باستخدام بيانات العنوان التي تم إرجاعها من واجهة برمجة تطبيقات التحقّق من صحة العناوين في ضوء الطلب، لأنّها قد تحتوي على تصحيحات وإضافات بسيطة، مثل ما يلي:

  • الكتابة بالأحرف اللاتينية الكبيرة
  • تصحيحات التنسيق، مثل
    • من شارع إلى شارع
    • الترتيب الصحيح لمكونات العنوان
  • ZIP+4 في الولايات المتحدة الأمريكية.

اعتبارات التنفيذ

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

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

هناك طريقتان مقترحتان لقبول المحاولة الثانية:

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

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

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

بعد اكتمال جلسة الدفع، يمكنك اختياريًا استخدام طريقة provideValidationFeedback لإرسال ملاحظات إلى Google حول محاولة معيّنة للتحقّق من صحة العنوان.

الخلاصة

يقدم هذا المستند نظرة عامة على تدفق الدفع الذي ينفذ الإكمال التلقائي، والتحقق من صحة العنوان، والتأكيد المرئي على خرائط Google. استخدِم هذا المستند كنقطة بداية لتصميم عملية التنفيذ، وذلك باتّباع مسارات إدخال العناوين المقترَحة.

الخطوات التالية

يمكنك تنزيل تحسين عمليات الدفع والتسليم والعمليات من خلال عناوين موثوقة والاطّلاع على البرنامج التعليمي على الويب تحسين عمليات الدفع والتسليم والعمليات من خلال التحقق من العنوان .

اقترحت مزيدًا من القراءة:

المساهمون

هنريك فالف | مهندس حلول
توماس أنغلاريت | مهندس حلول
سارثاك غانغولي | مهندس حلول

  1. المُرخَّص له غير الحصري لخدمة البريد في الولايات المتحدة. العلامات التجارية التالية مملوكة من ®US Postal Service ويتم استخدامها بموجب إذن: CASSTM وUSPS® وDPV®. ↩