id: https://nde.nl/ontology/hc/classes/ConversionRate
name: ConversionRate
title: ConversionRate
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  xsd: http://www.w3.org/2001/XMLSchema#
imports:
  - linkml:types
  - ../slots/has_type
  - ../slots/temporal_extent
# default_range: string
classes:
  ConversionRate:
    description: 'Structured representation of a conversion rate metric for heritage
      institutions.

      **WHY A DEDICATED CLASS?**

      Conversion rates are more than simple floats - they need: - **Type**: What kind
      of conversion (visitor-to-purchase, visitor-to-member) - **Value**: The actual
      percentage (0.35 = 35%) - **Time Period**: When this rate was measured - **Context**:
      Comparison benchmarks, notes

      **SLOT_FIXES.YAML REVISION** (lines 1646-1669): - Branch 1: has_type
      → ConversionRateType/ConversionRateTypes - Branch 2: temporal_extent → TimeSpan
      (measurement period)

      **USE CASES**: - Gift shop performance: 35% visitor-to-purchase conversion -
      Membership drives: 5% visitor-to-member conversion - Digital engagement: 3%
      website-to-visit conversion

      **ONTOLOGY MAPPING**: - class_uri: schema:QuantitativeValue (numeric measurement)
      - Uses schema:interactionStatistic for behavioral metrics'
    class_uri: schema:QuantitativeValue
    exact_mappings:
    - schema:QuantitativeValue
    close_mappings:
    - schema:interactionStatistic
    slots:
    - has_type
    - temporal_extent
    - has_value
    slot_usage:
      has_type:
#         range: string # uriorcurie
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value: "has_type:\n  has_label: \"Visitor to Purchase\"\n\
            \  source_population: \"museum visitors\"\n  target_action: \"made gift\
            \ shop purchase\"\n"
      temporal_extent:
        range: TimeSpan
        inlined: true
        examples:
        - value: "temporal_extent:\n  begin_of_the_begin: \"2024-01-01\"\n  end_of_the_end:\
            \ \"2024-12-31\"\n"
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: Conversion rates applicable to all custodian types
        with retail or engagement.
      custodian_types_primary: '*'
      specificity_score: 0.45
      specificity_rationale: Moderate specificity - relevant to custodians tracking
        performance metrics.
    examples:
    - value: "ConversionRate:\n  rate_value: 0.35\n  has_type:\n    has_label:\
        \ \"Visitor to Purchase\"\n  temporal_extent:\n    begin_of_the_begin: \"\
        2024-01-01\"\n    end_of_the_end: \"2024-12-31\"\n"
    - value: "ConversionRate:\n  rate_value: 0.05\n  has_type:\n    has_label:\
        \ \"Visitor to Member\"\n  temporal_extent:\n    begin_of_the_begin: \"2024-06-01\"\
        \n    end_of_the_end: \"2024-08-31\"\n"
    comments:
    - Created from slot_fixes.yaml migration (2026-01-14)
    - Replaces simple float visitor_conversion_rate slot
    - Supports multiple conversion types with industry benchmarks
    - Temporal extent enables trend analysis over time