추천 프로그램

작동 방식

추천 프로그램은 기존 사용자가 추천 링크를 통해 다른 사람을 초대함으로써 신규 사용자를 유치하기 위해 고안된 도구입니다. 이 프로그램은 웹 사이트나 게임에 통합될 수 있습니다. 결과적으로, 모든 프로그램 참여자는 보상을 받게 됩니다:

• 초대받은 사용자는 첫 구매 이후 한 번만 보상을 받게 됩니다.
• 초대하는 사용자는 스토어에서 구매한 각 초대받은 사용자에 대해 보상을 받게 됩니다.

• 엑솔라 웹사이트 빌더를 사용하여 생성된 웹 사이트를 포함한 모든 웹 사이트
• 게임

추천 프로그램이 웹 사이트에서든 게임 내에서든 어디에서 사용되든, 그 작동 방식과 보상 조건은 동일하게 유지됩니다.

다음 시나리오에 대해 추천 프로그램 구성 가능:

• 인게임 아이템 판매 - 가상 아이템, 인게임 재화 패키지 및 번들
• 게임 키를 통한 게임 및 DLC 판매

• 다음 유형의 아이템 중 하나 또는 여러 개를 보상으로 제공합니다:
  • 인게임 재화
  • 가상 아이템
  • 아이템 번들
• 추천 프로그램 위젯 사용자 지정.
• 추천 링크 생성.
• 사용자가 첫 구매 전에 추천 프로그램을 변경할 수 있는 기능.

• 프로젝트에는 추천 프로그램이 하나만 있을 수 있습니다.
• 사용자는 자신을 초대할 수 없습니다.

사용자 절차

초대하는 사용자 절차

1. 사용자가 사이트나 게임에 로그인하거나 가입합니다.
2. 사용자가 추천 프로그램 위젯을 열고 프로그램 조건을 읽습니다.
3. 사용자는 위젯에서 추천 링크를 받게 됩니다.
4. 사용자가 추천 링크를 다른 사용자와 공유합니다.
5. 사용자가 추천 프로그램 위젯을 열고, 초대받은 사람이 추천 링크를 따라 프로그램 조건을 충족하면 보상을 받게 됩니다.

초대받은 사용자 절차

1. 사용자는 프로그램 조건 및 보상에 대한 설명이 포함된 추천 링크를 받게 됩니다.
2. 사용자가 추천 링크를 따라갑니다.
3. 사용자는 웹 사이트 또는 게임에 가입합니다.
4. 사용자가 처음 구매합니다.
5. 사용자가 보상을 받습니다.

설정 방법

추천 프로그램 생성

1. 관리자 페이지에서 프로젝트를 열고 LiveOps > 추천 프로그램 섹션으로 이동합니다.

2. 추천 프로그램 생성을 클릭합니다.
3. 필요한 매개 변수 설정:
   • 추천 프로그램 이름을 지정합니다.
   • 설명을 입력합니다.

4. 다음을 클릭합니다.
5. 사용자가 받을 보상을 추가하세요:

• 초대하는 사용자를 위한 보상을 추가하려면 초대하는 플레이어 보상 섹션에서 아이템 SKU와 수량을 지정하세요.

• 초대받은 사용자를 위한 보상을 추가하려면 초대받은 사용자 섹션에서 아이템 SKU와 수량을 지정하세요.

6. 다음을 클릭합니다.
7. 추천 프로그램에 대한 설정을 검하고 생성을 클릭합니다.

추천 프로그램 편집

현재 활성화된 추천 프로그램을 변경할 수 있습니다:

• 보상으로 제공되는 아이템 목록 변경
• 조건 변경

1. 생성된 추천 프로그램으로 이동합니다.
2. 편집을 클릭합니다.

3. 텍스트 및/또는 사용자 아이템 목록을 업데이트합니다.
4. 다음을 클릭합니다.
5. 추천 프로그램 설정을 검토한 후 생성을 클릭합니다.

편집된 추천 프로그램은 기본적으로 활성화되며 추천 프로그램 섹션에 표시됩니다. 변경 사항을 저장한 이후에는 사용자에게 업데이트된 프로그램 조건이 표시되고 새로운 보상이 지급됩니다.

