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

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

با استفاده از 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} ، شناسه منحصر به فرد حساب مرکز فروش خود را وارد کنید.

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

{
  "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 استفاده کنید. فیلدهایی را که می‌خواهید تغییر دهید در بدنه درخواست قرار دهید و آن فیلدها را در پارامتر کوئری 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 یا مرکز فروشندگان): برای تعریف یک الگوی URL واحد، چه checkout_uri_template و چه cart_uri_template ، می‌توانید از تنظیمات زیر-API یا مرکز فروشندگان استفاده کنید. این الگو برای همه محصولات واجد شرایط شما اعمال می‌شود. توصیه می‌کنیم که یک URL ثابت برای همه محصولات خود داشته باشید. به عنوان مثال، yourstore.com/checkout?id={id} .

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

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

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

الگوی آدرس اینترنتی پرداخت

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

وقتی لینک‌های پرداخت را با استفاده از sub-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 کار کند و نیازی به ورود مشتری نداشته باشد.
  • دامنه‌ی موجود در الگوی پرداخت ارائه شده باید با دامنه‌ی محصول مطابقت داشته باشد.

بیشتر بدانید