在显示可播放地点以及用户与这些地点互动时记录新事件。
系统未保存部分展示;要么系统已保存所有展示且此请求成功,要么未保存任何展示,导致此请求失败。
HTTP 请求
POST https://playablelocations.googleapis.com/v3:logImpressions
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 | |
---|---|
{ "impressions": [ { object ( |
字段 | |
---|---|
impressions[] |
必需。展示事件详细信息。您一次最多可记录 50 个展示报告。 |
requestId |
必需。用于唯一标识日志展示次数请求的字符串。这样可以检测重复请求。我们建议您为此值使用 UUID。该值不得超过 50 个字符。 只有在失败时重试请求,才应重复使用 |
clientInfo |
必需。客户端设备的相关信息。例如,设备型号和操作系统。 |
响应正文
如果成功,则响应正文将为空。
展示
封装展示事件详情。
JSON 表示法 | |
---|---|
{
"locationName": string,
"impressionType": enum ( |
字段 | |
---|---|
locationName |
必需。可播放位置的名称。 |
impressionType |
必需。展示事件类型。 |
gameObjectType |
开发者为游戏中使用的每种游戏对象类型定义的任意类型标识符。 由于玩家会以不同的方式与不同类型的游戏对象互动,因此您可以通过此字段按类型划分展示数据,以便进行分析。 您应该分配一个唯一的 例如,1=怪兽位置,2=能力提升道具位置。 |
ImpressionType
展示事件类型。
枚举 | |
---|---|
IMPRESSION_TYPE_UNSPECIFIED |
未指定类型。请勿使用。 |
PRESENTED |
向玩家呈现了可播放位置。 |
INTERACTED |
玩家与可播放位置进行了互动。 |