使用查询参数

您可以通过在网站链接中使用查询参数来让用户快速访问网页商城的功能，例如在社交媒体或群发邮件中推广某个页面。这样的链接可以自动在网站上认证用户身份或将其跳转到具体商品的购买界面。

通过使用查询参数，您可以配置以下点击链接时进行的操作：

• 通过用户ID或深度链接自动认证用户身份。
• 跳转到具体商品的卡片。如用户已登录网站，将自动前往商品购买界面。
• 打开商品或订阅购买的支付UI。通过此链接，用户将自动登录网站。
• 自动对目录商品应用促销码或兑换优惠券奖励。

您可以在一个链接中使用多个参数，从而组合多项功能。

设置身份认证

通过用户ID进行授权

使用包含自动用户授权查询参数的链接前往网站。此方案适用于网站设置了通过用户ID进行授权的情况。

要通过用户ID来自动认证用户身份：

1. 复制网站的链接。
2. 在链接末尾添加?user-id=<user_ID>，其中<user_ID>是对其发送链接的用户ID。

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

3. 向用户发送单独链接。

用户点击链接后将跳转到该网站并自动认证。

通过深度链接进行授权

使用包含自动用户授权查询参数的链接前往网站。此方案适用于网站设置了通过深度链接进行认证的情况。

要通过深度链接来自动认证用户身份：

1. 复制网站的链接。
2. 在链接末尾添加?deeplink=true。

• 示例：https://webshop-external-demo.xsolla.site/?deeplink=true

3. 在公开资料中分享该链接或向用户发送单独链接。

用户点击链接后将跳转到该网站并自动认证。

设置跳转到商品卡片

使用包含查询参数的链接在打开网站时直接将用户跳转到指定商品。对于未授权用户，将打开查询参数所指定商品的信息卡片。如用户已登录网站，点击链接后将打开商品购买的支付界面。

要将用户跳转至指定商品：

1. 复制网站链接。
2. 在链接末尾添加?purchase-sku=<item_SKU>，其中<item_SKU>是目标商品的SKU。

• 要查找商品的SKU（以虚拟物品为例）：
  1. 在发布商帐户中打开您的项目，然后前往商品目录 > 虚拟物品部分。
  2. 前往物品所属的物品组。
  3. 复制具体商品名称下方行中的SKU。
  示例：https://webshop-external-demo.xsolla.site/?purchase-sku=my-awesome-crystal

3. 在公开资料中分享该链接或向用户发送单独链接。

根据用户是否已在网站上认证了身份，用户点击链接后将跳转到网站上显示商品详细信息的商品卡片或跳转到购买该商品的支付界面。

设置跳转到商品购买界面

使用包含查询参数的链接在打开网站时将用户跳转到指定商品的购买支付UI。商品购买链接还会包含身份认证参数，让用户自动登录。

设置步骤：

1. 复制网站链接。
2. 在链接末尾添加身份认证参数：?user-id=<user_ID>或?deeplink=true。
3. 在身份认证参数后添加?purchase-sku=<item_SKU>，其中<item_SKU>是目标商品的SKU。

• 要查找商品的SKU（以虚拟物品为例）：
  1. 在发布商帐户中打开您的项目，然后前往商品目录 > 虚拟物品部分。
  2. 前往物品所属组。
  3. 复制具体商品名称下方行中的SKU。

• 实例：https://webshop-external-demo.xsolla.site/?user-id=12345&purchase-sku=my-awesome-crystal

4. 在公开资料中分享该链接或向用户发送单独链接。

设置跳转到订阅购买界面

使用包含查询参数的链接在打开网站时将用户跳转到指定订阅计划的购买支付UI。订阅购买链接还会包含身份认证参数，让用户自动登录。

要进行设置：

1. 复制网站链接。
2. 在链接末尾添加其中一个身份认证参数：?user-id=<user_ID>或?deeplink=true。
3. 在身份认证参数后添加&purchase-subscription=<plan_ID>，其中<plan_ID>是订阅计划ID。

1. 查找订阅计划ID：
   1. 在发布商帐户中打开您的项目并前往商品目录 > 订阅部分。
   2. 从所需订阅计划行中复制其名称上方的ID。

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

4. 在公开资料中分享该链接或向用户发送单独链接。

设置促销码或优惠券的应用

用户通过包含查询参数的链接来应用促销码或优惠券。优惠码可在前往网站后自动应用或通过点击兑换按钮来应用。您也可以在身份认证方式的链接中添加相关参数。要使用包含优惠码参数的链接，请在项目中设置促销码和优惠券。

1. 复制网站的链接。
2. 在链接末尾添加以下查询参数之一：
   • ?redeem-code=<promo_code> — 自动兑换优惠码。
   • ?insert-code=<promo_code> — 点击按钮进行兑换。

• 将<promo_code>替换为在发布商帐户中生成的或您自行设置的促销码或优惠券。

• 示例：https://xsolla.webshop.com/?redeem-code=promo777

• 如希望自动在网站上认证用户身份，请在链接的优惠码参数前添加以下身份认证参数之一：?user-id=<user_ID>或?deeplink=true。

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

3. 在公开资料中分享该链接或向用户发送单独链接。

用户点击链接后将跳转到网站，优惠码将自动激活或用户手动选择兑换优惠码。