الهدف
يصف هذا المستند طرقًا للجمع بين الإكمال التلقائي للأماكن والعنوان واجهة برمجة التطبيقات للتحقق من صحة البيانات1 و"خرائط Google" في عملية الدفع المرتبطة بالتجارة الإلكترونية بغرض التقاط عناوين عالية الجودة.
المتطلبات الأساسية
تنصح Google الإلمام بما يلي:
- الأماكن الخاصة بالإكمال التلقائي لمطوّر JavaScript
المستندات.
- فهم من وجهة نظر تقنية كيف تساعد ميزة "الإكمال التلقائي" للأماكن وخيارات تطبيقها.
- دليل تنفيذ عملية الدفع للمكان
الإكمال التلقائي:
- أمثلة على أفضل ممارسات تنفيذ ميزة "الإكمال التلقائي" للأماكن في الدفع عبر التجارة الإلكترونية.
- منتج واجهة برمجة التطبيقات للتحقق من صحة العنوان
المستندات،
مع التركيز على إنشاء التحقق من الصحة
المنطق.
- من وجهة نظر فنية، تعرَّف على كيفية استخدام واجهة برمجة تطبيقات التحقق من صحة العناوين. ويعمل ومراجعة الإشارات التي تحدد جودة العنوان.
ما هي عملية التحقّق من صحة العنوان؟
واجهة برمجة تطبيقات التحقق من صحة العنوان هي خدمة تقبل عنوانًا. يحدد مكونات العنوان ويتحقق من صحتها. كما أنه يوحّد لعنوان بريدي ويعثر على أفضل إحداثيات خط العرض/خط الطول له. اختياريًا، بالنسبة إلى العناوين الواقعة في الولايات المتحدة وبورتوريكو، يمكنك تمكين نظام دعم دقة الترميز (CASSTM)لماذا تحتاج إلى إثبات صحة العنوان عند الدفع؟
اجمع عناوين دقيقة خلال عملية الطلب:
هذه خطوة مهمة لتعزيز عمليات التسليم الناجحة، وزيادة عمليات التوصيل في الوقت المحدد
وتنفيذه، كما يقلل رسوم تصحيح العنوان المكلفة.
توجيه العملاء إلى إدخال العنوان بسرعة ودقة:
تؤدي ميزة "الإكمال التلقائي" للأماكن إلى تسريع عملية إدخال العناوين وتقليل أخطاء الإدخال، ما يسمح
العملاء بسهولة خلال عملية الدفع. تقديم ملاحظات من خلال عملية التحقّق من العنوان
بشأن جودة العنوان بشكل عام، وإجراء تصحيحات مثل توحيد
الأخطاء الإملائية ويحسن البيانات الوصفية، مثل توفير الوحدات السكنية أو
مؤشر تجاري (متوفّر في select
المناطق.
نظرة عامة حول خطوات التنفيذ
يوضح هذا القسم سير عمل إدخال العنوان الموصى به للتجارة الإلكترونية وعمليات الدفع. تتكون العملية من ثلاث خطوات:
- استخدِم ميزة "الإكمال التلقائي" للأماكن لالتقاط العنوان في البداية.
- استخدِم واجهة برمجة تطبيقات التحقق من صحة العنوان لتأكيد العنوان الذي تم إدخاله.
- عرض موقع العنوان الذي تم إدخاله على الخريطة لتسليم الطلب الثقة للعملاء.
بعد ذلك، سنتعمق في كل خطوة على حدة.
الخطوة 1: مسار إدخال العنوان - باستخدام خدمة الإكمال التلقائي للأماكن
تنفيذ المكان الإكمال التلقائي باستخدام JavaScript API في السطر الأول من نموذج إدخال العنوان.
تقدم ميزة الإكمال التلقائي للأماكن إلى العميل اقتراحات أثناء دخوله تفاصيل العنوان. عند تنفيذها باستخدام واجهة برمجة تطبيقات JavaScript، عندما يبدأ المستخدمون أثناء الكتابة، تظهر قائمة منسدلة أسفل حقل نموذج إدخال العنوان، وتعرض نتائج من خدمة الإكمال التلقائي التي يتم تحديثها مع كل ضغطة مفتاح. بمجرد أن ينقر المستخدم أدخل معلومات كافية للعثور على العنوان، فيحدده من الجديد. يؤدي هذا الإجراء إلى تعبئة حقول النموذج تلقائيًا بالعنوان البيانات.
يمكنك توفير نمطين لإدخال النماذج للمستخدم من خلال ميزة "الإكمال التلقائي للأماكن": إما شاشة تحتوي على جميع حقول العناوين أو شاشة بها إدخال واحد . ويطلب حقل الإدخال الفردي هذا من المستخدم بدء البحث أثناء الكتابة، بدلاً من إدخال مكونات العنوان بشكلٍ فردي. بعد الإكمال التلقائي يملأ العنوان، فسيوسع سير العمل حقول النموذج بالعنوان البيانات، بما يسمح للعميل بالمراجعة وإجراء التعديلات، مثل إضافة رقم الشقة أو الوحدة.
في ما يلي مثال على الشكل الذي قد يظهر به هذا التدفّق، باستخدام حقل إدخال واحد:
الخطوة 2: استخدام واجهة برمجة تطبيقات التحقق من صحة العناوين للتحقق من صحة العناوين
بعد أن يُدخل المستخدم العنوان، توصي Google بالاتصال بـ العنوان التحقق من صحة واجهة برمجة التطبيقات عند الدفع للتأكد من أنّ العنوان صالح وكامل تشغيل مكالمة إلى واجهة برمجة تطبيقات التحقق من صحة العنوان عند نقر المستخدم على الزر "التالي" أو "متابعة" على نموذج العنوان. يؤدي هذا الزر غالبًا إلى صفحة الدفع.
تنصح Google بطلب واجهة برمجة تطبيقات التحقق من صحة العنوان لكل معاملة.
يوضح مخطط التدفق التالي مثالاً للتكامل التام بين الأطراف واجهة برمجة تطبيقات التحقق من صحة العناوين في عملية الدفع:
يناقش هذا المستند تناول سيناريوهات القبول لاحقًا.
الخطوة 3: تقديم تأكيد مرئي
بعد إدخال العنوان، قدم للمستخدم تأكيدًا مرئيًا على التسليم الموقع الجغرافي من خلال عرضه على الخريطة. فهذا يوفر للعميل المزيد التأكد من صحة العنوان، وتقليل التسليم أو الاستلام والإخفاقات.
يمكن عرض الخريطة أثناء عملية الدفع أو إرسالها داخل المعاملة. رسالة تأكيد إلكترونية. ويمكن إتمام كلتا حالتي الاستخدام هاتين من خلال واجهات برمجة التطبيقات التالية.
توفّر Maps JavaScript API خريطة تفاعلية لعرض الموقع الجغرافي للمستخدم. | تتيح واجهة خرائط Google الثابتة تضمين الصور في صفحة الويب أو في مرحلة لاحقة من الرسالة الإلكترونية. |
---|---|
![]() |
![]() |
نظرة متعمّقة - معالجة سيناريوهات القبول
يمكن تصنيف ردود واجهة برمجة التطبيقات للتحقق من صحة العناوين في ثلاثة سيناريوهات رئيسية:
- إصلاح: العنوان منخفض الجودة. يجب إرسال طلب للحصول على مزيد من المعلومات.
- تأكيد: العنوان عالي الجودة، ولكنّه التغييرات من عنوان الإدخال. قد تطلب التأكيد.
- قبول: العنوان عالي الجودة يمكنك قبول العنوان المقدم.
يتم تناول هذا المفهوم في مقالة إنشاء التحقق من الصحة منطق في مستندات واجهة برمجة تطبيقات التحقق من صحة العناوين، وسنناقش كل سيناريو في هذا القسم.
إصلاح
يعرض هذا القسم كيفية إصلاح إدخال عنوان. للحصول على معلومات عن التي تعرضها واجهة برمجة تطبيقات التحقق من صحة العنوان، وذلك للإشارة إلى انخفاض جودة عنوانك، فراجع إصلاح عنوانك في وثائق إنشاء منطق التحقق من الصحة.
إذا أشارت الاستجابة من واجهة برمجة تطبيقات التحقق من العناوين إلى عنوان غير صالح، إعادة توجيه العميل إلى نموذج إدخال العنوان للتحقق من البيانات التي أدخلها. بعد إصلاح العنوان، من المفترض أن تتم إعادة إرسال الخدمة إلى العنوان. التحقق من صحة واجهة برمجة التطبيقات لضمان صلاحية التصحيحات التي تم إجراؤها.
يمكنك أيضًا تمييز أخطاء معيّنة في سطر العنوان باستخدام الإشارات
على مستوى addressComponents
. يمكنك الاطّلاع على مثال على ذلك في
لقطة الشاشة على اليسار.
تأكيد
يعرض هذا القسم كيفية تأكيد عنوان. للحصول على معلومات عن التي تشير إلى أن واجهة برمجة تطبيقات التحقق من صحة العناوين تقوم بإرجاعها للإشارة إلى أن العنوان يجب أن يكون مؤكد، راجع تأكيد عنوانك في وثائق إنشاء منطق التحقق من الصحة.
غالبًا ما يحتاج النظام إلى مطالبة المستخدم بتأكيد العنوان. على سبيل المثال: أخطأ العميل في كتابة اسم المدينة، ومن ثم يتم تصحيحه بواسطة العنوان واجهة برمجة تطبيقات التحقق من صحة البيانات يجب عليك تأكيد هذا الحلّ مع العميل. هذا بسبب قد تؤدي التغييرات التي تجريها واجهة برمجة التطبيقات إلى تغيير جذري ما كان مدخلاً.
استخدام نموذج بيني لعرض المعلومات على العميل، ما يؤدي إلى تفعيل ثلاثة خيارات للمتابعة:
- التأكّد من العنوان الذي عرضته واجهة برمجة التطبيقات وعملية الدفع يستمر، باستخدام العنوان المصحَّح.
- حدد العنوان كما تم إدخاله في الأصل، مع تجاهل التصحيح من واجهة برمجة تطبيقات التحقق من صحة العناوين يمكن أن تستمر عملية الدفع كالمعتاد، يمكن وضع علامة عليه للمراجعة قبل الشحن، إذا كانت العملية يسمح بها.
- يلغي العميل نموذج الدفع أو يتراجع، ويتم إعادته إلى إدخال عنوان البريد الإلكتروني في مرحلة الدفع، حيث يمكنهم إعادة الدخول إلى عنوانك من البداية، ابدأ العملية من جديد.
يمكنك مشاهدة مثال على ذلك في لقطة الشاشة على اليسار.
قبول
يعرض هذا القسم كيفية قبول عنوان. للحصول على معلومات عن التي تشير إلى أن واجهة برمجة تطبيقات التحقق من صحة العناوين تقوم بإرجاعها للإشارة إلى أن العنوان جيد الجودة ويجب قبولها، راجع قبول عنوانك في وثائق إنشاء منطق التحقق من الصحة.
في هذا السيناريو، يجب أن تنتقل عملية الدفع إلى المرحلة التالية، من المحتمل تجميع الدفعات، بدون أي مطالبات للعميل فيما يتعلق بجودة العنوان. أكدت واجهة برمجة التطبيقات أن العنوان الذي أدخله العميل جيد، والتسليم.
ننصحك باستخدام بيانات العنوان التي تم إرجاعها من واجهة برمجة تطبيقات التحقق من صحة العناوين. ضد الأمر، نظرًا لأن هذا قد يتضمن تصحيحات وإضافات بسيطة، مثل ما يلي:
- الكتابة بالأحرف الكبيرة
- تصحيحات التنسيق، على سبيل المثال
- الشارع إلى الشارع
- الترتيب الصحيح لمكونات العنوان
- ZIP+4 في الولايات المتحدة الأمريكية.
اعتبارات التنفيذ
عند بناء منطق قبول العنوان، تأكد من أن التنفيذ لا تمنع العملاء من إتمام الدفع بسبب إدخال عنوان غير صالح. إنشاء بطريقة تمنع احتمالية حدوث تكرار لا نهائي إذا كانت واجهة برمجة التطبيقات بشكل متكرر إلى أن الإدخال غير صالح.
تنصح Google بتزويد العملاء بفرصتين كحد أقصى لإدخال وقبول مدخلاتهم، وفي المحاولة الثانية، حتى إذا لم يقبلوا والتحقق منه. وفي المحاولة الثانية، يكون الهدف هو السماح لهم بالمضي قدمًا بغض النظر عن التحقق من الصحة.
هناك طريقتان مقترحتان لقبول المحاولة الثانية:
- فرض المتابعة: وضِّح للعميل نافذة توضّح العنوان بشكل مختلف. التحقق، ولكن مع السماح للخيار بمواصلة استخدام العنوان المكتوب.
- الموافقة الصامتة: لقبول المحاولة الثانية تلقائيًا بدون لتأكيد العنوان، حتى إذا لم يتم التحقق من صحة العنوان بشكل كامل.
إذا أمكن، صمم نظامك لوضع علامة على العناوين التي لا يمكن التحقق من صحتها، بحيث يمكن لممثل خدمة العملاء مراجعتها قبل شحن الطلب. هذا النمط التدبير الإضافي يضمن لك وقوع أي أخطاء.
تقدم تشييد المباني الجديدة صورة توضيحية جيدة لسبب إنشاء هذا التحقق الموصى بها. قد تكون هناك فجوة بين وقت تشييد المبنى الجديد الانتهاء وعندما يتم ملء عنوان هذا المبنى في العنوان البريدي لقواعد البيانات. يجب أن يتوفر للعملاء خيار فرض المتابعة من خلال لصفحة الدفع مع العنوان المكتوب، حتى إذا لم يتم التحقق من صحتها.
بعد اكتمال جلسة الدفع، يمكنك استخدام
provideValidationFeedback
لإرسال تعليقات إلى Google حول محاولة محددة للتحقق من العنوان.
الخاتمة
قدم هذا المستند نظرة عامة حول تنفيذ تدفق الدفع الإكمال التلقائي، والتحقق من صحة العنوان، والتأكيد المرئي على "خرائط Google". استخدام هذا المستند كنقطة انطلاق لتصميم التنفيذ، باتباع مسارات إدخال العناوين الموصى بها.
الخطوات التالية
نزِّل مقالة تحسين الدفع والتسليم والعمليات باستخدام عناوين موثوق بها. التقرير الموجز وعرض صفحة تحسين الدفع والتسليم والعمليات باستخدام العنوان التحقق من صحة برنامج تعليمي على الويب
قراءة إضافية مقترَحة:
- إضافة مستندات الإكمال التلقائي
- مستندات واجهة برمجة التطبيقات للتحقّق من صحة العناوين
- إعداد التقارير في "منصة خرائط Google"
المساهمون
هنريك فالف | مهندس الحلول
توماس Anglaret | مهندس الحلول
سارثاك غانغولي | مهندس حلول
-
المُرخَّص له غير الحصري التابع لخدمة البريد في الولايات المتحدة. العلامات التجارية التالية مملوكة من ®الولايات المتحدة Postal Service® ويتم استخدامها بإذن: CASSTM وUSPS® وDPV®. ↩