سوالات متداول

پاسخ سوالات متداول در مورد پروتکل تجارت جهانی (UCP) را بیابید.

عمومی

پروتکل تجارت جهانی (UCP) چیست؟

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

مزایای اصلی ادغام با UCP چیست؟

وقتی با UCP ادغام می‌شوید، موارد زیر را به دست می‌آورید:

  • دسترسی گسترده‌تر: دسترسی مستقیم به کاربران روی سطوح ما، شامل حالت هوش مصنوعی در جستجوی گوگل و برنامه Gemini.
  • کاهش اصطکاک در پرداخت: ما خریدهای مستقیم را در جریان تعامل فعال می‌کنیم و کاربران را درگیر نگه می‌داریم.
  • کنترل: شما همچنان فروشنده‌ی رکوردها هستید و کنترل کامل بر روابط و داده‌های مشتریان خود را حفظ می‌کنید.
  • انعطاف‌پذیری: ما مسیرهای ادغام مختلفی (بومی و جاسازی‌شده) را متناسب با برند و پشته فنی شما ارائه می‌دهیم.
  • آمادگی برای تجربیات عامل‌محور: ما در حال طراحی این قابلیت هستیم تا از قابلیت‌های عامل‌محور آینده، مانند سبدهای خرید چند کالایی و پیوند حساب، پشتیبانی کند.

چه چیزی UCP را متفاوت می‌کند؟

  • ماژولار و قابل توسعه: UCP به گونه‌ای طراحی شده است که ماژولار و قابل توسعه باشد تا با استفاده از قابلیت‌ها و افزونه‌ها، از تجربیات تجاری غنی پشتیبانی کند.
  • پیاده‌سازی سریع و آسان: UCP به بازرگانان این امکان را می‌دهد که مجموعه‌ای از قابلیت‌ها و افزونه‌هایی را که می‌خواهند پشتیبانی کنند و همچنین رسانه ارتباطی که به بهترین وجه با نیازهای توسعه‌ای آنها مانند APIها، MCP یا A2A مطابقت دارد را انتخاب کنند.
  • طراحی مشترک با رهبران صنعت: UCP متن‌باز است و مستقیماً با همکاری رهبران صنعت طراحی شده است تا از نیازهای متنوع یک اکوسیستم تجاری غنی پشتیبانی کند.
  • پرداخت‌های امن و یکپارچه: UCP از پرداخت‌های امن با استفاده از توکن‌سازی پشتیبانی می‌کند و به بازرگانان اجازه می‌دهد تا با استفاده از کنترل‌کننده‌های پرداخت، بر روی ادغام‌های پرداخت موجود، کار کنند.

ادغام‌های ما روی چه سطوحی ظاهر خواهند شد؟

در زمان راه‌اندازی، ادغام UCP شما، تجربیات حالت هوش مصنوعی در جستجوی گوگل و همچنین برنامه وب Gemini و برنامه موبایل Gemini را تقویت خواهد کرد. ما در حال برنامه‌ریزی برای پشتیبانی از سایر سطوح در آینده هستیم.

یکپارچه‌سازی و پیکربندی

آیا UCP با فناوری‌های موجود من سازگار است؟

ما UCP را بر اساس استانداردهای باز ساختیم و آن را به طور یکپارچه با پروتکل‌های اصلی موجود که ممکن است از قبل از آنها استفاده کنید، مانند AP2، A2A و ​​MCP، سازگار کردیم.

آیا باید در حساب مرکز فروش خود تغییراتی ایجاد کنم؟

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

ما چه تفاوتی با پروتکل‌های دیگر داریم؟

ما UCP را به عنوان یک استاندارد جامع و باز، به طور خاص برای تجارت مبتنی بر هوش مصنوعی، با همکاری شرکای صنعتی طراحی کردیم. برخلاف پروتکل‌هایی که صرفاً بر پرداخت‌ها متمرکز هستند، ما از سفر خرید گسترده‌تر (شامل کشف و بررسی) که توسط نمودار خرید ما پشتیبانی می‌شود، پشتیبانی می‌کنیم.

چگونه می‌توانم ترافیک کانال‌های UCP را از ترافیک کانال‌های خودم تشخیص دهم؟

