Nastavení automatických slev

Pokud chcete implementovat cenový token, postupujte podle těchto pokynů.

Struktura tokenu

Tokeny JWT obsahují dva objekty JSON: záhlaví a datovou část.

Záhlaví

{

"alg": "ES256",

"typ": "JWT"

}

Záhlaví tokenu vygenerovaného Googlem mají dvě pole:

• alg – použitý algoritmus, hodnota je vždy „ES256“,
• typ – typ média, hodnota je vždy „JWT“.

Pokud záhlaví tokenu obsahuje další pole nebo jsou v polích jiné než výše uvedené hodnoty, je nutné token odmítnout.

Datová část

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

Datová část má tato pole:

• exp – čas vypršení platnosti je časová hodnota typu Unix. Pokud platnost tokenu vypršela, je nutné ho odmítnout.
• o - ID propagační nabídky se používá k ověření, jestli se vstupní stránka shoduje s produktem nebo platnou variantou. Pokud se vstupní stránka neshoduje s produktem nebo platnou variantou, musí být odmítnuta. Platná varianta může být jiná velikost stejných bot.
• m – číslo obchodníka. Pokud se číslo obchodníka neshoduje, je nutné token odmítnout.
• p – cena s automatickými slevami Google (GAD)
• pp – dřívější cena*
  *Pro EHP: Pokud je v reklamě v Nákupech uvedena dřívější cena, bude také předána v adrese URL. V internetovém obchodě můžete zobrazovat dřívější cenu. Dřívější cena představuje nejnižší cenu zobrazenou uživatelům na Googlu za posledních 30 dní v následujících zemích: Chorvatsko, Lotyšsko, Norsko, Polsko, Španělsko. Ve všech ostatních zemích EHP odráží dřívější cena cenu před uplatněním po sobě jdoucích snížení cen za posledních 60 dní.
• c – měna, velká písmena.

Využití tokenu

Přesná implementace tokenu závisí na použité knihovně, ale obecně existují tři kroky: dekódování a ověření podpisu, ověření pole a snížení ceny.

Dekódování a ověření podpisu Zakódovaný token Base64URL se předává v parametru požadavku na adresu URL pv2:

Většina knihoven kombinuje dekódování a ověření podpisu v jedné funkci, kde je token ES256 (algoritmus) a veřejný klíč vstup a dekódovaná část token_body je výstup:

Veřejný klíč k ověření

Následující klíč je určen k použití všemi uživateli automatických slev bez vypršení platnosti.

Ověření pole

Pokud vybraná knihovna v předchozím kroku klíč a algoritmus přijme a vynutí si jejich použití navzdory možnostem záhlaví, není nutné provádět žádné další kontroly záhlaví. V opačném případě je třeba pole záhlaví prověřit podle výše uvedených pokynů. Další informace najdete v doporučených postupech k webovému tokenu JSON.

Bez ohledu na to, jaká knihovna se používá, musí být pole o, m a p ověřena oproti údajům na straně obchodníka. Pokud se neshodují, musí být token odmítnut, aby zákazníci nemohli tokeny mezi jednotlivými produkty nebo obchodníky kopírovat. Obchodník může platnost pole exp zkontrolovat a odmítnout token, pokud už není platný, ale není to povinné.

Spotřební cena Pokud jsou všechna pole platná a vypršela platnost tokenu, musí obchodník použít cenu uvedenou v poli p.

Pokud cena splní požadavky uvedené na této stránce, mohou ji obchodníci snížit pomocí stávajících funkcí kuponů. S cenou v tokenu se musí shodovat zejména cena uvedená na vstupní stránce. Samotné přidání slevy na stránce placení nestačí.

Testování Po dokončení bude integrace otestována ve třech krocích:

• funkční test – provádí obchodník,
• ověření klíče – provádí obchodník pomocí tokenu od Googlu,
• komplexní konečný test – provádí Google.

Funkční testování Nejjednodušší způsob testování během vývoje a po něm je vygenerování dočasné dvojice klíčů. Díky tomu máte nad tokeny plnou kontrolu. Platnou dvojici klíčů vygenerujete tímto příkazem:

Tokeny je možné generovat pomocí jwt.io nebo podobných nástrojů s algoritmem ES256.

Ověření klíče Abychom ověřili, zda jsou produkční klíče správně nakonfigurovány, ve službě Merchant Center jsou při registraci k dispozici podepsané tokeny (ukázkové adresy URL).