راهنمای پیاده‌سازی «تراکنش‌های غنی‌شده»

نمای کلی

درک صورت‌حساب‌های تراکنش اغلب برای کاربران دشوار است، زیرا از کوته‌نوشت‌هایی مانند «ACMEHCORP» به‌جای نام فروشنده مانند «Acme Houseware» استفاده می‌شود که می‌تواند منجر به افزایش تماس‌های پشتیبانی مشتری و اختلافات پرهزینه شود. «تراکنش‌های غنی‌شده» این تراکنش‌ها را ساده می‌کند و با ارائه نام کامل و دسته کسب‌وکار فروشنده، عکس نمای فروشگاه، نشانی و مکان آن روی نقشه، اطلاعات تماس کامل، و غیره، آن‌ها را قابل‌فهم می‌کند. این کار به افزایش رضایت و شفافیت کاربر کمک می‌کند و همچنین می‌تواند تماس‌های پشتیبانی مشتری را کاهش دهد، NPS را افزایش دهد، و باعث شود زمان بیشتری در برنامه سپری شود.

«تراکنش‌های غنی‌شده»—راهنمای پیاده‌سازی و نکات سفارشی‌سازی که در این موضوع ارائه می‌دهیم—ترکیب بهینه‌ای از میاناهای برنامه‌سازی کاربردی Google Maps Platform است که برای ساختن تجربه‌های کاربری عالی از سابقه تراکنش توصیه می‌کنیم. این راهنمای پیاده‌سازی به شما نشان می‌دهد که چگونه مکانی را با فروشنده‌ای خاص مطابقت دهید و اطلاعات دقیق او را نشان دهید.

فعال کردن میاناهای برنامه‌سازی کاربردی

برای پیاده‌سازی «تراکنش‌های غنی‌شده»، باید APIهای زیر را در کنسول Google Cloud فعال کنید. اَبَرپیوندهای زیر شما را به کنسول Google Cloud می‌فرستد تا هر میانای برنامه‌سازی کاربردی را برای پروژه انتخابی‌تان فعال کنید:

• Places API.
• Geocoding API.
• Maps Static API، کیت توسعه نرم‌افزار Google Maps برای Android، یا کیت توسعه نرم‌افزار Google Maps برای iOS.

بخش‌های راهنمای پیاده‌سازی

پیاده‌سازی‌ها و سفارشی‌سازی‌های زیر در اینجا پوشش داده شده است:

• check_circle_filled نماد علامت تأیید نشان‌دهنده مرحله اصلی پیاده‌سازی است.
• stars نماد ستاره سفارشی‌سازی اختیاری اما توصیه‌شده‌ای است که راهکار را بهبود می‌بخشد.

نمودار زیر نشان می‌دهد که برنامه شما چگونه تراکنش‌های فروشنده را مطابقت می‌دهد تا بااستفاده از «جزئیات جا» از پایگاه داده موجود فروشندگان یا ازطریق درخواست «جستجوی جاها» نتیجه‌ای را برگرداند:

دریافت شناسه‌های مکان «پلاتفرم Google Maps»

ممکن است پایگاه داده‌ای از فروشندگان با اطلاعات پایه مانند نام کسب‌وکار و نشانی آن داشته باشید. برای دریافت اطلاعاتی که «پلاتفرم Google Maps» درباره آن مکان دارد، ازجمله اطلاعات تماس و اطلاعات همیاری‌شده توسط کاربر، به شناسه مکان «پلاتفرم Google Maps» نیاز دارید که با هریک از فروشندگان در پایگاه داده شما مطابقت دارد.

برای دریافت شناسه مکان برای کسب‌وکار، درخواستی به نقطه پایانی /findplacefromtext در Places API ارسال کنید و فقط فیلد place_id را درخواست کنید تا درخواست به‌عنوان تماس بدون هزینه یافتن مکان - فقط شناسه صورت‌حساب شود. اگر فروشنده چندین مکان دارد، از نام فروشنده همراه با نام شهر یا خیابان استفاده کنید. کیفیت داده‌های برگردانده‌شده توسط تماس متفاوت است، بنابراین باید بررسی کنید که آیا نتایج برگردانده‌شده واقعاً با فروشنده مطابقت دارد یا نه.

در اینجا نمونه‌ای از درخواست شناسه مکان برای دفتر Google در تایپه بااستفاده از نام فروشنده و شهر آورده شده است:

