快速入門：設定廣告版位
獎勵廣告是一種激勵玩家觀看影片廣告以換取獎勵的方式。每個廣告及其相關聯的獎勵稱為一個廣告版位。在本快速入門中，您將設定一個廣告版位並為其設定獎勵。必要條件
- PlayFab 開發人員帳戶。
- 來自您廣告提供者的應用程式識別碼 (Application ID) 和廣告單元類型 (Advertising Unit type)。
設定廣告版位
在 Rewarded Ads 索引標籤中，您首先會看到廣告的主要儀表板。您可以在這裡找到廣告的基本 KPI，以及顯示近期廣告事件的圖表 (這些事件也會顯示在 PlayStream 中) 在頂端選取 Placements。 廣告版位是此系統最基本的部分。您可以將單一版位視為一個「廣告位置」：也就是將顯示的廣告類型 (橫幅、影片等)，以及玩家會在遊戲中的哪個時間點看到它 (關卡插頁、點選「顯示廣告」後的結果等)。 在右上角選取 New Ad Placement。您可以隨意為版位命名，並輸入來自廣告提供者的應用程式識別碼和廣告單元類型。如果您不確定在何處可以找到特定提供者的應用程式識別碼和廣告單元類型，請告訴我們，我們可以與您合作找出這些資訊。新增獎勵
現在您需要新增特定的獎勵。針對此版位的每個可能獎勵，選取 New Reward。為您的獎勵命名，並輸入在授與該特定獎勵時要傳回給用戶端的任何描述文字和資產套件 URL。接著在 Actions 下選取 Add Action。就像一般的 PlayStream 動作一樣，您現在可以執行多種不同的動作，例如執行 Cloud Script 處理常式、授與項目等。通常您會在這裡授與虛擬貨幣或項目，但如果您想要使用其他動作類型，其處理方式都會與一般 PlayStream 動作觸發程序相同。 定義好幾個獎勵之後，請為每個獎勵指定權重以設定隨機分佈。如果您已為遊戲定義區段，您也可以在 Rewards 下方的 Segment Assignment 工具中設定覆寫。例如，如果您希望某個特定玩家群組永遠獲得特定獎勵，請在指派清單中將該區段設定為該獎勵。區段指派會依優先順序排列，因此第一個符合目前玩家的區段就是所使用的區段。下列範例定義了一個廣告版位，有 0% 的機率提供免費寶石、30% 的機率提供額外經驗值，以及 70% 的機率提供「鑰匙」項目。
擷取廣告版位
定義至少一個廣告版位之後，您可以使用 Client/GetAdPlacements 查詢可用版位的清單。請在呼叫中指定識別碼，以確保您只會取得指定版位的資訊。若要篩選特定版位，您可以使用您為其定義的名稱 (如上所述)，或 PlayFab 為該版位產生的唯一識別碼 (您可以在上述範例的 URL 中看到)。否則，系統會在AdPlacementDetails 物件中傳回玩家具有有效獎勵的所有可用版位，包括玩家的獎勵、目前剩餘的觀看次數，以及重設觀看次數限制的時間。
在用戶端程式碼中選取廣告版位後，請務必儲存 PlacementId 和 RewardId。您會在接下來的兩個階段中使用這些值。
回報廣告活動
我們為廣告定義了四種活動狀態：「Opened」、「Closed」、「Start」和「End」。使用獎勵廣告時，請確保每當您的廣告 SDK 回報狀態變更時，都呼叫 Client/ReportAdActivityRequest 以更新活動狀態。獎勵廣告活動
當您的廣告 SDK 回報廣告觀看已成功完成時，請呼叫 Client/RewardAdActivity 以觸發獎勵。此呼叫需要 Client/GetAdPlacements 所傳回的PlacementId 和 RewardId。它會先檢查獎勵是否有效，然後為玩家處理獎勵。項目會立即授與，接著此呼叫會傳回由 Grant Item、Grant Virtual Currency 和 Increment Player Statistic 動作對玩家所做的完整變更集。
最後，請務必注意，獎勵識別碼不會在呼叫 GetAdPlacements 時繫結至玩家。根據您提供的權重，多次呼叫 GetAdPlacements 可能會導致獎勵變更。呼叫 RewardAdActivity 只要求獎勵對玩家有效，並不要求它是 GetAdPlacements 最後傳回的獎勵。