Enriched Transactions প্রয়োগ করার নির্দেশিকা

এক নজরে

ওয়েব iOS API

Google Maps Platform ওয়েব (JS, TS), Android ও iOS-এর জন্য উপলভ্য, এছাড়াও, জায়গা, দিকনির্দেশ ও দূরত্বের ব্যাপারে তথ্য পাওয়ার জন্য ওয়েব পরিষেবা API অফার করে। এই গাইডের স্যাম্পেলগুলি একটি প্ল্যাটফর্মের জন্য লেখা হয়েছে, তবে অন্যান্য প্ল্যাটফর্মে প্রয়োগের জন্য ডকুমেন্টেশন লিঙ্ক প্রদান করা হয়েছে।

ট্রানজ্যাকশন স্টেটমেন্ট প্রায়ই ব্যবহারকারীদের পক্ষে বোঝা কঠিন হয়, কারণ "Acme Houseware"-এর মতো মার্চেন্টের নামের পরিবর্তে "ACMEHCORP"-এর মতো সংক্ষিপ্ত নাম ব্যবহার করা হয়, যার ফলে গ্রাহক সহায়তা টিমের কাছে কল এবং ব্যয়বহুল বিরোধের সংখ্যা বৃদ্ধি পেতে পারে। Enriched Transactions এইসব ট্রানজ্যাকশনকে সহজ করে তোলে এবং মার্চেন্টের পুরো নাম ও ব্যবসার বিভাগ, স্টোরফ্রন্টের ফটো, ঠিকানা ও ম্যাপে লোকেশন, সম্পূর্ণ যোগাযোগের তথ্য এবং আরও অনেক কিছু প্রদান করে সেগুলিকে সহজবোধ্য করে তোলে। এটি ব্যবহারকারীর সন্তুষ্টি ও স্বচ্ছতা বাড়াতে সাহায্য করে এবং গ্রাহক সহায়তা কলের সংখ্যা কমাতে, NPS বাড়াতে ও অ্যাপে আরও বেশি সময় কাটাতে সাহায্য করে।

Enriched Transactions—এই বিষয়ে আমরা যে প্রয়োগ করার নির্দেশিকা এবং কাস্টমাইজেশন সংক্রান্ত পরামর্শ প্রদান করি— সেটিই আমরা Google Maps Platform API-এর সর্বোত্তম কম্বিনেশন হিসেবে সাজেস্ট করি যাতে ট্রানজ্যাকশনের ইতিহাস সংক্রান্ত দুর্দান্ত ব্যবহারকারীর অভিজ্ঞতা তৈরি করা যায়। এই প্রয়োগ করার নির্দেশিকা আপনাকে দেখাবে কীভাবে কোনও লোকেশনকে নির্দিষ্ট মার্চেন্টের সাথে ম্যাচ করতে হয় এবং তাদের বিস্তারিত তথ্য দেখাতে হয়।

সমৃদ্ধ ট্রানজ্যাকশন স্যাম্পেল স্ক্রিন
এনরিচড ট্রানজ্যাকশন স্যাম্পেল স্ক্রিন (বড় করতে ক্লিক করুন)

API চালু করুন

Enriched Transactions প্রয়োগ করতে, আপনাকে Google Cloud কনসোলে নিম্নলিখিত API চালু করতে হবে। নিম্নলিখিত হাইপারলিঙ্ক আপনাকে Google Cloud কনসোলে পাঠায় যাতে আপনার বেছে নেওয়া প্রোজেক্টের জন্য প্রতিটি API চালু করতে পারেন:

সেট-আপ সম্পর্কে আরও তথ্যের জন্য, Google Maps Platform-এর ব্যবহার শুরু করা দেখুন।

প্রয়োগ করার নির্দেশিকা সংক্রান্ত বিভাগ

এখানে নিম্নলিখিত প্রয়োগ ও কাস্টমাইজেশন সম্পর্কে আলোচনা করা হয়েছে:

  • টিক চিহ্ন আইকন হল একটি মূল প্রয়োগের ধাপ।
  • স্টার আইকনটি ঐচ্ছিক হলেও সমাধান উন্নত করার জন্য এটি কাস্টমাইজ করার সাজেশন দেওয়া হয়।
Google Maps Platform-এর সাথে মার্চেন্ট ম্যাচ করা Google Maps Platform-এ কোনও জায়গার সাথে ট্রানজ্যাকশন ইতিহাসে কোনও মার্চেন্টকে অ্যাসোসিয়েট করা।
মার্চেন্টের বিবরণ দেখানো ডেটা-সমৃদ্ধ ট্রানজ্যাকশন দেখান যা মার্চেন্ট সম্পর্কে সহায়ক তথ্য দেখায়, যাতে ব্যবহারকারীরা দ্রুত ট্রানজ্যাকশন শনাক্ত করতে পারেন।
মার্চেন্টের লোকেশনের ম্যাপ যোগ করুন মার্চেন্টের লোকেশনের ম্যাপ যোগ করুন।

Google Maps Platform-এর সাথে মার্চেন্ট ম্যাচ করুন

