사용자 알림

경험 알림 은 13+ 사용자가 실시간, 개인화된 알림을 통해 가장 좋아하는 경험에 대해 알 수 있는 방법입니다. 개발자로서 알림 내용을 결

경험 알림 시스템에는 팔로잉있습니다.

• 매개 변수를 사용하여 사용자 지정 가능한 알림 — 매개 변수를 사용하여 알림 메시지를 사용자 지정할 수 있습니다. 예를 들어:

  • 골드 거위 알이 부화했습니다!
  • Allie @LaterSk8er1님이 방금 도쿄 투어 트랙에서 기록을 경신했습니다! 복수의 시간입니까?

• 데이터 시작 데이터 포함 — 알림 받는 사람이 가입할 때 읽을 수 있는 선택적인 시작 데이터를 포함하십시오. 이는 사용자를 Player:GetJoinData()로 라우트하거나 참여 경험을 개인화할 수 있습니다.

• 분석 지원 — 크리에이터 대시보드에서 얻을 수 있는 대상과 알림의 성능을 추적합니다.

알림을 받은 후 사용자는 가입 버튼을 통해 직접 경험에 참여하고 런칭 데이터에 따라 생성할 수 있습니다.

기능, 요구 사항, 사용 가이드라인 및 해당 엔진 API에 대한 자세한 정보는 경험 가이드에 참조하십시오.

구현

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

사용자에게 경험 알림을 보내려면:

1. 크리에이터 대시보드에서 알림 문자열 생성.이 단계는 크리에이터 대시보드에서 수행해야 하며, 해당에 대한 오픈 클라우드 API는 없습니다.
2. 요청 형성:

   1. API 키를 x-api-key에 복사하십시오.
   2. 알림 문자열 자산 ID를 payload.message_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 매개변수를 추가하십시오:

매개 변수를 사용하여 알림 사용자 정의
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"
	}
}'

속도 제한 및 배달

각 사용자는 지정된 경험에서 하루에 하나 의 알림을 받을 수 있으며, 사용자의 속도 제한이 도달하면 투명한 피드백을 받습니다.

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