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

ソーシャルメディアやメールキャンペーンでページを宣伝する際、ウェブサイトのリンクにクエリパラメータを使用することで、ユーザーはウェブショップの機能に素早くアクセスできるようになります。クエリパラメータを使用することで、ユーザーがリンクをクリックした際に実行される以下の操作を設定できます：

• ユーザーIDまたはディープリンクを利用した自動認証。
• 特定のアイテムのカードへリダイレクトします。ユーザーがすでにサイトにログインしている場合、そのままアイテムの購入に進みます。
• アイテムまたはサブスクリプションを購入するための決済UIを開きます。このリンクを使用すると、ユーザーはサイトに自動的にログインされます。
• IPアドレスから検出された国に関わらず、ユーザーの国情報を上書きします。.
• カタログにプロモーションコードを自動適用、または報酬付きクーポンを引き換えます。

認証のセットアップ

ユーザー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つも含まれています。

セットアップするには：

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つも含まれています。

セットアップするには：

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. リンクを公開資料で共有するか、ユーザーに個別に送信してください。

購入国の設定

purchase-countryクエリパラメータを含むリンクを利用すれば、ユーザーがウェブショップにアクセスする際に、国を強制的に指定することが可能です。このパラメータを使用すると、IPアドレスから自動検出される国情報に関わらず、チェックアウト時の国を固定できます。

設定方法：

1. ウェブサイトへのリンクをコピーします。
2. リンクの末尾に、以下の認証パラメータのいずれかを追加してください：?user-id=<user_ID>または?deeplink=true。
3. 認証パラメータ後、&purchase-sku=<ITEM_SKU>&purchase-country=<COUNTRY_CODE>を追加します。そこで：
   • <ITEM_SKU>はアイテムのSKU。
   • <COUNTRY_CODE>は、ISO 3166-1 alpha-2形式における2文字の国名コードです。このパラメータは、ウェブショップに表示される通貨、税金、および利用可能な決済方法に影響を与えます。

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

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

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

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

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

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

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

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

3. リンクを公開資料で共有するか、ユーザーに個別に送信してください。

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