ユーザー通知

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、こちらをクリックしてください。

経験通知は、オプトインした13歳以上のユーザーが、お気に入りのゲームをタイムリーでパーソナライズされた通知を通じて把握する方法です。開発者として、ユーザーに通知するのに最も重要なゲーム内の活動の種類を決定し、通知の内容を定義することができます。

通知を受け取ると、ユーザーは参加ボタンを通じて体験に直接参加し、あなたの起動データに従ってスポーンします。

機能、資格要件、使用ガイドライン、および対応するエンジン API についての詳細は、体験ガイドを参照してください。

実装

UserNotification リソースを使用すると、ユーザーに体験通知を送信できます。使用する前に、API キーを生成するか、アプリのために OAuth 2.0 を設定する必要があります。このページの例では API キーを使用しています。

ユーザーに体験通知を送信するには：

通知文字列を作成します。クリエイターダッシュボードでこのステップを実行する必要があります。Open Cloud API ではこの操作はできません。
リクエストを形成します：
1. x-api-key リクエストヘッダーに API キーをコピーします。
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} ポイント差で抜きました！レベルアップの時間ですか？

スクリプトに 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 つの通知を1日につき受け取ることができ、ユーザーのスロットル制限に達した場合は透明性のあるフィードバックを受け取ります。

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

日本語