紹介プログラム

紹介プログラムは、既存のユーザーが特別なリンクを介して友人をウェブショップに招待する、新しいユーザーを引き付ける方法です。その結果、プログラムの参加者全員が報酬を受け取り、ウェブショップとのやりとりを継続するロイヤルティとモチベーションが高まります。

紹介プログラムにより、インフルエンサーとクランリーダーは、自分とサブスクライバーの利益のためにウェブショップを宣伝することができます。招待された人は最初の購入に対して報酬を受け取るため、ウェブショップから購入するエンゲージメントの高いユーザーの数が増えます。

• 次の種類の1つまたは複数のアイテムを報酬として提供します。
  • 仮想通貨
  • 仮想アイテム
  • アイテムとのバンドル
• 紹介プログラムウィジェットのカスタマイズ。
• 紹介リンクの生成。
• 招待された人が初めて購入する前に、選択した紹介プログラムを変更する。

• プロジェクトには紹介プログラムが1つだけ存在できます。
• ユーザーは自分自身を招待できません。

ユーザー招待のフロー

1. 招待するユーザーがウェブショップに移動します。
2. 招待するユーザーがサイトにログインまたは登録します。
3. 招待するユーザーは、紹介プログラムウィジェットを開き、プログラムの条件を読み取ります。
4. 招待するユーザーは、ウィジェットに紹介リンクを取得します。
5. 招待された人は、招待されたユーザーとリンクを共有します。
6. 招待された人はリンクをたどり、プログラムの条件を満たします。
7. 招待するユーザーは紹介プログラムウィジェットを開き、ボタンをクリックして報酬を受け取ります。

招待された人のフロー

1. 招待された人には、プログラムの条件と報酬の説明が記載された紹介リンクが届きます。
2. 招待された人は、紹介リンクからウェブショップに移動します。
3. 招待された人はウェブショップに登録します。
4. 招待された人は、ウェブショップで最初の購入を行います。
5. 招待された人は報酬を受け取ります。

入手方法

紹介プログラムの作成

1. アドミンページでプロジェクトを開きます。
2. サイドメニューで「ストア」をクリックします。
3. Live-ops and promotion toolsペインで、以下をクリックします：
   • 接続する - プロモーションまたは報酬を持っていない場合。
   • 構成する - プロモーションまたは報酬を接続したことがある場合。

4. 「紹介プログラム」タブで「紹介プログラムを作成」をクリックします。
5. 必要なパラメータを設定します：
   • 紹介プログラムの名前を指定します
   • 説明を入力します

6. 「次へ」をクリックします。
7. 招待したユーザーと招待された人が受け取る報酬を追加します：
   • 招待された人に報酬を追加するにはの「プレイヤーを招待した際の報酬」セクションで、アイテムのSKUとその数量を指定します。
   • 招待された人への報酬を追加するには、「招待された人への報酬」セクションで、アイテムのSKUとその数量を指定します。

8. 「次へ」をクリックします。
9. 紹介プログラムの説明を確認し、「作成」をクリックします。

10. 紹介プログラムを有効にするには、「紹介プログラムトグル」をオンの位置に設定します。

紹介プログラムの設定後、ウィジェットの作成とカスタマイズができます。

ウィジェットのセットアップ

1. 紹介プログラムのページで、「カスタマイザーに移動する」をクリックします。

2. 一連の状態のウィジェットコンポーネントを設定します。ウィジェットをゲームやサイトのデザインに一致させるために、ウィジェットをカスタマイズし、次の特性を構成できます：
   • インターフェース要素のセット
   • インターフェース要素の色
   • ローカライゼーションを考慮したボタンのテキストとヘッダー
   • フォントの種類、色、サイズ

ウィジェットの設定では、紹介プログラムのよくある質問ブロックの内容を、ゲームの詳細に合わせてカスタマイズすることもできます。

3. ローカリゼーションを設定します。すべてのウィジェットテキストは、「プロジェクト設定 > 一般設定 > プロジェクト言語」セクションのアドミンページで指定されたプロジェクト言語に翻訳されます。
   デフォルトの翻訳を変更するには、テキストを2回クリックし、独自の翻訳を入力します。
4. 「公開」をクリックします。
5. 開いたウィンドウでウィジェットコードをコピーして、ウェブサイトに追加します。

ウィジェットコードをサイトに追加すると、ウィジェットを開くボタンがページに表示されます。

サイトにウィジェットコードを追加する

1. アドミンページでプロジェクトを開きます。
2. サイドメニューで「サイトビルダー」をクリックします。
3. 「サイト」セクションで、サイトを選択し、「サイトビルダーを開く」をクリックします。
4. 「ブロックを追加」をクリックします。
5. 「カスタムコード」ブロックを選択します。
6. 紹介プログラムのウィジェットコードを追加します。

