Configura gli sconti automatici

Segui queste istruzioni per implementare il token del prezzo.

Struttura del token

I token JWT contengono due oggetti JSON: intestazione e payload.

Intestazione

{

"alg": "ES256",

"typ": "JWT"

}

Le intestazioni dei token generati da Google contengono due campi:

• alg: l'algoritmo utilizzato, il cui valore è sempre "ES256".
• typ: il tipo di media, il cui valore è sempre "JWT".

Se l'intestazione del token contiene altri campi o valori di campi diversi da quelli sopra descritti, il token deve essere rifiutato.

Payload

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

Il payload include i seguenti campi:

• exp: la scadenza espressa come tempo Unix. Se il token è scaduto, deve essere rifiutato.
• o: ID offerta, utilizzato per verificare se la pagina di destinazione corrisponde al prodotto o a una variante valida. Se la pagina di destinazione non corrisponde al prodotto o alla variante valida, deve essere rifiutata. Una variante valida può essere una taglia diversa delle stesse scarpe.
• m: l'ID commerciante. In presenza di incoerenze nell'ID commerciante, il token deve essere rifiutato.
• p: il prezzo di Google Automated Discounts (GAD).
• pp: il prezzo precedente.*
  * Per il SEE: il prezzo precedente verrà passato anche nell'URL se mostrato nell'annuncio Shopping. Puoi scegliere di mostrare il prezzo precedente nel tuo negozio online. Il prezzo precedente rappresenta il prezzo più basso mostrato agli utenti su Google negli ultimi 30 giorni nei seguenti paesi: Croazia, Lettonia, Norvegia, Polonia e Spagna. Per tutti gli altri paesi del SEE, il prezzo precedente riflette il prezzo prima dell'applicazione di riduzioni di prezzo consecutive negli ultimi 60 giorni.
• c: la valuta in lettere maiuscole.

Utilizzo del token

I dettagli esatti in merito all'utilizzo del token dipendono dalla libreria utilizzata. Tuttavia, in linea generale, sono necessari tre passaggi: decodifica e convalida della firma, convalida dei campi e utilizzo del prezzo.

Decodifica e convalida della firma Il token con codifica Base64URL viene passato nel parametro di richiesta dell'URL pv2:

La maggior parte delle librerie combina la decodifica e la convalida della firma in una singola funzione in cui "token", "ES256" (algoritmo) e "public_key" sono gli input, mentre "token_body" è l'output:

Chiave pubblica per la convalida

La seguente chiave è pensata per essere utilizzata da tutti gli utenti degli sconti automatici senza scadenza.

Convalida dei campi

Se la libreria selezionata accetta la chiave e l'algoritmo indicati nel passaggio precedente e ne forza l'utilizzo a prescindere dalle opzioni dell'intestazione, non sono necessari ulteriori controlli dell'intestazione. In caso contrario, i campi dell'intestazione dovranno essere controllati in base alle linee guida riportate sopra. Per saperne di più, consulta le best practice correnti per i token web JSON.

Indipendentemente dalla libreria utilizzata, i campi o, m e p devono essere convalidati in base ai dati del commerciante. In presenza di incoerenze, il token deve essere rifiutato per impedire ai clienti di copiare i token per più prodotti e/o commercianti. Il commerciante può verificare il campo exp e rifiutare il token se è scaduto, ma questa azione non è obbligatoria.

Utilizzo del prezzo Se tutti i campi sono validi e il token non è scaduto, il commerciante deve utilizzare il prezzo specificato nel campo p.

Puoi utilizzare la funzionalità dei coupon esistenti per scontare il prezzo, se quest'ultimo soddisfa i requisiti elencati in questa pagina. In particolare, il prezzo indicato nella pagina di destinazione deve corrispondere a quello specificato nel token. Non è sufficiente aggiungere lo sconto nella pagina di pagamento.

Test Una volta completata, l'integrazione verrà verificata in tre passaggi:

• Test funzionali eseguiti dal commerciante
• Convalida delle chiavi eseguita dal commerciante con il token fornito da Google
• Test completo end-to-end eseguito da Google

Test funzionale Il modo più semplice per eseguire test durante e dopo lo sviluppo è generare una coppia di chiavi temporanea. In questo modo avrai il pieno controllo dei token. È possibile generare una coppia di chiavi valida con questo comando:

I token possono essere generati con jwt.io o strumenti simili utilizzando l'algoritmo ES256.

Convalida delle chiavi Per convalidare la corretta configurazione delle chiavi di produzione, i token firmati sono disponibili in Merchant Center durante le procedure di onboarding (URL di esempio).