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

الهدف

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الصورة

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

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

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

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

الصورة

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

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

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

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

توفّر Maps JavaScript API خريطة تفاعلية لعرض الموقع الجغرافي للمستخدم. تتيح Maps Static 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®. ↩