> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Partitioning 快速入門 (預覽)

> 在 Game Manager 中新增、編輯和移除 Managed Events，以針對傳送至 Azure Blob Storage 和 Azure Data Explorer 的 Data Connections 啟用 PlayFab Event Partitioning。

> [!NOTE]
>
> Event Partitioning 功能目前為私人預覽版，這表示只有我們為其啟用此功能的特定遊戲才能使用。隨著我們持續收集意見反應並針對客戶使用進行最佳化，預期此功能會持續變更，恕不另行通知。

您可以透過 Game Manager 和 API 管理 Event Partitioning。

## 在 Game Manager 中新增、編輯和刪除 Managed Events

了解如何透過 Game Manager 新增、編輯和刪除 Manage Events 來設定分割。

### 新增 Managed Event

* 前往 **PlayFab** 並登入 [Game Manager](https://developer.playfab.com/)。
* 瀏覽至您的 **Title**。
* 從左側功能表選取 **Data**。
* 選取 **Manage Events (Preview)** 索引標籤。
* 選取 **Add Managed Event**。
* 在 **Event Type** 下拉式清單中，選擇您要管理的事件。如果自訂事件未出現在下拉式清單中，您可以輸入自訂事件名稱，然後選取建立事件名稱的選項。
* 將取樣百分比保留為預設值。如果您也想要對事件進行取樣，請參閱 [Event Sampling 概觀](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/export-data/event-sampling-overview.md)，以了解設定此值的詳細資料。
* 勾選 **Partition in Data Connections** 方塊，以針對此事件啟用分割。
* 選取 **Save**。

### 編輯 Managed Event

* 選取 **Managed Events** 索引標籤。
* 選取 **Event namespace** 以開啟事件。
* 您可以編輯 **Sample Rate** % 和 **Partition in Data Connections** 核取方塊。
* 選取 **Save**。

### 刪除 Managed Event

* 選取 **Managed Events** 索引標籤。
* 選取 **Event namespace** 左側的核取方塊，以選取您要刪除的 Managed Event。
* 選取資料表頂端的 **Delete**。
* 選取 **Delete** 以確認。

### 透過 API 管理 Event Partitioning

您也可以使用下列 ManageEvents API 來管理 Event Partitioning。

#### SetManagedEvents

此 API 可用來為遊戲設定受管理事件的清單。如果事件名稱和命名空間的組合已存在，則會以新設定更新現有設定。

要求範例：

```HTTP theme={null}

POST : https://<titleid>.playfabapi.com/Event/SetManagedEvents 

{ 
    "ManagedEvents":[{ 
                "Namespace": "demo_namespace, 
                "Name": "demo_name", 
                "SamplingRatio": 100, 
                "isPartitioned": true 
            }] 
}

```

#### DeleteManagedEvents

**DeleteManagedEvents** API 用來從遊戲的受管理事件清單中刪除事件名稱和事件命名空間組合。使用此 API 時，請在要求本文中提供名稱和命名空間。

要求範例：

```HTTP theme={null}

POST https://<titleid>.playfabapi.com/Event/DeleteManagedEvent

{ 
      "Namespace": "demo_namespace", 
      "Name": "demo_name" 
} 

```

#### GetManagedEvent

**GetManagedEvent** 用來取得受管理事件的設定。

要求範例：

```HTTP theme={null}

POST https://<titleid>.playfabapi.com/Event/GetManagedEvent

{ 
      "Namespace": "demo_namespace", 
      "Name": "demo_name" 
}

```

#### GetManagedEvents

**GetManagedEvents** 用來取得所有受管理事件的清單。

要求範例：

```HTTP theme={null}

POST https://<titleid>.playfabapi.com/Event/GetManagedEvents

```

## 後續步驟

* [Event Partitioning 概觀](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/export-data/event-partitioning-overview.md)


## Related topics

- [Event Sampling 快速入門](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/export-data/event-sampling-quickstart.md)
- [Event Partitioning 概觀 (預覽)](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/export-data/event-partitioning-overview.md)
- [結構描述快速入門](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/acting-data/schemas-quickstart.md)
- [Data Connections 快速入門](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/export-data/data-connection-quickstart.md)
- [Data Explorer 快速入門](https://devdocs.xbox.com/zh-TW/services/playfab/data-analytics/learn-data/data-explorer/quickstart.md)