Esta página foi traduzida pela API Cloud Translation.

Usar dados estruturados para indexação avançada de sites

Se a indexação avançada de sites estiver ativada no seu repositório de dados, você poderá usar os seguintes tipos de dados estruturados para aprimorar a indexação:

Datas de página predefinidas e inferidas pelo Google
Atributos de dados estruturados personalizados

Esta página apresenta esses dois tipos de dados estruturados para suas páginas da Web e descreve como adicionar atributos estruturados personalizados ao esquema de repositório de dados.

Sobre as datas de página predefinidas e inferidas pelo Google

Ao rastrear as páginas da Web na repositório de dados do seu site, o Google infere os dados da página usando as propriedades aplicáveis ao seu conteúdo. A Vertex AI para Pesquisa adiciona essas propriedades de dados de página inferidas ao seu esquema. Esses dados inferidos incluem as seguintes propriedades de data predefinidas, também chamadas de datas de linha de abertura:

datePublished: a data e a hora em que a página foi publicada pela primeira vez
dateModified: a data e a hora em que a página foi modificada mais recentemente

Essas propriedades são indexadas automaticamente. É possível usar essas propriedades de data diretamente para enriquecer sua pesquisa sem adicioná-las ao esquema. Para adicionar datas de autoria ao seu site, consulte Influenciar as datas de autoria na Pesquisa Google.

Para entender como incluir essas propriedades de data predefinidas nas suas solicitações de pesquisa, como em expressões de filtro e especificações de aumento, consulte Exemplo de caso de uso com uma data de página inferida pelo Google.

Sobre campos de data e hora personalizados em uma página da Web

É possível adicionar campos de data e hora personalizados às suas páginas da Web. Essas tags podem ser usadas com a indexação avançada quando você adiciona atributos de dados estruturados personalizados ao repositório de dados dados.
Confira um exemplo que mostra onde adicionar uma metatag de data e hora personalizada chamada lastModified na página da 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>

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

Para entender como incluir essas tags de data/hora personalizadas nas suas solicitações de pesquisa, como em expressões de filtro e especificações de aumento, consulte Exemplo de caso de uso com um atributo de data/hora personalizado.

Sobre os atributos de dados estruturados personalizados

É possível adicionar atributos de dados estruturados como tags meta e PageMaps às suas páginas da Web e usá-los para enriquecer a indexação. Para usar atributos estruturados personalizados para indexação, atualize o esquema.

Exemplo de caso de uso para tags `meta`

Suponha que você tenha um grande número de páginas da Web relevantes para vários departamentos da sua organização. É possível usar tags meta para rotular as páginas relevantes para cada departamento. Em seguida, use as tags indexadas como filtros nas consultas. Isso permite restringir os resultados da pesquisa a páginas da Web que contêm um rótulo que corresponde a qualquer um dos departamentos especificados.

Esse processo pode ser resumido da seguinte forma:

Adicione as seguintes tags meta a um subconjunto das suas páginas da Web:
- Relevante para departamentos de engenharia e TI: <meta name="department" content="eng, infotech">
- Relevante para os departamentos de finanças e RH: <meta name="department" content="finance, human resources">
Refazer a análise das páginas atualizadas.
Adicione department ao esquema do repositório de dados como uma matriz indexável, conforme descrito na seção Adicionar atributos de dados estruturados personalizados ao esquema do repositório de dados.

Depois de atualizar o esquema, o repositório de dados é reindexado automaticamente. Depois que a reindexação for concluída, use o filtro department em uma expressão de filtro para reordenar ou filtrar os resultados da pesquisa. Por exemplo, quando os usuários do departamento financeiro fazem consultas, os resultados da pesquisa podem ficar mais relevantes para eles com o department filtro definido como finance.

Exemplo de tags `meta` em uma página da Web

Confira um exemplo de tags meta que podem ser adicionadas à sua página da Web. Essas tags podem ser usadas com a indexação avançada quando você adiciona atributos de dados estruturados personalizados ao repositório de dados dados.

<!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 Vertex AI Search. -->
    <meta name="robots" content="index,follow">

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

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

    <!-- Vertex AI 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>

Exemplo de caso de uso para PageMaps

