使用遙測金鑰
您可以從 GameManager 中Data 區段下的 Telemetry Keys 索引標籤，管理為遊戲設定的金鑰。
建立金鑰之後，您可以在呼叫 WriteTelemetryEvents 時，透過 HTTP 標頭 X-TelemetryKey 包含該金鑰，從遊戲用戶端使用它：
呼叫端應提供遙測金鑰或實體權杖其中之一。如果兩者都提供，則會忽略遙測金鑰，並將要求視為未提供遙測金鑰來處理。
限制
使用遙測金鑰時，適用下列限制：- 一個遊戲最多可以設定五個遙測金鑰。
- 遙測金鑰只能用於透過 WriteTelemetryEvents API 傳送遙測事件。它們無法用於透過 WriteEvents API 傳送 PlayStream 事件。
- 已將 Insights 保留期設定為 超過 30 天的遊戲，目前無法設定遙測金鑰。
為事件指定實體
PlayFab 事件會透過其Entity 屬性指出事件的主體。當您使用實體權杖驗證傳送遙測時，此欄位會自動填入已登入實體的相關資訊。不過，當您使用遙測金鑰時，並沒有已登入的實體。因此，使用遙測金鑰傳送的遙測事件，不允許指定 PlayFab 內建實體作為其主體。
使用遙測金鑰時，您可能仍想將遙測事件與某個主體建立關聯，例如遊戲中使用的自訂玩家識別碼。若要這麼做，您可以在用戶端中建立事件時指定外部實體。
外部實體只是您將 type 設定為 external 所指定的實體。它們並非正式屬於 PlayFab 實體系統的一部分。它們僅在此情境中使用，以提供一個方便的機制，將遙測事件與在您系統中有意義的主體識別碼建立關聯。
若要在程式碼中建立事件時指定外部實體作為主體，您應該：
- 將事件的
Entity.type欄位設定為external(區分大小寫)。 - 將事件的
Entity.id欄位設定為您的自訂主體識別碼，長度上限為 64 個字元。
事件的
OriginInfo.Key 屬性會包含用來擷取事件的金鑰名稱。如果您設定了多個遙測金鑰，可以使用此屬性查看擷取事件時使用的是哪個金鑰。