شما می‌توانید ترافیک UCP را از ترافیک معمولی وب‌سایت یا برنامه خود به دو روش متمایز کنید:

  • هدرهای HTTP: شما می‌توانید درخواست‌های UCP ورودی را در سطح شبکه با تأیید اینکه درخواست دو شرط را برآورده می‌کند، شناسایی کنید: یک هدر با برچسب UCP-Agent:Profile وجود داشته باشد و مقدار User-Agent با Google/UCP شروع شود.
  • قراردادهای API: ما رویدادهای چرخه حیات پرداخت، سفارش و تراکنش را با استفاده از قراردادهای API که در مشخصات ما تعیین شده‌اند، تبادل می‌کنیم. این به شما امکان می‌دهد تا ترافیک و پرداخت‌های جاری از طریق سطوح هوش مصنوعی ما را در سطح برنامه به وضوح تفکیک کنید.

چگونه بررسی موجودی کالا را به صورت آنی انجام دهیم؟

به عنوان فروشنده‌ی کالا، مسئولیت بررسی موجودی کالا در لحظه بر عهده‌ی شماست. اگر در هر مرحله از فرآیند پرداخت، موجودی کالا تمام شود، API شما باید یک پیام پاسخ شامل کد خطای out_of_stock را برگرداند. وقتی سیستم شما این خطا را برمی‌گرداند، ما یک پیام خطای مرتبط به کاربر نشان می‌دهیم، مانند «این کالا در حال حاضر موجود نیست. گزینه‌ی دیگری را امتحان کنید یا بعداً دوباره بررسی کنید.»

برای اطلاعات بیشتر، به مثال‌های خطای out_of_stock مراجعه کنید.

چگونه می‌توانم با خیال راحت یکپارچه‌سازی زنده خود را به نسخه جدیدتر مشخصات UCP منتقل کنم؟

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

آیا گوگل به طور خودکار آدرس‌های حمل و نقل بین‌المللی را اعتبارسنجی و مسدود می‌کند؟

خیر. به عنوان فروشنده‌ی کالا، مسئولیت اعتبارسنجی آدرس‌های ارسال بر عهده‌ی شماست. وقتی کاربری یک آدرس ارسال را انتخاب می‌کند، ما جزئیات مقصد (از جمله کد address_country ) را در طول فراخوانی‌های API مربوط به ایجاد پرداخت یا به‌روزرسانی پرداخت به سرور شما ارسال می‌کنیم. اگر آدرس خارج از مناطق ارسال پشتیبانی‌شده‌ی شما باشد، سیستم شما باید این را در پاسخ API با استفاده از کدهای خطای استاندارد UCP، مانند address_undeliverable یا address_unverifiable ارسال کند.

برای اطلاعات بیشتر، به کدهای خطا مراجعه کنید.

پرداخت‌ها و توکن‌سازی

UCP چگونه با پروتکل پرداخت‌های عامل (AP2) مرتبط است؟

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

چگونه پرداخت‌ها را پردازش می‌کنیم؟ آیا به پشتیبانی از گوگل پی نیاز دارم؟

نیازی نیست که از پرداخت با API گوگل پی در وب‌سایت یا برنامه خود پشتیبانی کنید، اما ارائه‌دهنده خدمات پرداخت (PSP) شما باید بتواند توکن‌های ما را پردازش کند. اکثر PSP های بزرگ جهانی از گوگل پی پشتیبانی می‌کنند .

اگر چندین حساب کنسول Google Pay & Wallet داشته باشم (مثلاً یکی برای هر کشور)، کدام را باید در پروفایل UCP خود مشخص کنم؟

ما شما را ملزم به استفاده از پروفایل‌های مختلف برای کشورهای مختلف نمی‌کنیم. شما می‌توانید از هر حساب کنسول Google Pay & Wallet یا ترکیبی از حساب‌ها که به بهترین وجه با کسب‌وکار شما سازگار است، استفاده کنید.

اگر از قبل Google Pay داشته باشم، آیا تنظیمات فعلی من (مثلاً محدودیت‌های کارت) را رعایت خواهید کرد؟

