Utilisation des paramètres de requête

Lorsque vous faites la promotion d’une page sur les réseaux sociaux ou dans des campagnes par e-mail, vous pouvez ajouter des paramètres de requête au lien du site web pour permettre aux utilisateurs d’accéder directement aux fonctionnalités du Web Shop. Grâce à ces paramètres, vous pouvez définir les actions suivantes qui seront effectuées lorsqu’un utilisateur clique sur le lien :

• Authentification automatique via ID utilisateur ou lien profond.
• Redirection vers la carte d’un objet spécifique. Si l’utilisateur est déjà connecté au site, il procédera à l’achat de l’objet.
• Ouverture de l’interface de paiement pour l’achat d’un objet ou d’un abonnement. L’utilisateur sera également connecté automatiquement au site via ce lien.
• Remplacez le pays de l’utilisateur, quel que soit le pays détecté via son adresse IP.
• Application automatique d’un code promo au catalogue ou échange d’un coupon contre une récompense.

Configuration de l'autorisation

Autorisation par ID utilisateur

Utiliser un lien avec un paramètre de requête pour autoriser automatiquement l’utilisateur lors de sa navigation sur le site. Cette option convient si votre site est configuré pour l’authentification par ID utilisateur.

Pour authentifier automatiquement l’utilisateur par ID utilisateur :

1. Copiez le lien sur le site.
2. Ajoutez ?user-id=<user_ID> à la fin du lien, <user_ID> étant l’ID de l’utilisateur à qui vous envoyez le lien

• Exemple : https://webshop-external-demo.xsolla.site/?user-id=12345

3. Envoyez des liens individuels aux utilisateurs.

Lorsque l’utilisateur clique sur le lien, il est redirigé vers le site et authentifié automatiquement.

Autorisation par lien profond

Utiliser un lien avec un paramètre de requête pour autoriser automatiquement l’utilisateur lors de sa navigation sur le site. Cette option convient si votre site est configuré pour l’authentification par lien profond.

Pour authentifier automatiquement l’utilisateur via un lien profond :

1. Copiez le lien sur le site.
2. Ajoutez ?deeplink=true à la fin du lien.

• Exemple : https://webshop-external-demo.xsolla.site/?deeplink=true

3. Partagez le lien dans les documents publics ou envoyez des liens individuels aux utilisateurs.

Lorsque l’utilisateur clique sur le lien, il est redirigé vers le site et authentifié automatiquement.

Configuration de la transition vers une carte de bien

Utilisez un lien avec un paramètre de requête pour rediriger l’utilisateur directement vers l’objet souhaité à l’ouverture du site. Pour un utilisateur non autorisé, une carte contenant des informations sur l’objet spécifié s’ouvre. Si l’utilisateur est déjà connecté au site, après le clic sur le lien, l’interface de paiement s’affiche.

Pour diriger l’utilisateur vers un objet spécifique :

1. Copiez le lien vers le site.
2. Ajoutez ?purchase-sku=<item_SKU> à la fin du lien, <item_SKU> étant l’UGS de l’objet souhaité.

• Pour trouver l'UGS d'un objet (en prenant un objet virtuel comme exemple) :
  1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual item.
  2. Accédez au groupe d'objets contenant l'objet recherché.
  3. Copiez l'UGS affiché sur la ligne de l'objet, sous son nom.
  Exemple : https://webshop-external-demo.xsolla.site/?purchase-sku=my-awesome-crystal

3. Partagez le lien dans les documents publics ou envoyez des liens individuels aux utilisateurs.

Après avoir cliqué sur le lien, l’utilisateur est dirigé vers la carte de l’’ objet contenant des informations détaillées ou vers l’interface de paiement pour l’achat. La destination dépend de l’authentification de l’utilisateur sur le site.

Configuration de la transition vers l'achat d'un objet

Utilisez un lien avec des paramètres de requête pour rediriger l’utilisateur vers l’interface de paiement pour l’achat d’un objet spécifique dès l’ouverture du site. Le lien d’achat de l’objet inclut un paramètre d’autorisation, permettant à l’utilisateur de se connecter automatiquement.

Pour configurer :