조건 업데이트 전에 사용자가 이미 받은 보상은 변경되지 않습니다.

조건을 업데이트한 후 위젯을 다시 게시할 필요는 없습니다.

표시 방법

추천 프로그램은 위젯을 통해 표시됩니다. 사용자가 프로그램 조건을 확인하고 참여할 수 있도록 웹 사이트나 게임에 위젯을 추가하세요.

위젯 설정

1. 생성된 추천 프로그램 페이지에서, 사용자 지정 도구로 이동을 클릭합니다.

2. 개별 상태를 위한 위젯 구성 요소를 설정합니다. 위젯을 게임 및 사이트의 디자인과 일치하도록 만들려면 위젯을 사용자 지정하고 다음과 같은 기능을 구성할 수 있습니다:
   • UI 요소 집합
   • UI 요소의 색상
   • 현지화를 포함한 버튼 텍스트 및 헤더
   • 글꼴 유형, 색상 및 크기

3. 현지화를 설정합니다. 모든 위젯 텍스트는 프로젝트 설정 > 일반 설정 > 프로젝트 언어 섹션의 관리자 페이지에 지정된 프로젝트 언어로 번역됩니다. 기본 번역을 변경하려면 텍스트를 두 번 클릭하고 직접 입력하세요.
4. 변경 사항 게시
5. 열린 창에서 위젯 코드를 복사하여 웹 사이트에 추가합니다.

위젯을 게시한 후에도 언제든지 위젯 설정으로 돌아가 변경할 수 있습니다. 변경 사항을 적용하려면 위젯을 다시 게시하세요.

엑솔라 웹사이트 빌더를 통해 위젯 코드를 사이트에 추가

자체 사이트 인터페이스를 구현하는 경우 위젯 코드를 사이트 코드에 추가하세요. 엑솔라 웹사이트 빌더를 사용하는 경우 다음 단계를 따라 사이트에 추천 프로그램 위젯을 추가하세요:

1. 관리자 페이지에서 프로젝트를 열고 스토어프런트 > 웹 사이트 섹션으로 이동합니다.
2. 사이트 섹션에서 사이트를 선택하고 웹 사이트 빌더 열기를 클릭합니다.
3. 블록 추가를 클릭합니다.
4. 사용자 지정 코드 블록을 선택합니다.
5. 추천 프로그램 위젯 코드를 추가합니다.
6. 변경 사항을 적용하려면 웹 사이트를 게시하십시오:

1. 1. 웹사이트 빌더의 오른쪽 상단 모서리에서 게시를 클릭합니다.

1. 2. 게시하려는 페이지 옆의 확인란을 선택합니다.

1. 3. 웹 사이트가 게시 준비가 되었는지 확인한 후 게시를 클릭합니다.

게임이나 자신의 사이트에 통합

엑솔라 웹사이트 빌더 없이 생성한 게임이나 웹 사이트에 추천 프로그램을 통합하려면 다음 단계를 따르세요:

1. 위젯에서 직접 사용자 인증을 구현합니다. 추천 프로그램 위젯의 사용자 인증은 위젯이 임베드된 웹 사이트에서의 인증을 통해 수행됩니다. 사용자 인증 시나리오는 웹 사이트에서 하거나 위젯 내에서 하는 두 가지 시나리오가 있습니다:

1. • 사용자가 사이트에 로그인하는 경우 onTokenChange() 메서드를 사용하여 사용자의 인증 토큰을 위젯에 전달해야 합니다. 사용자가 시스템에서 로그아웃하면 메서드 매개 변수로 null을 전달합니다.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as 사용자
    participant WebShop as 웹샵 솔루션
    participant Widget as 위젯
    User ->> WebShop: 로그인
    activate WebShop
    WebShop ->> Widget: 토큰이 포함된 알림
    deactivate WebShop

