Kullanıcı bildirimleri

Tecrübe Bildirimleri 13'den fazla kullanıcının favori deneyimlerine hızlı, kişiselleştirilmiş bildirimlerle ulaşmasını sağlar. As a developer, you can determine what kind of in-experience activities

Deneyim Bildirme sistemi takip edilensunar:

• Parametrelerle Özelleştirilebilir Bildirimler — Bildirim mesajını özelleştirmek için tüm esnekliği:

  • Altın güvercin yumurtasının çıktı!
  • Allie @LaterSk8er1 sadece Tokyo Turu pistindeki rekorunu kırdı! İntikam alma zamanı!

• Verileri Başlatma Verileri — Uyarı alıcısının katılmasıyla okunabilecek başlatma verilerini içerebilir. Bu, bir kullanıcıyı bir koordine konumuna yönlendirmeyi veya katılma deneyimini kişiselleştirmeyi içerebilir.

• Veri Analizi Desteği — Ulaşılabilir kullanıcınızı ve bildirilerinizin performansını Yaratıcı Dashboard'ında takip edin.

Bir bildirim aldıktan sonra, kullanıcılar deneyime doğrudan Katıl düğmesi aracılığıyla katılabilir ve çıkış verilerinize göre oluşturabilirler.

Özellikler, uygunluk gereksinimleri, kullanım talimatları ve karşılık gelen Motor API hakkında daha fazla bilgi için Deneyim kılavuzu 'ya bakın.

Uygulama

Kullanıcı Bildirimi kaynağı, kullanıcılara deneyim bildirimleri göndermenizi sağlar.Kullanmadan önce, bir API anahtarı oluşturmalısınız veya uygulamanız için OAuth 2.0'yi yapılandırmalısınız veya.Bu sayfadaki örnekler API anahtarlarını kullanır.

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

1. Bir bildirim dizesi oluşturunYaratıcı Panosu .Bu adım Yaratıcı Panosunda yapılmalıdır; bunun için Açık Bulut API yoktur.
2. talepoluştur:

   1. API anahtarını x-api-key istek başlığına kopyala.
   2. Bildirim dize özniteliği ID'sini payload.message_id özelliğinin değeri olarak kopyalayın.
   3. Set payload.type 'i "MOMENT" 'e ayarla.
   4. Evren kaynak URL'si olmak için source.universe ayarlanın "universes/${UniverseID}".

Bir deneyim bildirimi gönder
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"
	}
}'

Bildirim kimliğini id alanında döndüren örnek yanıt:

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

Özel parametler kullanarak bildirimleri özelleştir

Her alıcı için bildirimi özelleştirmek için, parametreleri bildirim dizesine ekleyin.Sonra API'yi çağırırken parametleri özelleştirin.Örneğin, bildirim dizesini şu şekilde tanımlayabilirsiniz:

Kodda userId-friend ve points parametlerini ekleyin:

Parametreleri Kullanarak Bildirimi Özelleştir
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 analiz verilerini dahil et

Kullanıcı deneyimini daha da geliştirmek için, yönlendirme verileri ni bildirime dahil edebilirsiniz, böylece kullanıcıları bir koordinat konumuna yönlendirmek veya katılma deneyimini kişiselleştirmek gibi senaryolara uygun olur.Ayrıca, farklı kategori notlarının performansını bölmek için analiz verilerini de ekleyebilirsiniz.

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

Oran sınırları ve teslimat

Her kullanıcı, belirli bir deneyimden günde bir bildirim alabilir ve bir kullanıcının sınırına ulaşıldığında transparan geri bildirim alırsınız.

Bir bildirimin teslim edilmeyebileceği birçok başka neden vardır. Daha fazla bilgi için, Motor rehberinde Teslimat sistemi bakın.