Opportunità con valore aggiunto

Sfondo

Ora puoi aggiornare oggetti e classi per includere moduli di opportunità a valore aggiunto. I moduli verranno visualizzati nella pagina dei dettagli e potranno includere link ai contenuti dell'emittente. Questo documento illustra i passaggi chiave necessari per attivare e utilizzare i moduli utilizzando l'API Google Wallet.

Esempio di funzionalità

Esempio singolo del modulo Valore opportunità Esempio di elenco di moduli di Opportunità di valore
Visualizzazione singola Visualizzazione elenco

La guida che segue presuppone che tu abbia familiarità con i concetti di base di Google Wallet e che abbia già completato i prerequisiti consigliati. Invia eventuali domande o feedback al tuo PDC di Google Wallet.

Passaggi per l'integrazione

Per aggiungere un nuovo modulo, devi aggiornare l'oggetto e/o la classe in modo da includere ValueAddedModuleData. ValueAddedModuleData contiene i seguenti campi:

[Obbligatorio] Intestazione LocalizedString

L'intestazione visualizzata nel modulo. Il limite di caratteri è 60 e le stringhe più lunghe verranno troncate. Esempio di intestazione Opportunità di valore

Corpo LocalizedString

Il corpo visualizzato nel modulo. Il limite di caratteri è 50 e le stringhe più lunghe verranno troncate.
Esempio di corpo dell'opportunità di valore

Immagine immagine

L'immagine visualizzata nel modulo. Le proporzioni consigliate sono 1:1 e le immagini verranno ridimensionate per adattarsi a queste proporzioni.
Esempio di immagine di opportunità di valore

[Obbligatorio] stringa uri

L'URI a cui rimanda il modulo quando viene fatto clic. Può essere un link web o un link diretto.

ViewConstraints diModuleViewConstraints

Restrizioni che devono essere soddisfatte affinché il modulo venga visualizzato. ModuleViewConstraints ha il seguente campo:

TimeInterval displayInterval

Il periodo di tempo durante il quale il modulo verrà mostrato agli utenti. Può essere definito sia un valore "startTime" sia un valore "endTime". Il modulo viene visualizzato immediatamente dopo l'inserimento, a meno che non sia impostato un valore "startTime". Il modulo viene visualizzato a tempo indeterminato se "endTime" non è impostato.

int32 sortIndex

L'indice per ordinare i moduli. I moduli con un indice di ordinamento inferiore vengono visualizzati prima di quelli con un indice di ordinamento più elevato. Se non specificato, si presume che l'indice di ordinamento sia INT_MAX. Per due moduli con lo stesso indice, il comportamento di ordinamento non è definito.

Esempio di valore aggiuntoModuleData:

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

Comportamento previsto

Dopo aver aggiornato correttamente l'oggetto e/o la classe, ora vedrai i moduli nel passaggio corrispondente. Se hai aggiunto un solo modulo, lo vedrai sulla parte anteriore della tessera.

Linee guida sui moduli di opportunità a valore aggiunto

I moduli ti consentono di migliorare l'esperienza degli utenti con la tessera con azioni aggiuntive. Quando crei e gestisci i moduli, tieni presente quanto segue:

  • I moduli devono essere definiti con un linguaggio appropriato per indicare che sono attivabili e aiutare gli utenti a capire che sono cliccabili.
  • I moduli devono avere le immagini appropriate correlate al modulo specifico.
  • Hai il controllo dei moduli e devi gestire in modo proattivo la loro priorità in base all'importanza e alla pertinenza.
  • Devi mostrare agli utenti solo i moduli attivi. Puoi controllarlo impostando il valore displayInterval sul modulo o aggiungendolo o rimuovendolo in modo proattivo dalla classe o dall'oggetto.

Gestione delle eccezioni

Messaggio Motivo
ValueAddedModuleData deve contenere un'intestazione. ValueAddedModuleData non ha un'intestazione.
Valore aggiuntoModuleData deve contenere un URI non vuoto. ValueAddedModuleData non ha un URI non vuoto.
Per corso sono consentiti un massimo di 10 moduli con valore aggiunto. Necessità di ridurre il valore aggiunto dei moduli del corso.
Per oggetto sono consentiti al massimo 10 moduli con valore aggiunto. È necessario ridurre i moduli con valore aggiunto nell'oggetto.