Notifiche dell'utente

Le notifiche di esperienza sono un modo per utenti opt-in di età 13+ per tenere il passo con le loro esperienze preferite attraverso notifiche tempestive e personalizzate.Come sviluppatore, puoi determinare quale tipo di attività in-experience è più importante per avvisare i tuoi utenti, nonché definire il contenuto della notifica.

Dopo aver ricevuto una Notifiche, gli utenti possono unirsi all'esperienza direttamente attraverso il pulsante Unisciti e generare secondo i tuoi dati di lancio.

Per ulteriori informazioni su funzionalità, requisiti di idoneità, linee guida per l'uso e l'API Motorecorrispondente, vedi la guida alle esperienze.

Implementazione

La risorsa Notifica utente ti consente di inviare notifiche di esperienza agli utenti.Prima di utilizzarlo, devi generare una chiave API o configurare OAuth 2.0 per la tua applicazione.Gli esempi di questa pagina utilizzano le chiavi API.

Per inviare una notifica di esperienza a un utente:

1. Crea una stringa di notifica nella Dashboard del creatore.Questo passo deve essere eseguito nella dashboard del creatore; non esiste un Open Cloud API per esso.
2. Formula la Richiesta:

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

Invia una Notifichedi 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 di 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 nella 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"}
		}
	}
}'

Include dati di lancio e analitici

Per migliorare ulteriormente l'esperienza utente, puoi includere dati di lancio nella Notifiche, utili per scenari come la routing degli utenti in una posizione coordinata o la personalizzazione dell'esperienza di join.Inoltre, puoi includere analitica dati per segmentare le prestazioni di diverse categorie di notifiche.

Includi dati di lancio e dati analitici
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 tariffa e consegna

Ogni utente può ricevere una notifica al giorno da una determinata esperienza, e ricevi feedback trasparenti quando viene raggiunto il limite di velocità di un utente.

Ci sono molte altre ragioni per cui una notifica potrebbe non essere consegnata. Per ulteriori informazioni, vedi Sistema di consegna nella guida del motore.