از آنجا که UCP یک یکپارچه‌سازی جداگانه است، شما باید پیکربندی Google Pay خود را صریحاً در پروفایل UCP خود ارائه دهید. می‌توانید از همان پارامترهای پیکربندی که برای وب‌سایت یا برنامه خود استفاده می‌کنید استفاده کنید، یا می‌توانید پیکربندی متفاوتی ارائه دهید. الزامات زیر را در نظر داشته باشید:

  • پارامترهای پشتیبانی‌شده: تنظیمات مشابه یکپارچه‌سازی موجود شما هستند، اما پارامترهای پشتیبانی‌شده تطابق یک‌به‌یک ندارند (برای مثال، UCP به جای camelCase از snake_case استفاده می‌کند). برای لیست کامل، به پیکربندی کنترل‌کننده پرداخت Google Pay مراجعه کنید.
  • روش‌های احراز هویت پشتیبانی‌شده: UCP در سطوح هوش مصنوعی گوگل فقط PAN_ONLY برای فیلد allowed_auth_methods پشتیبانی می‌کند. می‌توانید روش‌های دیگری (مانند CRYPTOGRAM_3DS ) را نیز اضافه کنید، اما آنها در جریان پرداخت UCP استفاده نمی‌شوند.

امنیت و نظارت

گوگل چگونه سلامت اندپوینت API من را رصد می‌کند؟

گوگل ممکن است به صورت دوره‌ای درخواست‌های HTTP را به نقاط انتهایی API شما ارسال کند تا از در دسترس بودن و پاسخگویی آنها اطمینان حاصل کند. این درخواست‌های بررسی سلامت شامل یک هدر خاص User-Agent خواهند بود: User-Agent: Google-UCP-Prober/1.0 .

چگونه می‌توانم تأیید کنم که درخواست‌های API واقعاً از طرف گوگل می‌آیند؟

برای تأیید اینکه درخواست‌ها از گوگل سرچشمه می‌گیرند، راهنمای رسمی در «تأیید درخواست‌ها از گوگل» را دنبال کنید. این راهنما روش‌هایی مانند جستجوی معکوس DNS را شرح می‌دهد و پیوندهایی به فایل‌های محدوده IP منتشر شده ما ارائه می‌دهد.

آیا می‌توانم درخواست‌های ورودی API گوگل را به کشورهای خاص محدود کنم (محدودیت جغرافیایی)؟

خیر. گوگل ترافیک خروجی را به صورت پویا با استفاده از سرورهای اصلی مدیریت می‌کند، بنابراین ما نمی‌توانیم تضمین کنیم که درخواست‌ها از یک کشور خاص سرچشمه می‌گیرند. به جای استفاده از مسدود کردن IP جغرافیایی، توصیه می‌کنیم فایروال خود را طوری پیکربندی کنید که درخواست‌های گوگل را بر اساس توکن OAuth 2.0 Bearer یا سایر امضاهای امن ارائه شده در طول فرآیند احراز هویت ماشین به ماشین، تأیید اعتبار کرده و اجازه دهد.

تجربه کاربری

آیا ادغام بومی بر رتبه‌بندی محصول من تأثیر خواهد گذاشت؟

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

آیا کاربران می‌توانند آدرس ارسال خود را در هنگام پرداخت تغییر دهند؟

بله. ما به کاربران اجازه می‌دهیم تا آدرس ارسال خود را در طول فرآیند بررسی و تغییر دهند. ما انتظار داریم سیستم شما به صورت پویا هزینه‌ها و مالیات ارسال را بر اساس آدرس جدید ارائه شده به‌روزرسانی کند.

چگونه می‌توانم اعلام کنم که احراز هویت اختیاری کاربر (پیوند هویت) در دسترس است؟

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

برای اطلاعات بیشتر، به پیوند هویت - OAuth 2.0 مراجعه کنید.

خطاهای پرداخت قابل بازیابی چگونه به کاربر نمایش داده می‌شوند؟

وقتی API شما یک خطای قابل بازیابی - مانند address_undeliverable - برمی‌گرداند، رابط کاربری ما از کاربر می‌خواهد اطلاعات خود را به‌روزرسانی کند (برای مثال، با انتخاب یک آدرس ارسال متفاوت). مطمئن شوید که شدت خطا را به طور دقیق در آرایه messages خود به عنوان recoverable تنظیم کرده‌اید؛ در غیر این صورت، کاربر با صفحه خطای مسدود شدن مواجه می‌شود و نمی‌تواند پرداخت را تکمیل کند.

