クエリパラメータを使用する

ウェブサイトリンクのクエリパラメータを使用して、ユーザにウェブショップ機能にすばやくアクセスできるようにできます。例えば、ソーシャルメディアや大量のメールでページを宣伝する場合などです。このようなリンクは、ウェブサイト上のユーザーを自動的に認証したり、特定のアイテムを購入するようにリダイレクトします。

クエリパラメータを使用して、リンクをクリックしたときに実行される以下のアクションを構成できます：

• ユーザーIDまたはディープリンクによる自動認証。
• 特定のアイテムのカードにリダイレクトする。ユーザーがすでにサイトにログインしている場合は、アイテムの購入に進みます。
• アイテムを購入するための決済インターフェイスを開く。このリンクを使用すると、ユーザーは自動的にサイトにログインします。
• カタログにプロモーションコードを自動的に適用したり、クーポンを報酬で引き換えます。

1つのリンクで複数のパラメータを使用することができ、複数の機能を組み合わせることができます。

認証のセットアップ

ユーザーIDによる認証

サイトへの移動時に自動ユーザー認証にクエリパラメータ付きのリンクを使用します。このオプションは、サイトがユーザーIDによる認証に設定されている場合に適しています。

ユーザーID経由でユーザーを自動的に認証するには：

1. サイトへのリンクをコピーします。
2. リンクの末尾に?user-id=<UserID>を追加します。<UserID>はリンクを送信するユーザー IDです。

例： https://webshop-external-demo.xsollasitebuilder.com/?user-id=12345

3. ユーザーに個別のリンクを送信します。

ユーザーがリンクをクリックすると、サイトにリダイレクトされ、自動的に認証されます。

ディープリンクによる認証

サイトへの移動時に自動ユーザー認証にクエリパラメータ付きのリンクを使用します。このオプションは、サイトがディープリンクによる認証に設定されている場合に適しています。

ディープリンク経由でユーザーを自動的に認証するには：

1. サイトへのリンクをコピーします。
2. リンクの末尾に、?deeplink=trueを追加します。

例： https://webshop-external-demo.xsollasitebuilder.com/?deeplink=true

3. 公開資料のリンクを共有するか、個々のユーザーに個別のリンクを送信します。

ユーザーがリンクをクリックすると、サイトにリダイレクトされ、自動的に認証されます。

アイテムカードへのトランジションの設定

クエリパラメータ付きのリンクを使用して、サイトを開いたときにユーザーを目的のアイテムに直接リダイレクトします。認証されていないユーザーの場合、クエリパラメータで指定されたアイテムに関する情報を含むカードが開かれます。ユーザーがすでにサイトにログインしている場合、リンクをクリックした後、アイテムを購入するための決済インターフェイスが開きます。

指定されたアイテムにユーザーを誘導するには：

1. サイトへのリンクをコピーします。
2. リンクの末尾に?purchase-sku=<item SKU>を追加します。<item SKU>は目的のアイテムのSKUです。

アイテムSKUを見つけるには（例として仮想アイテムを使用）：

1. パブリッシャーアカウントに移動します。
2. サイドメニューで、「ストア」をクリックします。
3. 「仮想アイテム」ブロックで、「構成」をクリックします。
4. アイテムが配置されているアイテムのグループに移動します。
5. 特定のアイテムの名前の下にある行からSKUをコピーします。

例：https://webshop-external-demo.xsollasitebuilder.com/?purchase-sku=giant

3. 公開資料のリンクを共有するか、個々のユーザーに個別のリンクを送信します。

ユーザーがリンクをクリックすると、アイテムに関する詳細情報が記載されたアイテムカードが表示されているウェブサイト、またはアイテムを購入するための決済インターフェイスに誘導されます。これは、ユーザーがサイトで認証されているかどうかによって異なります。

アイテム購入への移行のセットアップ

クエリパラメータ付きのリンクを使用して、サイトを開くときに特定の製品を購入するための決済インターフェイスにユーザーをリダイレクトします。アイテムを購入するリンクには、ユーザーが自動的にログインできるようにする認証パラメータの1つも含まれています。

セットアップするには：

1. ウェブサイトへのリンクをコピーします。
2. リンクの末尾に認証パラメータのいずれかを追加します：?user-id=<UserID>または?deeplink=true。
3. 認証パラメータの後に?purchase-sku=<item SKU>を追加します。<item SKU>はアイテムのSKUです。

アイテムSKUを見つけるには（例として仮想アイテムを使用）：

1. パブリッシャーアカウントに移動します。
2. サイドメニューで、「ストア」をクリックします。
3. 「仮想アイテム」ブロックで、「構成」をクリックします。
4. アイテムが配置されているアイテムのグループに移動します。
5. 特定のアイテムの名前の下にある行からSKUをコピーします。

例：https://webshop-external-demo.xsollasitebuilder.com/?user-id=12345&purchase-sku=giant

4. 公開資料のリンクを共有するか、個々のユーザーに個別のリンクを送信します。

プロモーションコードまたはクーポンのアプリケーションの設定

クエリパラメータを含むリンクを使用して、ユーザーによるプロモーションコードまたはクーポンを適用します。 コードは、ウェブサイトに移動した後に自動的に適用されるか、コードを引き換えるボタンをクリックすることで適用されます。また、いずれかの認証方法のリンクにパラメータを追加することもできます。コードパラメーター付きのリンクを使用するには、プロジェクトでプロモーションコードとクーポンを設定します。

コードを適用するには：

1. サイトへのリンクをコピーします。
2. リンクの末尾に、次のクエリパラメータのいずれかを追加します：
   • ?redeem-code=<promo code> – コードの自動引き換え用。
   • ?insert-code=<promo code> – ボタンをクリックして引き換え用。

<promo code>の代わりに、パブリッシャーアカウントで生成されたプロモーションコードまたはクーポン、または自分で設定したプロモーションコードまたはクーポンを指定してください。

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

サイトでユーザーを自動的に認証するには、リンク内のコードパラメータの前に認証パラメータの1つを追加します：?user-id=<UserID>または?deeplink=true。

例： https://webshop-external-demo.xsollasitebuilder.com/?user-id=12345&redeem-code=TESTCOUPON

3. 公開資料のリンクを共有するか、個々のユーザーに個別のリンクを送信します。

認証されたユーザーがリンクをクリックすると、サイトにリダイレクトされ、コードが自動的に有効になるか、ユーザーは手動でコードを引き換えるオプションがあります。

最終更新日: 2025年3月27日