پیاده‌سازی سیگنال‌های ریسک، پیاده‌سازی سیگنال‌های ریسک

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

این داده‌ها عمدتاً در طول فراخوانی رابط برنامه‌نویسی کاربردی (API) پرداخت کامل (Complete Checkout) به اشتراک گذاشته می‌شوند.

در مشخصات 2026-04-08 ، این سیگنال‌ها درون شیء signals یافت می‌شوند و از پیشوندهای com.google. و dev.ucp. برای نام سیگنال‌ها استفاده می‌کنند.

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

داده‌های جلسه

نام سیگنال توضیحات مسیر API
آدرس آی‌پی آدرس IP کاربر در جلسه. com.google.ip_address
dev.ucp.buyer_ip
زمان شروع جلسه زمان شروع خرید (برچسب زمانی Unix epoch). com.google.session_start_time

داده‌های دستگاه

نام سیگنال توضیحات مسیر API
نوع دستگاه نوع دستگاه مورد استفاده (مثلاً MOBILE ، DESKTOP ، TABLET یا UNKNOWN ). برگرفته از User Agent. com.google.device_type
منطقه زمانی دستگاه منطقه زمانی فعلی دستگاهی که در جلسه استفاده می‌شود. com.google.device_timezone

داده‌های مکانی

سیگنال‌های تقریبی موقعیت جغرافیایی زیر برای کمک به پیشگیری از کلاهبرداری و تشخیص تصاحب حساب استخراج شده‌اند.

نام سیگنال توضیحات مسیر API
کشور کاربر موقعیت تقریبی کشور خریدار (مثلاً United States ). com.google.user_country
وضعیت کاربر ایالت یا استان محل سکونت تقریبی خریدار (مثلاً California ). com.google.user_state

داده‌های مرورگر

نام سیگنال توضیحات مسیر API
عامل کاربر رشته اطلاعات کلاینت مرورگر. dev.ucp.user_agent
زبان مرورگر زبانی که در مرورگر دستگاه استفاده می‌شود (مثلاً "en"). com.google.locale
ارتفاع ویوپورت ارتفاع نمای مرورگر بر حسب پیکسل. com.google.viewport_height_px
عرض دریچه دید عرض نمای مرورگر بر حسب پیکسل. com.google.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 است).

داده‌های تأیید پرداخت

فیلدهای زیر در شیء signals در پاسخ «پرداخت کامل» موجود است.

نام سیگنال توضیحات مسیر API
نتیجه کامل AVS نتیجه بررسی سیستم تأیید آدرس (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"
  }
}
قبلی
چرخه عمر سفارش (پس از خرید)