Mehrwertpotenzial

Hintergrund

Sie können jetzt Objekte und Klassen aktualisieren, um Module für zusätzliche Funktionen einzubinden. Module werden im unteren Bereich der Karte oder des Tickets angezeigt und können mit Inhalten des Ausstellers verknüpft werden. In diesem Dokument werden die wichtigsten Schritte beschrieben, die erforderlich sind, um Module mit der Google Wallet API zu aktivieren und zu verwenden.

Hinweis:Für Geschenkkarten, Treuepunktekarten und Angebote unterstützen wir auch eine automatische Integration mit dem Shopping Merchant Center.

Beispiel für eine Funktion

Einzelne Ansicht	Listenansicht

In diesem Leitfaden wird davon ausgegangen, dass Sie mit den grundlegenden Konzepten von Google Wallet vertraut sind und die empfohlenen Voraussetzungen bereits erfüllt haben. Senden Sie alle Fragen oder Feedback an Ihren Google Wallet-Ansprechpartner.

Integrationsschritte

Wenn Sie ein neues Modul hinzufügen möchten, müssen Sie das Objekt und/oder die Klasse aktualisieren, um ValueAddedModuleData einzuschließen. „ValueAddedModuleData“ hat die folgenden Felder:

[Erforderlich] LocalizedString-Header

Der Header, der im Modul angezeigt wird. Die Zeichenbeschränkung liegt bei 60 Zeichen. Längere Strings werden abgeschnitten.

LocalizedString-Text

Der im Modul angezeigte Text. Die Zeichenbeschränkung liegt bei 50. Längere Strings werden abgeschnitten.

Bild

Das Bild, das im Modul angezeigt wird. Das empfohlene Seitenverhältnis für Bilder ist 1:1. Bilder werden entsprechend angepasst.

[Erforderlich] string uri

Die URI, zu der das Modul führt, wenn darauf geklickt wird. Das kann ein Weblink oder ein Deeplink sein.

ModuleViewConstraints viewConstraints

Einschränkungen, die alle erfüllt sein müssen, damit das Modul angezeigt wird. „ModuleViewConstraints“ hat das folgende Feld:

TimeInterval displayInterval

Der Zeitraum, in dem das Modul Nutzern angezeigt wird. Sie können sowohl `startTime` als auch `endTime` definieren. Das Modul wird sofort nach dem Einfügen angezeigt, sofern keine `startTime` festgelegt ist. Das Modul wird auf unbestimmte Zeit angezeigt, wenn „endTime“ nicht festgelegt ist.

int32 sortIndex

Der Index zum Sortieren der Module. Module mit einem niedrigeren Sortierindex werden vor Modulen mit einem höheren Sortierindex angezeigt. Wenn kein Wert angegeben ist, wird angenommen, dass der Sortierindex INT_MAX ist. Bei zwei Modulen mit demselben Index ist das Sortierverhalten nicht definiert.

Beispiel für 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"
      }
    ]
  }

Hinweis:Sie können dem Objekt und der Klasse jeweils bis zu 15 Module hinzufügen. Auf der Karte oder dem Ticket werden jedoch maximal 15 Module angezeigt. Wir priorisieren die Module und filtern die Objekte heraus, die nicht den Ansichtseinschränkungen entsprechen.

Erwartetes Verhalten

Nachdem Sie das Objekt und/oder die Klasse erfolgreich aktualisiert haben, werden auf der entsprechenden Karte nun Module angezeigt. Wenn Sie nur ein Modul hinzugefügt haben, wird es auf der Vorderseite der Karte angezeigt.

Richtlinien für Value Added Opportunity-Module

Mit Modulen können Sie die Passnutzung durch Ihre Nutzer mit zusätzlichen Aktionen erweitern. Beim Erstellen und Verwalten der Module sollten Sie Folgendes beachten:

• Module sollten mit einer geeigneten Sprache definiert werden, um anzuzeigen, dass sie interaktiv sind. So können Nutzer erkennen, dass sie darauf klicken können.
• Für Module sollten die entsprechenden Bilder definiert sein, die sich auf das jeweilige Modul beziehen.
• Sie haben die Kontrolle über die Module und sollten die Priorisierung des Moduls je nach Wichtigkeit und Relevanz proaktiv verwalten.
• Sie sollten Nutzern nur aktive Module anzeigen. Sie können dies steuern, indem Sie das „displayInterval“ für das Modul festlegen oder es proaktiv der Klasse oder dem Objekt hinzufügen oder daraus entfernen.

Umgang mit Ausnahmen

Botschaft	Grund
„ValueAddedModuleData“ muss einen Header enthalten.	ValueAddedModuleData hat keinen Header.
ValueAddedModuleData muss einen nicht leeren URI enthalten.	ValueAddedModuleData hat keinen nicht leeren URI.
Pro Klasse sind maximal 15 Module mit Mehrwert zulässig.	Die Anzahl der Module mit Mehrwert im Kurs muss reduziert werden.
Pro Objekt sind maximal 15 Module mit Mehrwert zulässig.	Die Anzahl der Value-Added-Module für das Objekt muss reduziert werden.