برای اطلاعات بیشتر، به کدهای خطا مراجعه کنید.

آیا کنترل داده‌های مشتری‌ام را از دست خواهم داد؟

خیر. شما فروشنده‌ی اسناد هستید. شما مالکیت کامل روابط و داده‌های مشتریان خود را حفظ می‌کنید.

چگونه حریم خصوصی مشتریان را مدیریت کنیم؟

رویه‌های استاندارد امنیتی و حریم خصوصی ما در مورد تعامل اعمال می‌شود، اما شما مالک داده‌های تراکنش هستید. ما همچنین در حال ایجاد ویژگی‌هایی مانند پیوند حساب هستیم که برای کنترل کاربر بر داده‌های خود طراحی شده‌اند.

چه شرایط و ضوابطی برای تراکنش UCP اعمال می‌شود؟

شرایط و ضوابط شما، خرید را پوشش می‌دهد، درست مانند زمانی که مشتری در وب‌سایت شما تسویه حساب می‌کند. ما این شرایط را به مشتری نمایش می‌دهیم و او باید در طول فرآیند پرداخت، آنها را بپذیرد.

آیا محدودیت‌هایی در بازاریابی مجدد برای مشتریانی که از طریق UCP جذب شده‌اند، وجود دارد؟

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

سیاست حفظ اطلاعات برای داده‌های سفارش ارسالی به گوگل چیست؟

گوگل داده‌های سفارش استاندارد (اطلاعاتی که در صفحه «سفارش‌های من» کاربر نمایش داده می‌شود) را به طور نامحدود نگه می‌دارد تا زمانی که کاربر صریحاً درخواست حذف آن را مطابق با سیاست‌های حذف داده‌های استاندارد ما ارائه دهد.

از آنجا که شما فروشنده‌ی اطلاعات هستید، سیاست‌های نگهداری و انطباق داده‌های شرکت شما (برای مثال، نگهداری سوابق مالی به مدت ۷ سال) همچنان در مورد داده‌های ذخیره شده در سیستم‌های شما اعمال می‌شود.

،

پاسخ سوالات متداول در مورد پروتکل تجارت جهانی (UCP) را بیابید.

عمومی

پروتکل تجارت جهانی (UCP) چیست؟

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

مزایای اصلی ادغام با UCP چیست؟

وقتی با UCP ادغام می‌شوید، موارد زیر را به دست می‌آورید:

  • دسترسی گسترده‌تر: دسترسی مستقیم به کاربران روی سطوح ما، شامل حالت هوش مصنوعی در جستجوی گوگل و برنامه Gemini.
  • کاهش اصطکاک در پرداخت: ما خریدهای مستقیم را در جریان تعامل فعال می‌کنیم و کاربران را درگیر نگه می‌داریم.
  • کنترل: شما همچنان فروشنده‌ی رکوردها هستید و کنترل کامل بر روابط و داده‌های مشتریان خود را حفظ می‌کنید.
  • انعطاف‌پذیری: ما مسیرهای ادغام مختلفی (بومی و جاسازی‌شده) را متناسب با برند و پشته فنی شما ارائه می‌دهیم.
  • آمادگی برای تجربیات عامل‌محور: ما در حال طراحی این قابلیت هستیم تا از قابلیت‌های عامل‌محور آینده، مانند سبدهای خرید چند کالایی و پیوند حساب، پشتیبانی کند.

چه چیزی UCP را متفاوت می‌کند؟

  • ماژولار و قابل توسعه: UCP به گونه‌ای طراحی شده است که ماژولار و قابل توسعه باشد تا با استفاده از قابلیت‌ها و افزونه‌ها، از تجربیات تجاری غنی پشتیبانی کند.
  • پیاده‌سازی سریع و آسان: UCP به بازرگانان این امکان را می‌دهد که مجموعه‌ای از قابلیت‌ها و افزونه‌هایی را که می‌خواهند پشتیبانی کنند و همچنین رسانه ارتباطی که به بهترین وجه با نیازهای توسعه‌ای آنها مانند APIها، MCP یا A2A مطابقت دارد را انتخاب کنند.
  • طراحی مشترک با رهبران صنعت: UCP متن‌باز است و مستقیماً با همکاری رهبران صنعت طراحی شده است تا از نیازهای متنوع یک اکوسیستم تجاری غنی پشتیبانی کند.
  • پرداخت‌های امن و یکپارچه: UCP از پرداخت‌های امن با استفاده از توکن‌سازی پشتیبانی می‌کند و به بازرگانان اجازه می‌دهد تا با استفاده از کنترل‌کننده‌های پرداخت، بر روی ادغام‌های پرداخت موجود، کار کنند.

