هدف
این سند روشهایی را برای ترکیب تکمیل خودکار مکان، اعتبارسنجی آدرس API 1 و نقشهها در یک پرداخت تجارت الکترونیک به منظور ثبت آدرسهای با کیفیت بالا شرح میدهد.
پیشنیازها
گوگل آشنایی با موارد زیر را توصیه میکند:
- مستندات توسعهدهندهی جاوااسکریپت با قابلیت تکمیل خودکار را قرار دهید .
- از نظر فنی نحوه عملکرد Place Autocomplete و گزینههای پیادهسازی آن را درک کنید.
- راهنمای پیادهسازی پرداخت برای قابلیت تکمیل خودکار مکان (Place Autocomplete).
- نمونههایی از بهترین شیوههای پیادهسازی تکمیل خودکار مکان در پرداخت تجارت الکترونیک.
- مستندات محصول API اعتبارسنجی آدرس ، با تمرکز بر ساخت منطق اعتبارسنجی شما .
- از نقطه نظر فنی نحوه عملکرد API اعتبارسنجی آدرس را درک کنید و سیگنالهایی را که کیفیت آدرس را تعیین میکنند، بررسی کنید.
اعتبارسنجی آدرس چیست؟
API اعتبارسنجی آدرس، سرویسی است که یک آدرس را میپذیرد. این API اجزای آدرس را شناسایی و آنها را اعتبارسنجی میکند. همچنین آدرس را برای ارسال پستی استانداردسازی کرده و بهترین مختصات طول/عرض جغرافیایی شناخته شده را برای آن پیدا میکند. به صورت اختیاری، برای آدرسهای ایالات متحده و پورتوریکو، میتوانید سیستم پشتیبانی دقت کدگذاری (CASS™) را فعال کنید.چرا در هنگام پرداخت به اعتبارسنجی آدرس نیاز دارید؟
در طول فرآیند سفارش، آدرسهای دقیق را جمعآوری کنید:
این یک گام مهم برای ارتقای تحویلهای موفق، افزایش زمان تحویل و کاهش هزینههای گزاف اصلاح آدرس است.
مشتریان را راهنمایی کنید تا آدرس را سریع و دقیق وارد کنند:
تکمیل خودکار آدرس، سرعت ورود آدرس را افزایش داده و خطاهای ورودی را کاهش میدهد و به مشتریان اجازه میدهد تا به راحتی در فرآیند پرداخت حرکت کنند. اعتبارسنجی آدرس، بازخوردی در مورد کیفیت کلی آدرس ارائه میدهد، اصلاحاتی مانند استانداردسازی و اشتباهات املایی را انجام میدهد و فرادادهها را بهبود میبخشد، مانند ارائه یک نشانگر مسکونی یا تجاری (در مناطق منتخب موجود است.)
نمای کلی پیادهسازی
این بخش، گردش کار پیشنهادی برای ورود آدرس در صندوقهای فروشگاههای اینترنتی را شرح میدهد. این فرآیند شامل سه مرحله است:
- برای ثبت اولیه آدرس، از قابلیت تکمیل خودکار مکان استفاده کنید.
- برای تأیید آدرس وارد شده، از API اعتبارسنجی آدرس استفاده کنید.
- نمایش موقعیت مکانی آدرس وارد شده روی نقشه، برای اطمینان خاطر مشتریان در تحویل کالا.
در ادامه، هر مرحله را به صورت جداگانه بررسی خواهیم کرد.
مرحله ۱: جریان ورود آدرس - با استفاده از سرویس تکمیل خودکار مکان
با استفاده از API جاوا اسکریپت، قابلیت تکمیل خودکار مکان را در خط اول فرم ورود آدرس پیادهسازی کنید.
تکمیل خودکار مکان، هنگام وارد کردن جزئیات آدرس، پیشنهاداتی را به مشتری ارائه میدهد. هنگامی که با استفاده از API جاوا اسکریپت پیادهسازی میشود، هنگامی که کاربران شروع به تایپ میکنند، یک منوی کشویی در زیر فیلد فرم ورود آدرس ظاهر میشود و نتایج سرویس تکمیل خودکار را که با هر ضربه کلید بهروزرسانی میشود، نشان میدهد. هنگامی که کاربر اطلاعات کافی برای یافتن آدرس وارد کرد، آن را از منوی کشویی انتخاب میکند. این عمل به طور خودکار فیلدهای فرم را با دادههای آدرس پر میکند.
شما میتوانید با استفاده از قابلیت تکمیل خودکار مکان، دو سبک ورود اطلاعات به فرم را در اختیار کاربر قرار دهید: یا نمایشی با تمام فیلدهای آدرس، یا نمایشی با یک فیلد ورودی. این فیلد ورودی واحد، کاربر را ترغیب میکند تا هنگام تایپ، جستجو را شروع کند، به جای اینکه اجزای آدرس را به صورت جداگانه وارد کند. پس از تکمیل خودکار، فیلدهای فرم با دادههای آدرس گسترش مییابند و به مشتری اجازه میدهند تا آنها را بررسی و ویرایش کند، به عنوان مثال شماره آپارتمان یا واحد را اضافه کند.
در اینجا مثالی از نحوه نمایش این جریان با استفاده از یک فیلد ورودی واحد آورده شده است:

