هدف
این سند روشهایی را برای ترکیب «تکمیل خودکار مکان»، «Address Validation API 1 » و Maps در یک تسویهحساب تجارت الکترونیک به منظور ثبت آدرسهای با کیفیت بالا توضیح میدهد.
پیش نیازها
گوگل توصیه می کند با موارد زیر آشنا شوید:
- اسناد توسعه دهنده جاوا اسکریپت تکمیل خودکار را قرار دهید .
- از نقطه نظر فنی نحوه عملکرد Place Autocomplete و گزینه های اجرای آن را درک کنید.
- راهنمای اجرای تکمیل خودکار مکان را بررسی کنید.
- نمونههایی از بهترین شیوههای پیادهسازی تکمیل خودکار مکان در تسویهحساب تجارت الکترونیک.
- مستندات محصول Address Validation API با تمرکز بر ایجاد منطق اعتبارسنجی شما .
- از نقطه نظر فنی نحوه عملکرد Address Validation API را درک کنید و سیگنال هایی را که کیفیت آدرس را تعیین می کنند بررسی کنید.
اعتبار سنجی آدرس چیست؟
Address Validation API سرویسی است که یک آدرس را می پذیرد. اجزای آدرس را شناسایی و آنها را تأیید می کند. همچنین آدرس پستی را استاندارد می کند و بهترین مختصات طول و عرض جغرافیایی شناخته شده را برای آن پیدا می کند. به صورت اختیاری، برای آدرسهای ایالات متحده و پورتوریکو، میتوانید سیستم پشتیبانی دقت کدگذاری (CASS™) را فعال کنید.چرا هنگام تسویه حساب به تأیید اعتبار نیاز دارید؟
آدرس های دقیق را در طول فرآیند سفارش جمع آوری کنید:
این یک گام مهم برای ارتقای تحویل موفقیت آمیز، افزایش انجام به موقع و کاهش هزینه های پرهزینه اصلاح آدرس است.
مشتریان را راهنمایی کنید تا آدرس را سریع و دقیق وارد کنند:
تکمیل خودکار مکان، ورود آدرس را سرعت میبخشد و خطاهای ورودی را کاهش میدهد و به مشتریان امکان میدهد به راحتی از طریق تسویهحساب حرکت کنند. اعتبار آدرس بازخوردی را در مورد کیفیت کلی آدرس ارائه میکند، اصلاحاتی مانند استانداردسازی و اشتباهات املایی را انجام میدهد و ابردادهها را افزایش میدهد، مانند ارائه یک نشانگر مسکونی یا تجاری (در مناطق منتخب موجود است.
بررسی اجمالی پیاده سازی
این بخش گردش کار ورودی آدرس توصیه شده برای تسویهحسابهای تجارت الکترونیک را تشریح میکند. این فرآیند شامل سه مرحله است:
- برای ثبت آدرس ابتدا از Place Autocomplete استفاده کنید.
- برای تأیید آدرس وارد شده از Address Validation API استفاده کنید.
- مکان آدرس وارد شده را روی نقشه نمایش دهید تا اطمینان حاصل از تحویل به مشتریان ارائه شود.
در مرحله بعد، هر مرحله را جداگانه بررسی خواهیم کرد.
مرحله 1: جریان ورود آدرس - با استفاده از سرویس تکمیل خودکار مکان
تکمیل خودکار مکان را با استفاده از API جاوا اسکریپت در خط اول فرم ورود آدرس پیاده سازی کنید.
Place Autocomplete پیشنهادهایی را به مشتری ارائه می دهد که جزئیات آدرس خود را وارد می کند. هنگامی که با استفاده از JavaScript API اجرا میشود، وقتی کاربران شروع به تایپ میکنند، یک کشویی زیر فیلد فرم ورود آدرس ظاهر میشود که نتایج سرویس تکمیل خودکار را نشان میدهد که با هر ضربه کلید بهروزرسانی میشود. هنگامی که کاربر اطلاعات کافی برای یافتن آدرس را وارد کرد، آن را از منوی کشویی انتخاب می کند. این عمل به طور خودکار فیلدهای فرم را با داده های آدرس پر می کند.
شما می توانید دو سبک ورود فرم را با تکمیل خودکار مکان به کاربر ارائه دهید: یا یک نمایش با تمام فیلدهای آدرس، یا یک نمایش با یک فیلد ورودی واحد. این فیلد ورودی منفرد از کاربر میخواهد تا هنگام تایپ کردن، به جای وارد کردن اجزای آدرس به صورت جداگانه، جستجو را آغاز کند. هنگامی که تکمیل خودکار آدرس را پر می کند، گردش کار فیلدهای فرم را با داده های آدرس گسترش می دهد و به مشتری این امکان را می دهد که بررسی و ویرایش کند، مثلاً یک آپارتمان یا شماره واحد را اضافه کند.
در اینجا مثالی از نحوه ظاهر شدن این جریان با استفاده از یک فیلد ورودی است:
مرحله 2: از Address Validation API برای اعتبارسنجی آدرس ها استفاده کنید
پس از اینکه کاربر آدرس را وارد کرد، Google توصیه میکند هنگام تسویه حساب با Address Validation API تماس بگیرید تا تأیید کنید که آدرس معتبر و کامل است. هنگامی که کاربر روی دکمه Next یا Continue در فرم آدرس کلیک کرد، تماسی با Address Validation API برقرار کنید. این دکمه اغلب به صفحه پرداخت منتهی می شود.
Google توصیه میکند برای هر تراکنش، Address Validation API را فراخوانی کنید.
نمودار جریان زیر نمونه ای از ادغام سرتاسر Address Validation API را در یک پرداخت نشان می دهد:
این سند بعداً سناریوهای پذیرش آدرس را مورد بحث قرار می دهد.
مرحله 3: تایید بصری را ارائه دهید
پس از وارد کردن آدرس، با نمایش آن بر روی نقشه، تأیید بصری محل تحویل را به کاربر ارائه دهید. این به مشتری اطمینان بیشتری می دهد که آدرس صحیح است و خرابی های تحویل یا تحویل را کاهش می دهد.
نقشه را می توان در طول فرآیند پرداخت نشان داد یا در ایمیل تأیید تراکنش ارسال کرد. هر دوی این موارد استفاده را می توان با API های زیر انجام داد.
Maps JavaScript API یک نقشه تعاملی برای نمایش موقعیت کاربر ارائه می دهد. | Maps Static API امکان جاسازی تصویر در صفحه وب یا در مرحله بعد در ایمیل را فراهم می کند. |
---|---|
Deep Dive - آدرس سناریوهای پذیرش
پاسخ های Address Validation API را می توان به سه سناریو اصلی دسته بندی کرد:
- Fix— آدرس کیفیت پایینی دارد. شما باید برای اطلاعات بیشتر درخواست کنید.
- تأیید - آدرس با کیفیت بالا است، اما تغییراتی نسبت به آدرس ورودی دارد. ممکن است از شما درخواست تأیید کنید.
- Accept را — آدرس با کیفیت است. می توانید آدرس ارائه شده را بپذیرید.
این مفهوم در بخش Build your validation logic اسناد Address Validation API پوشش داده شده است و ما در این بخش هر سناریو را مورد بحث قرار خواهیم داد.
رفع کنید
این بخش نحوه تعمیر ورودی آدرس را نشان می دهد. برای اطلاعات در مورد سیگنالهای خاصی که Address Validation API برای نشان دادن یک آدرس با کیفیت پایین برمیگرداند، به رفع آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
اگر پاسخ از Address Validation API نشان دهنده آدرس نامعتبر است، مشتری را به فرم ورود آدرس هدایت کنید تا داده های وارد شده او را بررسی کند. پس از رفع آدرس، سرویس شما باید مجدداً به Address Validation API ارسال شود تا از معتبر بودن اصلاحات انجام شده اطمینان حاصل شود.
همچنین میتوانید با استفاده از سیگنالهای بازگرداندهشده در سطح addressComponents
خطاهای خط آدرس خاص را برجسته کنید. نمونه ای از این را می توان در اسکرین شات سمت راست مشاهده کرد.
تایید کنید
این بخش نحوه تایید یک آدرس را نشان می دهد. برای اطلاعات در مورد سیگنالهای خاصی که Address Validation API برمیگرداند تا نشان دهد یک آدرس باید تأیید شود، به تأیید یک آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
اغلب سیستم شما می خواهد از کاربر بخواهد تا یک آدرس را تأیید کند. به عنوان مثال، یک مشتری نام شهر را اشتباه می نویسد، که سپس توسط Address Validation API تصحیح می شود. شما باید این اصلاح را با مشتری تأیید کنید. این به این دلیل است که تغییرات ایجاد شده توسط API ممکن است اساساً آنچه در ابتدا وارد شده است را تغییر دهد.
از یک مدال بینابینی برای نمایش اطلاعات به مشتری استفاده کنید و سه گزینه را قادر می سازد تا ادامه دهید:
- آدرس را همانطور که توسط API برگردانده شده است تأیید کنید و فرآیند پرداخت با استفاده از آدرس تصحیح شده ادامه می یابد.
- با نادیده گرفتن تصحیح Address Validation API، آدرس را همانطور که در ابتدا وارد کرده اید انتخاب کنید. روند تسویه حساب می تواند به طور عادی ادامه یابد، و اگر فرآیند شما اجازه دهد، می توان سفارش را برای بررسی پایین دستی قبل از ارسال علامت گذاری کرد.
- مشتری مودال را لغو می کند یا از آن خارج می شود، و او را به مرحله ورود آدرس فرآیند پرداخت باز می گرداند، جایی که می تواند آدرس را از ابتدا وارد کند و فرآیند را از اول شروع کند.
نمونه ای از این را می توان در اسکرین شات سمت راست مشاهده کرد.
قبول کنید
این بخش نحوه پذیرش آدرس را نشان می دهد. برای اطلاعات در مورد سیگنالهای خاصی که Address Validation API برای نشان دادن کیفیت خوب آدرس و باید پذیرفته شود، برمیگرداند، به پذیرش آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
در این سناریو، فرآیند تسویه حساب باید به مرحله بعدی، احتمالاً گرفتن پرداخت، بدون هیچ گونه درخواستی برای مشتری در مورد کیفیت آدرس، حرکت کند. API تأیید کرده است که آدرس وارد شده توسط مشتری با کیفیت خوب و قابل تحویل است.
توصیه میکنیم از دادههای آدرس برگشتی از Address Validation API در برابر سفارش استفاده کنید، زیرا ممکن است حاوی اصلاحات و اضافات جزئی باشد، مانند موارد زیر:
- حروف بزرگ
- برای مثال اصلاحات قالب بندی
- خیابان به خیابان
- ترتیب صحیح اجزای آدرس
- ZIP+4 در ایالات متحده آمریکا.
ملاحظات پیاده سازی
هنگام ایجاد منطق پذیرش آدرس خود، مطمئن شوید که پیاده سازی شما به دلیل وارد کردن آدرس نامعتبر، مانع از خروج مشتریان نمی شود. منطق را به گونه ای بسازید که اگر API به طور مکرر نشان می دهد ورودی آنها نامعتبر است، از احتمال یک حلقه بی نهایت جلوگیری می کند.
گوگل توصیه می کند که حداکثر دو فرصت برای وارد کردن آدرس به مشتریان ارائه دهید و در تلاش دوم، ورود آنها را بپذیرید، حتی اگر تایید نشد. در تلاش دوم، هدف این است که به آنها اجازه دهیم بدون در نظر گرفتن اعتبار سنجی ادامه دهند.
دو روش پیشنهادی برای پذیرش تلاش دوم:
- ادامه دادن اجباری: به مشتری یک مدل نشان دهید که نشان میدهد نشانی معتبر نیست، اما اجازه دهید این گزینه با آدرس تایپشدهاش ادامه دهد.
- پذیرش بیصدا: بهطور خودکار تلاش دوم را بدون مرحله تأیید بپذیرید، حتی اگر آدرس کاملاً تأیید نشود.
در صورت امکان، سیستم خود را به گونهای طراحی کنید که نشانیهایی را که تأیید نمیکنند، علامتگذاری کنید تا نماینده خدمات مشتری بتواند قبل از ارسال سفارش، آنها را بررسی کند. این معیار اضافی به شما اطمینان می دهد که هر گونه اشتباهی را متوجه شوید.
ساخت و ساز ساختمان جدید نشان می دهد که چرا این بررسی توصیه می شود. ممکن است بین زمانی که ساخت و ساز ساختمان جدید به پایان می رسد و زمانی که آدرس آن ساختمان در پایگاه داده آدرس پستی پر می شود فاصله وجود داشته باشد. مشتریان باید این گزینه را داشته باشند که به اجبار از طریق صفحه پرداخت با آدرس تایپ شده خود ادامه دهند، حتی اگر اعتبار آن تأیید نشود.
پس از اتمام جلسه تسویه حساب، به صورت اختیاری از روش provideValidationFeedback
برای ارسال بازخورد Google در مورد تلاش برای تأیید اعتبار آدرس خاص استفاده کنید.
نتیجه گیری
این سند یک نمای کلی از یک جریان تسویهحساب را ارائه میکند که تکمیل خودکار، اعتبارسنجی آدرس و تأیید بصری را در Google Map اجرا میکند. از این سند به عنوان نقطه شروع برای طراحی پیاده سازی خود با پیروی از جریان های ورودی آدرس توصیه شده استفاده کنید.
مراحل بعدی
وایت پیپر بهبود پرداخت، تحویل و عملیات با آدرسهای قابل اعتماد را دانلود کنید و با وبینار اعتبارسنجی آدرس بهبود پرداخت، تحویل و عملیات را مشاهده کنید.
پیشنهاد مطالعه بیشتر:
مشارکت کنندگان
Henrik Valve | مهندس راه حل
توماس آنگلرت | مهندس راه حل
سرتاک گنگولی | مهندس راه حل
دارنده مجوز غیر انحصاری خدمات پستی ایالات متحده. علامت(های) تجاری زیر متعلق به US Postal Service® است و با مجوز استفاده می شود: CASS™، USPS®، DPV®. ↩