ca4a54181e
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting. - Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes. - Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting. - Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting. - Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability. - Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability. - Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name. - Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity. - Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity. - Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity. - Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
154 lines
4.9 KiB
YAML
154 lines
4.9 KiB
YAML
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_or_had_type
|
||
- ../slots/temporal_extent
|
||
- ./ConversionRateType
|
||
- ./ConversionRateTypes
|
||
- ./TimeSpan
|
||
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_or_had_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_or_had_type
|
||
- temporal_extent
|
||
|
||
attributes:
|
||
rate_value:
|
||
range: float
|
||
required: true
|
||
description: >-
|
||
The conversion rate as a decimal (0.35 = 35%).
|
||
Always expressed as proportion between 0.0 and 1.0.
|
||
minimum_value: 0.0
|
||
maximum_value: 1.0
|
||
|
||
rate_percentage:
|
||
range: float
|
||
description: >-
|
||
The conversion rate as a percentage (35 = 35%).
|
||
Calculated field: rate_value × 100.
|
||
minimum_value: 0.0
|
||
maximum_value: 100.0
|
||
|
||
sample_size:
|
||
range: integer
|
||
description: >-
|
||
The number of observations in the denominator (total visitors, emails sent, etc.).
|
||
Required for statistical significance assessment.
|
||
|
||
converted_count:
|
||
range: integer
|
||
description: >-
|
||
The number of successful conversions (numerator).
|
||
Required for statistical significance assessment.
|
||
|
||
measurement_period_description:
|
||
range: string
|
||
description: >-
|
||
Human-readable description of the measurement period.
|
||
Examples: "Q1 2025", "Calendar Year 2024", "Exhibition period"
|
||
|
||
benchmark_comparison:
|
||
range: string
|
||
description: >-
|
||
How this rate compares to industry benchmarks.
|
||
Examples: "Above average", "Top quartile", "Below benchmark"
|
||
|
||
notes:
|
||
range: string
|
||
description: >-
|
||
Additional context about this conversion rate measurement.
|
||
Examples: Special circumstances, data collection methodology.
|
||
|
||
slot_usage:
|
||
has_or_had_type:
|
||
range: uriorcurie
|
||
inlined: true
|
||
examples:
|
||
- value: |
|
||
has_or_had_type:
|
||
has_or_had_label: "Visitor to Purchase"
|
||
source_population: "museum visitors"
|
||
target_action: "made gift shop purchase"
|
||
temporal_extent:
|
||
range: TimeSpan
|
||
inlined: true
|
||
examples:
|
||
- value: |
|
||
temporal_extent:
|
||
begin_of_the_begin: "2024-01-01"
|
||
end_of_the_end: "2024-12-31"
|
||
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:
|
||
rate_value: 0.35
|
||
has_or_had_type:
|
||
has_or_had_label: "Visitor to Purchase"
|
||
temporal_extent:
|
||
begin_of_the_begin: "2024-01-01"
|
||
end_of_the_end: "2024-12-31"
|
||
- value: |
|
||
ConversionRate:
|
||
rate_value: 0.05
|
||
has_or_had_type:
|
||
has_or_had_label: "Visitor to Member"
|
||
temporal_extent:
|
||
begin_of_the_begin: "2024-06-01"
|
||
end_of_the_end: "2024-08-31"
|
||
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
|