ادغام‌های ما روی چه سطوحی ظاهر خواهند شد؟

در زمان راه‌اندازی، ادغام UCP شما، تجربیات حالت هوش مصنوعی در جستجوی گوگل و همچنین برنامه وب Gemini و برنامه موبایل Gemini را تقویت خواهد کرد. ما در حال برنامه‌ریزی برای پشتیبانی از سایر سطوح در آینده هستیم.

یکپارچه‌سازی و پیکربندی

آیا UCP با فناوری‌های موجود من سازگار است؟

ما UCP را بر اساس استانداردهای باز ساختیم و آن را به طور یکپارچه با پروتکل‌های اصلی موجود که ممکن است از قبل از آنها استفاده کنید، مانند AP2، A2A و ​​MCP، سازگار کردیم.

آیا باید در حساب مرکز فروش خود تغییراتی ایجاد کنم؟

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

ما چه تفاوتی با پروتکل‌های دیگر داریم؟

ما UCP را به عنوان یک استاندارد جامع و باز، به طور خاص برای تجارت مبتنی بر هوش مصنوعی، با همکاری شرکای صنعتی طراحی کردیم. برخلاف پروتکل‌هایی که صرفاً بر پرداخت‌ها متمرکز هستند، ما از سفر خرید گسترده‌تر (شامل کشف و بررسی) که توسط نمودار خرید ما پشتیبانی می‌شود، پشتیبانی می‌کنیم.

چگونه می‌توانم ترافیک کانال‌های UCP را از ترافیک کانال‌های خودم تشخیص دهم؟

شما می‌توانید ترافیک UCP را از ترافیک معمولی وب‌سایت یا برنامه خود به دو روش متمایز کنید:

  • هدرهای HTTP: شما می‌توانید درخواست‌های UCP ورودی را در سطح شبکه با تأیید اینکه درخواست دو شرط را برآورده می‌کند، شناسایی کنید: یک هدر با برچسب UCP-Agent:Profile وجود داشته باشد و مقدار User-Agent با Google/UCP شروع شود.
  • قراردادهای API: ما رویدادهای چرخه حیات پرداخت، سفارش و تراکنش را با استفاده از قراردادهای API که در مشخصات ما تعیین شده‌اند، تبادل می‌کنیم. این به شما امکان می‌دهد تا ترافیک و پرداخت‌های جاری از طریق سطوح هوش مصنوعی ما را در سطح برنامه به وضوح تفکیک کنید.

چگونه بررسی موجودی کالا را به صورت آنی انجام دهیم؟

به عنوان فروشنده‌ی کالا، مسئولیت بررسی موجودی کالا در لحظه بر عهده‌ی شماست. اگر در هر مرحله از فرآیند پرداخت، موجودی کالا تمام شود، API شما باید یک پیام پاسخ شامل کد خطای out_of_stock را برگرداند. وقتی سیستم شما این خطا را برمی‌گرداند، ما یک پیام خطای مرتبط به کاربر نشان می‌دهیم، مانند «این کالا در حال حاضر موجود نیست. گزینه‌ی دیگری را امتحان کنید یا بعداً دوباره بررسی کنید.»

برای اطلاعات بیشتر، به مثال‌های خطای out_of_stock مراجعه کنید.

چگونه می‌توانم با خیال راحت یکپارچه‌سازی زنده خود را به نسخه جدیدتر مشخصات UCP منتقل کنم؟

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

آیا گوگل به طور خودکار آدرس‌های حمل و نقل بین‌المللی را اعتبارسنجی و مسدود می‌کند؟

