Peluang Bernilai Tambah

Latar belakang

Sekarang Anda dapat memperbarui objek dan class untuk menyertakan modul peluang nilai tambah. Modul akan ditampilkan di halaman detail dan dapat ditautkan ke konten penerbit. Dokumen ini menjelaskan langkah-langkah utama yang diperlukan untuk mengaktifkan dan menggunakan modul menggunakan Google Wallet API.

Contoh fitur


Tampilan tunggal	Tampilan daftar

Panduan berikut mengasumsikan bahwa Anda sudah memahami konsep dasar Google Wallet dan telah menyelesaikan prasyarat yang direkomendasikan. Kirim pertanyaan atau masukan apa pun kepada POC Google Wallet Anda.

Langkah-Langkah Integrasi

Untuk menambahkan modul baru, Anda harus memperbarui objek dan/atau class untuk menyertakan ValueAddedModuleData. ValueAddedModuleData memiliki kolom berikut:

[Wajib] Header LocalizedString

Header yang ditampilkan di modul. Batas karakternya adalah 60 dan string yang lebih panjang akan dipotong. Contoh Header Peluang Nilai

Isi LocalizedString

Isi yang ditampilkan di modul. Batas karakter adalah 50 dan string yang lebih panjang akan terpotong.
Contoh Isi Peluang Nilai

Gambar gambar

Gambar yang ditampilkan di modul. Rasio gambar yang direkomendasikan adalah 1:1 dan gambar akan diubah ukurannya agar sesuai dengan rasio ini.
Contoh Gambar Peluang Nilai

[Wajib] string uri

URI yang akan dituju modul saat diklik. Ini dapat berupa link web atau deep link..

ModuleViewConstraints viewConstraints

Batasan yang semuanya harus dipenuhi agar modul ditampilkan. ModuleViewConstraints memiliki kolom berikut:

TimeInterval displayInterval

Jangka waktu modul akan ditampilkan kepada pengguna. Dapat menentukan `startTime` dan `endTime`. Modul ditampilkan segera setelah penyisipan kecuali jika `startTime` ditetapkan. modul ditampilkan tanpa batas waktu jika `endTime` tidak disetel.

int32 sortIndex

Indeks untuk mengurutkan modul. Modul dengan indeks pengurutan yang lebih rendah ditampilkan sebelum modul dengan indeks pengurutan yang lebih tinggi. Jika tidak ditentukan, indeks pengurutan diasumsikan sebagai INT_MAX. Untuk dua modul dengan indeks yang sama, perilaku pengurutan tidak ditentukan.

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

Perilaku yang Diharapkan

Setelah berhasil memperbarui objek dan/atau class, Anda akan melihat modul di kartu yang sesuai. Jika Anda hanya menambahkan satu modul, Anda akan melihatnya di bagian depan kartu.

Panduan Modul Peluang Nilai Tambah

Modul adalah peluang bagi Anda untuk meningkatkan pengalaman kartu pengguna dengan tindakan tambahan. Anda harus mempertimbangkan hal berikut saat membuat dan mengelola modul:

Modul harus ditentukan dengan bahasa yang tepat untuk menunjukkan bahwa modul tersebut dapat ditindaklanjuti guna membantu pengguna memahami bahwa modul ini dapat diklik.
Modul harus memiliki gambar yang sesuai dan terkait dengan modul tertentu.
Anda memegang kendali atas modul dan harus secara proaktif mengelola prioritas modul bergantung pada kepentingan dan relevansinya.
Anda hanya boleh menampilkan modul yang aktif kepada pengguna. Anda dapat mengontrolnya dengan menetapkan displayInterval pada modul atau secara proaktif menambahkan atau menghapusnya dari class atau objek.

Penanganan pengecualian

Kirim pesan	Alasan
ValueAddedModuleData harus berisi header.	ValueAddedModuleData tidak memiliki header.
ValueAddedModuleData harus berisi URI yang tidak kosong.	ValueAddedModuleData tidak memiliki URI yang tidak kosong.
Maksimum 15 modul nilai tambah diizinkan per kelas.	Perlu mengurangi modul nilai tambah pada kelas.
Maksimal 15 modul nilai tambah diizinkan per objek.	Perlu mengurangi modul nilai tambah pada objek.