Suponha que você tenha várias páginas da Web com receitas de comida. É possível adicionar dados do PageMap ao conteúdo HTML de cada página. Em seguida, use os nomes de atributos do PageMap indexados como filtros nas consultas. Por exemplo, se você quiser aumentar ou ocultar páginas da Web dependendo das classificações da receita, siga este processo:

Adicione dados do PageMap semelhantes aos seguintes às suas páginas da 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>

Refazer a análise das páginas atualizadas.
Adicione rating ao esquema do repositório de dados como uma matriz indexável, conforme descrito na seção Adicionar atributos de dados estruturados personalizados ao esquema do repositório de dados.

Depois de atualizar o esquema, o repositório de dados é reindexado automaticamente. Depois que a reindexação for concluída, use o atributo rating em uma expressão de filtro para reordenar ou filtrar os resultados da pesquisa. Por exemplo, quando os usuários pesquisam receitas, aumente os resultados de pesquisa com as classificações mais altas usando rating como um atributo numérico personalizado.

Exemplo de caso de uso para dados do schema.org

Suponha que você tenha um site de avaliações e que as páginas da Web sejam anotadas com dados do schema.org no formato JSON-LD na tag script do HTML. Em seguida, use as anotações indexadas como filtros nas suas consultas. Por exemplo, se você quiser melhorar ou ocultar páginas da Web dependendo das classificações agregadas, siga este processo:

Adicione as anotações do schema.org para conteúdo de avaliação semelhante ao seguinte às suas páginas da Web. Para conferir outros tipos de modelos de schema.org disponíveis, consulte Esquemas:

<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>

Refazer a análise das páginas atualizadas.
Adicione o caminho para ratingValue ao esquema do repositório de dados. Use um identificador como o nome do campo no esquema do repositório de dados, como rating_value, conforme descrito na seção Adicionar atributos de dados estruturados personalizados ao esquema do repositório de dados.

Depois de atualizar o esquema, o repositório de dados é reindexado automaticamente. Depois que a reindexação for concluída, use o atributo rating_value em uma expressão de filtro para reordenar ou filtrar os resultados da pesquisa. Por exemplo, quando os usuários pesquisam livros, aumente os resultados de pesquisa com as classificações mais altas usando rating_value como um atributo numérico personalizado.

Antes de começar

Antes de atualizar o esquema do repositório de dados, faça o seguinte:

Ative a indexação avançada de sites para o repositório de dados. Para mais informações, consulte Ativar a indexação avançada de sites.
Entender como os dados estruturados funcionam.
Entenda como usar o PageMaps. Revise a lista de DataObjects reconhecidos que podem ser adicionados aos dados do PageMap.
Saiba como usar tags meta. Não use metatags excluídas ou sem suporte.
Verifique se o atributo que precisa ser indexado não tem nenhum dos seguintes valores:
- datePublished
- dateModified
- siteSearch
Depois de adicionar dados estruturados às suas páginas da Web, você precisa refazer a rastreamento delas. Isso pode levar várias horas.
Depois de adicionar atributos de dados estruturados ao esquema da repositório de dados, as páginas da Web na repositório de dados são reindexadas automaticamente. A reindexação é uma operação de longa duração que pode levar várias horas.

Adicionar atributos de dados estruturados personalizados ao esquema do repositório de dados

Para adicionar atributos de dados estruturados personalizados ao esquema do repositório de dados:

Adicione tags meta, dados do PageMap e do schema.org a todas as páginas do seu site que você quer enriquecer com a indexação de dados estruturados:
- Para tags meta:
  - Cada tag meta precisa ter o atributo name definido para o campo que você quer indexar e o atributo content para uma string de um ou mais valores separados por vírgulas.
  - A Pesquisa da Vertex AI oferece suporte a tags meta com nomes que correspondem ao padrão [a-zA-Z0-9][a-zA-Z0-9-_]*. Não use metatags excluídas ou sem suporte.
- Para dados do PageMap:
  - Os dados do PageMap precisam consistir em DataObjects reconhecidos que contenham os nomes de atributo que você quer indexar. Os nomes de atributos nos DataObjects precisam ser definidos para o campo que você quer indexar.
