ユーザー通知

エクスペリエンス通知は、13以上のユーザーが、気に入るエクスペリエンスをタイムリーで個人化された通知で追跡することができる方法です。開発者として、ユーザー

エクスペリエンスノーティフィケーションシステムは、フォロー中機能を提供します：

パラメーターでカスタマイズ可能な通知 — パラメーターで通知メッセージをカスタマイズできます。たとえば：
- あなたのゴールドのタマゴは孵化しました！
- Allie @LaterSk8er1が東京ツアーのトラックであなたの記録を更新したばかり！復讐の時間ですか？
データのローンチ — 通知受信者が参加するときに読み込むオプションのデータのローンチを含めることができます。これには、ユーザーをコーディネート場所または参加体験をパーソナライズすることが含まれます。
アナリティクスサポート — クリエイターダッシュボードの届きやすいオーディエンスと通知のパフォーマンスを追跡します。

通知を受け取った後、ユーザーは参加ボタンを介して直接エクスペリエンスに参加し、発進データに従ってスポーンできます。

機能、資格要件、使用ガイドライン、および対応するエンジン APIに関する詳細情報は、エクスペリエンスガイドを参照してください。

実装

ユーザー通知リソースでは、ユーザーにエクスペリエンス通知を送信できます。使用する前に、アプリに対して API キーを生成するまたは OAuth 2.0 を構成する必須です。このページの例では、APIキーを使用しています。

ユーザーにエクスペリエンス通知を送信するには：

クリエイターダッシュボードで通知ストリングを作成する Creator Dashboard。このステップはクリエイターダッシュボードで行わなければなりません；それにはオープンクラウド APIはありません。
リクエストを形成する:
1. API キーを x-api-key リクエストヘッダーにコピーします。
2. 通知ストリングアセット IDを payload.message_id プロパティの値としてコピーします。
3. Set payload.type を "MOMENT" に設定します。
4. Set 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} beat your high score by {points} points! Time to level up?

スクリプトに 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"
	}
}'

レート制限と配信

各ユーザーは、指定のエクスペリエンスから毎日 1 通知を受け取ることができ、ユーザーのスロット制限が達したときに透明なフィードバックを受け取ります。

通知が配信されない理由はたくさんあります。詳しくは、エンジンガイドの配信システムを参照してください。

実装

パラメータを使用して通知をカスタマイズ

発進と分析データを含める

レート制限と配信

ページ内容