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

الهدف

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

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

تنصح Google بالإلمام بما يلي:

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

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

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

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

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

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

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

  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: تقديم تأكيد مرئي

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

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

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

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

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

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

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

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

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

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

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

الخاتمة

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

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

مقالات نقترح قراءتها:

المساهمون

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

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