```html
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

حتماً پارامتر ورودی را در درخواست میانای برنامه‌سازی کاربردی کدگذاری نشانی وب کنید.

شناسه‌های مکان فروشگاه

برای ذخیره کردن اطلاعات مربوط به فروشنده از Google Maps Platform برای درخواست‌های آینده، می‌توانید این شناسه مکان را به‌طور نامحدود در پایگاه داده‌تان به‌عنوان مشخصه‌ای از سابقه فروشنده ذخیره کنید. باید فقط یک بار برای هر فروشنده درخواست «یافتن مکان» را انجام دهید. همچنین می‌توانید هر بار که کاربر جزئیات تراکنش را درخواست می‌کند، شناسه مکان را جستجو کنید.

برای اطمینان از اینکه همیشه دقیق‌ترین اطلاعات را دارید، شناسه‌های جا را هر ۱۲ ماه یک‌بار بااستفاده از درخواست جزئیات جا با پارامتر place_id بازآوری کنید.

درصورتی‌که «جزئیات جا» که نمایش می‌دهید با فروشنده‌ای که تراکنش در آن انجام شده است مطابقت نداشته باشد، توصیه می‌کنیم به کاربران اجازه دهید درباره کیفیت مطابقت فروشنده بازخورد ارائه دهند.

می‌توانید «جزئیات مکان» را که کاربران باید پس‌از بازدید از یکی از مکان‌هایتان بدانند هم‌رسانی کنید. با «جزئیات جا» غنی مانند اطلاعات تماس، ساعات کاری، رده‌بندی‌های کاربر، و عکس‌های کاربر، برنامه‌تان می‌تواند تراکنش تکمیل‌شده کاربران را به آن‌ها یادآوری کند. پس‌از برقراری تماس با Places API برای دریافت «جزئیات جا»، می‌توانید پاسخ را در پنجره اطلاعات، نوار کناری وب، یا به هر روشی که می‌خواهید در چارچوب «شرایط خدمات» ما فیلتر و ارائه کنید.

برای درخواست «جزئیات جا»، به شناسه جای هریک از مکان‌هایتان نیاز دارید. برای بازیابی شناسه مکان خود، دریافت شناسه مکان را ببینید.

درخواست «جزئیات جا» زیر نشانی، مختصات، وب‌سایت، شماره تلفن، رده‌بندی، و ساعات کاری را در خروجی json برای شناسه جای Google Taipei 101 برمی‌گرداند:

```html
https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

مکان فروشنده را تعیین کنید

‫Maps Static API نشانی یا مختصات را برای قرار دادن نشانگر می‌پذیرد. اگر سابقه فروشنده شما ازقبل نشانی دارد، می‌توانید از این بخش رد شوید و به بخش بعدی بروید، اما توصیه می‌کنیم برای دقت نقشه، از مختصات به‌جای نشانی استفاده کنید.

اگر پایگاه داده فروشنده شما نشانی خیابان دارد اما مختصات جغرافیایی ندارد و شما قبلاً جزئیات جا را درخواست نکرده‌اید، می‌توانید از Geocoding API برای تبدیل نشانی خیابان به مختصات طول/عرض جغرافیایی در سمت سرور استفاده کنید، مختصات را در پایگاه داده خود ذخیره کنید، و مختصات را حداقل هر ۳۰ روز یک‌بار بازآوری کنید.

در اینجا نمونه‌ای از استفاده از Geocoding API برای دریافت طول و عرض جغرافیایی شناسه مکان دفتر Google در تایپه آورده شده است:

```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

افزودن نشانگر برای مکان فروشنده به نقشه

ازآنجایی‌که کاربران شما نقشه را برای تأیید تراکنش‌ها می‌بینند و نه برای مرور یا پیمایش، می‌خواهید نقشه‌ای ایجاد کنید که تعامل‌پذیری محدودی داشته باشد.

برای وب تلفن همراه و رایانه، نشانی وب Maps Static API با یک نشانگر در طول/عرض جغرافیایی یا نشانی فروشنده ایجاد کنید. می‌توانید از Maps Static API بااستفاده از فراخوانی سرویس وب استفاده کنید که نسخه تصویری نقشه را براساس پارامترهایی که مشخص می‌کنید ایجاد می‌کند. برای تلفن همراه، به بخش بعدی افزودن نقشه در برنامه تلفن همراه بروید.

فراخوانی زیر نقشه راهی را با اندازه ۶۴۰×۴۸۰ پیکسل نشان می‌دهد که در سطح بزرگ‌نمایی پیش‌فرض روی نشانگری در دفتر Google در تایپه متمرکز شده است. همچنین یک نشانگر قرمز مکان تحویل و یک سبک نقشه مبتنی بر Cloud را مشخص می‌کند:

```html
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

این تماس به بخش‌های زیر تقسیم می‌شود:

این نتیجه به تصویری تبدیل می‌شود که در زیر نشان داده شده است:

همچنین می‌توانید از نشانی به‌عنوان مکان نشانگر استفاده کنید:

```html
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
```

برای گزینه‌های پارامتر بیشتر، اسناد Maps Static API را ببینید.

افزودن نقشه به برنامه تلفن همراه

اگر از «کیت توسعه نرم‌افزار Google Maps برای Android» یا «کیت توسعه نرم‌افزار Google Maps برای iOS» استفاده می‌کنید، می‌توانید بااستفاده از مختصات موجود در اطلاعات جزئیات جا، نشانگر قرار دهید.

ازآنجایی‌که کاربران شما نقشه را برای تأیید تراکنش‌ها می‌بینند نه برای مرور یا پیمایش، نقشه‌ای با تعامل محدود انتخاب کنید:

• برای برنامه‌های Android، آموزش افزودن نقشه با نشانگر را ببینید، و حالت ساده را فعال کنید تا تعامل محدودی ارائه دهید.
• برای برنامه‌های iOS، آموزش افزودن نقشه با نشانگر را ببینید، و کنترل‌ها و اشاره‌ها را با پرچم GMSUiSettings غیرفعال کنید.