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

الهدف

يوضّح هذا المستند طرقًا لدمج خدمة الإكمال التلقائي للأماكن وواجهة برمجة التطبيقات 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 عند الدفع للتأكّد من أنّ العنوان صالح وكامل. إرسال طلب إلى واجهة برمجة التطبيقات Address Validation API عند نقر المستخدم على الزر "التالي" أو "متابعة" في نموذج العنوان يؤدي هذا الزر غالبًا إلى صفحة الدفع.

تنصح Google باستخدام واجهة Address Validation API لكل معاملة.

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

الصورة

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

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

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

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

توفّر Maps JavaScript API خريطة تفاعلية لعرض الموقع الجغرافي للمستخدم. تتيح Maps Static 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 to St
    • الترتيب الصحيح لمكوّنات العنوان
  • الرمز البريدي ZIP+4 في الولايات المتحدة

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

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

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

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

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

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

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

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

الخاتمة

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

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

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

مقالات مقترَحة للقراءة:

المساهمون

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

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