التحقّق من صحة العنوان عند الدفع

الهدف

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

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

تنصح Google بأن تكون على دراية بما يلي:

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

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

‫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 to St
    • الترتيب الصحيح لمكوّنات العنوان
  • ‫ZIP+4 في الولايات المتحدة

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

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

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

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

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

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

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

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

الخاتمة

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

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

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

المساهمون

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

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