Konfigurowanie rabatów automatycznych

Aby skorzystać z tokena ceny, postępuj zgodnie z tymi instrukcjami implementacji.

Struktura tokena

Tokeny JWT zawierają 2 obiekty JSON: nagłówek i ładunek.

Nagłówek

{

"alg": "ES256",

"typ": "JWT"

}

Nagłówki tokenów wygenerowanych przez Google mają 2 pola:

• alg – używany algorytm, którego wartość to zawsze „ES256”;
• typ – typ nośnika, którego wartość to zawsze „JWT”.

Jeśli nagłówek tokena zawiera jakiekolwiek inne pola lub wartości pól różnią się od opisanych powyżej, token należy odrzucić.

Ładunek

{
"exp": 1571673600,
"o": "tddy123uk",
"m": "140301646",
"p": 21.99,
"pp": 15.00,
"c": "PLN"
}

Ładunek zawiera następujące pola:

• exp – czas wygaśnięcia podany jako czas uniksowy. Po wygaśnięciu token należy odrzucić.
• o – identyfikator oferty używany do sprawdzenia, czy strona docelowa jest zgodna z produktem lub jego prawidłową wersją. Jeśli strona docelowa nie jest zgodna z produktem lub prawidłową wersją, musi zostać odrzucona. Prawidłowa wersja może obejmować inny rozmiar tych samych butów.
• m – identyfikator sprzedawcy. W przypadku niezgodności token musi zostać odrzucony.
• p – cena według rabatu automatycznego Google (GAD)
• pp – cena poprzednia*
  * W przypadku Europejskiego Obszaru Gospodarczego: poprzednia cena zostanie również przekazana w adresie URL, jeśli jest ona widoczna w reklamie produktowej. Możesz wyświetlać w sklepie internetowym poprzednią cenę. Poprzednia cena to najniższa cena wyświetlana użytkownikom w Google w ciągu ostatnich 30 dni w tych krajach: Chorwacja, Hiszpania, Łotwa, Norwegia, Polska. W przypadku wszystkich pozostałych krajów w EOG poprzednia cena odpowiada cenie sprzed zastosowania kolejnych obniżek cen w ciągu ostatnich 60 dni.
• c – waluta zapisana wielkimi literami.

Wykorzystanie tokena

Szczegóły dotyczące wykorzystania tokena zależą od używanej biblioteki, ale zasadniczo musisz wykonać 3 kroki: dekodowanie i weryfikację podpisu, weryfikację pola oraz zastosowanie ceny.

Dekodowanie i weryfikacja podpisu Token zakodowany w standardzie Base64URL jest przekazywany w parametrze żądania pv2 adresu URL:

Większość bibliotek łączy dekodowanie i weryfikację podpisu w ramach jednej funkcji, w której „token”, „ES256” (algorytm) i „klucz publiczny” to dane wejściowe, a „token_body” to dane wyjściowe:

Klucz publiczny do weryfikacji

Ten klucz ma być używany przez wszystkich użytkowników automatycznych rabatów bez daty ważności.

Weryfikowanie pola

Jeśli wybrana biblioteka akceptuje klucze i algorytmy w poprzednim kroku i wymusza ich użycie pomimo opcji nagłówka, dodatkowe sprawdzanie nagłówka nie jest konieczne. W przeciwnym razie należy sprawdzić pola nagłówka pod kątem powyższych wytycznych. Więcej informacji znajdziesz w sprawdzonych metodach dotyczących tokenów sieciowych JSON.

Niezależnie od używanej biblioteki, pola o, m i p muszą być porównane z danymi od strony sprzedawcy. Jeśli dane się różnią, token musi zostać odrzucony, aby klienci nie mogli kopiować tokenów produktów lub sprzedawców. Jeśli token wygaśnie, sprzedawca może zaznaczyć pole exp i go odrzucić, ale nie jest to obowiązkowe.

Wykorzystywanie ceny Jeśli wszystkie pola są prawidłowe, a token jest ważny, sprzedawca musi wykorzystać cenę podaną w polu p.

Możesz obniżyć cenę przy użyciu aktualnego kuponu, jeśli spełnia on wymagania wymienione na tej stronie. W szczególności cena na stronie docelowej musi odpowiadać cenie podanej w tokenie. Samo dodanie rabatu na stronie płatności nie wystarczy.

Testowanie Po zakończeniu integracji zostanie ona przetestowana w 3 krokach:

• testy funkcjonalne wykonywane przez sprzedawcę,
• weryfikacja klucza dokonywana przez sprzedawcę za pomocą tokena od Google,
• kompleksowy test wykonywany przez Google.

Testy funkcjonalne Najprostszym sposobem na testowanie w trakcie programowania i po nim jest wygenerowanie tymczasowej pary kluczy. Dzięki temu będziesz mieć pełną kontrolę nad tokenami. Prawidłową parę kluczy można wygenerować przy użyciu tego polecenia:

Tokeny można wygenerować na platformie jwt.io lub przy użyciu podobnego narzędzia wykorzystującego algorytm ES256.

Weryfikacja kluczy Aby można było sprawdzić, czy klucze produkcyjne są prawidłowo skonfigurowane, podpisane tokeny są dostępne w Merchant Center podczas procesu wprowadzania (przykładowe adresy URL).