Geautomatiseerde kortingen instellen

Volg deze instructies om het prijstoken te implementeren.

Tokenstructuur

JWT-tokens bevatten 2 JSON-objecten: header en payload.

Header

{

"alg": "ES256",

"typ": "JWT"

}

Door Google gegenereerde tokenheaders hebben 2 velden:

• alg: Het gebruikte algoritme, waarvan de waarde altijd 'ES256' is.
• typ: Het mediatype, waarvan de waarde altijd 'JWT' is.

Als de tokenheader nog andere velden bevat of de veldwaarden anders zijn dan hierboven wordt beschreven, moet het token worden afgewezen.

Payload

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

Payload heeft de volgende velden:

• exp: Vervaltijd in Unix-tijd. Als het token verlopen is, moet het worden afgewezen.
• o: Aanbieding-ID, die wordt gebruikt om te controleren of de landingspagina overeenkomt met het product of een geldige variant. Als de landingspagina niet overeenkomt met het product of de geldige variant, moet deze worden afgewezen. Een geldige variant kan een andere maat van hetzelfde paar schoenen zijn.
• m: De verkoper-ID. Als de verkoper-ID niet overeenkomt, moet het token worden afgewezen.
• p: De prijs met geautomatiseerde kortingen van Google.
• pp: Eerdere prijs*
  *Voor de EER: De eerdere prijs wordt ook doorgegeven in de URL als deze in de Shopping-advertentie wordt getoond. U kunt ervoor kiezen de eerdere prijs in uw online winkel te tonen. De vorige prijs is de laagste prijs die in de afgelopen 30 dagen aan gebruikers op Google is getoond in de volgende landen: Kroatië, Letland, Noorwegen, Polen en Spanje. Voor alle andere landen in de EER is de eerdere prijs de prijs vóór de toepassing van opeenvolgende prijsverlagingen in de afgelopen 60 dagen.
• c: De valuta, in hoofdletters.

Een token gebruiken

De exacte details over het gebruik van het token zijn afhankelijk van de gebruikte bibliotheek, maar op een geavanceerd niveau zijn er 3 stappen: decoderen en handtekeningvalidatie, veldvalidatie en verbruiksprijs.

Decoderen en handtekeningvalidatie Het token met Base64URL-codering wordt doorgegeven in een pv2 URL-verzoekparameter:

De meeste bibliotheken combineren het decoderen en de handtekeningvalidatie tot één functie, waarbij 'token', 'ES256' (algoritme) en 'public key' invoer zijn en 'token_body' de uitvoer is:

Openbare sleutel voor validatie:

De volgende sleutel is bedoeld voor gebruik zonder vervaldatum door alle gebruikers van geautomatiseerde kortingen.

Veldvalidatie

Als de geselecteerde bibliotheek de sleutel en het algoritme in de vorige stap heeft geaccepteerd en het gebruik ervan afdwingt ondanks de headeropties, zijn extra headercontroles niet nodig. Als dat niet het geval is, moeten de headervelden worden gecontroleerd aan de hand van de bovenstaande richtlijnen. Ga naar de praktische tips voor JSON Web Tokens voor meer informatie.

Welke bibliotheek er ook wordt gebruikt, de velden o, m en p moeten worden gevalideerd aan de hand van de gegevens van de verkoper. Als de velden niet overeenkomen met de gegevens, moet het token worden afgewezen zodat gebruikers geen tokens kunnen kopiëren naar andere producten en/of verkopers. De verkoper kan het veld exp controleren en het token afwijzen als het verlopen is, maar dit is niet verplicht.

Verbruiksprijs Als alle velden geldig zijn en het token niet is verlopen, moet de verkoper de prijs in het veld p gebruiken.

Gebruik de functionaliteit voor bestaande kortingsbonnen om korting te geven op de prijs als die voldoet aan de vereisten op deze pagina. De prijs op de landingspagina moet overeenkomen met de prijs in het token. Het is niet voldoende om de korting alleen toe te voegen aan de betaalpagina.

Testen Nadat de integratie is afgerond, wordt deze in 3 stappen getest:

• Functionaliteitstest (uitgevoerd door de verkoper)
• Sleutelvalidatie (uitgevoerd door de verkoper met het door Google verstrekte token)
• Volledige end-to-end-test (uitgevoerd door Google)

Functionele tests De makkelijkste manier om de integratie tijdens en na de ontwikkeling te testen, is door een tijdelijk sleutelpaar te genereren. Zo heeft u volledige controle over de tokens. Een geldig sleutelpaar kan worden gegenereerd met deze opdracht:

U kunt tokens genereren met jwt.io of vergelijkbare tools die ES256 als algoritme gebruiken.

Sleutelvalidatie Tijdens onboardings zijn er ondertekende tokens beschikbaar in Merchant Center (voorbeeld-URL's) om te controleren of productiesleutels correct zijn ingesteld.