خیر. به عنوان فروشنده‌ی کالا، مسئولیت اعتبارسنجی آدرس‌های ارسال بر عهده‌ی شماست. وقتی کاربری یک آدرس ارسال را انتخاب می‌کند، ما جزئیات مقصد (از جمله کد address_country ) را در طول فراخوانی‌های API مربوط به ایجاد پرداخت یا به‌روزرسانی پرداخت به سرور شما ارسال می‌کنیم. اگر آدرس خارج از مناطق ارسال پشتیبانی‌شده‌ی شما باشد، سیستم شما باید این را در پاسخ API با استفاده از کدهای خطای استاندارد UCP، مانند address_undeliverable یا address_unverifiable ارسال کند.

برای اطلاعات بیشتر، به کدهای خطا مراجعه کنید.

پرداخت‌ها و توکن‌سازی

UCP چگونه با پروتکل پرداخت‌های عامل (AP2) مرتبط است؟

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

چگونه پرداخت‌ها را پردازش می‌کنیم؟ آیا به پشتیبانی از گوگل پی نیاز دارم؟

نیازی نیست که از پرداخت با API گوگل پی در وب‌سایت یا برنامه خود پشتیبانی کنید، اما ارائه‌دهنده خدمات پرداخت (PSP) شما باید بتواند توکن‌های ما را پردازش کند. اکثر PSP های بزرگ جهانی از گوگل پی پشتیبانی می‌کنند .

اگر چندین حساب کنسول Google Pay & Wallet داشته باشم (مثلاً یکی برای هر کشور)، کدام را باید در پروفایل UCP خود مشخص کنم؟

ما شما را ملزم به استفاده از پروفایل‌های مختلف برای کشورهای مختلف نمی‌کنیم. شما می‌توانید از هر حساب کنسول Google Pay & Wallet یا ترکیبی از حساب‌ها که به بهترین وجه با کسب‌وکار شما سازگار است، استفاده کنید.

اگر از قبل Google Pay داشته باشم، آیا تنظیمات فعلی من (مثلاً محدودیت‌های کارت) را رعایت خواهید کرد؟

از آنجا که UCP یک یکپارچه‌سازی جداگانه است، شما باید پیکربندی Google Pay خود را صریحاً در پروفایل UCP خود ارائه دهید. می‌توانید از همان پارامترهای پیکربندی که برای وب‌سایت یا برنامه خود استفاده می‌کنید استفاده کنید، یا می‌توانید پیکربندی متفاوتی ارائه دهید. الزامات زیر را در نظر داشته باشید:

  • پارامترهای پشتیبانی‌شده: تنظیمات مشابه یکپارچه‌سازی موجود شما هستند، اما پارامترهای پشتیبانی‌شده تطابق یک‌به‌یک ندارند (برای مثال، UCP به جای camelCase از snake_case استفاده می‌کند). برای لیست کامل، به پیکربندی کنترل‌کننده پرداخت Google Pay مراجعه کنید.
  • روش‌های احراز هویت پشتیبانی‌شده: UCP در سطوح هوش مصنوعی گوگل فقط PAN_ONLY برای فیلد allowed_auth_methods پشتیبانی می‌کند. می‌توانید روش‌های دیگری (مانند CRYPTOGRAM_3DS ) را نیز اضافه کنید، اما آنها در جریان پرداخت UCP استفاده نمی‌شوند.

امنیت و نظارت

گوگل چگونه سلامت اندپوینت API من را رصد می‌کند؟

گوگل ممکن است به صورت دوره‌ای درخواست‌های HTTP را به نقاط انتهایی API شما ارسال کند تا از در دسترس بودن و پاسخگویی آنها اطمینان حاصل کند. این درخواست‌های بررسی سلامت شامل یک هدر خاص User-Agent خواهند بود: User-Agent: Google-UCP-Prober/1.0 .

چگونه می‌توانم تأیید کنم که درخواست‌های API واقعاً از طرف گوگل می‌آیند؟

برای تأیید اینکه درخواست‌ها از گوگل سرچشمه می‌گیرند، راهنمای رسمی در «تأیید درخواست‌ها از گوگل» را دنبال کنید. این راهنما روش‌هایی مانند جستجوی معکوس DNS را شرح می‌دهد و پیوندهایی به فایل‌های محدوده IP منتشر شده ما ارائه می‌دهد.

آیا می‌توانم درخواست‌های ورودی API گوگل را به کشورهای خاص محدود کنم (محدودیت جغرافیایی)؟

