Configurer les remises automatiques

Suivez ces instructions pour intégrer le jeton de prix.

Structure des jetons

Les jetons JWT contiennent deux objets JSON : l'en-tête et la charge utile.

En-tête

{

"alg": "ES256",

"typ": "JWT"

}

Les en-têtes des jetons générés par Google comportent deux champs :

• alg : algorithme utilisé. La valeur est toujours "ES256".
• typ : type de contenu. La valeur est toujours "JWT".

Si l'en-tête du jeton contient d'autres champs ou que les valeurs des champs diffèrent de celles décrites ci-dessus, le jeton doit être refusé.

Charge utile

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

La charge utile comprend les champs suivants :

• exp : délai d'expiration exprimé en heures Unix. Si le jeton a expiré, il doit être refusé.
• o : ID de l'offre. Il permet de vérifier si la page de destination correspond au produit ou à une variante valide. Si elle ne correspond pas, elle doit être refusée. Exemple de variante valide : une taille différente pour une paire de chaussures.
• m : ID du marchand. Si l'ID du marchand ne correspond pas, le jeton doit être refusé.
• p : prix avec les remises automatiques de Google.
• pp : prix précédent*.
  * Pour l'EEE : le prix précédent est également transmis via l'URL s'il est affiché dans l'annonce Shopping. Vous pouvez choisir d'afficher le prix précédent sur votre boutique en ligne. Le prix précédent correspond au prix le plus bas présenté aux utilisateurs sur Google au cours des 30 derniers jours dans les pays suivants : Croatie, Espagne, Lettonie, Norvège et Pologne. Pour tous les autres pays de l'EEE, le prix précédent correspond au prix avant l'application de réductions de prix consécutives au cours des 60 derniers jours.
• c : devise (en majuscules).

Intégration du jeton

Les informations exactes concernant l'intégration du jeton dépendent de la bibliothèque utilisée, mais à un niveau avancé, trois étapes sont nécessaires : décoder et valider les signatures, valider les champs et intégrer le prix.

Décodage et validation des signatures Le jeton encodé en Base64URL est transmis dans le paramètre de requête d'URL pv2 :

La plupart des bibliothèques regroupent le décodage et la validation des signatures en une seule fonction dans laquelle "token", "ES256" (algorithme) et "public key" constituent des entrées, et "token_body" est le résultat :

Clé publique de validation :

La clé ci-dessous est destinée à tous les utilisateurs des remises automatiques et n'expire pas.

Validation des champs

Si la bibliothèque sélectionnée accepte la clé et l'algorithme à l'étape précédente, et qu'elle impose leur utilisation malgré les options d'en-tête, il n'est pas nécessaire de procéder à d'autres vérifications des en-têtes. Dans le cas contraire, vous devez vous assurer que les champs d'en-tête respectent les consignes ci-dessus. Pour en savoir plus, consultez les bonnes pratiques courantes concernant les jetons Web JSON.

Quelle que soit la bibliothèque utilisée, les champs o, m et p doivent être validés en fonction des données du marchand. S'ils ne leur correspondent pas, le jeton doit être refusé afin que les clients ne puissent pas le copier sur tous les produits et/ou marchands. Le marchand peut vérifier le champ exp et refuser le jeton s'il a expiré, mais ce n'est pas obligatoire.

Intégration du prix Si tous les champs sont valides et que le jeton n'a pas expiré, le marchand doit utiliser le prix indiqué dans le champ p.

Vous pouvez utiliser la fonctionnalité du bon de réduction existante pour proposer une réduction sur le prix si celui-ci remplit les conditions indiquées sur cette page. Plus précisément, le prix affiché sur la page de destination doit correspondre à celui du jeton. Il ne suffit pas d'ajouter la remise sur la page de paiement.

Tests Une fois l'intégration terminée, elle est testée en trois étapes :

• Tests fonctionnels (effectués par le marchand)
• Validation des clés (par le marchand à l'aide du jeton fourni par Google)
• Tests de bout en bout (effectués par Google)

Tests fonctionnels Le moyen le plus simple d'effectuer les tests pendant et après le développement consiste à générer une paire de clés temporaire. Vous avez ainsi un contrôle total sur les jetons. Vous pouvez générer une paire de clés valide à l'aide de cette commande :

Les jetons peuvent être générés à l'aide de jwt.io ou d'outils similaires utilisant l'algorithme ES256.

Validation des clés Pour confirmer que les clés de production sont bien configurées, des jetons signés sont disponibles dans Merchant Center lors de l'intégration (exemples d'URL).