Informazioni sugli eventi utente relativi ai contenuti multimediali

Questa pagina descrive gli eventi utente per le app di ricerca e suggerimenti di contenuti multimediali, inclusi tipi di eventi utente, requisiti ed esempi per i tipi di eventi utente. Gli eventi utente sono obbligatori per le app multimediali.

Per informazioni generali sulla ricerca e sui consigli sui contenuti multimediali, consulta Introduzione alla ricerca e ai consigli sui contenuti multimediali.

Per assistenza con la registrazione degli eventi utente, consulta Registra gli eventi utente in tempo reale. Per importare in blocco gli eventi utente passati, consulta Importare gli eventi utente storici.

Tipi di eventi utente

Puoi registrare i seguenti tipi di eventi utente mentre gli utenti finali navigano o eseguono ricerche sul tuo sito:

Nome evento utente Azione dell'utente
view-item Visualizza i dettagli di un documento.
view-home-page Visualizza la home page.
search Cerca nel datastore.
media-play I clic vengono riprodotti su un elemento multimediale.
media-complete Interrompe la riproduzione di un elemento multimediale, segnalando la fine della visione.

Per informazioni dettagliate sull'oggetto evento utente, consulta la documentazione di riferimento dell'API UserEvent.

Requisiti degli eventi per la ricerca e i suggerimenti sui contenuti multimediali

I tipi di eventi utente necessari sono determinati dal fatto che la tua app sia un'app di ricerca o di consigli, dall'obiettivo (percentuale di clic, tasso di conversione o durata della visualizzazione) e, solo per le app di consigli, dal tipo di modello che hai scelto. Per saperne di più sui tipi di modelli di consigli e sugli obiettivi di ottimizzazione, consulta Informazioni sui tipi di consigli per le app multimediali.

Per determinare quali eventi utente devi raccogliere, consulta la seguente tabella.

Evento search view-home-page view-item media-play media-complete
Caso d'uso della ricerca
Obbligatorio Non
obbligatorio		 Obbligatorio Obbligatorio Obbligatorio
Tipo di modello Consigliati per te, per obiettivo
CTR Non
obbligatorio		 Obbligatorio per il contesto della home page

Non obbligatorio per il contesto generale		 È obbligatorio specificare view-item o media-play.
Fortemente consigliato

Obbligatorio se la retrocessione della cronologia è attivata
CVR Non
obbligatorio		 Obbligatorio per il contesto della home page

Non obbligatorio per il contesto generale		 È obbligatorio specificare view-item o media-play. Obbligatorio
Durata della visualizzazione Non
obbligatorio		 Obbligatorio per il contesto della home page

Non obbligatorio per il contesto generale		 È obbligatorio specificare view-item o media-play. Obbligatorio
Tipo di modello Altri che ti potrebbero piacere, per obiettivo
CTR Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play.
Fortemente consigliato

Obbligatorio se la retrocessione della cronologia è attivata
CVR Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Obbligatorio
Durata della visualizzazione Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Obbligatorio
Tipo di modello Più simili, per obiettivo
CTR Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Obbligatorio se la retrocessione della cronologia è attiva
CVR Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Obbligatorio
Durata della visualizzazione Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Obbligatorio
Tipo di modello più popolare, per obiettivo
CTR Non
obbligatorio		 Non
obbligatorio		 È obbligatorio specificare view-item o media-play. Non
obbligatorio
CVR Non
obbligatorio		 Non
obbligatorio		 Non
obbligatorio		 Non
obbligatorio		 Obbligatorio

Requisiti per gli eventi utente multimediali

Assicurati che gli eventi utente soddisfino i seguenti requisiti in modo che le tue app multimediali possano generare risultati di qualità.

Tipo di evento Requisito Impatto
Tutti gli eventi

Non includere dati sintetici o eventi duplicati.

Gli eventi sintetici o duplicati influiscono negativamente sulla qualità dei risultati e possono impedirti di eseguire il deployment dell'app. Gli eventi duplicati possono causare valori delle metriche errati.

Includi almeno 100 pseudo ID utente unici per ogni tipo di evento inserito.

Includi questi ID in modo che le app di consigli sui contenuti multimediali abbiano dati sufficienti per generare risultati di qualità.

