Mehrwertpotenzial

Hintergrund

Sie können jetzt Objekte und Klassen aktualisieren, um Module für zusätzliche Funktionen einzubinden. Module werden auf der Detailseite angezeigt und können auf Inhalte des Ausstellers verweisen. 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, Kundenkarten 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. 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.

[Required] 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 aus dem Objektfilter und filtern diejenigen heraus, die die Ansichtseinschränkungen nicht erfüllen.

Erwartetes Verhalten

Nachdem Sie das Objekt und/oder die Klasse erfolgreich aktualisiert haben, werden auf der entsprechenden Karte/dem entsprechenden Ticket 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. Beachten Sie beim Erstellen und Verwalten der Module Folgendes:

• 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 sollte das entsprechende Bildmaterial definiert sein, das sich auf das jeweilige Modul bezieht.
• 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 präsentieren. Sie können dies steuern, indem Sie das „displayInterval“ für das Modul festlegen oder es proaktiv aus der Klasse oder dem Objekt hinzufügen oder 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 Kurs sind maximal 15 Module mit Mehrwert zulässig.	Die Anzahl der Module mit Mehrwert für den 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.