Tiefe Links

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Tiefe Links lassen dich Benutzer an einen bestimmten Ort in einem Erlebnis senden, was den Prozess des Beitritts verschlanken, Benutzern helfen, ihre Freunde zu finden, und Verkehrsattribution bieten kann.Die optionalen Startdaten in diesen Links lassen dich die Benutzererfahrung anpassen, wenn jemand beitritt.

Baue einen tiefen verlinken

Eine tief verknüpfte URL besteht aus einem URL-Format zusammen mit den von Ihnen angegebenen Parametern. Die folgenden Abschnitte beschreiben, wie jedes Format konstruiert wird.

URL-Parameter

Tiefe Links unterstützen die folgenden URL-Parameter. Alle sind optional, es sei denn, anders angegeben.

Parameter | Beschreibung :--- | :--- placeId | Die Platz-ID, die beigetreten werden soll.Erforderlich, es sei denn userId wird angegeben. userId | Die Benutzer-ID zum Beitritt.Ergebnisse in einem "Folgende Benutzer hat die Erlebnisverlassen"-Fehler, wenn der Benutzer die Erfahrung verlassen hat oder offline ist.| Der private Codes.| Der private Codes. gameInstanceId | Die eindeutige Kennung der Spielinstanz, der beizutreten ist, auch als DataModel.JobId bezeichnet. launchData | Zusätzliche Informationen, die du innerhalb des tiefen verlinkenenthalten möchtest, wie z. B. Werbecodes oder Koordinaten.Verarbeiten mit der Player:GetJoinData()-Methode.Siehe Include Startdaten.

Anforderungen und Richtlinien

  • Du musst spezielle Zeichen, wie Leerstellen, URL-codieren. Diese Zeichen werden automatisch dekodiert, wenn der Benutzer deiner Erlebnisbeitritt.
  • Die dekodierten Startdaten können nicht mehr als 200 Bytes betragen.
  • Du kannst komplexere Daten als JSON-String speichern und dekodieren sie mit HttpService:JSONDecode() auf dem Server.
  • Sende keine vertraulichen Informationen im launchData-Parameter; sie sind vollständig sichtbar in der URL.Darüber hinaus können Benutzer die URL modifizieren, so dass die Daten möglicherweise nicht authentisch sind.

Webliste zur App

Dieses Format leitet Benutzer auf die Roblox-Erfahrungsseite im Web und startet dann die Roblox-App.Das bereitgestellte Beispiel bietet eine Platz-ID und einen URL-codierten String.

格式ierung https://www.roblox.com/games/start?placeId=<id>&launchData=<string>
Beispiel Beispiel-Link

Direkt auf die App

Dieses Format leitet Benutzer direkt zur Roblox-App. Das bereitgestellte Beispiel bietet eine Platz-ID und einen URL-codierten String.

格式ierung roblox://placeId=<id>&launchData=<string>
Beispiel Beispiel-Link

Aufgeschoben

Für Benutzer, die Roblox nicht auf ihren mobilen Geräten installiert haben, verwende die AppsFlyer-Version eines tiefen Links, um Benutzer die Roblox-App herunterladen zu lassen und dann dem tiefen verlinkenzu folgen.Um diese Art von tiefem verlinkenzu konstruieren, geben Sie den Präfix https://ro.blox.com/Ebh5? an.Stelle den "direkten Link zur App" mit dem af_dp -Parameter und den "Web-Link zur App" mit dem af_web_dp -Parameter bereit, die in den vorherigen Abschnitten beschrieben sind.

格式ierung ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link>
Beispiel ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D&af_web_dp=https%3A%2F%2Fwww.roblox.com%2Fgames%2Fstart%3FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D

Verarbeite einen tiefen verlinken

In deiner Erlebniserhalte die Startdaten mit der Methode Player:GetJoinData(), die eine Diktion zurückgibt.In diesem Wörterbuch enthält der Schlüssel LaunchData die Zeichenkette, die du im launchData Parameter deines tiefen verlinkenangegeben hast.

Siehe die Player:GetJoinData() Referenzdokumentation für Codebeispiele zur Verarbeitung von Startdaten.