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

الهدف

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

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

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

ما هي عملية التحقّق من العنوان؟

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

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

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

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

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

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

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

بعد ذلك، سنتناول كل خطوة على حدة.

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

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

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

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

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

الصورة

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

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

تنصح Google بالاتّصال بواجهة برمجة التطبيقات Address Validation API لكل معاملة.

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

الصورة

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

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

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

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

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

نظرة معمّقة على سيناريوهات قبول العناوين

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

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

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

إصلاح

الصورة

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

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

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

تأكيد

الصورة

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

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

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

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

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

قبول

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

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

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

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

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

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

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

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

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

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

يقدّم تشييد المباني الجديدة مثالاً جيدًا على سبب рекомендоваه هذا الفحص. قد تكون هناك فجوة بين وقت اكتمال بناء المبنى الجديد ووقت تعبئة عنوان ذلك المبنى في قواعد بيانات العنوان البريدي. يجب أن يتوفّر للعملاء خيار مواصلة الدفع من خلال صفحة الدفع باستخدام العنوان الذي كتبوه، حتى إذا لم يتم التحقّق من صحته.

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

الخاتمة

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

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

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

مراجع إضافية مقترَحة:

المساهمون

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

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