Otimizar os resultados da pesquisa (legado)

É possível especificar condições de otimização na solicitação de pesquisa para promover ou rebaixar determinados documentos nos resultados da pesquisa. Quando um documento atende às condições especificadas, os valores de otimização são aplicados a ele e os resultados são ordenados de acordo. Também é possível especificar valores numéricos e de carimbo de data/hora personalizados que permitem ordenar os resultados com base em parâmetros como popularidade e atualidade.

A especificação de otimização em uma solicitação de pesquisa é diferente de um controle de otimização anexado a uma configuração de veiculação. Para mais informações sobre os controles de otimização, consulte Sobre os controles de otimização.

Nesta página, descrevemos os seguintes tipos de especificações de otimização:

Aumento com uma condição fixa

Para impulsionar os resultados em um valor fixo com base no cumprimento de uma condição, faça o seguinte:

  1. Especifique a especificação de otimização no campo boostSpec ao enviar uma solicitação servingConfigs.search.

    {
  "boostSpec": {
    "conditionBoostSpecs": {
      "condition": "BOOST_CONDITION",
      "boost": BOOST_VALUE
    }
  }
}

    A especificação contém os seguintes parâmetros:

    • BOOST_CONDITION: uma expressão de filtro de texto para selecionar os documentos em que o aumento será aplicado. O filtro precisa ser avaliado como um valor booleano.
    • BOOST_VALUE: um número de ponto flutuante no intervalo [-1,1]. Quando o valor é negativo, os resultados são rebaixados (aparecem mais abaixo nos resultados). Quando o valor é positivo, os resultados são promovidos (aparecem mais acima nos resultados).

Exemplo de caso de uso:

Suponha que seu repositório de dados contenha dados sobre hotéis e as classificações deles. Você quer impulsionar hotéis com classificações por estrelas maiores ou iguais a três. A classificação por estrelas está disponível no campo numérico star_rating. É possível especificar o condition no boostSpec como star_rating >= 3.0 e um valor de otimização de 0,7 para otimizar todos os hotéis com star_rating de 3,0 ou mais em um valor igual.

{
  "boostSpec": {
    "conditionBoostSpecs": {
      "condition": "star_rating>=3.0",
      "boost": 0.7
    }
  }
}

Otimizar usando atributos numéricos personalizados

É possível impulsionar resultados com base em atributos numéricos personalizados de maneira linear por partes, especificando pontos de controle e os valores de otimização correspondentes.

Para especificar uma especificação de otimização usando atributos numéricos personalizados, faça o seguinte:

  1. Especifique a especificação de otimização no campo boostSpec ao enviar uma solicitação servingConfigs.search.

    {
  "boostSpec": {
    "conditionBoostSpecs": {
        "condition": "BOOST_CONDITION",
        "boostControlSpec": {
          "attributeType": "NUMERICAL",
          "interpolationType": "LINEAR",
          "fieldName": "CUSTOM_ATTRIBUTE_FIELD_NAME",
          "controlPoints": [
            {
              "attributeValue": "CUSTOM_ATTRIBUTE_VALUE_1",
              "boostAmount": BOOST_AMOUNT_1
            },
            {
              "attributeValue": "CUSTOM_ATTRIBUTE_VALUE_2",
              "boostAmount": BOOST_AMOUNT_2
            }
          ]
        }
    }
  }
}

    A especificação contém os seguintes parâmetros:

    • BOOST_CONDITION: uma expressão de filtro de texto para selecionar os documentos em que o aumento será aplicado. O filtro precisa ser avaliado como um valor booleano.
    • CUSTOM_ATTRIBUTE_FIELD_NAME: o nome do campo do atributo numérico personalizado cujo valor decide o valor do aumento.
    • CUSTOM_ATTRIBUTE_VALUE: o valor numérico do atributo personalizado para um determinado ponto de controle com um tipo de dados de string. Por exemplo, "3.3" ou "12". Para mais informações, consulte ControlPoint.
    • BOOST_AMOUNT: um número de ponto flutuante no intervalo [-1,1]. Quando o valor é negativo, os resultados são rebaixados (aparecem mais abaixo nos resultados). Quando o valor é positivo, os resultados são promovidos (aparecem mais acima nos resultados). Indica o valor de otimização mapeado para o atributo personalizado de um determinado ponto de controle.

