Mehrwertpotenzial

Hintergrund

Sie können jetzt Objekte und Kurse aktualisieren, um Module mit zusätzlichen Informationen zu Angeboten hinzuzufügen. Die Module werden auf der Detailseite angezeigt und können mit Ausstellerinhalten verknüpft sein. In diesem Dokument werden die wichtigsten Schritte zum Aktivieren und Verwenden von Modulen mit der Google Wallet API erläutert.

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 der folgenden Anleitung wird davon ausgegangen, dass Sie mit den grundlegenden Konzepten von Google Wallet vertraut sind und die empfohlenen Voraussetzungen bereits erfüllt haben. Senden Sie Fragen oder Feedback an Ihren Google Wallet-POC.

Integrationsschritte

Wenn Sie ein neues Modul hinzufügen möchten, müssen Sie das Objekt und/oder die Klasse so aktualisieren, dass ValueAddedModuleData enthalten ist. ValueAddedModuleData enthält die folgenden Felder:

[Erforderlich] LocalizedString-Header

Die im Modul angezeigte Überschrift. Die Zeichenbeschränkung beträgt 60 Zeichen. Längere Strings werden abgeschnitten.

LocalizedString body

Der im Modul angezeigte Textkörper. Die maximale Zeichenanzahl beträgt 50 und längere Strings werden abgeschnitten.

Bild

Das auf dem Modul angezeigte Bild. Das empfohlene Bildseitenverhältnis ist 1:1. Die Größe der Bilder wird entsprechend angepasst.

[Erforderlich] String-URI

Die URI, auf die das Modul beim Klicken führt. Dies 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. Es kann sowohl ein „startTime“ als auch ein „endTime“ definiert werden. Das Modul wird sofort nach dem Einfügen angezeigt, es sei denn, ein „startTime“ ist festgelegt. 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 Sortierfeld angegeben ist, wird INT_MAX angenommen. 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 bis zu zehn Module und in der Klasse bis zu zehn Module hinzufügen. Auf der Karte/dem Ticket werden jedoch maximal zehn Module angezeigt. Wir priorisieren die Module aus dem Objekt und filtern diejenigen heraus, die die Einschränkungen der Ansicht nicht erfüllen.

Erwartetes Verhalten

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

Richtlinien für Module mit Mehrwert

Module bieten Ihnen die Möglichkeit, das Karten-/Ticketerlebnis der Nutzer durch zusätzliche Aktionen zu verbessern. Beachten Sie beim Erstellen und Verwalten der Module Folgendes:

• Die Module sollten mit einer geeigneten Sprache definiert werden, die darauf hinweist, dass sie umsetzbar sind, damit Nutzer verstehen, dass diese Module anklickbar sind.
• 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 der Module je nach Wichtigkeit und Relevanz proaktiv verwalten.
• Sie sollten nur aktive Nutzermodule anzeigen. Sie können dies steuern, indem Sie das Attribut „displayInterval“ für das Modul festlegen oder es proaktiv der Klasse oder dem Objekt hinzufügen oder daraus entfernen.

Ausnahmebehandlung

Botschaft	Grund
„ValueAddedModuleData“ muss einen Header enthalten.	ValueAddedModuleData hat keinen Header.
„ValueAddedModuleData“ muss einen nicht leeren URI enthalten.	ValueAddedModuleData weist keinen nicht leeren URI auf.
Pro Klasse sind maximal 10 Mehrwertmodule zulässig.	Die Anzahl der Module mit Mehrwert im Kurs muss reduziert werden.
Pro Objekt sind maximal zehn Zusatzmodule zulässig.	Die wertschöpfenden Module für das Objekt müssen reduziert werden.