Cơ hội gia tăng giá trị

Thông tin khái quát

Giờ đây, bạn có thể cập nhật các đối tượng và lớp để thêm các mô-đun cơ hội gia tăng giá trị. Các mô-đun sẽ xuất hiện trên trang thông tin chi tiết và có thể liên kết đến nội dung của đơn vị phát hành. Tài liệu này hướng dẫn các bước chính cần thiết để bật và sử dụng các mô-đun bằng Google Wallet API.

Ví dụ về tính năng


Chế độ xem đơn	Chế độ xem danh sách

Hướng dẫn sau đây giả định rằng bạn đã quen thuộc với các khái niệm cơ bản về Google Wallet và đã hoàn thành các điều kiện tiên quyết được đề xuất. Hãy gửi mọi câu hỏi hoặc ý kiến phản hồi cho đầu mối liên hệ của bạn tại Google Wallet.

Các bước tích hợp

Để thêm một mô-đun mới, bạn sẽ cần cập nhật đối tượng và/hoặc lớp để thêm ValueAddedModuleData. ValueAddedModuleData có các trường sau:

[Bắt buộc] Tiêu đề LocalizedString

Tiêu đề xuất hiện trên mô-đun. Giới hạn ký tự là 60 và các chuỗi dài hơn sẽ bị cắt bớt. Ví dụ về tiêu đề cơ hội về giá trị

Nội dung đã bản địa hoá

Nội dung hiển thị trên mô-đun. Giới hạn ký tự là 50 và các chuỗi dài hơn sẽ bị cắt ngắn.
Ví dụ về nội dung cơ hội về giá trị

Hình ảnh hình ảnh

Hình ảnh xuất hiện trên mô-đun. Tỷ lệ khung hình nên dùng cho hình ảnh là 1:1 và hình ảnh sẽ được đổi kích thước cho phù hợp với tỷ lệ này.
Ví dụ về hình ảnh cơ hội có giá trị

[Bắt buộc] uri chuỗi

URI mà mô-đun sẽ dẫn đến khi được nhấp vào. Đây có thể là một đường liên kết trên web hoặc một đường liên kết sâu.

ModuleViewConstraints viewConstraints

Các điều kiện ràng buộc mà bạn phải đáp ứng để mô-đun xuất hiện. ModuleViewConstraints có trường sau:

TimeInterval displayInterval

Khoảng thời gian mà người dùng sẽ nhìn thấy mô-đun. Có thể xác định cả "startTime" và "endTime". Mô-đun sẽ xuất hiện ngay sau khi được chèn, trừ phi bạn đặt "startTime". Mô-đun này sẽ hiển thị vô thời hạn nếu bạn không đặt "endTime".

int32 sortIndex

Chỉ mục để sắp xếp các mô-đun. Các mô-đun có chỉ mục sắp xếp thấp hơn sẽ xuất hiện trước các mô-đun có chỉ mục sắp xếp cao hơn. Nếu bạn không chỉ định, thì chỉ mục sắp xếp sẽ được giả định là INT_MAX. Đối với hai mô-đun có cùng chỉ mục, hành vi sắp xếp là không xác định.

Ví dụ về 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"
      }
    ]
  }

Hành vi dự kiến

Sau khi cập nhật thành công đối tượng và/hoặc lớp, bạn sẽ thấy các mô-đun trên thẻ tương ứng. Nếu chỉ thêm một mô-đun, bạn sẽ thấy mô-đun đó ở mặt trước của thẻ và vé.

Nguyên tắc về mô-đun cơ hội gia tăng giá trị

Các mô-đun là cơ hội để bạn tăng cường trải nghiệm thẻ và vé của người dùng bằng các thao tác bổ sung. Bạn nên cân nhắc những điều sau đây khi tạo và quản lý các mô-đun:

Bạn nên xác định các mô-đun bằng ngôn ngữ phù hợp để cho biết rằng người dùng có thể thực hiện hành động đối với các mô-đun này, giúp họ hiểu rằng họ có thể nhấp vào các mô-đun này.
Các mô-đun phải có hình ảnh phù hợp được xác định liên quan đến mô-đun cụ thể.
Bạn nắm quyền kiểm soát các mô-đun và phải chủ động quản lý mức độ ưu tiên của mô-đun tuỳ theo mức độ quan trọng và mức độ liên quan.
Bạn chỉ nên cho người dùng thấy những mô-đun đang hoạt động. Bạn có thể kiểm soát việc này bằng cách đặt displayInterval trên mô-đun hoặc chủ động thêm hoặc xoá mô-đun đó khỏi lớp hoặc đối tượng.

Xử lý ngoại lệ

Tin nhắn	Lý do
ValueAddedModuleData phải chứa một tiêu đề.	ValueAddedModuleData không có tiêu đề.
ValueAddedModuleData phải chứa một URI không trống.	ValueAddedModuleData không có URI không trống.
Mỗi lớp học được phép có tối đa 15 mô-đun giá trị gia tăng.	Cần giảm các mô-đun gia tăng giá trị trên lớp.
Mỗi đối tượng được phép có tối đa 15 mô-đun giá trị gia tăng.	Cần giảm các mô-đun giá trị gia tăng trên đối tượng.