Offer: help needed to model offers

[saumier]

How to model offers in RDF such that the most common use cases for events in the cultural sector are well expressed and can drive a website page with the needed information displayed and buttons with links to buy tickets or register.

The following cases occur on cultural event websites such as https://signelaval.com/fr/evenements

1. free - event is free
2. paid - event requires a payment
3. free with registration - event is free but participants are required to register for the event in advance
4. paid with registration - event requires a payment and participants are required to register for the event in advance

Issues to explore

• The current model for offers on Schema.org does not include sufficient options to represent the above.
• The only relevant option I have found is schema:isAccessibleForFree which is a property of schema:Event and not schema:Offer.
• There is no clear approach on schema.org to include a general buy url that would be linked to a webpage event if there are multiple Offers. It is very rare for an event to have a url for each ticket price. In most real world cases there is one url for the event that takes the user to the ticketing platform that can offer specific dates and prices.

Proposed solution

Create a controlled vocabulary of types of Offer:

• adr:OfferIsFree
• adr:OfferIsFreeWithRegistration
• adr:OfferIsPaid
• adr:OfferIsPaidWithRegistration

Is there a better and more standard solution? How to other ontologies express these needs?

Example forms that need to be expressed in RDF

These forms have 3 types of tickets. The Paid ticket that requires registration is not illustrated, but is a real need.

Paid event

Proposed RDF (turtle) with Offers at the same level as AggregateOffer.

offers 
     [
         a AggregateOffer  ;
         additionalType ado:OfferIsPaid ;
         url "Entrez l'adresse web URL" ;
         name "Ajouter des informations supplémentaires sur la billeterie"@fr 
     ] , 
    [ 
        a Offer  ;
        price "25.0" ;
        name "Enfants"@fr 
    ] ,
   [ 
        a Offer  ;
        price "55.0" ;
        name "Adultes"@fr 
    ] .

Free event

Proposed RDF (turtle)

offers [ 
     a AggregateOffer  ;
     additionalType adr:OfferIsFree ;
     name "Ajouter des informations supplémentaires sur la billeterie"@fr ]

Free event with a link to register

Proposed RDF (turtle) with url for registration.

offers [ 
     a AggregateOffer  ;
     additionalType  adr:OfferIsFreeWithRegistration ;
     url "Entrez l'adresse web URL" ;
     schema:name "Ajouter des informations supplémentaires sur la billeterie"@fr ] .

[saumier]

@fjjulien Please let me know if you have any questions on this documentation. Thx.

[fjjulien]

@fjjulien Please let me know if you have any questions on this documentation. Thx.

This is much clearer, now. The only case I can't mentally represent is the fourth one: paid with registration. A payment checkout process involves de facto the same kinds of questions as a registration process. What kinds of events in the performing arts sector would need that? A conference in which a single payment can be made for multiple delegate registrations?

[saumier]

The "paid with registration" use case is coming from Isabelle at Tout Culture. I think it has to do with workshops like dance. The webpage describing the master class needs to have people register only, then later they will pay.

@troughc Can you provide some more background as to why Isabelle needs this use case? Thx.

[fjjulien]

Thanks that is useful.

I'm having a heard time mentally representing a "paid with registration" event in the context of the performing arts. A payment checkout process involves the same kind of questions as a registration process. Why require the user to do the same kind of process twice?

[troughc]

@fjjulien the problem is that there are courses (i.e. an art class like painting) and workshops in Tout Culture. These require Registration AND payment.

With the current model, we ONLY have free with registration (so all events that require registration are FREE).

We need to be able to have a PAID registration option for classes/workshops/conference events that a person might want to attend.

I had suggested that we remove the precondition FREE with registration. However, Maude needs FREE registration for her website to accurately display information. So we need both FREE and PAID options.

Example: an art course that requires registration and has a price associated: https://www.visualartscentre.ca/register/?action=course_detail&course_id=7306

[Anicetondo]

**Quelques suggestions sur un évènement et les éventuels détails sur l’offre de spectacle:

Modélisez l’événement culturel lui-même en tant que ressource principale. Cette ressource principale peut être liée à toutes les autres informations associées à l’événement, y compris les offres de billets.**

**Quelques modèles d’un évènement spécifique:

(Ceci existe déjà dans votre représentation)**

:Event1 a schema:Event ;
schema:name "Nom de l'événement" ;
schema:description "Description de l'événement" ;
schema:startDate "2023-10-15T19:00:00"^^xsd:dateTime ;
schema:endDate "2023-10-15T21:00:00"^^xsd:dateTime .

Concernant les Offres de billets : Modélisez les différentes offres pour l’événement en se servant du vocabulaire schema.org. Pour chaque offre , spécifiez si l’événement est gratuit, payant, nécessite une inscription, ou les combinaisons de ces options :

Exemple spécifique( quelques propriétés peuvent être retirées si elles ne sont jugées utiles)

