Method: logImpressions

Registra novos eventos quando os locais de reprodução são exibidos e quando há interação com eles.

As impressões não são parcialmente salvas. Ou todas as impressões são salvas e essa solicitação é bem-sucedida, ou nenhuma impressão é salva, e a solicitação falha.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "impressions": [
    {
      object (Impression)
    }
  ],
  "requestId": string,
  "clientInfo": {
    object (ClientInfo)
  }
}
Campos
impressions[]

object (Impression)

Obrigatório. Detalhes do evento de impressão O número máximo de relatórios de impressão que pode ser registrado ao mesmo tempo é 50.

requestId

string

Obrigatório. Uma string que identifica exclusivamente a solicitação de impressões de registro. Isso permite que você detecte solicitações duplicadas. Recomendamos que você use UUIDs para esse valor. O valor não pode exceder 50 caracteres.

Reutilize o requestId somente ao repetir uma solicitação em caso de falha. Nesse caso, a solicitação precisa ser idêntica à que falhou.

clientInfo

object (ClientInfo)

Obrigatório. Informações sobre o dispositivo cliente. Por exemplo, modelo do dispositivo e sistema operacional.

Corpo da resposta

Se bem-sucedido, o corpo da resposta fica vazio.

Impressão

Encapsula os detalhes do evento de impressão.

Representação JSON
{
  "locationName": string,
  "impressionType": enum (ImpressionType),
  "gameObjectType": integer
}
Campos
locationName

string

Obrigatório. O nome do local onde pode ser exibido.

impressionType

enum (ImpressionType)

Obrigatório. É o tipo de evento de impressão.

gameObjectType

integer

Um identificador de tipo arbitrário e definido pelo desenvolvedor para cada tipo de objeto usado no jogo.

Como os jogadores interagem com diferentes tipos de objetos do jogo de maneiras diferentes, esse campo permite segregar os dados de impressão por tipo para análise.

Atribua um ID gameObjectType exclusivo para representar um tipo distinto de objeto no jogo.

Por exemplo, 1=localização do monstro, 2=localização do power-up.

ImpressionType

É o tipo de evento de impressão.

Enums
IMPRESSION_TYPE_UNSPECIFIED Tipo não especificado. Não use.
PRESENTED O local onde o usuário pode jogar foi apresentado a um jogador.
INTERACTED Um jogador interagiu com o local jogável.