এই উদাহরণে ব্যবহার করা হয়েছে: Places API

নিচের ডায়াগ্রাম থেকে বোঝা যায় যে মার্চেন্টের বিদ্যমান ডেটাবেস থেকে জায়গার বিবরণ ব্যবহার করে অথবা জায়গা সার্চ করার অনুরোধের মাধ্যমে ফলাফল দেখানোর জন্য আপনার অ্যাপ্লিকেশন কীভাবে মার্চেন্টের ট্রানজ্যাকশন ম্যাচ করে:

মার্চেন্ট ম্যাচিং ফ্লো ম্যাট্রিক্স
মার্চেন্ট ম্যাচিং ফ্লো ম্যাট্রিক্স (বড় করে দেখতে ক্লিক করুন)

Google Maps Platform-এর জায়গা সংক্রান্ত আইডি পান

আপনার কাছে ব্যবসার নাম ও ঠিকানার মতো প্রাথমিক তথ্য সহ মার্চেন্টদের একটি ডেটাবেস থাকতে পারে। Google Maps Platform-এর কাছে সেই জায়গা সম্পর্কে থাকা তথ্য পেতে, যার মধ্যে যোগাযোগের তথ্য এবং ব্যবহারকারীর অবদান রাখা তথ্য অন্তর্ভুক্ত, আপনার ডেটাবেসে প্রতিটি মার্চেন্টের সাথে সম্পর্কিত Google Maps Platform-এর প্লেস আইডি প্রয়োজন।

কোনও ব্যবসার জন্য জায়গার আইডি পেতে, Places API-তে /findplacefromtext এন্ডপয়েন্টে অনুরোধ করুন এবং অনুরোধের জন্য কোনও চার্জ না দিয়ে জায়গা খুঁজুন - শুধু আইডি কল হিসেবে বিল করতে শুধু 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
```

API অনুরোধে ইনপুট প্যারামিটার URL এনকোড করতে ভুলবেন না।

স্টোরের প্লেস আইডি

ভবিষ্যতের অনুরোধের জন্য মার্চেন্ট সম্পর্কে Google Maps Platform থেকে তথ্য স্টোর করতে, আপনি মার্চেন্টের রেকর্ডের অ্যাট্রিবিউট হিসেবে আপনার ডেটাবেসে অনির্দিষ্টকালের জন্য এই প্লেস আইডি স্টোর করতে পারবেন। আপনাকে প্রতি মার্চেন্টের জন্য একবারই Find Place অনুরোধ করতে হবে। এছাড়াও, ব্যবহারকারী যখনই ট্রানজ্যাকশনের বিবরণ জানতে চাইবেন, আপনি প্লেস আইডি সার্চ করতে পারবেন।

আপনার কাছে যাতে সবসময় সবচেয়ে সঠিক তথ্য থাকে তা নিশ্চিত করতে, place_id প্যারামিটার সহ জায়গার বিবরণ অনুরোধ ব্যবহার করে প্রতি ১২ মাস অন্তর জায়গার আইডি রিফ্রেশ করুন।

আপনার দেখানো জায়গার বিবরণ যদি সেই মার্চেন্টের সাথে না মেলে যেখানে তারা ট্রানজ্যাকশন করেছেন, তাহলে আমরা সাজেস্ট করি যে আপনি ব্যবহারকারীদের মার্চেন্ট ম্যাচ করার কোয়ালিটি সম্পর্কে মতামত দেওয়ার অনুমতি দিন।

মার্চেন্টের বিবরণ দেখুন

এই উদাহরণে ব্যবহার করা হয়েছে: Places API এছাড়াও উপলভ্য: Android-এর জন্য Places SDK | iOS-এর জন্য Places SDK | Places Library, Maps JavaScript API

ব্যবহারকারীরা আপনার কোনও লোকেশন ভিজিট করার পরে তাদের যে জায়গার বিবরণ জানা প্রয়োজন, আপনি তা শেয়ার করতে পারবেন। যোগাযোগের তথ্য, কাজের সময়, ব্যবহারকারীর রেটিং ও ব্যবহারকারীর ফটোর মতো জায়গার বিবরণ সহ আপনার অ্যাপ ব্যবহারকারীদের তাদের সম্পূর্ণ করা ট্রানজ্যাকশনের কথা মনে করিয়ে দিতে পারে। জায়গার বিবরণ পেতে Places API-তে কল করার পরে, আপনি তথ্য উইন্ডো, ওয়েব সাইডবার বা আমাদের পরিষেবার শর্তাবলীর সীমার মধ্যে আপনার পছন্দমতো যেকোনও উপায়ে উত্তর ফিল্টার ও রেন্ডার করতে পারবেন।

মার্চেন্টের বিবরণ সংক্রান্ত স্ক্রিনের নমুনা
নমুনা মার্চেন্ট বিবরণ স্ক্রিন (বড় করতে ক্লিক করুন)

জায়গার বিবরণ সংক্রান্ত অনুরোধ করতে, আপনার প্রতিটি লোকেশনের জন্য জায়গার আইডি প্রয়োজন হবে। আপনার লোকেশনের প্লেস আইডি পেতে প্লেস আইডি পাওয়া দেখুন।

নিম্নলিখিত জায়গার বিবরণ সংক্রান্ত অনুরোধ, Google Taipei 101-এর জায়গা আইডির জন্য json আউটপুটে ঠিকানা, কোঅর্ডিনেট, ওয়েবসাইট, ফোন নম্বর, রেটিং ও সময় ফেরত পাঠায়:

```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
```

মার্চেন্টের লোকেশনের ম্যাপ যোগ করুন

এই উদাহরণে এগুলি ব্যবহার করা হয়েছে: Geocoding API | Maps Static API এছাড়াও উপলভ্য: Android | iOS

মার্চেন্টের লোকেশন নির্ধারণ করা

Maps Static API কোনও মার্কার প্লেস করার জন্য ঠিকানা বা কোঅর্ডিনেট গ্রহণ করে। আপনার মার্চেন্ট রেকর্ডে আগে থেকেই কোনও ঠিকানা থাকলে, আপনি পরবর্তী বিভাগে এগিয়ে যেতে পারেন, তবে ম্যাপে সঠিক লোকেশন দেখানোর জন্য আমরা ঠিকানার পরিবর্তে কোঅর্ডিনেট ব্যবহার করার সাজেশন দিই।

আপনার মার্চেন্ট ডেটাবেসে রাস্তার ঠিকানা থাকলেও ভৌগোলিক স্থানাঙ্ক না থাকলে এবং আপনি আগে থেকে জায়গার বিবরণ সংক্রান্ত অনুরোধ না করে থাকলে, আপনি Geocoding API ব্যবহার করে সার্ভার সাইডে রাস্তার ঠিকানাকে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে কনভার্ট করতে, আপনার ডেটাবেসে স্থানাঙ্ক স্টোর করতে এবং কমপক্ষে প্রতি ৩০ দিনে একবার স্থানাঙ্ক রিফ্রেশ করতে পারবেন।

Google তাইপেই অফিসের প্লেস আইডির অক্ষাংশ ও দ্রাঘিমাংশ পেতে Geocoding API ব্যবহার করার একটি উদাহরণ এখানে দেওয়া হল:

```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 URL তৈরি করুন। আপনি ওয়েব সার্ভিস কলের মাধ্যমে Maps Static API ব্যবহার করতে পারেন, যা আপনার উল্লেখ করা প্যারামিটার অনুযায়ী ম্যাপের একটি ছবি ভার্সন তৈরি করবে। মোবাইলের জন্য, পরবর্তী আপনার মোবাইল অ্যাপ্লিকেশন বিভাগে ম্যাপ যোগ করুন বিকল্পে যান।