خیر. گوگل ترافیک خروجی را به صورت پویا با استفاده از سرورهای اصلی مدیریت می‌کند، بنابراین ما نمی‌توانیم تضمین کنیم که درخواست‌ها از یک کشور خاص سرچشمه می‌گیرند. به جای استفاده از مسدود کردن IP جغرافیایی، توصیه می‌کنیم فایروال خود را طوری پیکربندی کنید که درخواست‌های گوگل را بر اساس توکن OAuth 2.0 Bearer یا سایر امضاهای امن ارائه شده در طول فرآیند احراز هویت ماشین به ماشین، تأیید اعتبار کرده و اجازه دهد.

تجربه کاربری

آیا ادغام بومی بر رتبه‌بندی محصول من تأثیر خواهد گذاشت؟

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

آیا کاربران می‌توانند آدرس ارسال خود را در هنگام پرداخت تغییر دهند؟

بله. ما به کاربران اجازه می‌دهیم تا آدرس ارسال خود را در طول فرآیند بررسی و تغییر دهند. ما انتظار داریم سیستم شما به صورت پویا هزینه‌ها و مالیات ارسال را بر اساس آدرس جدید ارائه شده به‌روزرسانی کند.

چگونه می‌توانم اعلام کنم که احراز هویت اختیاری کاربر (پیوند هویت) در دسترس است؟

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

برای اطلاعات بیشتر، به پیوند هویت - OAuth 2.0 مراجعه کنید.

خطاهای پرداخت قابل بازیابی چگونه به کاربر نمایش داده می‌شوند؟

وقتی API شما یک خطای قابل بازیابی - مانند address_undeliverable - برمی‌گرداند، رابط کاربری ما از کاربر می‌خواهد اطلاعات خود را به‌روزرسانی کند (برای مثال، با انتخاب یک آدرس ارسال متفاوت). مطمئن شوید که شدت خطا را به طور دقیق در آرایه messages خود به عنوان recoverable تنظیم کرده‌اید؛ در غیر این صورت، کاربر با صفحه خطای مسدود شدن مواجه می‌شود و نمی‌تواند پرداخت را تکمیل کند.

برای اطلاعات بیشتر، به کدهای خطا مراجعه کنید.

آیا کنترل داده‌های مشتری‌ام را از دست خواهم داد؟

خیر. شما فروشنده‌ی اسناد هستید. شما مالکیت کامل روابط و داده‌های مشتریان خود را حفظ می‌کنید.

چگونه حریم خصوصی مشتریان را مدیریت کنیم؟

رویه‌های استاندارد امنیتی و حریم خصوصی ما در مورد تعامل اعمال می‌شود، اما شما مالک داده‌های تراکنش هستید. ما همچنین در حال ایجاد ویژگی‌هایی مانند پیوند حساب هستیم که برای کنترل کاربر بر داده‌های خود طراحی شده‌اند.

چه شرایط و ضوابطی برای تراکنش UCP اعمال می‌شود؟

شرایط و ضوابط شما، خرید را پوشش می‌دهد، درست مانند زمانی که مشتری در وب‌سایت شما تسویه حساب می‌کند. ما این شرایط را به مشتری نمایش می‌دهیم و او باید در طول فرآیند پرداخت، آنها را بپذیرد.

آیا محدودیت‌هایی در بازاریابی مجدد برای مشتریانی که از طریق UCP جذب شده‌اند، وجود دارد؟

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

سیاست حفظ اطلاعات برای داده‌های سفارش ارسالی به گوگل چیست؟

گوگل داده‌های سفارش استاندارد (اطلاعاتی که در صفحه «سفارش‌های من» کاربر نمایش داده می‌شود) را به طور نامحدود نگه می‌دارد تا زمانی که کاربر صریحاً درخواست حذف آن را مطابق با سیاست‌های حذف داده‌های استاندارد ما ارائه دهد.

از آنجا که شما فروشنده‌ی اطلاعات هستید، سیاست‌های نگهداری و انطباق داده‌های شرکت شما (برای مثال، نگهداری سوابق مالی به مدت ۷ سال) همچنان در مورد داده‌های ذخیره شده در سیستم‌های شما اعمال می‌شود.