1. • 사용자가 위젯을 통해 로그인한 경우 위젯은 초기화 시 전달된 requestAuth 함수를 호출합니다. 이에 대한 응답으로 사이트는 사용자의 인증 토큰을 반환해야 합니다.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as 사용자
    participant WebShop as 웹샵 솔루션
    participant Widget as 위젯
    User ->> Widget: 로그인
    activate Widget
    Widget ->> WebShop: 로그인 요청
    deactivate Widget
    activate WebShop
    WebShop ->> Widget: 토큰
    deactivate WebShop

위젯을 초기화하는 예시 코드:

1window.XESApi.init({
2requestAuth: requestAuth,
3token: getToken()
4})

2. 추천 데이터가 올바르게 전달되도록 하십시오.
3. 추천 프로그램 위젯 코드를 게임 또는 웹 사이트 인터페이스에 포함시킵니다.

위젯 API

위젯 API는 위젯에서 사용자를 인증하기 위한 일련의 함수와 메서드를 제공합니다:

위젯 상태

추천 프로그램 위젯은 사용자 유형(초대하는 사용자 또는 초대받은 사용자), 사용자의 인증 상태 및 프로그램 조건 충족 여부에 따라 상태가 다를 수 있습니다.

위젯 구성 요소 세트에는 다양한 상태에 대한 UI 요소가 포함되어 있습니다. 위젯 설정 시 구성 요소를 구성할 수 있습니다.

위젯을 여는 버튼:

상태	설명	표시 대상	편집할 수 있는 구성 요소	이미지
세부 정보 보기	사용자가 프로그램에 참여하도록 유도.	아직 프로그램에 참여하지 않은 인증된 사용자.	배경 및 텍스트 색상. 위젯 열기 버튼의 텍스트 및 세부 정보 보기 버튼 텍스트.
인증 대기 중	위젯을 통해 사용자가 로그인하도록 유도.	추천 링크를 따라간 승인되지 않은 사용자.	배경 및 텍스트 색상. 버튼 텍스트.
첫 구매 대기 중	사용자가 첫 구매를 하도록 유도.	추천 링크를 따라 사이트에 로그인한 사용자.	배경 및 텍스트 색상. 버튼 텍스트.
보상 받기	사용자가 보상을 수령하도록 유도.	친구가 프로그램 조건을 충족한 초대하는 사용자는 보상을 받을 수 있습니다.	배경 및 텍스트 색상. 버튼 텍스트.
위젯 닫기	위젯이 열리면 버튼은 × 아이콘으로 표시됩니다.	위젯을 연 승인된 사용자의 세부 정보입니다.	배경 및 텍스트 색상. 버튼 색상.
기본값	위젯이 닫힙니다.	위젯을 닫은 사용자.	배경 및 텍스트 색상. 버튼 텍스트.

초대하는 사용자를 위한 위젯 페이지:

설명	표시 대상	편집할 수 있는 구성 요소	이미지
추천 프로그램 세부 정보. 추천 링크 전송 버튼. 상태별 보상 목록: 청구됨 - 초대받은 사용자에 대한 보상을 받았습니다. 진행 중 - 초대받은 사용자가 사이트에 로그인했지만 아직 구매를 하지 않았습니다. 청구 - 초대받은 사용자가 사이트에 로그인하여 첫 번째 구매를 한 경우입니다. 초대하는 사용자는 보상을 받을 수 있습니다.	친구가 추천 링크를 따라 사이트에 로그인한 권한이 있는 초대 하는 사용자입니다.	배경 및 텍스트 색상. 위젯 텍스트, 버튼 텍스트.
FAQ 섹션	프로그램 정보 버튼을 클릭한 권한이 부여된 초대하는 사용자입니다.	질문이 있는 블록 추가 및 제거. 배경 및 텍스트 색상. 질문 및 답변 콘텐츠.

초대받은 사용자를 위한 위젯 페이지:

설명	표시 대상	편집할 수 있는 구성 요소	이미지
위젯 텍스트는 사이트에서 구매를 유도합니다. 구매 후 사용자에게 보너스 수령에 대한 알림이 표시됩니다.	추천 링크를 따라 로그인한 사용자.	배경 및 텍스트 색상. 위젯 텍스트, 버튼 텍스트.