Quando um documento no resultado da pesquisa atende à condição especificada, um valor de otimização é aplicado da seguinte maneira:

Valor do atributo Valor do aumento
Menor que o primeiro ponto de controle É igual ao valor de otimização do primeiro ponto de controle.
Igual ao ponto de controle É igual ao valor de aumento mapeado
Entre pontos de controle É calculado por interpolação linear.
Maior que o último ponto de controle É igual ao valor de aumento do último ponto de controle

Exemplo de caso de uso:

Suponha que seu repositório de dados contenha dados sobre hotéis e as classificações deles. Você quer impulsionar os resultados da pesquisa de hotéis proporcionalmente às avaliações com estrelas. É possível definir a especificação de otimização da seguinte maneira:

{
  "boostSpec": {
    "conditionBoostSpecs": {
        "condition": "star_rating >= 3.0",
        "boostControlSpec": {
          "attributeType": "NUMERICAL",
          "interpolationType": "LINEAR",
          "fieldName": "star_rating",
          "controlPoints": [
            {
              "attributeValue": "3.5",
              "boostAmount": 0.25
            },
            {
              "attributeValue": "4.0",
              "boostAmount": 0.30
            },
            {
              "attributeValue": "4.5",
              "boostAmount": 0.32
            }
          ]
        }
    }
  }
}

Nesse cenário, os resultados da pesquisa são otimizados da seguinte maneira:

Nota com estrelas Valor do aumento
menor ou igual a 3,5 0,25
entre 3,5 e 4,0 entre 0,25 e 0,30, calculado usando interpolação linear
igual a 4.0 0,30
entre 4.0 e 4.5 entre 0,30 e 0,32, calculado usando interpolação linear
maior ou igual a 4,5 0.32

Otimizar de acordo com a atualização

É possível impulsionar os resultados com base em atributos de data e hora de maneira linear por partes, especificando pontos de controle e os valores de otimização correspondentes.

Para especificar uma especificação de otimização usando atributos de data e hora personalizados, faça o seguinte:

  1. Especifique a especificação de otimização no campo boostSpec ao enviar uma solicitação servingConfigs.search.

    {
  "boostSpec": {
    "conditionBoostSpecs": {
        "condition": "BOOST_CONDITION",
        "boostControlSpec": {
          "fieldName": "DATETIME_FIELD_NAME",
          "attributeType": "FRESHNESS",
          "interpolationType": "LINEAR",
          "controlPoints": [
            {
              "attributeValue": "DURATION_VALUE_1",
              "boostAmount": BOOST_AMOUNT_1
            },
            {
              "attributeValue": "DURATION_VALUE_2",
              "boostAmount": BOOST_AMOUNT_2
            }
          ]
        }
    }
  }
}

    A especificação contém os seguintes parâmetros:

    • BOOST_CONDITION: uma expressão de filtro de texto para selecionar os documentos em que o aumento será aplicado. O filtro precisa ser avaliado como um valor booleano.
    • DATETIME_FIELD_NAME: o nome do campo de um atributo personalizado do DATETIME, como data de publicação ou data da última atualização, ou um atributo predefinido inferido pelo Google, como datePublished.
    • DURATION_VALUE: o valor de duração no tipo de dados dayTimeDuration que decide o nível de atualização de um documento. Isso é calculado como a duração entre a data e hora em que a pesquisa é realizada e a data e hora do atributo de data e hora personalizado de um documento. O valor da duração precisa ser especificado de acordo com o formato ISO 8601 no padrão [nD][T[nH][nM][nS]]. Por exemplo, a duração entre 1º de janeiro de 2024 e 1º de março de 2024 pode ser expressa como 59D. Da mesma forma, a duração de dois dias e meio pode ser expressa como 2DT12H. Para mais informações, consulte ControlPoint.
    • BOOST_AMOUNT: um número de ponto flutuante no intervalo [-1,1]. Quando o valor é negativo, os resultados são rebaixados (aparecem mais abaixo nos resultados). Quando o valor é positivo, os resultados são promovidos (aparecem mais acima nos resultados). Indica o valor de otimização mapeado para o atributo de data e hora personalizado de um determinado ponto de controle.