مرحله ۲: استفاده از API اعتبارسنجی آدرس برای اعتبارسنجی آدرسها
پس از اینکه کاربر آدرس را وارد کرد، گوگل توصیه میکند که در هنگام پرداخت، API اعتبارسنجی آدرس را فراخوانی کنید تا تأیید شود که آدرس معتبر و کامل است. با کلیک کاربر روی دکمه بعدی یا ادامه در فرم آدرس، API اعتبارسنجی آدرس را فراخوانی کنید. این دکمه اغلب به صفحه پرداخت منتهی میشود.
گوگل توصیه میکند برای هر تراکنش، API اعتبارسنجی آدرس (Address Validation API) را فراخوانی کنید.
نمودار جریان زیر نمونهای از ادغام سرتاسری API اعتبارسنجی آدرس را در یک فرآیند پرداخت نشان میدهد:

این سند بعداً سناریوهای پذیرش آدرس را مورد بحث قرار میدهد.
مرحله ۳: ارائه تایید بصری
پس از وارد کردن آدرس، با نمایش مکان تحویل روی نقشه، تأیید بصری آن را به کاربر ارائه دهید. این کار به مشتری اطمینان بیشتری میدهد که آدرس صحیح است و خطاهای تحویل یا دریافت را کاهش میدهد.
نقشه میتواند در طول فرآیند پرداخت نشان داده شود یا در ایمیل تأیید تراکنش ارسال شود. هر دو مورد استفاده را میتوان با API های زیر انجام داد.
| API جاوا اسکریپت Maps یک نقشه تعاملی برای نمایش موقعیت مکانی کاربر ارائه میدهد. | API استاتیک نقشهها امکان جاسازی تصویر را در صفحه وب یا در مرحله بعدی در یک ایمیل فراهم میکند. |
|---|---|
![]() | ![]() |
بررسی عمیق - سناریوهای پذیرش را بررسی کنید
پاسخهای API اعتبارسنجی آدرس را میتوان به سه سناریوی اصلی طبقهبندی کرد:
- - کیفیت آدرس پایین است. باید درخواست اطلاعات بیشتر کنید.
- تأیید —آدرس با کیفیت بالا است، اما نسبت به آدرس ورودی تغییراتی دارد. ممکن است از شما تأییدیه بخواهد.
- که آیا آدرس ارائه شده کیفیت بالایی دارد یا خیر. میتوانید آدرس ارائه شده را بپذیرید.
این مفهوم در بخش «منطق اعتبارسنجی خود را بسازید» از مستندات API اعتبارسنجی آدرس پوشش داده شده است و ما در این بخش هر سناریو را مورد بحث قرار خواهیم داد.
رفع

این بخش نحوه اصلاح ورودی آدرس را نشان میدهد. برای اطلاعات بیشتر در مورد سیگنالهای خاصی که API اعتبارسنجی آدرس برای نشان دادن آدرس با کیفیت پایین برمیگرداند، به بخش اصلاح آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
اگر پاسخ از API اعتبارسنجی آدرس، نشاندهندهی آدرس نامعتبر باشد، مشتری را به فرم ورود آدرس هدایت کنید تا دادههای وارد شدهاش بررسی شود. پس از اصلاح آدرس، سرویس شما باید دوباره به API اعتبارسنجی آدرس ارسال کند تا از صحت اصلاحات انجام شده اطمینان حاصل شود.
همچنین میتوانید با استفاده از سیگنالهای برگردانده شده در سطح addressComponents ، خطاهای خاص خط آدرس را برجسته کنید. نمونهای از این مورد را میتوانید در تصویر سمت راست مشاهده کنید.
تأیید

