هوش مصنوعی گوگل، دادههای زمینهای را در اختیار بازرگانان قرار میدهد تا به آنها در ارزیابی ریسک تراکنشها و تصمیمگیری در مورد ادامه یا عدم ادامه تراکنشها کمک کند. این امر به بازرگانان اجازه میدهد تا کنترل کامل خریدهایی را که در پلتفرمهایشان اتفاق میافتد، در دست داشته باشند.
این دادهها عمدتاً در طول فراخوانی رابط برنامهنویسی کاربردی (API) پرداخت کامل (Complete Checkout) به اشتراک گذاشته میشوند.
در مشخصات 2026-01-23 ، این سیگنالها درون شیء risk_signals یافت میشوند.
گوگل انواع دادههای زیر را با فروشندگان به اشتراک میگذارد:
دادههای جلسه
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| آدرس آیپی | آدرس IP کاربر در جلسه. | ip_address |
| زمان شروع جلسه | زمان شروع خرید (برچسب زمانی Unix epoch). | session_start_time |
دادههای دستگاه
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| نوع دستگاه | نوع دستگاه مورد استفاده (مثلاً MOBILE ، DESKTOP ، TABLET یا UNKNOWN ). برگرفته از User Agent. | device_type |
| منطقه زمانی دستگاه | منطقه زمانی فعلی دستگاهی که در جلسه استفاده میشود. | device_timezone |
دادههای مکانی
سیگنالهای تقریبی موقعیت جغرافیایی زیر برای کمک به پیشگیری از کلاهبرداری و تشخیص تصاحب حساب استخراج شدهاند.
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| کشور کاربر | موقعیت تقریبی کشور خریدار (مثلاً United States ). | user_country |
| وضعیت کاربر | ایالت یا استان محل سکونت تقریبی خریدار (مثلاً California ). | user_state |
دادههای مرورگر
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| عامل کاربر | رشته اطلاعات کلاینت مرورگر. | user_agent |
| زبان مرورگر | زبانی که در مرورگر دستگاه استفاده میشود (مثلاً "en"). | locale |
| ارتفاع ویوپورت | ارتفاع نمای مرورگر بر حسب پیکسل. | viewport_height_px |
| عرض دریچه دید | عرض نمای مرورگر بر حسب پیکسل. | viewport_width_px |
دادههای سفارش
نقاط داده زیر در فراخوانیهای API Create/Update Checkout موجود هستند و زمینه سفارش را فراهم میکنند:
| نام سیگنال | توضیحات | مسیر API ( Create/Update Checkout ) |
|---|---|---|
| شناسه محصول | به فروشنده کمک میکند تا کالا را شناسایی کند. | line_items[x].item.id |
| شناسه تکمیل سفارش | به تعیین نوع و روش تحویل کمک میکند. | بسته به تنظیمات انجام سفارش متفاوت است |
دادههای حمل و نقل و صورتحساب
اطلاعات آدرس و خریدار عمدتاً در طول فراخوانیهای API Create/Update Checkout ارائه میشود.
- اطلاعات خریدار:
| نام سیگنال | توضیحات | مسیر API ( Create/Update Checkout ) |
|---|---|---|
| شناسه ایمیل کاربر | شناسه ایمیل گوگل کاربر وارد شده. | buyer.email |
- آدرس ارسال: در
Create/Update Checkoutو در بخشfulfillment.methods.destinations[x]موجود است (که در آنtypeبرابر با "shipping" وxبرابر باselected_destination_idاست).
| نام سیگنال | توضیحات | مسیر API | اختیاری |
|---|---|---|---|
| نام | نام کوچک گیرنده | 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است).
دادههای تأیید پرداخت
فیلدهای زیر در شیء risk_signals در پاسخ تکمیل پرداخت موجود است.
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| نتیجه کامل AVS | نتیجه بررسی سیستم تأیید آدرس (AVS). | avs_full_result |
| نتیجه CVV | نتیجه بررسی مقدار تأیید کارت (CVV). | cvv_result |
| احراز هویت آغاز شد | نشان میدهد که آیا احراز هویت کاربر اضافی انجام شده است یا خیر. | authentication_triggered |
| مجوز با 3DS پردازش شد | نشان میدهد که آیا تأیید هویت سه بعدی امن (3D Secure) انجام شده است یا خیر. | authorization_processed_with_3ds |
مثال
مثال زیر ساختار شیء سیگنالهای ریسک را برای نسخه 2026-01-23 نشان میدهد.
{
"risk_signals": {
"ip_address": "123.456.7.890",
"session_start_time": "1778090291092",
"device_type": "DESKTOP",
"device_timezone": "America/Los_Angeles",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
"locale": "en",
"viewport_height_px": 893,
"viewport_width_px": 1515,
"avs_full_result": "Y",
"cvv_result": "M",
"authentication_triggered": true,
"authorization_processed_with_3ds": true
}
}
هوش مصنوعی گوگل، دادههای زمینهای را در اختیار بازرگانان قرار میدهد تا به آنها در ارزیابی ریسک تراکنشها و تصمیمگیری در مورد ادامه یا عدم ادامه تراکنشها کمک کند. این امر به بازرگانان اجازه میدهد تا کنترل کامل خریدهایی را که در پلتفرمهایشان اتفاق میافتد، در دست داشته باشند.
این دادهها عمدتاً در طول فراخوانی رابط برنامهنویسی کاربردی (API) پرداخت کامل (Complete Checkout) به اشتراک گذاشته میشوند.
در مشخصات 2026-01-23 ، این سیگنالها درون شیء risk_signals یافت میشوند.
گوگل انواع دادههای زیر را با فروشندگان به اشتراک میگذارد:
دادههای جلسه
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| آدرس آیپی | آدرس IP کاربر در جلسه. | ip_address |
| زمان شروع جلسه | زمان شروع خرید (برچسب زمانی Unix epoch). | session_start_time |
دادههای دستگاه
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| نوع دستگاه | نوع دستگاه مورد استفاده (مثلاً MOBILE ، DESKTOP ، TABLET یا UNKNOWN ). برگرفته از User Agent. | device_type |
| منطقه زمانی دستگاه | منطقه زمانی فعلی دستگاهی که در جلسه استفاده میشود. | device_timezone |
دادههای مکانی
سیگنالهای تقریبی موقعیت جغرافیایی زیر برای کمک به پیشگیری از کلاهبرداری و تشخیص تصاحب حساب استخراج شدهاند.
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| کشور کاربر | موقعیت تقریبی کشور خریدار (مثلاً United States ). | user_country |
| وضعیت کاربر | ایالت یا استان محل سکونت تقریبی خریدار (مثلاً California ). | user_state |
دادههای مرورگر
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| عامل کاربر | رشته اطلاعات کلاینت مرورگر. | user_agent |
| زبان مرورگر | زبانی که در مرورگر دستگاه استفاده میشود (مثلاً "en"). | locale |
| ارتفاع ویوپورت | ارتفاع نمای مرورگر بر حسب پیکسل. | viewport_height_px |
| عرض دریچه دید | عرض نمای مرورگر بر حسب پیکسل. | viewport_width_px |
دادههای سفارش
نقاط داده زیر در فراخوانیهای API Create/Update Checkout موجود هستند و زمینه سفارش را فراهم میکنند:
| نام سیگنال | توضیحات | مسیر API ( Create/Update Checkout ) |
|---|---|---|
| شناسه محصول | به فروشنده کمک میکند تا کالا را شناسایی کند. | line_items[x].item.id |
| شناسه تکمیل سفارش | به تعیین نوع و روش تحویل کمک میکند. | بسته به تنظیمات انجام سفارش متفاوت است |
دادههای حمل و نقل و صورتحساب
اطلاعات آدرس و خریدار عمدتاً در طول فراخوانیهای API Create/Update Checkout ارائه میشود.
- اطلاعات خریدار:
| نام سیگنال | توضیحات | مسیر API ( Create/Update Checkout ) |
|---|---|---|
| شناسه ایمیل کاربر | شناسه ایمیل گوگل کاربر وارد شده. | buyer.email |
- آدرس ارسال: در
Create/Update Checkoutو در بخشfulfillment.methods.destinations[x]موجود است (که در آنtypeبرابر با "shipping" وxبرابر باselected_destination_idاست).
| نام سیگنال | توضیحات | مسیر API | اختیاری |
|---|---|---|---|
| نام | نام کوچک گیرنده | 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است).
دادههای تأیید پرداخت
فیلدهای زیر در شیء risk_signals در پاسخ تکمیل پرداخت موجود است.
| نام سیگنال | توضیحات | مسیر API |
|---|---|---|
| نتیجه کامل AVS | نتیجه بررسی سیستم تأیید آدرس (AVS). | avs_full_result |
| نتیجه CVV | نتیجه بررسی مقدار تأیید کارت (CVV). | cvv_result |
| احراز هویت آغاز شد | نشان میدهد که آیا احراز هویت کاربر اضافی انجام شده است یا خیر. | authentication_triggered |
| مجوز با 3DS پردازش شد | نشان میدهد که آیا تأیید هویت سه بعدی امن (3D Secure) انجام شده است یا خیر. | authorization_processed_with_3ds |
مثال
مثال زیر ساختار شیء سیگنالهای ریسک را برای نسخه 2026-01-23 نشان میدهد.
{
"risk_signals": {
"ip_address": "123.456.7.890",
"session_start_time": "1778090291092",
"device_type": "DESKTOP",
"device_timezone": "America/Los_Angeles",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
"locale": "en",
"viewport_height_px": 893,
"viewport_width_px": 1515,
"avs_full_result": "Y",
"cvv_result": "M",
"authentication_triggered": true,
"authorization_processed_with_3ds": true
}
}