1. Copiez le lien vers le site Web.
2. Ajoutez l’un des paramètres d’authentification à la fin du lien : ?user-id=<user_ID> ou ?deeplink=true.
3. Après le paramètre d’authentification, ajoutez ?purchase-sku=<item_SKU>, <item_SKU> étant l’UGS de l’objet.

• Pour trouver l'UGS d'un objet (en prenant un objet virtuel comme exemple) :
  1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items > Virtual item.
  2. Accédez au groupe d'objets contenant l'objet recherché.
  3. Copiez l'UGS affichée sur la ligne de l'objet, sous son nom.

• Exemple : https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=giant

4. Partagez le lien dans les documents publics ou envoyez des liens individuels aux utilisateurs.

Configuration de la transition vers l'achat d'un abonnement

Utilisez un lien avec des paramètres de requête pour rediriger l’utilisateur vers l’interface de paiement pour l’achat d’un abonnement spécifique dès l’ouverture du site. Le lien d’achat de l’abonnement inclut un paramètre d’autorisation, permettant à l’utilisateur de se connecter automatiquement.

Pour configurer :

1. Copiez le lien vers le site Web.
2. Ajoutez un des paramètres d’authentification à la fin du lien : ?user-id=<user_ID> ou ?deeplink=true.
3. Ajoutez &purchase-subscription=<plan_ID> après le paramètre d’authentification, <plan_ID> étant l’ID du plan d’abonnement.

1. Pour trouver l'ID du plan d'abonnement :
   1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Subscriptions.
   2. Copiez l'ID qui se trouve au-dessus du nom du plan d'abonnement concerné.

1. Exemple : https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-subscription=8Mp0MT9R

4. Partagez le lien dans des documents publics ou envoyez des liens individuels aux utilisateurs.

Configuration du pays d’achat

Utilisez un lien contenant le paramètre de requête purchase-country pour indiquer explicitement le pays de l’utilisateur lors de l’accès au Web Shop. Ce paramètre détermine le pays lors du paiement, quel que soit celui détecté automatiquement via l’adresse IP.

Pour le configurer :

1. Copiez le lien vers le site web.
2. Ajoutez l’un des paramètres d’authentification à la fin du lien : ?user-id=<user_ID> ou ?deeplink=true.
3. Après le paramètre d’authentification, ajoutez &purchase-sku=<ITEM_SKU>&purchase-country=<COUNTRY_CODE>, où :
   • <ITEM_SKU> est l’UGS de l’objet.
   • <COUNTRY_CODE> est le code pays à deux lettres au format ISO 3166-1 alpha-2. Ce paramètre influe sur la devise affichée, les taxes et les modes de paiement disponibles dans le Web Shop.

Exemple : https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=8Mp0MT9R&purchase-country=MY

Configuration de l'application d'un code promo ou d'un coupon

Utilisez un lien avec un paramètre de requête pour permettre à l’utilisateur d’appliquer un code promo ou un coupon. Le code peut être appliqué soit dès la navigation sur le site Web, soit en cliquant sur le bouton Redeem code. Vous pouvez ajouter des paramètres au lien pour l’authentification. Configurez les promo codes et coupons dans le projet pour utiliser cette fonction.

1. Copiez le lien sur le site.
2. Ajoutez l’un des paramètres de requête suivants à la fin du lien :
   • ?redeem-code=<promo_code> — pour l’échange automatique du code ;
   • ?insert-code=<promo_code> — pour l’échange après un clic sur le bouton.

• Au lieu de <promo_code>, spécifiez le code promo ou le coupon qui a été généré dans le Compte éditeur ou que vous avez défini vous-même.

• Exemple : https://xsolla.webshop.com/?redeem-code=promo777

• Si vous souhaitez que l'utilisateur soit automatiquement authentifié sur le site, ajoutez un des paramètres d'authentification avant le paramètre de code dans le lien : ?user-id=<user_ID> ou ?deeplink=true.

• Exemple : https://webshop-external-demo.xsolla.site/?user-id=12345&redeem-code=TESTCOUPON

3. Partagez le lien dans les documents publics ou envoyez des liens individuels aux utilisateurs.

Après avoir cliqué sur le lien, l’utilisateur sera dirigé vers le site. Le code sera alors activé automatiquement ou l’utilisateur pourra l’échanger manuellement.