Możliwości zwiększenia wartości

Tło

Możesz teraz aktualizować obiekty i klasy, aby uwzględniały moduły możliwości o wartości dodanej. Moduły będą wyświetlane na stronie z informacjami i mogą zawierać linki do treści wydawcy. W tym dokumencie znajdziesz najważniejsze kroki, które należy wykonać, aby włączyć i używać modułów za pomocą Google Wallet API.

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

Przykład funkcji

Widok pojedynczy	Widok listy

W tym przewodniku przyjęto założenie, że znasz podstawowe pojęcia związane z Portfelem Google i masz już za sobą zalecane wymagania wstępne. Wszelkie pytania i opinie możesz wysyłać do osoby kontaktowej w Portfelu Google.

Kroki integracji

Aby dodać nowy moduł, musisz zaktualizować obiekt lub klasę, aby uwzględnić ValueAddedModuleData. ValueAddedModuleData 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.

LocalizedString body

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

Obraz

Obraz wyświetlany w module. Zalecany format obrazu to 1:1, a rozmiar obrazów zostanie zmieniony, aby dopasować je do tego formatu.

[Wymagany] ciąg znaków uri

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

ModuleViewConstraints viewConstraints

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

TimeInterval displayInterval

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

int32 sortIndex

Indeks sortowania modułów. Moduły o niższym indeksie sortowania są wyświetlane przed modułami o wyższym indeksie sortowania. Jeśli wartość nie jest określona, przyjmuje się wartość równą INT_MAX. W przypadku dwóch 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 15 modułów, a do klasy – maksymalnie 15 modułów. Na karcie wyświetlanych będzie jednak maksymalnie 15 modułów. Najpierw wybierzemy moduły z filtrowania obiektów, odrzucając te, które nie spełniają ograniczeń widoku.

Oczekiwane zachowanie

Po zaktualizowaniu obiektu lub klasy w odpowiednim dokumencie zobaczysz moduły. Jeśli dodasz tylko 1 moduł, będzie on widoczny na przedniej stronie karty.

Wytyczne dotyczące modułów możliwości o wartości dodanej

Moduły to możliwości wzbogacenia karty użytkownika o 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 wskazywać, że można je kliknąć, i pomagać użytkownikom zrozumieć, że te moduły są klikalne.
• Moduły powinny zawierać odpowiednie obrazy powiązane z danym modułem.
• Masz kontrolę nad modułami i powinieneś(-aś) aktywnie zarządzać ich priorytetami w zależności od ich ważności i trafności.
• Użytkownikom należy wyświetlać tylko aktywne moduły. Możesz to kontrolować, ustawiając parametr displayInterval w module lub aktywnie dodając go do klasy lub obiektu albo usuwając z nich.

Obsługa wyjątków

Wiadomość	Uzasadnienie
Pole ValueAddedModuleData musi zawierać nagłówek.	ValueAddedModuleData nie ma nagłówka.
Pole ValueAddedModuleData musi zawierać niepusty identyfikator URI.	Element ValueAddedModuleData nie ma niepustego identyfikatora URI.
W przypadku każdych zajęć można użyć maksymalnie 15 modułów wartości dodanej.	Konieczne jest ograniczenie modułów wartości dodanej w klasie.
Maksymalna liczba modułów wartości dodanej na obiekt to 15.	Konieczność zmniejszenia liczby modułów o wartości dodanej w obiekcie.