Method: logImpressions

在显示可播放地点以及用户与这些地点互动时记录新事件。

系统未保存部分展示;要么系统已保存所有展示且此请求成功,要么未保存任何展示,导致此请求失败。

HTTP 请求

POST https://playablelocations.googleapis.com/v3:logImpressions

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "impressions": [
    {
      object (Impression)
    }
  ],
  "requestId": string,
  "clientInfo": {
    object (ClientInfo)
  }
}
字段
impressions[]

object (Impression)

必需。展示事件详细信息。您一次最多可记录 50 个展示报告。

requestId

string

必需。用于唯一标识日志展示次数请求的字符串。这样可以检测重复请求。我们建议您为此值使用 UUID。该值不得超过 50 个字符。

只有在失败时重试请求,才应重复使用 requestId。在这种情况下,请求必须与失败的请求相同。

clientInfo

object (ClientInfo)

必需。客户端设备的相关信息。例如,设备型号和操作系统。

响应正文

如果成功,则响应正文将为空。

展示

封装展示事件详情。

JSON 表示法
{
  "locationName": string,
  "impressionType": enum (ImpressionType),
  "gameObjectType": integer
}
字段
locationName

string

必需。可播放位置的名称。

impressionType

enum (ImpressionType)

必需。展示事件类型。

gameObjectType

integer

开发者为游戏中使用的每种游戏对象类型定义的任意类型标识符。

由于玩家会以不同的方式与不同类型的游戏对象互动,因此您可以通过此字段按类型划分展示数据,以便进行分析。

您应该分配一个唯一的 gameObjectType ID 来代表游戏中不同类型的游戏对象。

例如,1=怪兽位置,2=能力提升道具位置。

ImpressionType

展示事件类型。

枚举
IMPRESSION_TYPE_UNSPECIFIED 未指定类型。请勿使用。
PRESENTED 向玩家呈现了可播放位置。
INTERACTED 玩家与可播放位置进行了互动。