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

ข้อมูลเบื้องต้น

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

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

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

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

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

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

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

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

เนื้อหา LocalizedString

ส่วนเนื้อหาที่แสดงในโมดูล จํานวนอักขระสูงสุดคือ 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 ที่ไม่ว่างเปล่า
อนุญาตให้มีโมดูลที่มีมูลค่าเพิ่มได้สูงสุด 10 รายการต่อชั้นเรียน ต้องลดโมดูลที่เพิ่มมูลค่าในชั้นเรียน
แต่ละออบเจ็กต์มีโมดูลที่มีมูลค่าเพิ่มได้สูงสุด 10 รายการ ต้องลดโมดูลที่มีมูลค่าเพิ่มในออบเจ็กต์