Estructuración del feed de servicios

Interpretación de los precios de los servicios

El precio es un campo obligatorio. Consulta los ejemplos(como se muestran al usuario) para determinar cómo representar los precios en el feed.

Ejemplos

Interpretación del precio:

INTERPRETATION_EXACT Como se muestra al usuario: USD 39.99

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

Como se muestra al usuario: Sin costo

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

Interpretación del precio:

INTERPRETATION_STARTS_AT Como se muestra al usuario : Desde USD 0.00

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

Como se muestra al usuario: Desde USD 25.00

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

Interpretación del precio:

INTERPRETATION_RANGE: Como se muestra al usuario: USD 15.00 a USD 25.00

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

Interpretación del precio: INTERPRETATION_NOT_DISPLAYED

Como se muestra al usuario: No se mostrará ningún precio al usuario.

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

La descripción del servicio es muy recomendable, pero es opcional, ya que reconocemos que algunos servicios se explican por sí solos y no todos los comercios la proporcionan. Si la descripción de un servicio es idéntica al nombre del servicio, te recomendamos que la descripción esté vacía para evitar la redundancia. Sin embargo, no se aplicará.

Ejemplos

Cuando se proporciona una descripción de los servicios, ocurre lo siguiente:

  
{
  "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 pantalla de un tipo de servicio con una descripción

Cuando no se proporciona una descripción de los servicios, ocurre lo siguiente:

Captura de pantalla de un tipo de servicio sin descripción

Cuando se proporciona una descripción de un servicio, pero tiene más de 120 caracteres, esta se trunca:


{
  "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."
    }
  }
}

Las sugerencias de clasificación y categoría de servicio afectan el orden de los servicios dentro de una categoría de servicio y el orden de las categorías. Se supone que la sugerencia de clasificación de una categoría es la sugerencia de clasificación mínima de cualquier elemento de la categoría. Ten en cuenta que otros factores también pueden influir en la clasificación final, como el precio, el historial del usuario, etcétera. El enfoque recomendado es definir un orden total en todos los servicios, asignando a cada uno una sugerencia de clasificación de número entero única y asegurándose de que los valores de las sugerencias de clasificación no se superpongan entre las categorías. Por ejemplo, si queremos que el orden preferido de las categorías y los servicios sea el siguiente: Los complementos se pueden agregar como su propia categoría, solo si se pueden reservar de forma independiente (sin un servicio principal).

Ejemplo

  
{
  "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 pantalla de los diferentes tipos de servicios
Captura de pantalla de los servicios dentro de una página