사용자 알림

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

경험 알림은 13세 이상의 옵트인 사용자들이 시기적절하고 개인화된 알림을 통해 좋아하는 게임을 계속 업데이트 받을 수 있는 방법입니다. 개발자로서, 사용자가 알아야 할 가장 중요한 게임 내 활동이 무엇인지 결정하고, 알림 내용을 정의할 수 있습니다.

사용자가 알림을 수신한 후, Join 버튼을 통해 경험에 직접 참여하고 귀하의 런치 데이터에 따라 스폰됩니다.

기능, 자격 요건, 사용 지침 및 해당 엔진 API에 대한 자세한 내용은 Experiences guide를 참조하십시오.

구현

UserNotification 리소스를 통해 사용자에게 경험 알림을 전송할 수 있습니다. 사용하기 전에 API 키를 생성하거나 앱에 OAuth 2.0을 구성해야 합니다. 이 페이지의 예제는 API 키를 사용합니다.

사용자에게 경험 알림을 전송하려면:

Creator Dashboard에서 알림 문자열 만들기 (이 단계는 Creator Dashboard에서 수행해야 합니다; Open Cloud API는 없습니다).
요청 형식 지정:
1. x-api-key 요청 헤더에 API 키 복사.
2. payload.message_id 속성의 값으로 알림 문자열 자산 ID 복사.
3. payload.type을 "MOMENT"로 설정.
4. source.universe를 우주 리소스 URL "universes/${UniverseID}"로 설정.

경험 알림 전송
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
	"source": {
		"universe": "universes/${UniverseID}"
	},
	"payload": {
		"message_id": "${AssetID}",
		"type": "MOMENT"
	}
}'

알림 ID가 id 필드에 반환되는 예제 응답:


{
  "path": "users/505306092/notifications/6ca4d981-36fa-4255-82a1-14d95c116889",
  "id": "6ca4d981-36fa-4255-82a1-14d95c116889"
}

매개변수를 사용한 알림 사용자 지정

각 수신자를 위한 알림을 사용자 지정하려면 알림 문자열에 매개변수를 포함합니다. 그런 다음 API를 호출할 때 매개변수를 사용자 지정합니다. 예를 들어, 알림 문자열을 다음과 같이 정의할 수 있습니다:

{userId-friend}가 당신의 최고 점수를 {points}점 차로 이겼습니다! 레벨업할 시간입니다?

스크립트에서 userId-friend 및 points 매개변수를 추가합니다:

매개변수를 사용한 알림 사용자 지정
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
	"source": {
		"universe": "universes/${UniverseID}"
	},
	"payload": {
		"message_id": "${AssetID}",
		"type": "MOMENT",
		"parameters": {
			"userId-friend": {"int64_value": 3702832553},
			"points": {"string_value": "5"}
		}
	}
}'

런치 및 분석 데이터 포함

사용자 경험을 더욱 향상시키기 위해 알림에 런치 데이터를 포함할 수 있으며, 이는 사용자에게 좌표 위치로 라우팅하거나 참여 경험을 개인화하는 데 유용합니다. 또한, 분석 데이터를 포함하여 서로 다른 카테고리의 알림 성과를 세분화할 수 있습니다.

런치 데이터와 분석 데이터 포함
curl --location 'https://apis.roblox.com/cloud/v2/users/${UserId}/notifications' \
--header 'x-api-key: ${ApiKey}' \
--header 'Content-Type: application/json' \
--data '{
	"source": {
		"universe": "universes/${UniverseID}"
	},
	"payload": {
		"message_id": "${AssetID}",
		"type": "MOMENT"
	},
	"join_experience": {
		"launch_data": "Test_Launch_Data"
	},
	"analytics_data": {
		"category": "Test_Analytics_Category"
	}
}'

요금 한도 및 전송

각 사용자는 주어진 경험에서 하루에 하나의 알림만 받을 수 있으며, 사용자의 로드 제한에 도달했을 때 투명한 피드백을 받습니다.

알림이 전송되지 않을 수 있는 많은 다른 이유가 있습니다. 자세한 내용은 엔진 가이드에서 전송 시스템을 참조하십시오.

한국어