Konfigurer automatiske rabatter

Følg denne vejledning for at implementere pristokenet.

Tokenstruktur

JWT-tokens indeholder to JSON-objekter: Header og nyttedata.

Header

{

"alg": "ES256",

"typ": "JWT"

}

Google-genererede tokenheadere har 2 felter:

• alg – brugt algoritme, værdien er altid "ES256"
• typ – medietype, værdien er altid "JWT"

Hvis tokenheaderen indeholder andre felter, eller feltværdierne er anderledes end beskrevet ovenfor, skal tokenet afvises.

Nyttedata

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

Nyttedata har følgende felter:

• exp – udløbstidspunkt som Unix-tid. Hvis tokenet er udløbet, skal det afvises.
• o – tilbuds-id, som bruges til at tjekke, om landingssiden matcher produktet eller en gyldig variant. Hvis landingssiden ikke matcher produktet eller en gyldig variant, skal landingssiden afvises. En gyldig variant kan f.eks. være en anden størrelse af de samme sko.
• m – sælger-id. Hvis sælger-id'et ikke matcher, skal tokenet afvises.
• p – pris fra Googles automatiske rabatter (GAD, Google Automated Discounts)
• pp – tidligere pris*
  *For EØS: Den tidligere pris overføres også i webadressen, hvis den vises i Shopping-annoncen. Du kan vælge at vise den tidligere pris i din netbutik. Den tidligere pris repræsenterer den laveste pris, der er blevet vist til brugere på Google inden for de seneste 30 dage i følgende lande: Kroatien, Letland, Norge, Polen og Spanien. For alle andre EØS-lande afspejler den tidligere pris prisen før anvendelsen af de seneste prisnedsættelser i løbet af de seneste 60 dage.
• c – valutaen angivet i store bogstaver

Pristoken

De nøjagtige oplysninger om, hvordan tokenet bruges, afhænger af det anvendte bibliotek. Generelt set er der 3 trin: afkodning og signaturvalidering, feltvalidering samt gældende pris.

Afkodning og signaturvalidering Tokenet med indkodningen Base64URL er overført til parameteren for pv2-webadresseanmodningen:

De fleste biblioteker kombinerer afkodning og signaturvalidering i en enkelt funktion, hvor "token", "ES256" (algoritme) og "offentlig nøgle" er input, og "token_body" er output:

Offentlig nøgle til validering:

Følgende nøgle er beregnet til at blive brugt af alle brugere med automatiske rabatter uden udløbsdato.

Feltvalidering

Hvis det valgte bibliotek accepterer nøgle og algoritme i det foregående trin og tvinger deres brug på trods af valgmuligheder for headere, er der ikke behov for yderligere tjek af headere. Ellers skal headerfelterne tjekkes i henhold til retningslinjerne ovenfor. Du kan få flere oplysninger ved at gennemgå JSON Web Token Best Current Practices (bedste praksis for JSON-webtokens).

Uanset hvilket bibliotek der bruges, skal felterne o, m og p valideres med data på sælgersiden. Hvis de ikke matcher, skal tokenet afvises, så kunderne ikke kan kopiere tokens på tværs af produkter og/eller sælgere. Sælgeren kan markere feltet exp og afvise tokenet, hvis det er udløbet, men dette ikke er obligatorisk.

Forbrugspris Hvis alle felterne er gyldige, og tokenet ikke er udløbet, skal sælgeren bruge den pris, der er angivet i feltet p.

Du kan bruge din eksisterende kuponfunktion til at give rabat på prisen, hvis den opfylder de krav, der er angivet på denne side. Prisen på landingssiden skal især matche prisen i tokenet. Det er ikke tilstrækkeligt at tilføje rabatten på betalingssiden.

Test Når integrationen er gennemført, testes den i 3 trin:

• Funktionstest – udføres af sælgeren
• Nøglevalidering – udføres af sælger med tokens leveret af Google
• Afsluttende end-to-end-test – udføres af Google

Funktionstest Den nemmeste måde at teste på under og efter udviklingen er ved at generere et midlertidigt nøglepar. Dette giver dig fuld kontrol over tokens. Via denne kommando kan du generere et gyldigt nøglepar:

Tokener kan genereres med jwt.io eller lignende værktøjer ved hjælp af ES256 som en algoritme.

Nøglevalidering Signerede tokens er tilgængelige i Merchant Center under onboardingen (eksempler på webadresser) for at validere, at produktionsnøgler er konfigureret korrekt.