این بخش نحوه تأیید یک آدرس را نشان میدهد. برای اطلاعات بیشتر در مورد سیگنالهای خاصی که API اعتبارسنجی آدرس برای نشان دادن اینکه یک آدرس باید تأیید شود، برمیگرداند، به تأیید آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
اغلب سیستم شما میخواهد از کاربر بخواهد آدرس را تأیید کند. برای مثال، مشتری نام شهر را اشتباه تایپ میکند که سپس توسط API اعتبارسنجی آدرس اصلاح میشود. شما باید این اصلاح را با مشتری تأیید کنید. زیرا تغییرات ایجاد شده توسط API ممکن است اساساً آنچه را که در ابتدا وارد شده است تغییر دهد.
از یک ماژول بینابینی برای نمایش اطلاعات به مشتری استفاده کنید و سه گزینه را برای ادامه فعال کنید:
- آدرسی که توسط API برگردانده شده را تأیید کنید و فرآیند پرداخت با استفاده از آدرس اصلاحشده ادامه مییابد.
- آدرس را همانطور که در ابتدا وارد کردهاید انتخاب کنید و اصلاحیه از API اعتبارسنجی آدرس را نادیده بگیرید. فرآیند پرداخت میتواند به صورت عادی ادامه یابد و در صورت امکان، سفارش میتواند قبل از ارسال برای بررسیهای بعدی علامتگذاری شود.
- مشتری از این روش لغو یا انصراف میدهد و به مرحله ورود آدرس در فرآیند پرداخت برمیگردد، جایی که میتواند آدرس را از ابتدا وارد کند و فرآیند را از ابتدا شروع کند.
نمونهای از این مورد را میتوانید در اسکرینشات سمت راست مشاهده کنید.
پذیرفتن
این بخش نحوه پذیرش یک آدرس را نشان میدهد. برای اطلاعات بیشتر در مورد سیگنالهای خاصی که API اعتبارسنجی آدرس برای نشان دادن کیفیت خوب یک آدرس و پذیرش آن برمیگرداند، به بخش پذیرش آدرس در مستندات منطق اعتبارسنجی خود مراجعه کنید.
در این سناریو، فرآیند پرداخت باید به مرحله بعدی، احتمالاً ثبت پرداخت، منتقل شود و هیچ پیامی در مورد کیفیت آدرس به مشتری داده نشود. API تأیید کرده است که آدرس وارد شده توسط مشتری کیفیت خوبی دارد و قابل تحویل است.
توصیه میکنیم از دادههای آدرس برگشتی از API اعتبارسنجی آدرس برای سفارش استفاده کنید، زیرا این میتواند شامل اصلاحات و اضافات جزئی مانند موارد زیر باشد:
- حروف بزرگ
- اصلاحات قالببندی، برای مثال
- خیابان به خیابان
- ترتیب صحیح اجزای آدرس
- کد پستی +۴ در ایالات متحده آمریکا.
ملاحظات اجرایی
هنگام ساخت منطق پذیرش آدرس، مطمئن شوید که پیادهسازی شما مانع از خروج مشتریان به دلیل وارد کردن آدرس نامعتبر نمیشود. منطق را به گونهای بسازید که در صورت تکرار نشان دادن نامعتبر بودن ورودی توسط API، از ایجاد حلقه بینهایت جلوگیری کند.
گوگل توصیه میکند که به مشتریان حداکثر دو بار فرصت دهید تا آدرس خود را وارد کنند و در تلاش دوم، حتی اگر اعتبارسنجی نشود، ورود آنها را بپذیرید. در تلاش دوم، هدف این است که به آنها اجازه دهید صرف نظر از اعتبارسنجی، ادامه دهند.
دو روش پیشنهادی برای پذیرش تلاش دوم:
- ادامه اجباری: به مشتری یک پنجره توضیحی نشان دهید که توضیح میدهد آدرس در حال اعتبارسنجی نیست، اما به او اجازه دهید با آدرس تایپ شدهاش ادامه دهد.
- پذیرش بیصدا: بهطور خودکار تلاش دوم را بدون مرحله تأیید میپذیرد، حتی اگر آدرس بهطور کامل تأیید نشود.
در صورت امکان، سیستم خود را طوری طراحی کنید که آدرسهایی که اعتبارسنجی نمیشوند را علامتگذاری کند تا نماینده خدمات مشتری بتواند قبل از ارسال سفارش، آنها را بررسی کند. این اقدام اضافی تضمین میکند که هرگونه اشتباهی را متوجه خواهید شد.
ساخت و ساز ساختمان جدید، نمونه خوبی از این است که چرا این بررسی توصیه میشود. ممکن است بین زمان اتمام ساخت و ساز ساختمان جدید و زمانی که آدرس آن ساختمان در پایگاههای داده آدرس پستی ثبت میشود، فاصلهای وجود داشته باشد. مشتریان باید این گزینه را داشته باشند که با آدرس تایپ شده خود، حتی اگر اعتبارسنجی نشود، به اجبار از صفحه پرداخت عبور کنند.
پس از اتمام جلسه پرداخت، میتوانید به صورت اختیاری از متد provideValidationFeedback برای ارسال بازخورد به گوگل در مورد یک تلاش برای اعتبارسنجی آدرس خاص استفاده کنید.
نتیجهگیری
این سند، مروری کلی بر جریان پرداخت با پیادهسازی تکمیل خودکار، اعتبارسنجی آدرس و تأیید بصری روی نقشه گوگل ارائه داده است. از این سند به عنوان نقطه شروع برای طراحی پیادهسازی خود، با پیروی از جریانهای ورود آدرس توصیهشده، استفاده کنید.
مراحل بعدی
گزارش بهبود پرداخت، تحویل و عملیات با آدرسهای معتبر را دانلود کنید و وبینار بهبود پرداخت، تحویل و عملیات با اعتبارسنجی آدرس را مشاهده کنید.
مطالعه بیشتر پیشنهادی:

مشارکتکنندگان
هنریک والو | مهندس راهکارها
توماس انگلارت | مهندس راهکارها
سرتاک گنگولی | مهندس راه حل
دارنده مجوز غیر انحصاری خدمات پستی ایالات متحده. علامت تجاری(های) زیر متعلق به خدمات پستی ایالات متحده® هستند و با اجازه استفاده میشوند: CASS™، USPS®، DPV®. ↩

