จัดการการตั้งค่าการชำระเงิน

ฟีเจอร์การชำระเงินช่วยเร่งการซื้อสำหรับลูกค้าที่พร้อมซื้อด้วยการอนุญาตให้ลูกค้าไปยังหน้ารถเข็นหรือหน้าชำระเงินของเว็บไซต์ได้โดยตรงจากข้อมูลผลิตภัณฑ์ใน Google ซึ่งจะช่วยปรับปรุงอัตรา Conversion และมอบประสบการณ์การช็อปปิ้งที่ราบรื่น

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"
}

เรียกการตั้งค่าการชำระเงิน

หากต้องการดึงการตั้งค่าการชำระเงิน รวมถึงเทมเพลต 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

การดำเนินการนี้จะนำการกำหนดค่าระดับบัญชีออก ยกเลิกการลงทะเบียนคุณจาก โปรแกรมชำระเงิน และหยุดไม่ให้ลิงก์ชำระเงินปรากฏในผลิตภัณฑ์ของคุณใน ข้อมูลที่แสดงฟรีและโฆษณา Shopping

ตัวอย่างคำขอมีดังนี้

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

การเรียกที่สำเร็จจะแสดงเนื้อหาการตอบกลับที่ว่างเปล่า

คุณระบุ URL การชำระเงินสำหรับผลิตภัณฑ์ได้ 2 วิธีดังนี้

  • ระดับบัญชี (API ย่อยหรือ Merchant Center): หากต้องการกำหนดเทมเพลต URL เดียว ไม่ว่าจะเป็น checkout_uri_template หรือ cart_uri_template คุณสามารถใช้ API ย่อยหรือการตั้งค่า Merchant Center ได้ เทมเพลตนี้ จะมีผลกับผลิตภัณฑ์ที่มีสิทธิ์ทั้งหมด เราขอแนะนำให้คุณมี URL ที่สอดคล้องกันในผลิตภัณฑ์ เช่น yourstore.com/checkout?id={id}

  • ระดับผลิตภัณฑ์ (ฟีด): หากต้องการระบุ URL การชำระเงินที่เฉพาะเจาะจงสำหรับ สินค้าแต่ละรายการ ให้ใช้แอตทริบิวต์ checkout_link_template ในฟีดสินค้า ซึ่งช่วยให้คุณมี URL ที่กำหนดเองต่อผลิตภัณฑ์ หรือให้คุณเสนอการชำระเงิน เฉพาะสินค้าคงคลังบางส่วนได้

  • หากตั้งค่าเทมเพลต URL ระดับบัญชีโดยใช้ Sub-API นี้ โปรดตรวจสอบว่าคุณไม่ได้ส่งค่าสำหรับแอตทริบิวต์ checkout_link_template ในฟีดสำหรับผลิตภัณฑ์เหล่านั้น

  • หากใช้checkout_link_templateแอตทริบิวต์ฟีด โปรดตรวจสอบว่าคุณไม่ได้ตั้งค่าเทมเพลต URL ระดับบัญชีโดยใช้การตั้งค่า API ย่อยหรือ Merchant Center คุณยังคงใช้ Sub-API เพื่อเลือก eligible_destinations ได้ โดยไม่ต้องระบุ uri_settings หากจัดการ URL ผ่านฟีดเท่านั้น

เทมเพลต URL การชำระเงิน

เทมเพลต URL การชำระเงินช่วยให้คุณระบุ URL การชำระเงินในข้อมูลผลิตภัณฑ์ได้ ซึ่งทำให้ผู้เลือกซื้อออนไลน์มีตัวเลือกในการไปยังหน้าชำระเงินได้โดยตรงจาก ข้อมูล โดยต้องมีตัวยึดตําแหน่งพารามิเตอร์ {ID} และมีโดเมนที่ตรงกัน

เมื่อตั้งค่าลิงก์ชำระเงินโดยใช้ Sub-API ให้ใช้ฟิลด์ uri_settings ฟิลด์นี้ยอมรับเทมเพลต 2 แบบต่อไปนี้

  • 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 และไม่ต้องให้ลูกค้าลงชื่อเข้าใช้
  • โดเมนจากเทมเพลตการชำระเงินที่ระบุต้องตรงกับโดเมนผลิตภัณฑ์

ดูข้อมูลเพิ่มเติม