নিম্নলিখিত কলটি ডিফল্ট জুম লেভেলে Google তাইপেই অফিসের মার্কারের কেন্দ্রে ৬৪০x৪৮০ পিক্সেল সাইজের একটি রোডম্যাপ দেখায়। এছাড়াও, এটি একটি লাল রঙের ডেলিভারি লোকেশন মার্কার এবং ক্লাউড-ভিত্তিক ম্যাপ স্টাইল নির্দিষ্ট করে:

```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
```

এই কলটি নিম্নলিখিত বিভাগে বিভক্ত:

API URL https://maps.googleapis.com/maps/api/staticmap?
ছবির সাইজ size=640x480
মার্চেন্ট লোকেশন মার্কার (URL এনকোডিং ব্যবহার করে) markers=color:red%7C25.033976%2C121.5645389
ক্লাউড-ভিত্তিক ম্যাপ স্টাইল map_id=b224095f76859890
API Key key=YOUR_API_KEY
ডিজিটাল স্বাক্ষর (কীভাবে আপনার অনুরোধে ডিজিটাল স্বাক্ষর করবেন তা জানুন) signature=BASE64_SIGNATURE
সলিউশন চ্যানেল প্যারামিটার (প্যারামিটার ডকুমেন্টেশন দেখুন) solution_channel=GMP_guides_enrichedtransactions_v1_a

এই ফলাফলটি নিচে দেখানো ছবির মতো হয়ে যায়:

Google তাইপেই অফিসের স্ট্যাটিক ম্যাপের ছবি

এছাড়াও, আপনি মার্কার লোকেশন হিসেবে কোনও ঠিকানা ব্যবহার করতে পারবেন:

```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 ডকুমেন্টেশন দেখুন।

আপনার মোবাইল অ্যাপ্লিকেশনে ম্যাপ যোগ করুন

আপনি Android-এর জন্য Maps SDK বা iOS-এর জন্য Maps SDK ব্যবহার করলে, জায়গার বিবরণ থেকে পাওয়া স্থানাঙ্ক ব্যবহার করে মার্কার যোগ করতে পারবেন।

যেহেতু আপনার ব্যবহারকারীরা ট্রানজ্যাকশন কনফার্ম করার জন্য ম্যাপ দেখবেন, ব্রাউজ বা নেভিগেট করার জন্য নয়, তাই সীমিত ইন্টার‍্যাক্টিভিটি সহ ম্যাপ বেছে নিন: