Utilizzare i dati strutturati per l'indicizzazione avanzata dei siti web

Se l'indicizzazione avanzata dei siti web è attivata nel datastore, puoi utilizzare i seguenti tipi di dati strutturati per arricchire l'indicizzazione:

Questa pagina presenta entrambi i tipi di dati strutturati per le pagine web e descrive come aggiungere attributi strutturati personalizzati allo schema del datastore.

Informazioni sulle date delle pagine predefinite e dedotte da Google

Durante la scansione delle pagine web nel datastore del sito web, Google deduce i dati delle pagine utilizzando le proprietà che si applicano ai contenuti. Agent Search aggiunge queste proprietà dei dati delle pagine dedotte allo schema. Questi dati dedotti includono le seguenti proprietà di data predefinite, chiamate anche date di pubblicazione:

  • datePublished: la data e l'ora in cui la pagina è stata pubblicata per la prima volta
  • dateModified: la data e l'ora in cui la pagina è stata modificata più di recente

Queste proprietà vengono indicizzate automaticamente. Puoi utilizzare direttamente queste proprietà di data per arricchire la ricerca senza aggiungerle allo schema. Per aggiungere le date di pubblicazione al tuo sito web, vedi Influenzare le date di pubblicazione nella Ricerca Google.

Per capire come includere queste proprietà di data predefinite nelle richieste di ricerca, ad esempio nelle espressioni di filtro e nelle specifiche di aumento, vedi Esempio di caso d'uso che utilizza una data della pagina dedotta da Google.

Informazioni sui campi di data e ora personalizzati in una pagina web

Puoi aggiungere campi di data e ora personalizzati alle pagine web. Questi tag possono essere utilizzati con l'indicizzazione avanzata quando aggiungi attributi di dati strutturati personalizzati allo schema del datastore. Ecco un esempio che mostra dove aggiungere un meta tag di data e ora personalizzato denominato lastModified alla pagina web.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Your web page title</title>

    <!-- Agent Search can use this date. -->
    <meta name="lastModified" content="2022-07-01">
</head>
<body>
    </body>
</html>

Per capire come includere questi tag di data e ora personalizzati nelle richieste di ricerca, ad esempio nelle espressioni di filtro e nelle specifiche di aumento, vedi Esempio di caso d'uso che utilizza un attributo di data e ora personalizzato.

Informazioni sugli attributi dei dati strutturati personalizzati

Puoi aggiungere attributi di dati strutturati come tag meta e PageMaps alle pagine web e utilizzarli per arricchire l'indicizzazione. Per utilizzare gli attributi strutturati personalizzati per l'indicizzazione, devi aggiornare lo schema.

Esempio di caso d'uso per i tag meta

Supponiamo di avere un gran numero di pagine web pertinenti a vari reparti della tua organizzazione. Puoi utilizzare i tag meta per etichettare le pagine pertinenti a ogni reparto. Puoi quindi utilizzare i tag indicizzati come filtri nelle query. In questo modo puoi limitare i risultati di ricerca alle pagine web contenenti un'etichetta che corrisponde a uno dei reparti specificati.

Questo processo può essere riassunto come segue:

  1. Aggiungi i seguenti tag meta a un sottoinsieme delle pagine web:

    • Pertinenti ai reparti di ingegneria e IT:

      <meta name="department" content="eng, infotech">
<meta property="og:title" content="Password best practices">

    • Pertinenti ai reparti di finanza e RU:

      <meta name="department" content="finance, human resources">
<meta property="og:image" content="https://example.com/images/team-training-contractors.jpg">

      Per un esempio più elaborato, vedi Esempio meta di tag in una pagina web.

  2. Esegui di nuovo la scansione delle pagine aggiornate.

  3. Aggiungi department allo schema del datastore come array indicizzabile, come descritto nella sezione Aggiungere attributi di dati strutturati personalizzati allo schema del datastore.

Dopo aver aggiornato lo schema, il datastore viene indicizzato di nuovo automaticamente. Al termine della reindicizzazione, puoi utilizzare il department filtro in un' espressione di filtro per riordinare o filtrare i risultati di ricerca. Ad esempio, quando gli utenti del reparto finanziario eseguono query, i risultati di ricerca possono essere resi più pertinenti per loro con il department filtro impostato su finance.

Esempio di tag meta in una pagina web

Ecco un esempio dei tag meta che puoi aggiungere alla pagina web. Questi tag possono essere utilizzati con l'indicizzazione avanzata quando aggiungi attributi di dati strutturati personalizzati allo schema del datastore.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Your web page title</title>

    <!-- Robots instructions for crawlers and for Agent Search. -->
    <meta name="robots" content="index,follow">

    <!-- Agent Search can use custom datetime fields to filter, boost, and order. -->
    <meta name="lastModified" content="2024-09-06">

    <!-- Agent Search can filter by category or tags. -->
    <meta name="category" content="archived">
    <meta name="tags" content="legacy,interesting,faq">

    <!-- Agent Search can index these common HTML tags. -->
    <meta name="description" content="A description of your web page's content.">
    <meta name="author" content="Your name or organization">
    <meta name="keywords" content="relevant,keywords,separated,by,commas">
    <link rel="canonical" href="https://www.yourwebsite.com/this-page">
    <meta property="og:title" content="Your Webpage Title">
    <meta property="og:description" content="A description of your webpage's content.">
    <meta property="og:image" content="https://www.yourwebsite.com/image.jpg">
    <meta property="og:url" content="https://www.yourwebsite.com/this-page">
    <meta property="og:type" content="website">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="Your customized Webpage Title">
    <meta name="twitter:description" content="A description of your webpage's content.">
    <meta name="twitter:image" content="https://www.yourwebsite.com/image.jpg">
</head>
<body>
...
</body>
</html>

Esempio di caso d'uso per PageMaps

Supponiamo di avere diverse pagine web che contengono ricette alimentari. Puoi aggiungere dati PageMaps ai contenuti HTML di ogni pagina. Puoi quindi utilizzare i nomi degli attributi PageMap indicizzati come filtri nelle query. Ad esempio, se intendi aumentare o ridurre la visibilità delle pagine web in base alle valutazioni delle ricette, puoi seguire questa procedura:

  1. Aggiungi dati PageMaps simili ai seguenti alle pagine web:

    <html>
<head>
...
<!--
<PageMap>
    <DataObject type="document">
        <Attribute name="title">Baked potatoes</Attribute>
        <Attribute name="author">Dana A.</Attribute>
        <Attribute name="description">Homestyle baked potatoes in oven. This
        recipe uses Russet potatoes.</Attribute>
        <Attribute name="rating">4.9</Attribute>
        <Attribute name="lastUpdate">2015-01-01</Attribute>
    </DataObject>
</PageMap>
-->
</head>
...
</html>

  2. Esegui di nuovo la scansione delle pagine aggiornate.

  3. Aggiungi rating allo schema del datastore come array indicizzabile, come descritto nella sezione Aggiungere attributi di dati strutturati personalizzati allo schema del datastore.

Dopo aver aggiornato lo schema, il datastore viene indicizzato di nuovo automaticamente. Al termine della reindicizzazione, puoi utilizzare l'attributo rating in un' espressione di filtro per riordinare o filtrare i risultati di ricerca. Ad esempio, quando gli utenti cercano ricette, aumenta la visibilità dei risultati di ricerca con le valutazioni più alte utilizzando rating come attributo numerico personalizzato.

Esempio di caso d'uso per i dati di schema.org

