โอกาสในการสร้างมูลค่าเพิ่ม

ฉากหลัง

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

ตัวอย่างฟีเจอร์

ตัวอย่างเดียวของโมดูลโอกาสด้านคุณค่า ตัวอย่างรายการโมดูลโอกาสด้านคุณค่า
มุมมองเดี่ยว มุมมองรายการ

คู่มือต่อไปนี้มีสมมติฐานว่าคุณคุ้นเคยกับแนวคิดพื้นฐานของ Google Wallet และได้ทำตามข้อกำหนดเบื้องต้นที่แนะนำ เรียบร้อยแล้ว โปรดส่งคำถามหรือความคิดเห็นไปยังผู้ติดต่อของ Google Wallet

ขั้นตอนการผสานรวม

หากต้องการเพิ่มโมดูลใหม่ คุณจะต้องอัปเดตออบเจ็กต์และ/หรือคลาสให้มี ValueAddedModuleData ValueAddedModuleData มีช่องต่อไปนี้

[ต้องระบุ] ส่วนหัว LocalizedString

ส่วนหัวที่แสดงในโมดูล จำนวนอักขระสูงสุดคือ 60 ตัว และสตริงที่ยาวกว่านี้จะถูกตัดออก ตัวอย่างส่วนหัวของโอกาสด้านคุณค่า

LocalizedString body

เนื้อหาที่แสดงในโมดูล จำนวนอักขระสูงสุดคือ 50 ตัว และสตริงที่ยาวกว่านั้นจะถูกตัดออก
ตัวอย่างเนื้อหาโอกาสด้านคุณค่า

รูปภาพ

รูปภาพที่แสดงในโมดูล อัตราส่วนรูปภาพที่แนะนำคือ 1:1 และระบบจะปรับขนาดรูปภาพ ให้พอดีกับอัตราส่วนนี้
ตัวอย่างรูปภาพโอกาสด้านคุณค่า

[ต้องระบุ] สตริง uri

URI ที่โมดูลจะนำไปเมื่อคลิก ซึ่งอาจเป็นลิงก์เว็บหรือ Deep Link

ModuleViewConstraints viewConstraints

ข้อจำกัดที่ต้องเป็นไปตามทั้งหมดเพื่อให้โมดูลแสดง ModuleViewConstraints มีฟิลด์ต่อไปนี้

TimeInterval displayInterval

ระยะเวลาที่โมดูลจะแสดงต่อผู้ใช้ กำหนดได้ทั้ง `startTime` และ `endTime` โมดูลจะแสดงทันทีหลังจากแทรก เว้นแต่จะมีการตั้งค่า `startTime` โมดูล จะแสดงไปแบบไม่มีกำหนดหากไม่ได้ตั้งค่า `endTime`

int32 sortIndex

ดัชนีสำหรับการจัดเรียงโมดูล โมดูลที่มีดัชนีการจัดเรียงต่ำกว่าจะแสดงก่อนโมดูลที่มีดัชนีการจัดเรียงสูงกว่า หากไม่ได้ระบุ ระบบจะถือว่าดัชนีการจัดเรียงเป็น INT_MAX สำหรับ 2 โมดูลที่มีดัชนีเดียวกัน ระบบจะไม่กำหนดลักษณะการจัดเรียง

ตัวอย่าง ValueAddedModuleData:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

ลักษณะการทำงานที่คาดไว้

หลังจากอัปเดตออบเจ็กต์และ/หรือคลาสเรียบร้อยแล้ว คุณจะเห็นโมดูลในบัตรที่เกี่ยวข้อง หากเพิ่มโมดูลเพียงโมดูลเดียว คุณจะเห็นโมดูลดังกล่าวที่ด้านหน้าของบัตร

หลักเกณฑ์เกี่ยวกับโมดูลโอกาสที่มีมูลค่าเพิ่ม

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

  • ควรกำหนดโมดูลด้วยภาษาที่เหมาะสมเพื่อระบุว่าโมดูลดังกล่าวดำเนินการได้เพื่อช่วยให้ ผู้ใช้เข้าใจว่าโมดูลเหล่านี้คลิกได้
  • โมดูลควรมีภาพที่เหมาะสมซึ่งเกี่ยวข้องกับโมดูลนั้นๆ
  • คุณควบคุมโมดูลได้และควรจัดการการจัดลําดับความสําคัญของโมดูลอย่างต่อเนื่อง โดยขึ้นอยู่กับความสําคัญและความเกี่ยวข้อง
  • คุณควรแสดงเฉพาะโมดูลที่ใช้งานอยู่แก่ผู้ใช้ คุณควบคุมได้โดยการตั้งค่า displayInterval ในโมดูล หรือเพิ่มหรือนำออกจากคลาสหรือออบเจ็กต์ล่วงหน้า

การจัดการข้อยกเว้น

ข้อความ เหตุผล
ValueAddedModuleData ต้องมีส่วนหัว ValueAddedModuleData ไม่มีส่วนหัว
ValueAddedModuleData ต้องมี URI ที่ไม่ว่างเปล่า ValueAddedModuleData ไม่มี URI ที่ไม่ใช่ค่าว่าง
อนุญาตให้มีโมดูลเพิ่มมูลค่าได้สูงสุด 15 โมดูลต่อชั้นเรียน ต้องลดโมดูลที่มีการเพิ่มมูลค่าในชั้นเรียน
อนุญาตให้ใช้โมดูลเพิ่มมูลค่าได้สูงสุด 15 โมดูลต่อออบเจ็กต์ ต้องลดโมดูลที่มีการเพิ่มมูลค่าในออบเจ็กต์