認証のセットアップ

独自のサイトインターフェースを使用する場合は、ユーザー認証の機能をウィジェットに実装する必要があります。

ウィジェットでの認証は、ウィジェットが埋め込まれているサイトでの認証を通じて行われます。

ユーザーが承認する場所（サイト上またはウィジェット内）に応じて、次の2つのシナリオがあります：

• ユーザーがサイト上で認証を行う場合は、onTokenChange()メソッドを使用して、ユーザーの認証トークンをウィジェットに渡す必要があります。ユーザーがシステムからログアウトするときに、メソッドパラメータとしてnullを渡します。

• ユーザーがウィジェットを通じて承認すると、ウィジェットは初期化中に渡されたrequestAuth関数を呼び出します。これに対して、サイトはユーザーの認証トークンを返す必要があります。

window.XESApi.init({
requestAuth: requestAuth,
token: getToken()
})

ウィジェットAPIには、ウィジェットでユーザーを認証するための一連の関数とメソッドが用意されています：

変更の方法

紹介プログラムの設定を変更する

• 報酬として提供されるアイテムのリストを変更する
• 説明を変更する

1. 作成された紹介プログラムに移動します。
2. 「編集」をクリックします。

3. テキストまたはアイテムSKUを更新します。
4. 「保存」をクリックします。

変更を保存すると、ユーザーは更新されたプログラムの条件を確認し、新しい報酬を受け取ります。

条件更新前にユーザーがすでに受け取っていた報酬は変更されません。

条件を更新した後、ウィジェットを再公開する必要はありません。

ウィジェット設定の変更を行う

1. ウィジェット設定に移動します。
2. 必要な変更を加えます。
3. 「公開」をクリックします。

ウィジェット状態

紹介プログラムウィジェットは、招待するまたは招待されたユーザー、ユーザーの認証ステータス、プログラム条件の達成など、ユーザーのタイプに応じて異なる状態を持つことができます。

ウィジェットコンポーネントのセットには、さまざまな状態のインターフェース要素が含まれています。ウィジェットを設定する時にコンポーネントを設定できます。

ウィジェットを開くためのボタン：

状態	説明	表示対象	編集可能なコンポーネント	画像
詳細を見る	ユーザーをプログラムに参加させる	プログラムにまだ参加していない認証ユーザー。	背景とテキストの色。ウィジェットのテキストを開くボタンと表示詳細ボタンのテキスト。
認証待ち	ウィジェットからログインする意欲を高める。	紹介リンクをたどった認証されていないユーザー。	背景とテキストの色。ボタンのテキスト。
初回購入を待っています	初回購入の意欲を高める。	紹介リンクをたどってサイトにログインしたユーザー。	背景とテキストの色。ボタンのテキスト。
報酬を受け取る	ユーザーに報酬を受け取る意欲を高める。	プログラムの条件を満たしている友達を招待し、報酬を受け取ることができます。	背景とテキストの色。ボタンのテキスト。
ウィジェットを閉じる	ウィジェットが開いて、ボタンが「×」アイコンに変わりました。	ウィジェットの詳細を開いた認証されたユーザー。	背景とテキストの色。ボタンの色。
デフォルト	ウィジェットが閉じています。	ウィジェットを閉じたユーザー。	背景とテキストの色。ボタンのテキスト。

招待するユーザーのウィジェットページ：

説明	表示対象	編集可能なコンポーネント	画像
紹介プログラムの詳細。 紹介リンクを送信するためのボタン。 ステータス付きの報酬のリスト： 請求済み — 招待されたユーザーへの報酬を受け取りました。 進行中 — 招待された人はサイトにログインしましたが、まだ購入していません。 請求 — 招待された人はサイトにログインし、最初の購入を行いました。招待するユーザーには報酬を受け取ることができます。	友達が紹介リンクをたどってサイトにログインした認証された招待するユーザー。	背景とテキストの色。ウィジェットのテキスト、ボタンのテキスト。
よくある質問のセクション	プログラム情報ボタンをクリックした認証された招待するユーザー。	質問のあるブロックの追加と削除。背景とテキストの色。質疑応答の内容です。

招待された人向けのウィジェットページ：

説明	表示対象	編集可能なコンポーネント	画像
ウィジェットのテキストは、サイトでの購入を促します。購入後、ユーザーにはボーナスの受け取りに関する通知が表示されます。	紹介リンクをフォローしてログインしたユーザー。	背景とテキストの色。ウィジェットのテキスト、ボタンのテキスト。