Stay organized with collections
Save and categorize content based on your preferences.
Specifications
To affect the display order of the services for a given merchant, set
ranking_hint.score on each
Service
in the
Service feed.
// Ranking hints for a service.messageServiceRankingHint{// Arbitrary partner or merchant assigned rank for this service.//// Services with a higher score will be shown more prominently (e.g. shown// higher in lists). Note that other factors may also influence ranking, such// as price, availability, user history, etc.//// Optional. Must be non-negative if set.floatscore=1[features.field_presence=EXPLICIT];}
When multiple services are displayed (example: the page directly after the
"Book" button that displays all the services for the user to chose from), it
will use Service.ranking_hint.score as one of the signals to order
the Services. The higher the score the higher on the page the Service will be
displayed.
Example
A merchant has 3 services "Haircut", "Coloring", "Scalp massage and Haircut"
and their preferred order is as follow:
Haircut
Scalp massage and Haircut
Coloring
Service feed may be specified as follow:
Services
{"service":[{"price":{"currency_code":"USD","price_micros":20000000},"service_id":"haircut","prepayment_type":"NOT_SUPPORTED","merchant_id":"beauty-1","localized_service_name":{"value":"Haircut","localized_value":[{"locale":"en","value":"Haircut"}]},"localized_description":{"value":"Get a haircut.","localized_value":[{"locale":"en","value":"Get a haircut."}]},"ranking_hint":{"score":30.0}},{"localized_service_name":{"value":"Coloring","localized_value":[{"locale":"en","value":"Coloring"}]},"price":{"currency_code":"USD","price_micros":40000000},"service_id":"haircoloring","prepayment_type":"NOT_SUPPORTED","merchant_id":"beauty-1","localized_description":{"value":"Get your hair dyed.","localized_value":[{"locale":"en","value":"Get your hair dyed."}]},"ranking_hint":{"score":10.0}},{"localized_service_name":{"value":"Scalp massage and Haircut","localized_value":[{"locale":"en","value":"Scalp massage and Haircut"}]},"price":{"currency_code":"USD","price_micros":30000000},"service_id":"scalpmassage","prepayment_type":"NOT_SUPPORTED","merchant_id":"beauty-1","localized_description":{"value":"Get a shampoo and scalp massage followed by a haircut.","localized_value":[{"locale":"en","value":"Get a shampoo and scalp massage followed by a haircut."}]},"ranking_hint":{"score":20.0}}]}
The ordering specified above (without other signals) will result in:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["Control the display order of services by setting `ranking_hint.score` within each service in the Service feed."],["Services with higher `ranking_hint.score` values are displayed more prominently."],["Google might use additional signals alongside `ranking_hint.score`, potentially altering the specified order."],["If `ranking_hint.score` is used for one service of a merchant, it should be set for all services of that merchant."],["`ranking_hint.score` values must be non-negative."]]],["To control service display order, set `ranking_hint.score` in the Service feed. Higher scores elevate a service's position. Scores must be non-negative; if used for one merchant's service, all of the merchants services must include it. Google may use other signals to influence the ranking. For example, to order services as \"Haircut,\" \"Scalp massage and Haircut,\" then \"Coloring,\" assign scores of 30.0, 20.0, and 10.0, respectively, to each.\n"]]