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

الهدف

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

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

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

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

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

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

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

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

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

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

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

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

بعد ذلك، سنتعمق في كل خطوة على حدة.

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

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

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

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

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

صورة

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

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

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

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

صورة

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

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

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

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

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

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

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

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

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

إصلاح

صورة

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

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

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

تأكيد

صورة

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

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

استخدِم شكلاً بينيًا لعرض المعلومات للعميل، مع تفعيل ثلاثة خيارات للمتابعة:

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

يمكنك مشاهدة مثال على ذلك في لقطة الشاشة على اليسار.

قبول

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

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

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

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

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

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

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

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

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

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

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

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

الخلاصة

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

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

يمكنك تنزيل التقرير الموجز لتحسين عمليات الدفع والتسليم والعمليات باستخدام عناوين موثوقة والاطّلاع على البرنامج التعليمي على الويب تحسين الدفع والتسليم والعمليات باستخدام "التحقّق من صحة العناوين" .

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

المساهمون

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

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