Kullanıcı bildirimleri

Deneyim bildirimleri, 13 yaş ve üzeri katılım sağlamış kullanıcıların en sevdikleri oyunlarla alakalı olarak zamanında, kişiselleştirilmiş bildirimlerle güncel kalmalarını sağlamak için bir yoldur. Geliştirici olarak, kullanıcılarınıza bildirim vermenin en önemli olduğu oyun içi etkinlik türlerini belirleyebilir ve bildirim içeriğini tanımlayabilirsiniz.

Kullanıcı bir bildirim aldıktan sonra, Katıl butarasıyla doğrudan deneyime katılabilir ve başlatma verilerinize göre spawna olabilirler.

Özellikler, uygunluk gereksinimleri, kullanım kılavuzları ve ilgili Engine API'si hakkında daha fazla bilgi için Deneyimler kılavuzu sayfasına bakın.

Uygulama

UserNotification kaynağı, deneyim bildirimlerini kullanıcılara göndermenizi sağlar. Bunu kullanmadan önce, uygulamanız için bir API anahtarı oluşturmalısınız veya OAuth 2.0 yapılandırmalısınız. Bu sayfadaki örnekler API anahtarlarını kullanır.

Bir kullanıcıya deneyim bildirimi göndermek için:

1. Bir bildirim dizesi oluşturun Yaratıcı Gösterge Tablosu içinde (bu adımın Yaratıcı Gösterge Tablosu'nda yapılması gerekir; bunun için bir Open Cloud API yoktur).
2. İsteği oluşturun:

   1. API anahtarını x-api-key istek başlığına kopyalayın.
   2. Bildirim dizesinin varlık kimliğini payload.message_id özelliğinin değeri olarak kopyalayın.
   3. payload.type öğesini "MOMENT" olarak ayarlayın.
   4. source.universe değerini, evren kaynak URL'si "universes/${UniverseID}" olarak ayarlayın.

Bir deneyim bildirimi gönderin
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 alanında bildirim kimliğini döndüren örnek yanıt:

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

Parametreler kullanarak bildirimleri özelleştirin

Her alıcı için bildirimi özelleştirmek amacıyla, bildirim dizesine parametreler ekleyin. Ardından API'yi çağırırken parametreleri özelleştirin. Örneğin, bildirim dizesini şöyle tanımlayabilirsiniz:

userId-friend ve points parametrelerini script içerisinde ekleyin:

Parametreleri Kullanarak Bildirimi Özelleştirin
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"}
		}
	}
}'

Başlatma ve analitik verileri dahil etme

Kullanıcı deneyimini daha da geliştirmek için, başlatma verisi bildirimde yer alabilir; bu, kullanıcıları belirli bir koordinat konumuna yönlendirmek veya katılım deneyimini kişiselleştirmek gibi senaryolar için kullanışlıdır. Ayrıca, farklı bildirim kategorilerinin performansını segmentlemek için analitik verileri ekleyebilirsiniz.

Başlatma Verileri ve Analitik Verileri Dahil Etme
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"
	}
}'

Hız sınırlamaları ve teslimat

Her kullanıcı, belirli bir deneyimden günde yalnızca bir bildirim alabilir ve bir kullanıcının throttle limitine ulaştığında şeffaf geri bildirim alırsınız.

Bir bildirimin iletilmez olmasının başka birçok nedeni olabilir. Daha fazla bilgi için Teslimat sistemi sayfasına bakın.