Możliwości zwiększenia wartości

Tło

Możesz teraz aktualizować obiekty i klasy, aby uwzględnić moduły możliwości dodanej wartości. Będą one wyświetlane na stronie z informacjami i mogą zawierać link do treści wydawcy. Ten dokument zawiera opis najważniejszych kroków wymaganych do włączenia i używania modułów za pomocą interfejsu Google Wallet API.

Uwaga: w przypadku kart podarunkowych, kart lojalnościowych i ofert obsługujemy też automatyczną integrację z Merchant Center Zakupów Google.

Przykład funkcji

Widok pojedynczy	Widok listy

W tym przewodniku zakładamy, że znasz już podstawowe pojęcia związane z Portfelem Google i masz już za sobą wszystkie zalecane wymagania wstępne. Pytania i opinie możesz przesyłać do osoby kontaktowej ds. Portfela Google.

Etapy integracji

Aby dodać nowy moduł, musisz zaktualizować obiekt lub klasę, aby uwzględnić ValueAddedModuleData. Wartość dodana modułu zawiera te pola:

[Wymagany] Nagłówek LocalizedString

Nagłówek wyświetlany w module. Limit znaków wynosi 60, a dłuższe ciągi zostaną obcięte.

Tekst lokalizacji

Treść wyświetlana w module. Limit znaków wynosi 50, a dłuższe ciągi zostaną obcięte.

Image image

Obraz wyświetlany w module. Zalecany współczynnik proporcji obrazu to 1:1. Rozmiar obrazów zostanie odpowiednio zmieniony, aby pasowały do tego współczynnika.

[Required] URI ciągu

Identyfikator URI, do którego prowadzi moduł po kliknięciu. Może to być link internetowy lub precyzyjny link.

ModuleViewConstraints viewConstraints

Ograniczenia, które muszą być spełnione, aby moduł się wyświetlił. ModuleViewConstraints ma to pole:

TimeInterval displayInterval

Okres, przez jaki moduł będzie wyświetlany użytkownikom. Możesz zdefiniować zarówno parametr „startTime”, jak i „endTime”. Moduł wyświetla się natychmiast po wstawieniu, chyba że ustawisz parametr „startTime”. Jeśli nie ustawisz parametru endTime, moduł będzie wyświetlany bezterminowo.

int32 sortIndex

Indeks sortowania modułów. Moduly o niższym indeksie sortowania są wyświetlane przed modułami o wyższym indeksie sortowania. Jeśli nie jest określony, przyjmuje się indeks sortowania równy INT_MAX. W przypadku 2 modułów o tym samym indeksie działanie sortowania jest niezdefiniowane.

Przykład 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"
      }
    ]
  }

Uwaga: do obiektu możesz dodać maksymalnie 10 modułów, a do klasy maksymalnie 10 modułów. Na karcie będzie jednak wyświetlanych maksymalnie 10 modułów. Uwzględnimy tylko te moduły, które nie spełniają ograniczeń widoczności.

Oczekiwane działanie

Po zaktualizowaniu obiektu lub klasy zobaczysz moduły na odpowiednim przejściu. Jeśli dodasz tylko jeden moduł, zobaczysz go na przedniej stronie karty.

Wytyczne dotyczące modułów możliwości z dodatkową wartością

Dzięki modułom możesz wzbogacić wrażenia użytkownika związane z kartą, dodając dodatkowe działania. Podczas tworzenia modułów i zarządzania nimi weź pod uwagę te kwestie:

• Moduły powinny być zdefiniowane w odpowiednim języku, aby ułatwić użytkownikom zrozumienie, że można je kliknąć.
• Moduł powinien mieć zdefiniowane odpowiednie obrazy powiązane z danym modułem.
• Masz kontrolę nad modułami i powinnaś aktywnie zarządzać ich priorytetami w zależności od ich znaczenia i trafności.
• Należy wyświetlać tylko aktywne moduły użytkowników. Możesz to kontrolować, ustawiając parametr displayInterval w module lub dodając go do klasy lub obiektu albo usuwając z nich.

Obsługa wyjątków

Wiadomość	Uzasadnienie
Wartość dodana ModuleData musi zawierać nagłówek.	Wartość dodana ModuleData nie ma nagłówka.
Wartość ValueAddedModuleData musi zawierać niepusty identyfikator URI.	Wartość dodana modułu nie ma niepustego identyfikatora URI.
Na zajęciach można użyć maksymalnie 10 modułów z dodatkową wartością.	Muszę zmniejszyć liczbę modułów z wartością dodaną w klasie.
Na obiekt można umieścić maksymalnie 10 modułów wartości dodanej.	Musisz zmniejszyć wartość dodaną modułów obiektu.