Quando um documento no resultado da pesquisa atende à condição especificada, um valor de otimização é aplicado da seguinte maneira:

Valor da duração Valor do aumento
Menor que o primeiro ponto de controle É igual ao valor de otimização do primeiro ponto de controle.
Igual a um determinado ponto de controle É igual ao valor de aumento mapeado
Entre pontos de controle É calculada por interpolação linear
Maior que o último ponto de controle É igual ao valor de aumento do último ponto de controle

Exemplo de caso de uso com um atributo de data e hora personalizado

Suponha que seu repositório de dados contenha dados estruturados em que cada documento tem uma data de publicação. Você quer impulsionar os resultados da pesquisa proporcionalmente à atualidade deles. É possível definir a especificação de otimização da seguinte maneira:

{
  "boostSpec": {
    "conditionBoostSpecs": {
        "condition": true,
        "boostControlSpec": {
          "fieldName": "publication_date",
          "attributeType": "FRESHNESS",
          "interpolationType": "LINEAR",
          "controlPoints": [
            {
              "attributeValue": "7D",
              "boostAmount": 0.40
            },
            {
              "attributeValue": "30D",
              "boostAmount": 0.37
            },
            {
              "attributeValue": "60D",
              "boostAmount": 0.32
            },
            {
              "attributeValue": "90D",
              "boostAmount": 0
            }
          ]
        }
    }
  }
}

Nesse cenário, os resultados da pesquisa são otimizados da seguinte maneira:

Atualização Valor do aumento
menor ou igual a 7 dias 0,40
entre 7 e 30 dias entre 0,40 e 0,37, calculado usando interpolação linear
igual a 30 dias 0,37
entre 30 e 60 dias entre 0,37 e 0,32, calculado usando interpolação linear
igual a 60 dias 0.32
entre 60 e 90 dias entre 0,32 e 0,0, calculado usando interpolação linear
maior ou igual a 90 dias 0,0

Regular o valor do aumento com o filtro de relevância

Além dos fatores que influenciam a classificação de um resultado, como correspondência de palavras-chave, correspondência de contexto e relevância, a condição de otimização afeta significativamente a classificação de um resultado. Portanto, é preciso calibrar cuidadosamente o valor do aumento, especialmente ao usar o campo boostSpec com o filtro de relevância. Para mais informações sobre o filtro de relevância, consulte Filtrar pesquisas por relevância no nível do documento.

Suponha que você tenha documentos diferentes com datas de publicação diferentes. Para uma consulta específica, a tabela a seguir representa a classificação absoluta sem implementar nenhum valor de otimização ou filtro de relevância e indica a relevância dos documentos para a consulta.

Documento Data de publicação Relevância Classificação
A 1º de fevereiro de 2024 Alta #1
B 1º de março de 2024 Alta #2
C 1º de abril de 2024 Menor #3
D 1º de maio de 2024 Média #4
E 1º de junho de 2024 Baixo #5

Em 6 de junho de 2024, você adiciona as seguintes condições de pesquisa à sua solicitação:

  • Filtro de relevância definido como LOW.
  • Valor de otimização para que os documentos publicados nos últimos 31 dias sejam otimizados por um valor de 0,7 e os documentos com mais de uma semana, mas mais recentes que 60 dias, sejam otimizados por um valor de 0,6.

Na saída da pesquisa, os resultados são filtrados primeiro por relevância e, em seguida, o valor de otimização é aplicado. Portanto, as condições aplicadas alteram a classificação das páginas nos resultados da seguinte maneira:

Documento Data de publicação Relevância Classificação
E 1º de junho de 2024 Baixo #1
D 1º de maio de 2024 Média #2
A 1º de fevereiro de 2024 Alta #3
B 1º de março de 2024 Alta #4

O resultado com a menor relevância é filtrado devido ao filtro de relevância. Os documentos menos relevantes para uma consulta são classificados como os principais resultados porque são impulsionados por um grande valor de otimização. Os resultados mais relevantes são classificados mais abaixo.

Portanto, o Google recomenda que você comece o valor de otimização com um valor baixo e preciso e ajuste o valor dependendo do resultado da pesquisa. Neste exemplo, começar com valores de otimização de 0,1 ou menos pode buscar resultados mais relevantes na parte de cima.

A seguir