গুগলের এআই সারফেসগুলো ব্যবসায়ীদের প্রাসঙ্গিক ডেটা সরবরাহ করে, যা তাদের লেনদেনের ঝুঁকি মূল্যায়ন করতে এবং লেনদেনটি নিয়ে এগিয়ে যাবেন কি না, সে বিষয়ে সিদ্ধান্ত নিতে সাহায্য করে। এর ফলে ব্যবসায়ীরা তাদের প্ল্যাটফর্মে সংঘটিত কেনাকাটার ওপর সম্পূর্ণ নিয়ন্ত্রণ রাখতে পারেন।
এই ডেটা প্রধানত কমপ্লিট চেকআউট এপিআই কল চলাকালীন শেয়ার করা হয়।
২০২৬-০৪-০৮ স্পেসিফিকেশনে, এই সিগন্যালগুলো signals অবজেক্টের মধ্যে পাওয়া যায় এবং সিগন্যালের নাম হিসেবে com.google. ও dev.ucp. প্রিফিক্স ব্যবহার করা হয়।
গুগল ব্যবসায়ীদের সাথে নিম্নলিখিত ডেটা প্রকারগুলি শেয়ার করে:
সেশন ডেটা
| সংকেতের নাম | বর্ণনা | এপিআই পাথ |
|---|---|---|
| আইপি ঠিকানা | সেশনে থাকা ব্যবহারকারীর আইপি ঠিকানা। | com.google.ip_addressdev.ucp.buyer_ip |
| সেশন শুরুর সময় | ক্রয় শুরু করার সময় (ইউনিক্স ইপক টাইমস্ট্যাম্প)। | com.google.session_start_time |
ডিভাইসের ডেটা
| সংকেতের নাম | বর্ণনা | এপিআই পাথ |
|---|---|---|
| ডিভাইসের ধরন | ব্যবহৃত ডিভাইসের ধরণ (যেমন, MOBILE , DESKTOP , TABLET , বা UNKNOWN )। ইউজার এজেন্ট থেকে প্রাপ্ত। | com.google.device_type |
| ডিভাইসের সময় অঞ্চল | সেশনে ব্যবহৃত ডিভাইসটির বর্তমান টাইমজোন। | com.google.device_timezone |
অবস্থান ডেটা
জালিয়াতি প্রতিরোধ এবং অ্যাকাউন্ট দখলের ঘটনা শনাক্তকরণে সহায়তা করার জন্য নিম্নলিখিত স্থূল ভৌগোলিক অবস্থান সংকেতগুলো তৈরি করা হয়েছে।
| সংকেতের নাম | বর্ণনা | এপিআই পাথ |
|---|---|---|
| ব্যবহারকারীর দেশ | ক্রেতার মোটামুটি দেশের অবস্থান (যেমন, United States )। | com.google.user_country |
| ব্যবহারকারীর অবস্থা | ক্রেতার মোটামুটি রাজ্য বা প্রদেশের অবস্থান (যেমন, California )। | com.google.user_state |
ব্রাউজার ডেটা
| সংকেতের নাম | বর্ণনা | এপিআই পাথ |
|---|---|---|
| ব্যবহারকারী এজেন্ট | ব্রাউজার ক্লায়েন্টের তথ্য স্ট্রিং। | dev.ucp.user_agent |
| ব্রাউজার ভাষা | ডিভাইসের ব্রাউজারে ব্যবহৃত ভাষা (যেমন, "en")। | com.google.locale |
| ভিউপোর্ট উচ্চতা | ব্রাউজার ভিউপোর্টের উচ্চতা (পিক্সেল এককে)। | com.google.viewport_height_px |
| ভিউপোর্ট প্রস্থ | ব্রাউজার ভিউপোর্টের প্রস্থ (পিক্সেল এককে)। | com.google.viewport_width_px |
অর্ডার ডেটা
Create/Update Checkout API কলগুলোর মধ্যে নিম্নলিখিত ডেটা পয়েন্টগুলো পাওয়া যায় এবং এগুলো অর্ডারটির প্রেক্ষাপট প্রদান করে:
| সংকেতের নাম | বর্ণনা | এপিআই পাথ ( Create/Update Checkout ) |
|---|---|---|
| পণ্যের আইডি | বিক্রেতাকে পণ্যটি শনাক্ত করতে সাহায্য করে। | line_items[x].item.id |
| পরিপূর্ণতা আইডি | ডেলিভারির ধরণ ও পদ্ধতি নির্ধারণে সাহায্য করে। | পূরণের সেটআপের উপর ভিত্তি করে পরিবর্তিত হয় |
শিপিং এবং বিলিং ডেটা
ঠিকানা এবং ক্রেতার তথ্য প্রাথমিকভাবে Create/Update Checkout API কল চলাকালীন প্রদান করা হয়।
- ক্রেতার তথ্য:
| সংকেতের নাম | বর্ণনা | এপিআই পাথ ( Create/Update Checkout ) |
|---|---|---|
| ব্যবহারকারীর ইমেল আইডি | সাইন-ইন করা ব্যবহারকারীর গুগল ইমেল আইডি। | buyer.email |
- শিপিং ঠিকানা:
Create/Update Checkoutfulfillment.methods.destinations[x]এর অধীনে উপলব্ধ (যেখানেtypeহল "shipping" এবংxহলselected_destination_id)।
| সংকেতের নাম | বর্ণনা | এপিআই পাথ | ঐচ্ছিক |
|---|---|---|---|
| প্রথম নাম | প্রাপকের প্রথম নাম | first_name | না |
| শেষ নাম | প্রাপকের শেষ নাম | last_name | না |
| পুরো নাম | প্রাপকের পুরো নাম | full_name | হ্যাঁ |
| ফোন নম্বর | প্রাপকের ফোন নম্বর | phone_number | হ্যাঁ |
| রাস্তার ঠিকানা | প্রধান রাস্তার ঠিকানা লাইন | street_address | না |
| বর্ধিত ঠিকানা | অ্যাপার্টমেন্ট, স্যুইট, ইত্যাদি। | extended_address | হ্যাঁ |
| শহর | শহর বা এলাকা | address_locality | না |
| অঞ্চল | রাজ্য বা অঞ্চল | address_region | না |
| পোস্টাল কোড | জিপ বা পোস্টাল কোড | postal_code | না |
| দেশ | দেশের কোড | address_country | না |
- বিলিং ঠিকানা:
Complete Checkoutউপলব্ধ। ফিল্ডগুলি শিপিং ঠিকানা টেবিলে তালিকাভুক্ত ফিল্ডগুলির মতোই এবংpayment.instruments[x].billing_addressঅবজেক্টের মধ্যে পাওয়া যায় (যেখানেxহলselected_instrument_id)।
পেমেন্ট যাচাইকরণ ডেটা
'Complete Checkout' রেসপন্সের signals ' অবজেক্টের মধ্যে নিম্নলিখিত ফিল্ডগুলো পাওয়া যায়।
| সংকেতের নাম | বর্ণনা | এপিআই পাথ |
|---|---|---|
| এভিএস সম্পূর্ণ ফলাফল | ঠিকানা যাচাইকরণ সিস্টেম (AVS) যাচাইয়ের ফলাফল। | com.google.avs_full_result |
| CVV ফলাফল | কার্ড ভেরিফিকেশন ভ্যালু (CVV) যাচাইয়ের ফলাফল। | com.google.cvv_result |
| প্রমাণীকরণ সক্রিয় হয়েছে | অতিরিক্ত ব্যবহারকারী প্রমাণীকরণ করা হয়েছে কিনা তা নির্দেশ করে। | com.google.authentication_triggered |
| 3DS দ্বারা অনুমোদন প্রক্রিয়া সম্পন্ন হয়েছে | 3D Secure যাচাইকরণ করা হয়েছে কিনা তা নির্দেশ করে। | com.google.authorization_processed_with_3ds |
উদাহরণ
নিম্নলিখিত উদাহরণটি 2026-04-08 সংস্করণের জন্য ঝুঁকি সংকেত অবজেক্টের কাঠামো দেখায়।
{
"signals": {
"com.google.authentication_triggered": "",
"com.google.authorization_processed_with_3ds": "",
"com.google.avs_full_result": "",
"com.google.cvv_result": "",
"com.google.device_timezone": "America/Los_Angeles",
"com.google.device_type": "DESKTOP",
"com.google.ip_address": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
"com.google.locale": "en",
"com.google.session_start_time": "1781883906339",
"com.google.viewport_height_px": "1991",
"com.google.viewport_width_px": "2036",
"dev.ucp.buyer_ip": "2601:646:8600:3360:cce8:3033:4e1f:f6a8",
"dev.ucp.user_agent": "Mozilla/5.0 (X11; CrOS x86_64 14541.0.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"
}
}