Esta página descreve os eventos do utilizador para apps de pesquisa e recomendações de multimédia, incluindo tipos de eventos do utilizador, requisitos e exemplos de tipos de eventos do utilizador. Os eventos do utilizador são necessários para apps de multimédia.
Para informações gerais sobre a pesquisa e as recomendações de multimédia, consulte o artigo Introdução à pesquisa e às recomendações de multimédia.
Para obter ajuda com o registo de eventos do utilizador, consulte o artigo Registe eventos do utilizador em tempo real. Para importar eventos de utilizadores anteriores em massa, consulte o artigo Importe eventos de utilizadores históricos.
Tipos de eventos do utilizador
Pode registar os seguintes tipos de eventos do utilizador à medida que os utilizadores finais navegam ou pesquisam no seu site:
Nome do evento do utilizador | Ação do utilizador |
---|---|
view-item |
Ver detalhes de um documento. |
view-home-page |
Visualiza a página inicial. |
search |
Pesquisa na loja de dados. |
media-play |
Clica em play num item multimédia. |
media-complete |
Interrompe a reprodução de um item multimédia, o que significa que terminou de ver o conteúdo. |
Para ver detalhes sobre o objeto de evento do utilizador, consulte a
UserEvent
documentação de referência da API.
Requisitos de eventos para a pesquisa e as recomendações de multimédia
Os tipos de eventos de utilizador de que precisa são determinados consoante a sua app seja uma app de pesquisa ou uma app de recomendações, pelo objetivo (taxa de cliques, taxa de conversão ou duração da visualização) e, apenas para apps de recomendações, pelo tipo de modelo que escolheu. Para mais informações acerca dos tipos de modelos de recomendações e dos objetivos de otimização, consulte o artigo Acerca dos tipos de recomendações de apps de multimédia.
Para determinar que eventos do utilizador tem de recolher, consulte a tabela seguinte.
Evento | search |
view-home-page |
view-item |
media-play |
media-complete |
||
---|---|---|---|---|---|---|---|
Exemplo de utilização da pesquisa | |||||||
Obrigatória | Não obrigatório |
Obrigatória | Obrigatória | Obrigatória | |||
Tipo de modelo recomendado para si, por objetivo | |||||||
CTR | Não obrigatório |
Obrigatório para o contexto da página inicial Não obrigatório para o contexto geral |
É necessário indicar view-item ou media-play |
Recomendado Obrigatório se a despromoção do histórico estiver ativada |
|||
CVR | Não obrigatório |
Obrigatório para o contexto da página inicial Não obrigatório para o contexto geral |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Duração da visualização | Não obrigatório |
Obrigatório para o contexto da página inicial Não obrigatório para o contexto geral |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Tipo de modelo "Outros que podem gostar", por objetivo | |||||||
CTR | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Recomendado Obrigatório se a diminuição da importância do histórico estiver ativada |
|||
CVR | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Duração da visualização | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Tipo de modelo "Mais deste género", por objetivo | |||||||
CTR | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Obrigatório se a despromoção do histórico estiver ativada | |||
CVR | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Duração da visualização | Não obrigatório |
Não obrigatório |
É necessário indicar view-item ou media-play |
Obrigatória | |||
Tipo de modelo mais popular, por objetivo | |||||||
CTR | Não obrigatório |
Não obrigatório |
É necessário um dos seguintes campos: view-item ou media-play |
Não obrigatório |
|||
CVR | Não obrigatório |
Não obrigatório |
Não obrigatório |
Não obrigatório |
Obrigatória |
Requisitos para eventos de utilizadores de multimédia
Certifique-se de que os eventos do utilizador cumprem os seguintes requisitos para que as suas apps de multimédia possam gerar resultados de qualidade.
Tipo de evento | Requisito | Impacto |
---|---|---|
Todos os eventos |
Não inclua dados sintéticos nem eventos duplicados. |
Os eventos sintéticos ou duplicados afetam negativamente a qualidade dos resultados e podem impedir a implementação da sua app. Os eventos duplicados podem causar valores de métricas incorretos. |
Inclua, pelo menos, 100 pseudo IDs de utilizadores únicos para cada tipo de evento carregado. |
Inclua estes IDs para que as apps de recomendações de conteúdo multimédia tenham dados suficientes para gerar resultados de qualidade. |
|
Os pseudo IDs dos utilizadores têm de ser formatados exatamente da mesma forma na importação de eventos ou na gravação de eventos e nos pedidos de recomendações de multimédia. |
A utilização de um formato consistente para os pseudónimos dos utilizadores ajuda as apps de recomendações de multimédia a identificar corretamente os padrões dos visitantes e a fornecer resultados de melhor qualidade com base no comportamento dos utilizadores. |
|
O campo |
Um evento que inclua um documento sem um campo |
|
Os documentos incluídos nos eventos devem existir no seu repositório de dados. |
A proporção de eventos não associados deve ser mantida o mais baixa possível. Uma elevada proporção pode afetar negativamente a qualidade dos resultados. |
|
Alguns eventos de utilizador devem ter o mesmo ID pseudo do utilizador. |
Para criar históricos de sequências de comportamento válidos, as apps de recomendações de multimédia têm de conseguir ver vários eventos com o mesmo pseudo ID do utilizador.
Por exemplo, |
|
view-item |
Inclua exatamente um documento por evento. |
Não é possível usar o evento se não existir nenhum documento. Se forem incluídos vários documentos, o evento está formatado incorretamente e não pode ser usado. |
search |
Inclua o |
O |
media-play |
Inclua exatamente um documento por evento. |
Se forem incluídos vários documentos, o evento está formatado incorretamente e não pode ser usado. |
Etiquetas de eventos de utilizadores para testes A/B
Se fizer testes A/B, certifique-se de que adiciona IDs de etiquetas a todos os eventos do utilizador que recolhe, adicionando uma etiqueta para cada grupo de teste.
Por exemplo, adicione a etiqueta "tagIds": ["original"]
aos eventos do utilizador do seu modelo atual e adicione a etiqueta "tagIds": ["google"]
aos eventos do utilizador da Vertex AI Search for media.
Exemplos e esquemas de tipos de eventos de utilizadores
Esta secção fornece os formatos de dados para cada tipo de evento suportado pelas recomendações de multimédia. São facultados exemplos do Pixel de JavaScript. Para o BigQuery, é fornecido o esquema completo da tabela para cada tipo.
Para todos os tipos de eventos de utilizador, userId
é opcional.
Para mais detalhes sobre o objeto de evento do utilizador, consulte a
UserEvent
documentação de referência da API.
view_item
O exemplo seguinte mostra o formato dos dados de eventos do utilizador view-item
.
Objeto view_item mínimo necessário
Os exemplos seguintes mostram apenas os campos obrigatórios do view-item
formato de evento do utilizador.
Na maioria dos casos, documents
contém detalhes do documento associado.
Píxel de JavaScript
var user_event = {
"eventType": "view-item",
"userPseudoId": "user-pseudo-id",
"eventTime": "2020-01-01T03:33:33.000001Z",
"documents": [{
"id": "document-id"
}]
"panels": [
{
"panelId": "HOME_RFY_1",
"documents": [
{
"id": "123"
},
{
"id": "456"
}
],
"panelPosition": 1,
"totalPanels": 2
}
]
};
BigQuery
Este é o esquema JSON completo para este tipo de evento de utilizador. Especifique este esquema quando criar tabelas para este tipo de evento do utilizador no BigQuery.
Os modos dos campos obrigatórios estão definidos como REQUIRED
ou REPEATED
. Os modos dos campos opcionais estão definidos como NULLABLE
.
Tenha em atenção que o eventTime
é necessário para importar eventos com o
BigQuery. eventTime
é uma string com um formato de data/hora.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
view-home-page
O exemplo seguinte mostra o formato do evento de utilizador view-home-page
.
Objeto view-home-page mínimo necessário
Os exemplos seguintes mostram apenas os campos obrigatórios do view-home-page
formato de evento do utilizador.
Píxel de JavaScript
var user_event = {
"eventType": "view-home-page",
"userPseudoId": "user-pseudo-id",
"eventTime": "2020-01-01T03:33:33.000001Z",
"panels": [
{
"panelId": "HOME_RFY_1",
"documents": [
{
"id": "123"
},
{
"id": "456"
}
],
"panelPosition": 1,
"totalPanels": 2
}
]
};
BigQuery
Este é o esquema JSON completo para este tipo de evento de utilizador. Especifique este esquema quando criar tabelas para este tipo de evento do utilizador no BigQuery.
Os modos dos campos obrigatórios estão definidos como REQUIRED
ou REPEATED
. Os modos dos campos opcionais estão definidos como NULLABLE
.
Tenha em atenção que o eventTime
é necessário para importar eventos com o
BigQuery. eventTime
é uma string com um formato de data/hora.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" }, { "name": "quantity", "type": "INT64", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
Para obter informações sobre o objeto panels
, consulte o artigo Acerca dos painéis.
pesquisa
O exemplo seguinte mostra o formato do evento de utilizador search
.
Objeto de pesquisa mínimo necessário
Os exemplos seguintes mostram apenas os campos obrigatórios do formato de search
evento de utilizador.
searchQuery
para eventos de pesquisa em que o utilizador introduziu uma consulta de texto.
O attributionToken
é devolvido com os resultados da consulta de pesquisa.
documents
deve incluir a lista de IDs dos documentos apresentados ao utilizador final na página de resultados da pesquisa.
Píxel de JavaScript
var user_event = {
eventType: "search",
userPseudoId: "user-pseudo-id",
eventTime: "2020-01-01T03:33:33.000001Z",
searchInfo: {
searchQuery: "search-query",
},
attributionToken: "attribution-token",
documents: [
{
id: "document-id1",
},
{
id: "document-id2",
},
]
};
BigQuery
Este é o esquema JSON completo para este tipo de evento de utilizador. Especifique este esquema quando criar tabelas para este tipo de evento do utilizador no BigQuery.
Os modos dos campos obrigatórios estão definidos como REQUIRED
ou REPEATED
. Os modos dos campos opcionais estão definidos como NULLABLE
.
Tenha em atenção que o eventTime
é necessário para importar eventos com o
BigQuery. eventTime
é uma string com um formato de data/hora.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "searchInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "searchQuery", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageCategory", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] } ]
media-play
O exemplo seguinte mostra o formato do evento de utilizador media-play
.
Objeto media-play mínimo necessário
Os exemplos seguintes mostram apenas os campos obrigatórios do formato de evento de utilizador media-play
.
Píxel de JavaScript
var user_event = {
"eventType": "media-play",
"userPseudoId": "user-pseudo-id",
"eventTime": "2020-01-01T03:33:33.000001Z",
"documents": [
{
"id": "document-id1"
}
]
};
BigQuery
Este é o esquema JSON completo para este tipo de evento de utilizador. Especifique este esquema quando criar tabelas para este tipo de evento do utilizador no BigQuery.
Os modos dos campos obrigatórios estão definidos como REQUIRED
ou REPEATED
. Os modos dos campos opcionais estão definidos como NULLABLE
.
Tenha em atenção que o eventTime
é necessário para importar eventos com o
BigQuery. eventTime
é uma string com um formato de data/hora.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
media-complete
O exemplo seguinte mostra o formato do evento de utilizador media-complete
.
Objeto de conclusão de multimédia mínimo necessário
Os exemplos seguintes mostram apenas os campos obrigatórios do media-complete
formato de evento do utilizador.
Píxel de JavaScript
var user_event = {
"eventType": "media-complete",
"userPseudoId": "user-pseudo-id",
"eventTime": "2020-01-01T03:33:33.000001Z",
"documents": [
{
"id": "document-id1"
}
],
"mediaInfo": {
"mediaProgressDuration": "65s",
"mediaProgressPercentage": 0.2
}
};
BigQuery
Este é o esquema JSON completo para este tipo de evento de utilizador. Especifique este esquema quando criar tabelas para este tipo de evento do utilizador no BigQuery.
Os modos dos campos obrigatórios estão definidos como REQUIRED
ou REPEATED
. Os modos dos campos opcionais estão definidos como NULLABLE
.
Tenha em atenção que o eventTime
é necessário para importar eventos com o
BigQuery. eventTime
é uma string com um formato de data/hora.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] }, { "name": "mediaInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "mediaProgressDuration", "type": "STRING", "mode": "NULLABLE" }, { "name": "mediaProgressPercentage", "type": "NUMERIC", "mode": "NULLABLE" } ] } ]
Atributos personalizados
Pode incluir atributos e funcionalidades personalizados adicionais para eventos do utilizador. Isto
pode resultar em resultados melhorados e mais específicos para os seus utilizadores.
Para adicionar atributos personalizados, use attributes
quando
registar um evento do utilizador.
Se fornecer atributos personalizados para eventos de utilizadores carregados, é importante incluí-los também nos eventos de utilizadores que associa a pedidos de recomendações e de pesquisa. A formatação dos atributos personalizados tem de ser consistente entre os eventos importados e os eventos fornecidos com pedidos. Isto permite que as apps de multimédia usem esses atributos personalizados para melhorar a qualidade.
Pode fornecer valores de texto personalizados através do campo text
ou valores numéricos personalizados através do campo numbers
.
Por exemplo, o seguinte mostra a secção attributes
de um pedido para registar um evento do utilizador:
attributes: { user_age: {text: ["teen", "young adult"]}, user_location: {text: ["CA"]}, user_zip: {numbers: [90210]} }
Acerca das informações do utilizador
userPseudoId
representa o identificador único do utilizador e é obrigatório quando
regista um evento do utilizador.
As informações do utilizador (UserInfo
) incluídas quando regista um evento
do utilizador contêm o valor userPseudoId
e, se disponível, o valor userId
.
userId
é opcional e pode ser usado como um identificador único e persistente de um utilizador em vários dispositivos sempre que um utilizador inicia sessão no seu site. Quando regista o
userId
para um utilizador,
as apps de pesquisa e recomendações de multimédia
podem gerar resultados mais personalizados para um utilizador em vários dispositivos,
como um dispositivo móvel e um navegador de Internet.
Acerca da indicação de tempo
Quando regista um evento do utilizador, certifique-se de que inclui uma indicação de tempo precisa de quando o evento ocorreu. As datas/horas precisas garantem que os seus eventos são armazenados pela ordem correta. As datas/horas são registadas automaticamente para eventos recolhidos
através do píxel do JavaScript. Quando importa eventos, tem de indicar a data/hora no campo eventTime
no formato especificado pela RFC 3339.
Acerca dos painéis
Numa página inicial, normalmente, tem um ou mais painéis, como um painel "Tendências atuais" e um painel "Recomendado para si". Nas páginas de detalhes, também pode ter painéis, como "outros que podem interessar-lhe".
Informações do painel para eventos do utilizador
São necessárias informações do painel para eventos de utilizador de recomendação do tipo
view-home-page
e view-item
. As informações do painel são necessárias para as páginas iniciais e as páginas de detalhes que apresentam conteúdo recomendado pela Google.
Se estiver a realizar testes A/B para um painel, tem de registar eventos do utilizador com informações do painel para todo o conteúdo no teste, independentemente da origem. Para as páginas iniciais e as páginas de detalhes sem conteúdo de painéis gerado pela Google, é recomendado, mas não obrigatório, fornecer informações de painéis nos eventos view-home-page
e view-item
. Estes requisitos estão resumidos na tabela seguinte:
Origem do evento do utilizador (view-home-page e view-item )
|
PanelInfo obrigatório
|
---|---|
Inclui conteúdo recomendado pela Google | Sim |
Inclui conteúdo NÃO recomendado pela Google e usado em testes A/B | Sim |
Inclui conteúdo NÃO recomendado pela Google e NÃO usado em testes A/B | Não |
As informações do painel (PanelInfo
) são um conjunto de campos que descrevem vários elementos do painel:
O número de ID do painel
O nome a apresentar
A posição do painel na página (por exemplo, o primeiro painel [
1
] na página ou o terceiro painel [3
] na página)O número total de painéis na página
A lista de documentos (
DocumentInfo
) apresentada em cada painel
Para obter informações detalhadas sobre os objetos PanelInfo
, consulte o artigo
PanelInfo.
Pré-carregar painéis em comparação com o carregamento diferido de painéis
Existem dois métodos comuns para apresentar recomendações em páginas Web ou páginas para dispositivos móveis.
O método que usa determina o número e o conteúdo dos view-home-page
eventos do utilizador que regista.
Pré-carregamento: com o pré-carregamento, todos os itens de recomendações são gerados quando o utilizador chega à página. Neste caso, quando o utilizador carrega a página inicial, regista um evento de utilizador
view-home-page
(ouview-item
) com todos os painéis e documentos.Carregamento em diferido: com o carregamento em diferido, o conteúdo do painel não é gerado quando o utilizador chega à página. Em vez disso, o conteúdo é carregado dinamicamente quando o utilizador desloca a página para baixo até aos painéis ou para a direita para ver mais recomendações. Neste caso, quando um utilizador carrega a página inicial, regista um evento de utilizador
view-home-page
inicial (ouview-item
) e, em seguida, continua a registar mais eventos quando o utilizador desloca a página para gerar mais conteúdo recomendado. Nos eventos subsequentes, só tem de incluir na matrizpanels
o incremento de documentos apresentados.
Cenário de exemplo
A página inicial de uma empresa de multimédia apresenta dois painéis de recomendações:
Um painel de tendências do momento com tecnologia do modelo Mais popular.
Um painel de recomendações personalizado que está a ser testado com testes A/B. Alguns utilizadores veem um painel de sugestões com tecnologia do modelo Recomendado para si (grupo A), e outros utilizadores veem recomendações do modelo proprietário da empresa (grupo B).
Quando um utilizador atribuído ao grupo B vê esta página inicial, o evento de utilizador no formato de píxel JavaScript tem o seguinte aspeto:
var user_event = { "eventType": "view-home-page", "userPseudoId": "4003345673.123451357", "eventTime": "2025-07-01T03:33:33.000001Z", "userInfo": { "userId": "jane.doe@example.com", }, "tagIds": ["group-B"], "panels": [ { "panelId": "panel-1", "displayId": "Trending Now", "documents": [ { "id": "254722" }, { "id": "2951" }, ... { "id": "1201" } ], "panelPosition": 1, "totalPanels": 2 }, { "panelId": "panel-2", "displayId": "Recommended for You", "documents": [ { "id": "79132" }, { "id": "109487" }, ... { "id": "164179" } ], "panelPosition": 2, "totalPanels": 2 } ] };
O que se segue?
- Saiba como registar eventos de utilizadores.