- Para dados do schema.org:
  - As anotações precisam estar em um formato válido de JSON-LD, microdados ou RDFa. Para mais informações, consulte Formatos compatíveis.
Refazer o rastreamento das páginas da Web atualizadas.
Confira a definição do esquema do seu repositório de dados na API REST.
Atualize o repositório de dados dados pela API REST. Para mais informações, consulte Sobre como fornecer seu próprio esquema como um objeto JSON.
1. Adicione objetos para cada atributo personalizado que você quer tornar pesquisável, recuperável ou indexável.
2. Adicione o atributo personalizado e defina o type como array.
3. Adicione o tipo de dados do valor do atributo personalizado.
4. Especifique a origem do atributo personalizado em que ele pode ser encontrado no campo siteSearchStructuredDataSources.
5. Para dados do schema.org: especifique o caminho do atributo na anotação schema.org começando com a string _root no campo siteSearchSchemaOrgPaths.
Confira a seguir um exemplo de atualização de esquema para um site:
```
{
  "type": "object",
  "properties": [{
    "CUSTOM_ATTRIBUTE": {
      "type": "array",
      "items": {
        "type": "DATA_TYPE",
        "searchable": true,
        "retrievable": true,
        "indexable": true,
        "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"
}
```
Substitua:
- CUSTOM_ATTRIBUTE: o valor do atributo name. Exemplo:
  - Para uma tag meta definida como <meta name="department" content="eng, infotech">, use department
  - Para um atributo PageMap definido como <Attribute name="rating">4.9</Attribute>, use rating.
- DATA_TYPE: o tipo de dados do atributo name. Precisa ser uma string, um número ou uma data/hora. Exemplo:
  - Para uma tag meta definida como <meta name="department" content="eng, infotech">, use string
  - Para um atributo PageMap definido como <Attribute name="rating">4.9</Attribute>, use number.
  - Para um atributo PageMap definido como <Attribute name="lastPublished">2015-01-01</Attribute>, use datetime.
  Para ver mais informações, consulte FieldType.
- STRUCTURED_DATA_SOURCE_N: uma matriz que consiste em uma ou ambas as seguintes origens de dados estruturados em que o atributo CUSTOM_ATTRIBUTE pode ser encontrado:
  - Se o atributo personalizado puder ser encontrado como uma tag meta, especifique METATAG
  - Se o atributo personalizado puder ser encontrado como um atributo do PageMap, especifique PAGEMAP.
  - Se o atributo personalizado puder ser encontrado como dados do schema.org, especifique SCHEMA_ORG
  - Se o campo siteSearchStructuredDataSources estiver ausente ou em branco, os valores das três fontes de dados serão mesclados em uma matriz.
- IDENTIFIER_FOR_SCHEMA_ORG_FIELD: um identificador personalizado para indicar o campo schema.org. Ele não precisa ser igual ao nome do campo na anotação do schema.org na sua página da Web. Por exemplo, se o caminho do campo for _root.nutrition.calories, o identificador poderá ser calorific_value ou nutrition_value.
- DATA_TYPE_SCHEMA_ORG_FIELD: o tipo de dados do campo schema.org. Precisa ser string, número ou data/hora. Exemplo:
  - Para um campo schema.org definido como "calories":"240 calories", use string
  - Para um campo schema.org definido como "calories": 240, use number
  - Para um campo schema.org definido como "foundingDate": "1991-05-01", use datetime
  Para ver mais informações, consulte FieldType.
- PATH_TO_THE_SCHEMA_ORG_FIELD: o caminho para um único campo no schema.org que precisa ser acessado. Ele é especificado usando pontos de separação após cada nível aninhado. É necessário especificar o caminho completo necessário para acessar o campo obrigatório. Por exemplo, se um campo ratingValue estiver aninhado no campo aggregateRating, será possível especificar o caminho como _root.aggregateRating.ratingValue.

Depois que você atualiza o esquema do site, ele é reindexado automaticamente. Essa é uma operação de longa duração que pode levar várias horas.

A seguir

Use os metadados indexados para:

Controles de veiculação, como otimização, ocultação e filtragem
Apresentação como atributos nos resultados da pesquisa
Filtrar resultados da pesquisa
Aprimorar os resultados da pesquisa