Supponiamo di avere un sito web di recensioni e che le relative pagine web siano annotate con i dati di schema.org in formato JSON-LD all'interno del tag script HTML. Puoi quindi utilizzare le annotazioni indicizzate come filtri nelle query. Ad esempio, se intendi aumentare o ridurre la visibilità delle pagine web in base alle valutazioni aggregate, puoi seguire questa procedura:

  1. Aggiungi le annotazioni di schema.org per contenuti delle recensioni simili a quelle riportate di seguito alle pagine web. Per visualizzare altri tipi di modelli di schema.org disponibili, vedi Schemi:

    <script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Review",
  "aggregateRating": {
    "@type": "Average Rating",
    "ratingValue": 3.5,
    "reviewCount": 11
  },
  "description": "Published in 1843, this is the perfect depiction of the Victorian London. A Christmas Carol is the story of Ebenezer Scrooge's transformation.",
  "name": "A Christmas Carol",
  "image": "christmas-carol-first-ed.jpg",
  "review": [
    {
      "@type": "Review",
      "author": "Alex T.",
      "datePublished": "2000-01-01",
      "reviewBody": "Read this in middle school and have loved this ever since.",
      "name": "Worth all the adaptations",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": 5,
        "ratingValue": 5,
        "worstRating": 1
      }
    }
  ]
}
</script>

  2. Esegui di nuovo la scansione delle pagine aggiornate.

  3. Aggiungi il percorso a ratingValue allo schema del datastore. Utilizza un identificatore come nome del campo nello schema del datastore, ad esempio rating_value come descritto nella sezione Aggiungere attributi di dati strutturati personalizzati allo schema del datastore.

Dopo aver aggiornato lo schema, il datastore viene indicizzato di nuovo automaticamente. Al termine della reindicizzazione, puoi utilizzare l'attributo rating_value in un' espressione di filtro per riordinare o filtrare i risultati di ricerca. Ad esempio, quando gli utenti cercano libri, aumenta la visibilità dei risultati di ricerca con le valutazioni più alte utilizzando rating_value come attributo numerico personalizzato.

Prima di iniziare

Prima di aggiornare lo schema del datastore:

Aggiungere attributi di dati strutturati personalizzati allo schema del datastore

