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

الهدف

يوضّح هذا المستند طرقًا لدمج خدمة الإكمال التلقائي للأماكن وواجهة برمجة التطبيقات Address Validation API1 و"خرائط Google" في عملية الدفع في التجارة الإلكترونية بهدف جمع عناوين عالية الجودة.

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

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

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

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

‫Address Validation API هي خدمة تقبل عنوانًا. تحدّد هذه الخدمة مكوّنات العنوان وتتحقّق من صحتها. ويعمل أيضًا على توحيد تنسيق العنوان البريدي والعثور على أفضل إحداثيات معروفة لخطوط العرض/الطول الخاصة به. يمكنك اختياريًا تفعيل نظام دعم دقة الترميز (CASS™) للعناوين في الولايات المتحدة وبورتوريكو.

لماذا يجب إثبات صحة العنوان عند الدفع؟

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

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

نظرة عامة على عملية التنفيذ

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

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

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

الخطوة 1: مسار إدخال العنوان - استخدام خدمة "الإكمال التلقائي للمكان"

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

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

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

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

الصورة

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

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

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

يوضّح مخطط سير العمل التالي مثالاً على عملية دمج شاملة لواجهة Address Validation API ضمن عملية دفع:

الصورة

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

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

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

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

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

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

يمكن تصنيف الردود من واجهة برمجة التطبيقات Address Validation API إلى ثلاثة سيناريوهات رئيسية:

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

يتم تناول هذا المفهوم في قسم إنشاء منطق التحقّق ضمن مستندات Address Validation API، وسنتناول كل سيناريو في هذا القسم.

إصلاح

الصورة

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

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

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

تأكيد

الصورة

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

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

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

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

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

قبول

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

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

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

  • الكتابة بالأحرف الكبيرة
  • تصحيحات التنسيق، مثل
    • Street to St
    • الترتيب الصحيح لمكوّنات العنوان
  • ‫ZIP+4 في الولايات المتحدة

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

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

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

في ما يلي طريقتان مقترَحتان لقبول المحاولة الثانية:

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

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

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

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

الخاتمة

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

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

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

محتوى إضافي للقراءة:

المساهمون

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

  1. مرخّص غير حصري من خدمة البريد في الولايات المتحدة إنّ العلامات التجارية المسجّلة التالية مملوكة من United States Postal Service®‎ ويتم استخدامها بموجب إذن: CASS™‎ وUSPS®‎ وDPV®‎. ↩