Strukturyzowanie plików danych

Interpretacja cen usług

Cena jest polem wymaganym. Aby dowiedzieć się, jak przedstawiać ceny w pliku danych, zapoznaj się z przykładami(jak są wyświetlane użytkownikowi).

Przykłady

Interpretacja ceny:

INTERPRETATION_EXACT Jak wyświetlane użytkownikowi: 39,99 zł

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

Wyświetlana użytkownikowi: bezpłatna

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

Interpretacja ceny:

INTERPRETATION_STARTS_AT Jak wyświetlane użytkownikowi : Od 0,00 zł

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

Jak jest wyświetlana użytkownikowi: Od 25 PLN

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

Interpretacja ceny:

INTERPRETATION_RANGE: wyświetlany użytkownikowi zakres: 15,00–25,00 PLN

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

Interpretacja ceny: INTERPRETATION_NOT_DISPLAYED

Jak wyświetlić użytkownikowi: użytkownik nie zobaczy ceny

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

Opis usługi jest zdecydowanie zalecany, ale nie jest wymagany, ponieważ zdajemy sobie sprawę, że niektóre usługi są oczywiste i nie wszyscy sprzedawcy je podają. Jeśli opis usługi jest identyczny z jej nazwą, zalecamy, aby pozostawić to pole puste, aby uniknąć powielania. Nie będzie to jednak egzekwowane.

Przykłady

Gdy dla usługi podano opis:

  
{
  "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."
    }
  }
}
  
Zrzut ekranu z opisem typu usługi

Jeśli nie podano opisu usług:

Zrzut ekranu pokazujący typ usługi bez opisu

Jeśli opis usługi jest dłuższy niż 120 znaków, zostanie obcięty:


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

Wskazówki dotyczące kategorii usług i rankingu Wskazówki dotyczące rankingu wpływają zarówno na kolejność usług w ramach kategorii usług, jak i na kolejność samych kategorii. Wskazanie rankingu dla kategorii jest traktowane jako minimalne wskazanie rankingu dla dowolnego produktu w tej kategorii. Pamiętaj, że na ostateczne pozycjonowanie mogą mieć wpływ inne czynniki, takie jak cena, historia użytkownika itp. Zalecane jest zdefiniowanie całkowitego uporządkowania wszystkich usług poprzez przypisanie każdej z nich unikalnego podpowiedzi pozycjonowania w postaci liczby całkowitej i zapewnienie, że wartości podpowiedzi pozycjonowania nie będą się pokrywać w różnych kategoriach. Jeśli na przykład chcemy, aby preferowana kolejność kategorii i usług była następująca: dodatki można dodać jako osobną kategorię, tylko jeśli można je zarezerwować niezależnie (bez usługi podstawowej).

Przykład

  
{
  "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
      }
    }
  ]
}
  
Zrzut ekranu przedstawiający różne typy usług
Zrzut ekranu z usługami na stronie