Per aggiungere attributi di dati strutturati personalizzati allo schema del datastore:

  1. Aggiungi tag meta, dati PageMaps e dati di schema.org alle pagine del tuo sito web che vuoi arricchire con l'indicizzazione dei dati strutturati:

    • Per i tag meta:

    • Per i dati PageMaps:

      • I dati PageMaps devono essere costituiti da oggetti DataObject riconosciuti che contengono nomi di attributi che vuoi indicizzare. I nomi degli attributi all'interno degli oggetti DataObject devono essere impostati sul campo che vuoi indicizzare.

    • Per i dati di schema.org:

      • Le annotazioni devono essere in formato JSON-LD, Microdata o RDFa valido. Per ulteriori informazioni, vedi Formati supportati.

  2. Esegui di nuovo la scansione delle pagine web aggiornate.

  3. Visualizza la definizione dello schema per il datastore tramite l'API REST.

  4. Aggiorna lo schema del datastore utilizzando Google Cloud la console o l'API. Se scegli di farlo tramite l'API, scopri come fornire il tuo schema come oggetto JSON.

    1. Aggiungi oggetti per ogni attributo personalizzato che vuoi rendere ricercabile, recuperabile o indicizzabile.

    2. Aggiungi l'attributo personalizzato e imposta il relativo type su array.

    3. Aggiungi il tipo di dati del valore dell'attributo personalizzato.

    4. Specifica l'origine dell'attributo personalizzato in cui è possibile trovarlo nel campo siteSearchStructuredDataSources.

    5. Per i dati di schema.org: specifica il percorso dell'attributo nell'annotazione di schema.org a partire dalla stringa _root nel campo siteSearchSchemaOrgPaths.

    Di seguito è riportato un esempio di aggiornamento dello schema per un sito web:

    {
  "type": "object",
  "properties": {
    "CUSTOM_ATTRIBUTE": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "siteSearchMetatagName": "METATAG_NAME",
        "siteSearchStructuredDataSources": ["STRUCTURED_DATA_SOURCE_1", "STRUCTURED_DATA_SOURCE_2"]
      }
    },
    "IDENTIFIER_FOR_SCHEMA_ORG_FIELD": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE_SCHEMA_ORG_FIELD",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "siteSearchSchemaOrgPaths": ["_root.PATH_TO_THE_SCHEMA_ORG_FIELD"]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

    Sostituisci quanto segue:

    • CUSTOM_ATTRIBUTE: il valore dell'attributo name. Ad esempio:

      • Per un tag meta definito come <meta name="department" content="eng, infotech">, utilizza department
      • Per un attributo PageMap definito come <Attribute name="rating">4.9</Attribute>, utilizza rating

    • DATA_TYPE: il tipo di dati dell'attributo name. Deve essere stringa, numero o data e ora. Ad esempio:

      • Per un tag meta definito come <meta name="department" content="eng, infotech">, utilizza string
      • Per un attributo PageMap definito come <Attribute name="rating">4.9</Attribute>, utilizza number
      • Per un attributo PageMap definito come <Attribute name="lastPublished">2015-01-01</Attribute>, utilizza datetime

      Per ulteriori informazioni, vedi FieldType.

    • METATAG_NAME: il valore del campo siteSearchMetatagName, che ti consente di specificare il nome esatto di un tag meta della pagina web.

      Devi utilizzare la soluzione alternativa siteSearchMetatagName solo nei seguenti scenari:

      • L'attributo name del tag meta contiene caratteri speciali (ad esempio i due punti) e non corrisponde al pattern richiesto per CUSTOM_ATTRIBUTE, ovvero [a-zA-Z0-9][a-zA-Z0-9-_]*.

      Ad esempio, se hai un tag <meta name="og:updated_time">, non puoi utilizzare og:updated_time come CUSTOM_ATTRIBUTE. Dovresti invece utilizzare un identificatore conforme per CUSTOM_ATTRIBUTE (ad esempio og_updated_time) e poi impostare il valore di siteSearchMetatagName su og:updated_time.

      Ad esempio, se hai un tag <meta name="description">, non puoi utilizzare description come CUSTOM_ATTRIBUTE. Dovresti invece utilizzare un identificatore conforme per CUSTOM_ATTRIBUTE (ad esempio meta_tag_description) e poi impostare il valore di siteSearchMetatagName su meta_tag_description.

      Quando utilizzi siteSearchMetatagName per aggiornare lo schema, devi utilizzare l' endpoint v1alpha anziché l'endpoint v1 per chiamare il schema metodo.

    • STRUCTURED_DATA_SOURCE_N: un array composto da una o entrambe le seguenti origini di dati strutturati in cui è possibile trovare l'attributo CUSTOM_ATTRIBUTE:

      • Se l'attributo personalizzato è disponibile come tag meta, specifica METATAGS
      • Se l'attributo personalizzato è disponibile come attributo PageMap, specifica PAGEMAP
      • Se l'attributo personalizzato è disponibile come dati di schema.org, specifica SCHEMA_ORG
      • Se il campo siteSearchStructuredDataSources è assente o vuoto, i valori di tutte e tre le origini dati vengono uniti in un array.

    • IDENTIFIER_FOR_SCHEMA_ORG_FIELD: un identificatore personalizzato per indicare il campo di schema.org. Non deve essere esattamente uguale al nome del campo nell'annotazione di schema.org nella pagina web. Ad esempio, se il percorso del campo è _root.nutrition.calories, l'identificatore può essere calorific_value o nutrition_value.

    • DATA_TYPE_SCHEMA_ORG_FIELD: il tipo di dati del campo di schema.org. Deve essere stringa, numero o data e ora. Ad esempio:

      • Per un campo di schema.org definito come "calories":"240 calories", utilizza string
      • Per un campo di schema.org definito come "calories": 240, utilizza number
      • Per un campo di schema.org definito come "foundingDate": "1991-05-01", utilizza datetime

      Per ulteriori informazioni, vedi FieldType.

    • PATH_TO_THE_SCHEMA_ORG_FIELD: il percorso di un singolo campo nel campo di schema.org a cui è necessario accedere. Viene specificato utilizzando separatori punto dopo ogni livello nidificato. Devi specificare il percorso completo necessario per accedere al campo obbligatorio. Ad esempio, se un campo ratingValue è nidificato nel campo aggregateRating, puoi specificare il percorso come _root.aggregateRating.ratingValue.

Dopo aver aggiornato lo schema del sito web, il sito web viene indicizzato di nuovo automaticamente. Questa è un'operazione a lunga esecuzione che può richiedere diverse ore.

Passaggi successivi

Utilizza i metadati indicizzati per: