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

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

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

• ユーザー 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. ウェブサイトへのリンクをコピーします。
2. リンクの最後に以下の認証パラメータを追加します：?user-id=<UserID>または?deeplink=true。
3. ここで、<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>の代わりに、アドミンページで生成されたプロモーションコードまたはクーポンを指定してください。
   サイトでユーザーを自動的に認証するには、以下のリンク内のコードパラメータの前に認証パラメータの1つを追加します：?user-id=<UserID>または?deeplink=true。
   例：https://webshop-external-demo.xsollasitebuilder.com/?user-id=12345&redeem-code=TESTCOUPON
3. 公開資料でリンクを共有するか、ユーザーに個別のリンクを送信します。

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

最終更新日: 2024年8月22日