친구를 위한 선물

작동 방식

이 기능은 사용자가 게임 키, 가상 아이템, 인게임 재화 패키지 또는 구독을 실제 화폐로 구매하여 게임 내 친구에게 선물로 보낼 수 있게 합니다. 성공적으로 결제한 후, 제공자는 영수증을 받게 되고 수령인은 선물 세부 정보가 포함된 이메일을 받게 됩니다. 제공자는 자신의 데이터를 감추어 선물을 익명으로 보낼 수도 있습니다.

Note: 가상 아이템 또는 인게임 재화 패키지를 선물로 구매하는 것은 엑솔라 측 사용자 데이터 저장소가 비활성화된 프로젝트에만 가능합니다.

사용자

  • 구매 버튼을 통합하고 가상 아이템/인게임 재화/게임 키 모듈을 활성화한 파트너.
  • 구독을 통합한 파트너.

Info: Checkout API 메소드(사용되지 않음)를 사용하는 프로젝트에만 이 기능은 사용 가능합니다. 프로젝트 설정 > 통합 설정으로 이동해서 Commerce API 통합 토글이 꺼짐으로 설정되었는지 확인합니다.

획득 방법

기능 활성화 방법:

  1. 인게임 재화 패키지, 가상 아이템, 게임 키 패키지 또는 구독을 구성합니다.
  2. 다음의 친구 목록 전송 방법 중 하나를 선택해서 구현합니다. API 메소드 이용 또는 토큰 이용.
  3. 성공적인 웹훅 구매에서 프로세스되는 purchase.gift 매개 변수를 구현합니다.
  4. 계정 관리자에게 문의하여 설정을 완료합니다.

토큰을 통해 친구 목록 전송

제공자가 추천 목록에서 수신자를 선택하게 하려면, 사용자의 친구 목록을 토큰 요청 가져오기purchase.gift.friends 매개 변수로서 전달합니다. 귀하의 앱에 수신한 목록이 표시됩니다. 목록이 단 한 명의 사용자만 포함하는 경우, 이 사용자는 자동으로 선물 수신자로 정의됩니다.

선물을 주는 사람의 정보를 추가하려면 토큰 가져오기를 위한 요청에서 purchase.gift.giver_id, purchase.gift.message, purchase.gift.hide_giver_from_receiver 매개 변수를 전달하십시오.

사용자에게 선물로 주는 인게임 재화용 토큰 예시:

Copy
Full screen
Small screen
"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
Full screen
Small screen
"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를 구현하고 서명을 만듭니다. 서명 만드는 방법:

  1. 웹훅 URL게시자 계정 > 프로젝트 설정 > 웹훅에서 지정했는지 확인합니다.
  2. 서명 요청을 생성합니다.
  3. API 요청이 처리되는 동안에 생성된 서명과 sign 매개 변수에서 전달된 서명이 일치하는지 확인합니다.

요청 사례:

Copy
Full screen
Small screen
$ 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
Full screen
Small screen
[
  {
  "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
  }
]

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2020년 12월 14일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.