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

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

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

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

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

پیش نیازها

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

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

روش ها

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

تنظیمات پرداخت را ایجاد کنید

برای ایجاد یک تنظیم پرداخت، از روش 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"
}

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

برای بازیابی تنظیمات تسویه حساب خود، از جمله الگوی URL، مقصدهای انتخابی، وضعیت ثبت نام و وضعیت بررسی URL، از روش 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 استفاده کنید. فیلدهایی را که می خواهید تغییر دهید در بدنه درخواست قرار دهید و آن فیلدها را در پارامتر query update_mask مشخص کنید.

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

  • eligible_destinations
  • uri_settings

در اینجا یک نمونه درخواست به روز رسانی URL و حذف مقصد تبلیغات آمده است:

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 استفاده کنید.

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

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

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

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

شما دو راه برای ارائه URL های پرداخت برای محصولات خود دارید:

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

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

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

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

بررسی الگوی URL

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

هنگامی که پیوندهای پرداخت را با استفاده از API فرعی تنظیم می کنید، از قسمت uri_settings استفاده کنید. این قسمت یکی از دو الگو را می پذیرد:

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

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

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

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

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

بیشتر بدانید