Powiadomienia użytkownika

Powiadomienia o doświadczeniach są sposobem dla użytkowników z wybranymi opcjami w wieku 13 lat +, aby nadążyć za swoimi ulubionymi doświadczeniami za pomocą terminowych, spersonalizowanych powiadomień.Jako programista możesz określić, jakie rodzaje działań w doświadczeniu są najważniejsze do powiadomienia użytkowników, a także określić treść powiadomienia.

Po otrzymaniu powiadomienieużytkownicy mogą dołączyć do doświadczenia bezpośrednio za pomocą przycisku Dołącz i wygenerować zgodnie z danymi o uruchomieniu zgodnie z danymi o uruchomieniu.

Aby uzyskać więcej informacji na temat funkcji, wymagań kwalifikacyjnych, wytycznych dotyczących użytkowania i odpowiedniej API silnika, zobacz przewodnik doświadczeń.

Implementacja

Zasób powiadomienie użytkownika pozwala wysyłać powiadomienia o doświadczeniu do użytkowników.Zanim go użyjesz, musisz wygenerować klucz API lub skonfigurować OAuth 2.0 dla swojej aplikacja.Przykłady na tej stronie używają kluczy API.

Aby wysłać powiadomienie o doświadczeniu do użytkownika:

1. Stwórz ciąg powiadomień w panelu twórcy.Ten krok musi być wykonany w panelu twórcy; nie ma dla niego otwartej chmury API.
2. Sformułuj prośba:

   1. Kopiuj klucz API do nagłówka żądania x-api-key.
   2. Kopiuj ID strony powiadomienia jako wartość właściwości payload.message_id.
   3. Ustaw payload.type na "MOMENT".
   4. Ustaw source.universe, aby był to URL zasobu wszechświata "universes/${UniverseID}".

Wyślij powiadomienie o doświadczeniu
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"
	}
}'

Przykład odpowiedzi, która zwraca ID powiadomienia w polu id:

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

Dostosuj powiadomienia za pomocą parametrów

Aby dostosować powiadomienie dla każdego odbiorca, włącz parametry w linii powiadomienia.Następnie dostosuj parametry podczas wywoływania API.Na przykład możesz określić ciąg powiadomienia jako:

Dodaj parametry userId-friend i points w skrypcie:

Dostosuj powiadomienie za pomocą parametrów
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"}
		}
	}
}'

Włącz dane o uruchomieniu i analizie

Aby dalej poprawić doświadczenia użytkownika, możesz dodać dane o uruchomieniu do powiadomienie, przydatne do scenariuszy takich jak przekierowanie użytkowników do lokalizacji koordynacyjnej lub personalizacja doświadczenia połączenia.Ponadto możesz dodać dane analityczne do segmentowania wydajności różnych kategorii powiadomień.

Włącz dane o uruchomieniu i dane analityczne
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"
	}
}'

Ograniczenia stawki i dostarczanie

Każdy użytkownik może otrzymać jedną powiadomienie dziennie z danego doświadczenia, a otrzymasz przejrzyste informacje zwrotne, gdy osiągnie się limit przepustowości użytkownika.

Istnieje wiele innych powodów, dla których powiadomienie może nie zostać dostarczone. Aby uzyskać więcej informacji, zobacz System dostarczania w przewodniku silnika.