작동 방식
이 기능은 사용자가 게임 키, 가상 아이템, 인게임 재화 패키지 또는 구독을 실제 화폐로 구매하여 게임 내 친구에게 선물로 보낼 수 있게 합니다. 성공적으로 결제한 후, 제공자는 영수증을 받게 되고 수령인은 선물 세부 정보가 포함된 이메일을 받게 됩니다. 제공자는 자신의 데이터를 감추어 선물을 익명으로 보낼 수도 있습니다.
Note:
가상 아이템 또는 인게임 재화 패키지를 선물로 구매하는 것은 엑솔라 측 사용자 데이터 저장소가 비활성화된 프로젝트에만 가능합니다.
사용자
Info:
Checkout API 메소드(사용되지 않음)를 사용하는 프로젝트에만 이 기능은 사용 가능합니다. 프로젝트 설정 > 통합 설정으로 이동해서 Commerce API 통합 토글이 꺼짐으로 설정되었는지 확인합니다.
획득 방법
기능 활성화 방법:
- 인게임 재화 패키지, 가상 아이템, 게임 키 패키지 또는 구독을 구성합니다.
- 다음의 친구 목록 전송 방법 중 하나를 선택해서 구현합니다. API 메소드 이용 또는 토큰 이용.
- 성공적인 웹훅 구매에서 프로세스되는
purchase.gift
매개 변수를 구현합니다. - 계정 관리자에게 문의하여 설정을 완료합니다.
토큰을 통해 친구 목록 전송
제공자가 추천 목록에서 수신자를 선택하게 하려면, 사용자의 친구 목록을 토큰 요청 가져오기의 purchase.gift.friends
매개 변수로서 전달합니다. 귀하의 앱에 수신한 목록이 표시됩니다. 목록이 단 한 명의 사용자만 포함하는 경우, 이 사용자는 자동으로 선물 수신자로 정의됩니다.
선물을 주는 사람의 정보를 추가하려면 토큰 가져오기를 위한 요청에서 purchase.gift.giver_id
, purchase.gift.message
, purchase.gift.hide_giver_from_receiver
매개 변수를 전달하십시오.
사용자에게 선물로 주는 인게임 재화용 토큰 예시:
Copy
- http
"purchase":{
"virtual_currency":{
"quantity":100
},
"description":{
"value":"Test Purchase"
},
"gift":{
"giver_id":"John Smith",
"message":"GG WP",
"hide_giver_from_receiver" : true,
"friends": [
{
"id": "123",
"name": "captain",
"email": "captain@ship.com"
}]
}
}
사용자에게 선물로 주는 구독용 토큰 예시:
Copy
- http
"purchase": {
"gift": {
"giver_id": "John Smith",
"message": "GG WP",
"hide_giver_from_receiver": true,
"friends": [
{
"id": "123",
"name": "captain",
"email": "captain@ship.com"
}
]
}
}
API 요청을 통해 친구 목록 전달
친구 목록 전달을 위한 API를 구현하고 서명을 만듭니다. 서명 만드는 방법:
- 웹훅 URL을 게시자 계정 > 프로젝트 설정 > 웹훅에서 지정했는지 확인합니다.
- 서명 요청을 생성합니다.
- API 요청이 처리되는 동안에 생성된 서명과
sign
매개 변수에서 전달된 서명이 일치하는지 확인합니다.
요청 사례:
Copy
- http
$ curl -v 'https://your.webhook.url?notification_type=friends_list&user=user_id&query=frien&offset=10&limit=20&sign=12dfg3f5gdsf4g5s6dfg2sdg1' \
-X GET \
-u merchant_id:merchant_api_key
응답 예제:
Copy
- http
[
{
"friends": [
{
"id": "1",
"name": "John Carter",
"email": "carter@xsolla.com",
"image_url": "https://partner/link/doctor.jpg"
},
{
"id": "2",
"name": "John Smith",
"email": "smith@xsolla.com",
"image_url": "https://partner/link/cook.jpg"
}
],
"total": 10
}
]
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.이 페이지 평가
이 페이지 평가
답하기 원하지 않습니다
의견을 보내 주셔서 감사드립니다!
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.