**:Event1 schema:offers [

a schema:Offer ;
schema:name "Billet standard" ;
schema:description "Billet d'entrée standard" ;
schema:price 20.00 ;
schema:priceCurrency "CAD" ;
schema:availability schema:InStock ;
schema:validFrom "2023-09-23"^^xsd:date ;
schema:validThrough "2023-10-15"^^xsd:date ;
schema:eligibleCustomerType schema:Public ;
schema:availabilityStarts "2023-09-23T10:00:00"^^xsd:dateTime ;
schema:availabilityEnds "2023-10-15T18:00:00"^^xsd:dateTime ;
schema:requiresSubscription false ;

] .**

Conditions d’inscription : Pour les événements avec inscription, vous pouvez utiliser une propriété personnalisée pour spécifier les détails de l’inscription. Par exemple :

:Event1 ex:registrationRequirement [

ex:requiresRegistration true ;
ex:registrationURL "URL de la page d'inscription" ;

] .

Concernant l’option l’offre est gratuite ou payante : il est possible de structurer cela avec la propriété schema:price pour indiquer le prix du billet. et la condition serait donc ''''Si le prix est de zéro, l’événement est gratuit'''''.

Liens d’achat de billets : Vous pouvez ajouter des propriétés personnalisées pour les liens d’achat de billets. Par exemple :

:Event1 ex:buyTicketsURL « URL d’achat de billets » .

[Anicetondo]

Je pense que cette façon pourrait aider pour modéliser les offres de spectacles par rapport à l’idée qui est demandée. Je pense que cette façon pourrait aider pour modéliser les offres de spectacles par rapport à l’idée qui est demandée

[Anicetondo]

Mais si toutes les offres nécessitent une inscription, la il n'y aurait plus de condition à ce niveau
:Event1 ex:registrationRequirement [

ex:requiresRegistration true ;
ex:registrationURL "URL de la page d'inscription" ;
] .

le formulaire d'inscription sera alors présenté pour chaque offre

L'autre idée serait un peu similaire à la solution énoncée plus haut(solution de saumier)

mais à la différence qu'on peut avoir une propriété 'nature de l'offre' de telle sorte que pour une offre donnée cette propriété puisse prendre une des valeurs: 'Free' ou 'Paid' en ajoutant une restriction à la propriété.

[saumier]

@Anicetondo Merci pour les suggestions.

I am trying to not add additional properties like ex:registrationRequirement and ex:buyTicketsURL directly to Events but rather I am trying to group them in schema:offers. Is there something you can propose that uses properties within schema:Offer?

[Anicetondo]

@Anicetondo Merci pour les suggestions.

Cette façon de les regrouper dans schema : offers marche aussi c'est ce que je pourrait également proposer en modèle schéma sinon je vous ferai d'autres suggestions sous un format complémentaire au rdf

[fjjulien]

Comme Anicet, j'aurais tendance à décrire sémantiquement l'attribut "gratuit/payant" et la condition "requires registration" avec des propriétés distinctes. "Gratuit/payant" peut aisément être représenté avec schema:price, comme le suggère Anicet. "Requires registration" serait selon moi une condition (ou un pré-requis) qui doit être remplie par le client avant de pouvoir profiter de l'offre. Il pourrait y avoir d'autres conditions qui seraient décrites de la sorte, par exemple:

• Nécessite une pré-approbation
• Doit être membre en règle
• Etc.

Si chacune des ces conditions devait être intégrée à un seul vocabulaire contrôlé, le nombre de valeurs deviendrait exponentielle (et le vocabulaire, inutile).

La solution qui m'apparaît donc la plus simple serait de créer une nouvelle propriété pour représenter les conditions associées à l'offre. Aucune des propriétés actuelles de Schema ne pourrait servir à représenter ce genre d'information. Il faudrait créer une propriété dans l'ontologie Artsdata. Éventuellement, cette propriété pourrait être proposée à Schema.

[saumier]

Reviewing the discussion thus far, I'd like to propose the following using schema:potentialAction.
For more background: https://schema.org/docs/actions.html

Case 1: Free event

:event1 schema:offers [ 
     a schema:Offer  ;
     schema:price 0 
] .

Case 2: Free event with condition to register

:event2 schema:offers [ 
     a schema:Offer  ;
     schema:price 0 ;
    schema:potentialAction  [
         a schema:Action ;
        schema:additionalType  adr:RegistrationRequired ;
        schema:name "Please RSVP"@en ;
       schema:url "http://register.for.event2" ;
       ] .
] .

Case 3: Paid event with condition to register

:event3 schema:offers [ 
     a schema:Offer  ;
     schema:price 25.50 ;
    schema:potentialAction  [
         a schema:Action ;
        schema:additionalType  adr:RegistrationRequired ;
        schema:name "Signup for the workshop and pay later"@en ;
       schema:url "http://register.for.event 3" ;
       ] .
] .

@troughc @fjjulien @Anicetondo Let me know your thoughts. Thx.

There is also a discussion happening here with LaVitrine culturecreates/artsdata-planet-lavitrine#3