مدیریت تنظیمات تسویه‌حساب

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

با Merchant API، می‌توانید تنظیمات این ویژگی را بااستفاده از منبع CheckoutSettings مدیریت کنید.

این راهنما توضیح می‌دهد که چگونه از Merchant API برای ایجاد و مدیریت ثبت‌نام خود در ویژگی تسویه‌حساب به‌صورت برنامه‌ریزی‌شده استفاده کنید.

برای اطلاعات بیشتر، افزودن پیوند تسویه‌حساب برای محصولات را ببینید.

پیش‌نیازها

برای استفاده از منبع CheckoutSettings و روش‌های مرتبط، حتماً کارهای زیر را انجام دهید:

  • باید برای «آگهی‌های Shopping»، فهرستگان‌های رایگان، یا هر دو تأیید شده باشید و در آن‌ها شرکت کنید.
  • کشور فروش شما باید ایالات متحده باشد.

روش‌ها

برای ایجاد، بازیابی، به‌روزرسانی، و حذف تنظیمات تسویه‌حساب، می‌توانید از روش‌های زیر استفاده کنید:

ایجاد تنظیمات تسویه‌حساب

برای ایجاد تنظیمات تسویه‌حساب، از روش checkoutSettings.create استفاده کنید. uri_settings را با checkout_uri_template یا cart_uri_template و eligible_destinations انتخاب‌شده در بدنه درخواست بگنجانید.

در اینجا یک درخواست نمونه آورده شده است:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

{ACCOUNT_ID} را با شناسه یکتای حساب Merchant Center خودتان جایگزین کنید.

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

بازیابی تنظیمات تسویه‌حساب

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

در اینجا یک درخواست نمونه آورده شده است:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

به‌روزرسانی تنظیمات تسویه‌حساب

برای به‌روزرسانی تنظیمات تسویه‌حساب، از روش checkoutSettings.update استفاده کنید. فیلدهایی را که می‌خواهید تغییر دهید در بدنه درخواست اضافه کنید و آن فیلدها را در پارامتر پُرسمان update_mask مشخص کنید.

‫update_mask از فیلدهای زیر پشتیبانی می‌کند:

  • eligible_destinations
  • uri_settings

در اینجا نمونه درخواستی برای به‌روزرسانی نشانی وب و برداشتن مقصد آگهی‌ها آورده شده است:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

در اینجا نمونه‌ای از پاسخ یک تماس موفق آورده شده است:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

حذف

برای حذف تنظیمات تسویه‌حساب، از روش checkoutSettings.delete استفاده کنید.

این کنش پیکربندی سطح حسابتان را برمی‌دارد، شما را از برنامه تصفیه‌حساب لغو ثبت‌نام می‌کند، و باعث می‌شود پیوندهای تصفیه‌حساب دیگر در محصولاتتان در فهرستگان رایگان و آگهی‌های Shopping نشان داده نشود.

در اینجا یک درخواست نمونه آورده شده است:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

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

دو روش برای ارائه نشانی‌های وب تسویه‌حساب برای محصولاتتان دارید:

  • سطح حساب (زیرمیانای برنامه‌سازی کاربردی یا Merchant Center): برای تعریف یک الگوی نشانی وب، checkout_uri_template یا cart_uri_template، می‌توانید از زیرمیانای برنامه‌سازی کاربردی یا تنظیمات Merchant Center استفاده کنید. این الگو برای همه محصولات واجدشرایط شما اعمال می‌شود. توصیه می‌کنیم نشانی وب یکسانی برای همه محصولاتتان داشته باشید. برای مثال، yourstore.com/checkout?id={id}.

  • سطح محصول (فید): برای ارائه نشانی وب تسویه‌حساب خاص برای محصولات تکی، از مشخصه checkout_link_template در فید محصولتان استفاده کنید. این کار امکان استفاده از نشانی‌های وب سفارشی برای هر محصول را فراهم می‌کند یا به شما اجازه می‌دهد تسویه‌حساب را فقط برای زیرمجموعه‌ای از موجودی‌تان ارائه دهید.

  • اگر بااستفاده از این زیرمیانای برنامه‌سازی کاربردی، الگوی نشانی وب در سطح حساب تنظیم می‌کنید، مطمئن شوید که برای مشخصه checkout_link_template در فیدتان برای آن محصولات مقدار ارسال نکنید.

  • اگر از مشخصه فید checkout_link_template استفاده می‌کنید، مطمئن شوید که الگوی نشانی وب سطح حساب را بااستفاده از زیرمیانای برنامه‌سازی کاربردی یا تنظیمات Merchant Center تنظیم نکنید. اگر نشانی‌های وب را صرفاً ازطریق فید مدیریت می‌کنید، همچنان می‌توانید از زیرمیانای برنامه‌سازی کاربردی برای انتخاب eligible_destinations بدون ارائه uri_settings استفاده کنید.

الگوی نشانی وب تسویه‌حساب

الگوی نشانی وب تسویه‌حساب به شما امکان می‌دهد نشانی وب تسویه‌حساب را در داده‌های محصولتان بگنجانید که به خریداران آنلاین این گزینه را می‌دهد تا مستقیماً از فهرستگان‌های شما به صفحه تسویه‌حساب شما بروند. باید حاوی جای‌بان پارامتر {ID} باشد و دامنه مطابقی داشته باشد.

وقتی پیوندهای تسویه‌حساب را بااستفاده از زیرمیانای برنامه‌سازی کاربردی راه‌اندازی می‌کنید، از فیلد uri_settings استفاده کنید. این فیلد یکی از دو الگو را می‌پذیرد:

  • checkout_uri_template: الگوی نشانی وبی که وقتی جای‌بان پر می‌شود، کاربر را به صفحه تصفیه‌حساب شما هدایت می‌کند و مورد خاص آماده خرید است.
  • cart_uri_template: الگوی نشانی وبی که کاربر را به صفحه سبد خرید شما هدایت می‌کند و مورد خاصی به سبد خرید اضافه شده است.

الگوهای نمونه

  • تسویه‌حساب: https://www.your-store.com/checkout?item_id={id}
  • سبد خرید: https://shop.your-store.com/add_to_cart?product_sku={id}

مطمئن شوید الزامات زیر را برآورده می‌کنید:

  • الگوی نشانی وب شما باید به صفحه معتبری در سایتتان اشاره کند که با دامنه ثبت‌شده شما مطابقت داشته باشد، بااستفاده از روش HTTP GET کار کند، و مشتری را ملزم به ورود به سیستم نکند.
  • دامنه الگوی تصفیه‌حساب ارائه‌شده باید با دامنه محصول مطابقت داشته باشد.

بیشتر بدانید

قبلی
Manage online return policies
بعدی
Enable automatic improvements