Como estruturar o feed de serviços

Interpretação de preços dos serviços

Preço é um campo obrigatório. Confira os exemplos(conforme exibidos ao usuário) para determinar como representar os preços no feed.

Exemplos

Interpretação de preços:

INTERPRETATION_EXACT Conforme exibido ao usuário: US$ 39,99

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_EXACT",
    "min_price": {
      "price_micros": 39990000,
      "currency_code": "USD"
    }
  }
}
  

Conforme exibido ao usuário: sem custo financeiro

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_EXACT",
    "min_price": {
      "price_micros": 0,
      "currency_code": "USD"
    }
  }
}
  

Interpretação de preços:

INTERPRETATION_STARTS_AT Conforme exibido ao usuário : a partir de US $0,00

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_STARTS_AT",
    "min_price": {
      "price_micros": 0,
      "currency_code": "USD"
    }
  }
}
  

Conforme exibido ao usuário: a partir de US $25,00

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_STARTS_AT",
    "min_price": {
      "price_micros": 25000000,
      "currency_code": "USD"
    }
  }
}
  

Interpretação de preços:

INTERPRETATION_RANGE: conforme exibido ao usuário: US$ 15,00 a US$ 25,00

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_RANGE",
    "min_price": {
      "price_micros": 15000000,
      "currency_code": "USD"
    },
    "max_price": {
      "price_micros": 25000000,
      "currency_code": "USD"
    }
  }
}
  

Interpretação de preços: INTERPRETATION_NOT_DISPLAYED

Conforme exibido ao usuário: nenhum preço será exibido ao usuário

  
{
  "service_price": {
    "price_interpretation": "INTERPRETATION_NOT_DISPLAYED"
  }
}
  

A descrição do serviço é altamente recomendada, mas é opcional, porque reconhecemos que alguns serviços são autoexplicativos e nem todos os comerciantes os fornecem. Se a descrição de um serviço for idêntica ao nome do serviço, recomendamos que a descrição esteja em branco para evitar redundância. No entanto, isso não será aplicado.

Exemplos

Quando uma descrição é fornecida para um serviço:

  
{
  "localized_service_description": {
    "value": "Consultation to learn more about your hair coloring needs and schedule the reservation.",
    "Localized_value": {
      "locale": "en",
      "value": "Consultation to learn more about your hair coloring needs and schedule the reservation."
    }
  }
}
  
Captura de tela de um tipo de serviço com uma descrição

Quando nenhuma descrição é fornecida para os serviços:

Captura de tela de um tipo de serviço sem descrição

Quando uma descrição de serviço é fornecida, mas tem mais de 120 caracteres, ela fica truncada:


{
  "localized_service_description": {
    "value": "Keratin smoothing treatments repair damage, block humidity, and reduce frizz while restoring the hair’s strength & vibrance for healthier hair. Treatment times may vary.",
    "Localized_value": {
      "locale": "en",
      "value": "Keratin smoothing treatments repair damage, block humidity, and reduce frizz while restoring the hair’s strength & vibrance for healthier hair. Treatment times may vary."
    }
  }
}

Dicas de classificação e categoria de serviço afetam a ordem dos serviços em uma categoria e as próprias categorias. A dica de classificação para uma categoria é considerada a dica mínima de classificação de qualquer item da categoria. Outros fatores também podem influenciar a classificação final, como preço, histórico do usuário etc. A abordagem recomendada é definir uma ordenação total em todos os serviços, atribuindo a cada um deles uma dica de classificação em número inteiro exclusivo e garantindo que os valores dessas dicas não se sobreponham entre as categorias. Por exemplo, se quisermos que as categorias e os serviços sejam a ordem preferencial: os complementos só poderão ser adicionados como a própria categoria, apenas se puderem ser reservados de maneira independente (sem um serviço principal).

Exemplo

  
{
  "data": [
    {
      "merchant_id":"merchant-1",
      "service_id": "services-1",
      "localized_service_name": {
        "value": "Classic Shave"
      },
      "localized_service_category": {
        "value": "Barber"
      },
      "service_price": {
          "price_interpretation": "INTERPRETATION_STARTS_AT",
          "min_price": {
              "price_micros": 25000000,
              "currency_code": "USD"
          }
      },
       "service_duration": {
          "duration_interpretation": "INTERPRETATION_EXACT",
          "min_duration_sec": 4500
      },
        "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
          "language": "en"
        }
      ],
      "ranking hint": {
        "score": 1
      }
    },
    {
      "merchant_id":"merchant-1",
      "service_id": "services-2",
      "localized_service_name": {
        "value": "Beard Trim"
      },
      "localized_service_category": {
        "value": "Barber"
      },
       "service_price": {
          "price_interpretation": "INTERPRETATION_STARTS_AT",
          "min_price": {
              "price_micros": 20000000,
              "currency_code": "USD"
          }
      },
       "service_duration": {
          "duration_interpretation": "INTERPRETATION_EXACT",
          "min_duration_sec": 1500
      },
        "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
          "language": "en"
        }
      ],
      "ranking hint": {
        "score": 2
      }
    },
    {
      "merchant_id":"merchant-1",
      "service_id": "services-3",
      "localized_service_name": {
        "value": "Massage Shampoo"
      },
      "localized_service_category": {
        "value": "Shampoo"
      },
       "service_price": {
          "price_interpretation": "INTERPRETATION_STARTS_AT",
          "min_price": {
              "price_micros": 15000000,
              "currency_code": "USD"
          }
      },
       "service_duration": {
          "duration_interpretation": "INTERPRETATION_EXACT",
          "min_duration_sec": 1500
      },
        "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
          "language": "en"
        }
      ],
      "ranking hint": {
        "score": 3
      }
    },
    {
      "merchant_id":"merchant-1",
      "service_id": "services-4",
      "localized_service_name": {
        "value": "Buzz Cut"
      },
      "localized_service_category": {
        "value": "Haircuts"
      },
       "service_price": {
          "price_interpretation": "INTERPRETATION_STARTS_AT",
          "min_price": {
              "price_micros": 35000000,
              "currency_code": "USD"
          }
      },
       "service_duration": {
          "duration_interpretation": "INTERPRETATION_EXACT",
          "min_duration_sec": 3000
      },
        "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/appointment/service-1/in-person-1",
          "language": "en"
        }
      ],
      "ranking hint": {
        "score": 4
      }
    }
  ]
}
  
Captura de tela de diferentes tipos de serviços
Captura de tela dos serviços em uma página