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 membahas langkah-langkah utama yang diperlukan untuk mengaktifkan dan menggunakan modul menggunakan Google Wallet API.

Contoh fitur

Contoh Tunggal Modul Peluang Nilai Contoh Daftar Modul Peluang Nilai
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 ke POC Google Wallet Anda.

Langkah-langkah Integrasi

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

[Wajib] Header LocalizedString

Header yang ditampilkan di modul. Batas karakter adalah 60 dan string yang lebih panjang akan terpotong. 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

Image image

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] uri string

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

ModuleViewConstraints viewConstraints

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

TimeInterval displayInterval

Periode 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.

Contoh 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 kini akan melihat modul pada kartu yang sesuai. Jika hanya menambahkan satu modul, Anda akan melihatnya di bagian depan kartu.

Panduan tentang Modul Peluang Nilai Tambah

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

  • Modul harus ditentukan dengan bahasa yang sesuai untuk menunjukkan bahwa modul tersebut dapat ditindaklanjuti guna membantu pengguna memahami bahwa modul ini dapat diklik.
  • Modul harus memiliki gambar yang sesuai yang ditentukan dan terkait dengan modul tertentu.
  • Anda mengontrol modul dan harus secara proaktif mengelola prioritas modul bergantung pada tingkat kepentingan dan relevansinya.
  • Anda hanya boleh menampilkan modul pengguna yang aktif. Anda dapat mengontrolnya dengan menetapkan displayInterval pada modul atau menambahkan atau menghapusnya secara proaktif 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 10 modul nilai tambah diizinkan per kelas. Perlu mengurangi modul nilai tambah di class.
Maksimum 10 modul nilai tambah diizinkan per objek. Perlu mengurangi modul nilai tambah pada objek.