> ## 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.

# player_ad_rewarded

> player_ad_rewarded 事件。

当玩家收到广告奖励时会触发此事件。

## 属性

| 名称                       | 类型     | 描述                       |
| :----------------------- | :----- | :----------------------- |
| ActionGroupDebugMessages | \[]    | 来自奖励操作的调试消息              |
| AdPlacementId            | String | 广告位的 ID                  |
| AdPlacementName          | String | 广告位的名称                   |
| AdUnit                   | String | 广告单元类型                   |
| RewardId                 | String | 奖励的 ID                   |
| RewardName               | String | 奖励的名称                    |
| TitleId                  | String | 此玩家事件适用的游戏的 ID。          |
| ViewsRemainingThisPeriod | int32  | 该玩家在此广告位的窗口中剩余的观看次数（如适用） |

## 常见属性

所有 V1 PlayStream 事件均以 JSON 对象形式格式化，并共享以下常见属性：

| 名称             | 类型                                                                          | 描述                                                                                                                                                                      |
| :------------- | :-------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| EntityId       | String                                                                      | 此事件适用的实体（游戏、玩家等）的标识符。                                                                                                                                                   |
| EntityType     | String                                                                      | 此事件适用的实体（玩家、游戏等）的类型。如果 PlayFab 需要对此实体执行操作，则 EntityType 必须是“player”、“character”或“title”之一。任何 PlayFab 目前不解析的实体类型都必须以命名空间（例如“com.mygame.guild”）为前缀，因为 PlayFab 可能随时开始解析根实体。 |
| EventId        | String                                                                      | PlayFab 为此事件分配的唯一标识符。                                                                                                                                                   |
| EventName      | String                                                                      | 此事件的名称。                                                                                                                                                                 |
| EventNamespace | String                                                                      | 为此事件分配的命名空间。例如：“com.myprogram.ads”                                                                                                                                      |
| Source         | String                                                                      | 此 PlayStream 事件的源的名称；如果事件源自我们的系统，则为 PlayFab。                                                                                                                            |
| SourceType     | [SourceType](/services/playfab/api-references/events/data-types/sourcetype) | 此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。                                                                                                                              |
| Timestamp      | DateTime                                                                    | 与此事件关联的时间（UTC）。                                                                                                                                                         |


## Related topics

- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [player_ad_started](/zh-CN/services/playfab/api-references/events/AdPlacement/player-ad-started.md)
- [player_ad_closed](/zh-CN/services/playfab/api-references/events/AdPlacement/player-ad-closed.md)
- [player_ad_ended](/zh-CN/services/playfab/api-references/events/AdPlacement/player-ad-ended.md)
- [player_ad_opened](/zh-CN/services/playfab/api-references/events/AdPlacement/player-ad-opened.md)