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 w dolnej części karty i mogą zawierać linki do treści wydawcy. W tym dokumencie opisujemy 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 w Google Shopping.

Przykład funkcji

Widok pojedynczy	Widok listy

W tym przewodniku przyjęto założenie, że znasz podstawowe pojęcia dotyczące Portfela Google i masz już za sobą zalecane wymagania wstępne. Wszelkie pytania i opinie przesyłaj do osoby kontaktowej w Portfelu Google.

Kroki integracji

Aby dodać nowy moduł, musisz zaktualizować obiekt lub klasę, aby uwzględnić ValueAddedModuleData. ValueAddedModuleData ma 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 pasowały 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`. Jeśli parametr „endTime” nie jest ustawiony, moduł będzie wyświetlany bezterminowo.

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 może się jednak wyświetlać maksymalnie 15 modułów. Będziemy traktować priorytetowo 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 dokumentu.

Wytyczne dotyczące modułów 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
Element ValueAddedModuleData musi zawierać nagłówek.	Wartość ValueAddedModuleData nie ma nagłówka.
Pole ValueAddedModuleData musi zawierać niepusty identyfikator URI.	Element ValueAddedModuleData nie ma niepustego identyfikatora URI.
W ramach jednych zajęć można używać maksymalnie 15 modułów wartości dodanej.	Musisz ograniczyć moduły wartości dodanej w zajęciach.
W przypadku każdego obiektu dozwolonych jest maksymalnie 15 modułów wartości dodanej.	Konieczne jest zmniejszenie liczby modułów o wartości dodanej w obiekcie.