引き換えアシスタント（Redemption Assist）

引き換えコードをワンクリックで識別し、ワンクリックで引き換え、繰り返しコピー＆ペーストする手間を省きます。

機能概要

引き換えコードの自動識別：ウェブページ上でテキストをクリック、選択、またはコピーすると、プラグインがそこから引き換えコードを識別しようとします。手動で一文字ずつ確認する必要はありません。
親切なポップアップ通知：引き換えコードの可能性があるものを検出すると、右下隅に小さな通知カードがポップアップ表示され、すぐに引き換えるかどうかを尋ねます。
スマートなアカウントマッチング：現在のページアドレスに基づいて、All API Hub から最も一致するサイトアカウントを自動的に検索します。自分でリストを探し回る必要はありません。
ワンクリックで引き換え完了：「自動引き換え」をクリックすると、プラグインがバックグラウンドでリクエストを送信し、通知バブルの形式で引き換え結果を表示します。
独立したスイッチ：設定で引き換えアシスタントを個別に有効/無効にできます。他の機能モジュールには影響しません。

使用前提

All API Hub に対応するサイトアカウントが既に存在すること：
- 少なくとも1つのアカウントが正常に利用でき、残高や権限に異常がないこと。
ページ上に実際に引き換えコードが存在すること：
- 一般的な形式には「今日の引き換えコード」「ギフトコード」「チェックインコード」などがあり、通常は32文字の組み合わせです。

使用チュートリアル

チュートリアル1：ゼロから引き換えアシスタントを設定する

少なくとも1つのターゲットサイトアカウントを追加する
- アカウント管理で引き換えコードを使用するサイトアカウントを追加し、正常にログインおよびアクセスできることを確認します。
引き換えアシスタントのスイッチをオンにする（デフォルトでオン）
- 「基本設定」ページで「引き換えアシスタント」をオンにし、他のデフォルト設定を維持するだけで正常に利用できます。
アカウントにカスタムチェックイン/引き換えアドレスを追加する（推奨）
- アカウント編集ページを開き、「カスタムチェックイン/引き換えアドレス」を見つけます。
- 普段直接アクセスする引き換えページのアドレスを入力してください。これにより、システムが現在のページとアカウントをより正確にマッチングしやすくなります。

上記のステップを完了すると、グローバルな引き換え補助機能を体験できます。

チュートリアル2：日常使用における典型的な引き換えフロー

引き換えコードを含むページを開く
- 例：イベント告知ページ、チェックイン報酬ページ、チャンネルメッセージなど。
- ページ上には通常、引き換えコードとして32文字の文字列が表示されます。
検出アクションをトリガーする
- 引き換えコードに対して以下のいずれかの操作を実行します。
  - マウスで引き換えコードをドラッグして選択する;
  - ショートカットキーを使用して引き換えコードをコピーする;
  - 一部のページでコピー可能な領域をクリックする。
右下隅の引き換えアシスタントの通知を確認する
- システムが引き換えコードの可能性があるものを識別すると、右下隅に通知カードがポップアップ表示され、匿名化された引き換えコードのプレビューが表示されます。
確認して自動引き換えを開始する
- カード内の「自動引き換え」をクリックします。
- プラグインは現在のページURLに基づいて、最も適切なアカウントを自動的に選択し、引き換えリクエストを送信します。
結果の通知を確認する
- 成功時：
  - 通常、「引き換え成功」および入金されたクォータなどの情報が表示されます。
- 失敗時：
  - 失敗原因（例：引き換えコードが無効、引き換えコードは既に使用済みなど）、または一般的な失敗通知が表示されます。

チュートリアル3：複数アカウントのシナリオで適切なアカウントを選択する方法

同じサイトに複数の利用可能なアカウントが存在する場合
- 引き換えアシスタントは、任意のアカウントを直接使用するのではなく、「アカウント選択」をポップアップ表示します。
ポップアップでアカウント情報を確認する
- アカウント名、サイトアドレス、メモなどの主要な情報が表示されます。
- アカウントが多い場合は、検索フィルターを利用してターゲットアカウントを素早く特定できます。
アカウントを選択して引き換えを確認する
- 最も適切なアカウントを選択した後、「確認」をクリックすると、システムは選択されたアカウントに対して実際の引き換え操作を実行します。

ワンクリック引き換えの成功率を高める方法

「自動引き換えを一度クリックするだけで完了」を目指す場合は、以下の2点を重点的に最適化してください。

よく使うアカウントにカスタムチェックイン/引き換えアドレスを設定する：
- アカウント編集ページで「カスタムチェックイン/引き換えアドレス」を見つけ、実際に引き換えに使用するページアドレスを入力します。
- これにより、システムがURLに基づいてアカウントをマッチングする際に、より正確になり、複数アカウントの曖昧さが減少します。

上記の条件を満たせば、ほとんどの場合、「自動引き換え」をクリックするだけで直接成功し、手動でアカウントを選択する必要はほとんどありません。

よくある質問

Q1：ページに引き換えコードがあるのに、通知がポップアップ表示されないのはなぜですか？

考えられる原因：

設定で「引き換えアシスタント」が有効になっていない;
引き換えコードに対して選択やコピーなどの操作を実行しておらず、プラグインがテキストを読み取る機会がなかった;
引き換えコードが標準の32文字の文字列ではない、または途中にスペースや特殊記号が含まれており識別できない;
ブラウザまたは他のプラグインがスクリプトの実行やクリップボードへのアクセスを制限している（例：極端なシークレットモード、一部のセキュリティプラグインによるブロック）。

推奨されるトラブルシューティング手順：

All API Hub の設定で「引き換えアシスタント」がオンになっていることを確認する;
アカウント管理で現在のサイトアカウントが追加されており、正常にアクセスできることを確認する;
常用デスクトップブラウザ（Chrome / Edge / Firefox）で再試行する;
それでも解決しない場合は、リポジトリのIssuesにサイトのスクリーンショットとデバッグ情報を添付してフィードバックしてください。

Q2：自動引き換えはアカウントのセキュリティに影響しますか？

引き換えアシスタントのロジックはローカルブラウザ内でのみ実行され、アカウント情報や引き換えコードを第三者サーバーにアップロードすることはありません。
すべてのAPIリクエストは、対応するアグリゲーションサイトに直接送信されます。
ブラウザ自身のパスワード管理やプライバシーモードなど、ブラウザのパスワードとプライバシー保護ポリシーと併用することをお勧めします。