Gli pseudo ID utente devono essere formattati esattamente nello stesso modo nell'importazione degli eventi o nella registrazione degli eventi e nelle richieste di suggerimenti sui contenuti multimediali.

L'utilizzo di un formato coerente per gli ID pseudo degli utenti aiuta le app di consigli sui contenuti multimediali a identificare correttamente i pattern dei visitatori e a fornire risultati di qualità migliore in base al comportamento degli utenti.

Il campo DocumentInfo.name o il campo DocumentInfo.id è obbligatorio per tutti i documenti.

Un evento che include un documento senza un campo DocumentInfo.name o un campo DocumentInfo.id non può essere utilizzato dalle app per i consigli sui contenuti multimediali.

I documenti inclusi negli eventi devono esistere nel datastore.

Il rapporto tra gli eventi non uniti deve essere mantenuto il più basso possibile. Un rapporto elevato può influire negativamente sulla qualità dei risultati.

Alcuni eventi utente devono avere lo stesso pseudo ID utente.

Per creare cronologie valide delle sequenze di comportamenti, le app di suggerimenti sui contenuti multimediali devono essere in grado di visualizzare più eventi con lo stesso ID pseudo utente.

Ad esempio, visitor123 ha visualizzato cinque elementi e ha fatto clic su Riproduci su due di questi. Se questi eventi forniscono lo stesso pseudo ID utente con formattazione coerente, un'app di consigli sui contenuti multimediali può prendere in considerazione questa sequenza di comportamenti nei suoi risultati.

view-item

Includi esattamente un documento per evento.

L'evento non può essere utilizzato se non esiste alcun documento. Se sono inclusi più documenti, l'evento è malformato e non può essere utilizzato.

search

Includi il attributionToken. Il attributionToken viene restituito dal metodo search insieme ai risultati di ricerca o navigazione.

attributionToken consente a Vertex AI Search di attribuire con precisione l'evento di ricerca a una particolare risposta di ricerca.

media-play

Includi esattamente un documento per evento.

Se sono inclusi più documenti, l'evento è malformato e non può essere utilizzato.

Tag evento utente per i test A/B

Se esegui test A/B, assicurati di aggiungere gli ID tag a tutti gli eventi utente che raccogli, aggiungendo un tag per ogni gruppo di test.

Ad esempio, aggiungi il tag "tagIds": ["original"] agli eventi utente del tuo modello attuale e il tag "tagIds": ["google"] agli eventi utente di Vertex AI Search per i contenuti multimediali.

Esempi e schemi di tipi di eventi utente

Questa sezione fornisce i formati dei dati per ogni tipo di evento supportato dai consigli sui contenuti multimediali. Vengono forniti esempi per il pixel JavaScript. Per BigQuery, viene fornito lo schema completo della tabella per ogni tipo.

Per tutti i tipi di eventi utente, userId è facoltativo.

Per ulteriori dettagli sull'oggetto evento utente, consulta la documentazione di riferimento dell'API UserEvent.

view-item

Di seguito è riportato il formato dei dati sugli eventi utente view-item.

Oggetto visualizzazione articolo minimo richiesto

Gli esempi seguenti mostrano solo i campi obbligatori del formato dell'evento utente view-item.

Nella maggior parte dei casi, documents contiene i dettagli del documento associato.

Pixel 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

Questo è lo schema JSON completo per questo tipo di evento utente. Specifica questo schema quando crei tabelle per questo tipo di evento utente in BigQuery.

Le modalità per i campi obbligatori sono impostate su REQUIRED o REPEATED. Le modalità per i campi facoltativi sono impostate su NULLABLE.

Tieni presente che eventTime è necessario per importare eventi con BigQuery. eventTime è una stringa con un formato timestamp. 

[
  {
    "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

Di seguito viene mostrato il formato dell'evento utente view-home-page.

Oggetto Visualizza home page minimo richiesto

Gli esempi seguenti mostrano solo i campi obbligatori del formato dell'evento utente view-home-page.

Pixel 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

Questo è lo schema JSON completo per questo tipo di evento utente. Specifica questo schema quando crei tabelle per questo tipo di evento utente in BigQuery.

Le modalità per i campi obbligatori sono impostate su REQUIRED o REPEATED. Le modalità per i campi facoltativi sono impostate su NULLABLE.

Tieni presente che eventTime è necessario per importare eventi con BigQuery. eventTime è una stringa con un formato timestamp. 

[
  {
    "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"
          }
        ]
      }
    ]
  }
]

