shop_leave_rating 함수 설명
shop_leave_rating 함수는 운영 체제에 따라 다르게 동작하는 대화 상자를 열어 사용자가 특정 페이지에 평가나 댓글을 남기도록 요청하는 기능을 제공합니다. 이 함수는 Android와 iOS 타겟에서만 사용할 수 있습니다.
기능 설명
- 대화 상자 텍스트: 대화 상자에 표시될 텍스트를 정의할 수 있습니다.
- 버튼 텍스트: "예" 버튼과 "아니오" 버튼에 표시될 텍스트를 설정할 수 있습니다.
- 댓글 URL: 댓글이 게시될 URL을 지정할 수 있습니다.
iOS에서의 동작
iOS에서는 TestFlight를 사용할 때 개발 중에는 프롬프트가 표시되지만 실제로는 아무 작업도 수행할 수 없습니다. 앱이 App Store에 배포되면 버튼이 활성화되어 사용자가 리뷰를 작성하거나 평가를 남길 수 있는 옵션이 제공됩니다. TestFlight를 통해 게임을 배포하는 경우 이 창이 아예 표시되지 않을 수 있습니다.
문법
shop_leave_rating(text, yes_string, no_string, url)
매개변수 설명
| 매개변수 | 타입 | 설명 |
|---|---|---|
| text | String | 대화 상자에 표시될 텍스트 |
| yes_string | String | "예" 버튼에 표시될 텍스트 |
| no_string | String | "아니오" 버튼에 표시될 텍스트 |
| url | String | 댓글이 전송될 전체 URL |
반환값
- N/A (반환값 없음)
활용 예제
아래 코드는 사용자가 게임을 플레이한 후 댓글을 남기도록 요청하는 예제입니다.
if (timer <= 0) {
shop_leave_rating("게임을 플레이해 주셔서 감사합니다! 댓글을 남겨보세요.", "좋아요!", "오늘은 아니에요!", "http://MacSweeney/comments");
timer = 10000000;
} else {
timer -= 1;
}
위 코드는 timer 변수가 0으로 카운트다운되면 사용자에게 댓글을 남기도록 요청합니다.
추가 활용 예제
- 게임 종료 후 평가 요청
gml if (game_over) { shop_leave_rating("게임이 끝났습니다! 평가를 남겨주세요.", "평가하기", "나중에", "http://example.com/review"); } - 특정 레벨 클리어 후 요청
gml if (level_cleared) { shop_leave_rating("레벨을 클리어했습니다! 소감을 남겨주세요.", "좋아요!", "아니요", "http://example.com/level-review"); } - 주기적으로 평가 요청
gml if (request_timer <= 0) { shop_leave_rating("이 게임이 마음에 드시나요? 평가를 남겨주세요!", "네!", "아니요", "http://example.com/feedback"); request_timer = 300; // 5분 후 다시 요청 } else { request_timer -= 1; }
이와 같이 shop_leave_rating 함수를 활용하여 사용자에게 피드백을 요청할 수 있습니다.