Notifiche per gli utenti

Le notifiche delle esperienze sono un modo per gli utenti che hanno accettato di oltre 13 anni di rimanere aggiornati sui loro giochi preferiti attraverso notifiche tempestive e personalizzate. Come sviluppatore, puoi determinare quali tipi di attività in-game sono più importanti da comunicare ai tuoi utenti, oltre a definire il contenuto delle notifiche.

Dopo aver ricevuto una notifica, gli utenti possono unirsi all'esperienza direttamente tramite il pulsante Unisciti e apparire in base ai tuoi dati di lancio.

Per ulteriori informazioni sulle funzionalità, requisiti di idoneità, linee guida per l'uso e l'API corrispondente dell'Engine, vedere la guida alle esperienze.

Implementazione

La risorsa UserNotification ti consente di inviare notifiche relative all'esperienza agli utenti. Prima di utilizzarla, devi generare una chiave API o configurare OAuth 2.0 per la tua app. Gli esempi su questa pagina utilizzano le chiavi API.

Per inviare una notifica relativa all'esperienza a un utente:

1. Crea una stringa di notifica nel Creator Dashboard (questo passaggio deve essere eseguito nel Creator Dashboard; non esiste un'API Open Cloud per questo).
2. Forma la richiesta:

   1. Copia la chiave API nell'intestazione della richiesta x-api-key.
   2. Copia l'ID dell'asset della stringa di notifica come valore della proprietà payload.message_id.
   3. Imposta payload.type su "MOMENT".
   4. Imposta source.universe come URL della risorsa dell'universo "universes/${UniverseID}".

Invia una notifica relativa all'esperienza
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"
	}
}'

Esempio di risposta che restituisce l'ID della notifica nel campo id:

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

Personalizza le notifiche utilizzando i parametri

Per personalizzare la notifica per ciascun destinatario, includi parametri nella stringa di notifica. Quindi personalizza i parametri quando chiami l'API. Ad esempio, puoi definire la stringa di notifica come:

Aggiungi i parametri userId-friend e points nello script:

Personalizza la notifica utilizzando i parametri
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"}
		}
	}
}'

Includi dati di lancio e analisi

Per migliorare ulteriormente l'esperienza dell'utente, puoi includere dati di lancio nella notifica, utili per scenari come il reindirizzamento degli utenti a una posizione coordinata o la personalizzazione dell'esperienza di accesso. Inoltre, puoi includere dati di analisi per segmentare le prestazioni di diverse categorie di notifiche.

Includi dati di lancio e dati di analisi
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"
	}
}'

Limiti di frequenza e consegna

Ogni utente può ricevere una notifica al giorno da una determinata esperienza e ricevi feedback trasparente quando viene raggiunto il limite di tolleranza di un utente.

Ci sono molte altre ragioni per cui una notifica potrebbe non essere consegnata. Per ulteriori informazioni, vedere Sistema di consegna nella guida dell'Engine.