Per informazioni sull'oggetto panels, consulta Informazioni sui riquadri.

Di seguito viene mostrato il formato dell'evento utente search.

Oggetto di ricerca minimo richiesto

Gli esempi seguenti mostrano solo i campi obbligatori del formato dell'evento utente search.

Fornisci searchQuery per gli eventi di ricerca in cui l'utente ha inserito una query di testo.

Il attributionToken viene restituito con i risultati della query di ricerca.

documents deve includere l'elenco degli ID documento mostrati all'utente finale nella pagina dei risultati di ricerca.

Pixel 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

Questo è lo schema JSON completo per questo tipo di evento utente. Specifica questo schema quando crei tabelle per questo tipo di evento utente in BigQuery.

Le modalità per i campi obbligatori sono impostate su REQUIRED o REPEATED. Le modalità per i campi facoltativi sono impostate su NULLABLE.

Tieni presente che eventTime è necessario per importare eventi con BigQuery. eventTime è una stringa con un formato timestamp. 

[
  {
    "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

Di seguito viene mostrato il formato dell'evento utente media-play.

Oggetto di riproduzione multimediale minimo richiesto

I seguenti esempi mostrano solo i campi obbligatori del formato dell'evento utente media-play.

Pixel JavaScript

var user_event = {
  "eventType": "media-play",
  "userPseudoId": "user-pseudo-id",
  "eventTime": "2020-01-01T03:33:33.000001Z",
  "documents": [
    {
      "id": "document-id1"
    }
  ]
};

BigQuery

Questo è lo schema JSON completo per questo tipo di evento utente. Specifica questo schema quando crei tabelle per questo tipo di evento utente in BigQuery.

Le modalità per i campi obbligatori sono impostate su REQUIRED o REPEATED. Le modalità per i campi facoltativi sono impostate su NULLABLE.

Tieni presente che eventTime è necessario per importare eventi con BigQuery. eventTime è una stringa con un formato timestamp. 

[
  {
    "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

Di seguito viene mostrato il formato dell'evento utente media-complete.

Oggetto minimo richiesto con completamento dei contenuti multimediali

Gli esempi seguenti mostrano solo i campi obbligatori del formato dell'evento utente media-complete.

Pixel 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

Questo è lo schema JSON completo per questo tipo di evento utente. Specifica questo schema quando crei tabelle per questo tipo di evento utente in BigQuery.

Le modalità per i campi obbligatori sono impostate su REQUIRED o REPEATED. Le modalità per i campi facoltativi sono impostate su NULLABLE.

Tieni presente che eventTime è necessario per importare eventi con BigQuery. eventTime è una stringa con un formato timestamp. 

[
  {
    "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"
      }
    ]
  }
]

Attributi personalizzati

Puoi includere attributi e funzionalità personalizzati aggiuntivi per gli eventi utente. Ciò può portare a risultati migliori e più specifici per i tuoi utenti. Per aggiungere attributi personalizzati, utilizza attributes quando registri un evento utente.

Se fornisci attributi personalizzati per gli eventi utente importati, è importante includerli anche negli eventi utente che associ alle richieste di suggerimenti e di ricerca. La formattazione degli attributi personalizzati deve essere coerente tra gli eventi importati e quelli forniti con le richieste. In questo modo, le app multimediali possono utilizzare questi attributi personalizzati per migliorare la qualità.

Puoi fornire valori di testo personalizzati utilizzando il campo text o valori numerici personalizzati utilizzando il campo numbers.

Ad esempio, di seguito è riportata la sezione attributes di una richiesta per registrare un evento utente:

  attributes: {
    user_age: {text: ["teen", "young adult"]},
    user_location: {text: ["CA"]},
    user_zip: {numbers: [90210]}
  }

Informazioni sull'utente

userPseudoId rappresenta l'identificatore utente unico ed è obbligatorio quando registri un evento utente.

Le informazioni utente (UserInfo) incluse quando registri un evento utente contengono il valore userPseudoId e, se disponibile, il valore userId. userId è facoltativo e può essere utilizzato come identificatore univoco e permanente per un utente su più dispositivi ogni volta che un utente accede al tuo sito. Quando registri l'userId per un utente, le app di ricerca e consigli multimediali possono generare risultati più personalizzati per un utente su più dispositivi, ad esempio sia un dispositivo mobile che un browser web.

Informazioni sul timestamp

Quando registri un evento utente, assicurati di includere un timestamp accurato del momento in cui si è verificato l'evento. Timestamp accurati assicurano che gli eventi vengano memorizzati nell'ordine corretto. I timestamp vengono registrati automaticamente per gli eventi raccolti utilizzando il pixel JavaScript. Quando importi gli eventi, devi fornire il timestamp nel campo eventTime nel formato specificato da RFC 3339.

Informazioni sui pannelli

In una home page, in genere sono presenti uno o più riquadri, ad esempio un riquadro "Tendenze" e un riquadro "Consigliati per te". Nelle pagine di dettaglio, potresti anche trovare riquadri come "Altri video che potrebbero piacerti".

Informazioni sul riquadro per gli eventi utente

Le informazioni sul panel sono necessarie per gli eventi utente di tipo view-home-page e view-item. Le informazioni del riquadro sono necessarie per le home page e le pagine di dettaglio che mostrano i contenuti consigliati da Google.

Se esegui test A/B per un panel, devi registrare gli eventi utente con le informazioni del panel per tutti i contenuti del test, indipendentemente dalla fonte. Per le home page e le pagine di dettaglio senza contenuti del riquadro generati da Google, è consigliabile, ma non obbligatorio, fornire le informazioni del riquadro negli eventi view-home-page e view-item. Questi requisiti sono riassunti nella tabella seguente:

Origine dell'evento utente (view-home-page e view-item) PanelInfo obbligatorio
Include i contenuti consigliati da Google Sì
Include contenuti NON consigliati da Google e utilizzati nei test A/B Sì
Include contenuti NON consigliati da Google e NON utilizzati nei test A/B No

Le informazioni sul pannello (PanelInfo) sono un insieme di campi che descrivono vari elementi del pannello:

  • Il numero ID del riquadro

  • Il nome visualizzato

  • La posizione del pannello nella pagina (ad es. il primo pannello (1) della pagina o il terzo pannello (3) della pagina)

  • Il numero totale di riquadri nella pagina

  • L'elenco dei documenti (DocumentInfo) presentati in ogni riquadro

Per informazioni dettagliate sugli oggetti PanelInfo, consulta PanelInfo.

Pannelli precaricati e pannelli a caricamento differito

Esistono due metodi comuni per visualizzare i consigli sulle pagine web o sulle pagine mobile. Il metodo che utilizzi determina il numero e il contenuto degli eventi utente view-home-page che registri.

  • Precaricamento:con il precaricamento, tutti gli elementi dei suggerimenti vengono generati quando l'utente arriva alla pagina. In questo caso, quando l'utente carica la home page, registri un evento utente view-home-page (o view-item) con tutti i riquadri e i documenti.

  • Caricamento lento:con il caricamento lento, i contenuti del pannello non vengono generati quando l'utente arriva sulla pagina, ma vengono caricati dinamicamente quando l'utente scorre verso il basso fino ai pannelli o verso destra per visualizzare altri consigli. In questo caso, quando un utente carica la home page, registri un evento utente iniziale view-home-page (o view-item) e poi continui a registrare altri eventi quando l'utente scorre per generare altri contenuti consigliati. Negli eventi successivi, devi includere nell'array panels solo l'incremento dei documenti visualizzati.

Scenario di esempio

La home page di una società di media mostra due riquadri di consigli:

  • Un riquadro delle tendenze attuali basato sul modello Più popolari.

  • Un pannello di consigli personalizzati in fase di test A/B. Alcuni utenti vedono un pannello di suggerimenti basati sul modello Consigliati per te (gruppo A), mentre altri utenti vedono consigli basati sul modello proprietario dell'azienda (gruppo B).

Quando un utente assegnato al gruppo B visualizza questa home page, l'evento utente in formato pixel JavaScript ha il seguente aspetto:

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
    }
  ]
};

Passaggi successivi