chore: improve Event property

topsort-api-v2.yml

@@ -84,44 +84,44 @@
                   - results
                 examples:
                   - results:
                       - winners:
                           - rank: 1
                             type: product
                             id: p_Mfk11
                             resolvedBidId: WyJiX01mazExIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTMyNjYtY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0==
                             campaignId: 82588593-85c5-47c0-b125-07e315b7f2b3
                         error: false
                       - winners:
                           - rank: 1
                             type: product
                             id: p_Mfk15
                             resolvedBidId: WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0=
                             campaignId: 4bcc6093-f367-4df2-aa1b-7c1674dd6441
                           - rank: 2
                             type: product
                             id: p_PJbnN
                             resolvedBidId: WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0=
                             campaignId: a72e4e43-55b5-4d08-81bb-cbb57df59c72
                         error: false
                       - winners:
                           - rank: 1
                             type: product
                             id: p_PJbnN
                             resolvedBidId: WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd
                             campaignId: 1156ef4e-0109-4190-ac97-4436c82358d2
                             asset:
                               - url: https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png
                                 content:
                                   headingText:
                                     "A banner for Topsort with a product image and a shop now button"
                                   bannerText: "Topsort has the best tech!"
                                   bannerTextColour: "48a94c"
                                   heroImage: "https://assets.imageurl.io/s/85d2d333-eed5-44d7-b131-8851d59f0574"
                                   heroImageAltText: "Topsort product image"
                         error: false
                   - results:
                       - winners: []
                         error: false
         "400":
           $ref: "#/components/responses/BadRequest"
         "401":
@@ -584,8 +584,8 @@
                 minLength: 1
               minItems: 1
               examples:
                 - c_men_clothing
                 - c_shoes
         - type: object
           title: Category Disjunctions
           description: Multiple disjunctions of categories for the purpose of running an auction.
@@ -605,8 +605,8 @@
               minItems: 1
               maxItems: 5
               examples:
                 - c_red
                 - c_blue
     SingleCategory:
       type: object
       title: Single Category
@@ -631,7 +631,7 @@
       items:
         type: string
         description: A category ID.
-        minimum: 1
+        minLength: 1
       minItems: 1
     Device:
       type: string
@@ -833,6 +833,8 @@
       oneOf:
         - $ref: "#/components/schemas/SponsoredListingsAuction"
         - $ref: "#/components/schemas/BannersAuction"
+      minItems: 1
+      maxItems: 5
     RankingRequest:
       type: object
       description: |
@@ -1911,45 +1913,28 @@
     EventsRequest:
       type: object
       additionalProperties: false
-      properties:
-        impressions:
+      minProperties: 1
+      anyOf:
+        - title: Impressions
           type: array
-          items:
-            $ref: "#/components/schemas/Impression"
+          $ref: "#/components/schemas/Impression"
           minItems: 0
           maxItems: 50
-        clicks:
+        - title: Clicks
           type: array
-          items:
-            $ref: "#/components/schemas/Click"
+          $ref: "#/components/schemas/Click"
           minItems: 0
           maxItems: 50
-        purchases:
+        - title: Purchases
           type: array
-          items:
-            $ref: "#/components/schemas/Purchase"
+          $ref: "#/components/schemas/Purchase"
           minItems: 0
           maxItems: 50
-        pageviews:
+        - title: Page views
           type: array
-          items:
-            $ref: "#/components/schemas/Pageview"
+          $ref: "#/components/schemas/Pageview"
           minItems: 0
           maxItems: 50
-      minProperties: 1
-      anyOf:
-        - properties:
-            impressions:
-              minItems: 1
-        - properties:
-            clicks:
-              minItems: 1
-        - properties:
-            purchases:
-              minItems: 1
-        - properties:
-            pageviews:
-              minItems: 1
       examples:
         - impressions:
             - id: eb874c98-bf4d-40a9-ae6d-fcf4cecb535c
@@ -2010,6 +1995,7 @@
               deviceType: mobile
               channel: onsite
     Impression:
+      title: Impression
       type: object
       description: >
         An impression means a promotable has become visible to the consumer. For promoted entities,
@@ -2069,6 +2055,7 @@
           examples:
             - onsite
     Click:
+      title: Click
       description: >
         A click is sent to Topsort when the consumer has clicked on a promotable. For promoted
         entities, include the `resolvedBidId` field from the `/v2/auctions` response. For unpromoted
@@ -2134,6 +2121,7 @@
           examples:
             - onsite
     Purchase:
+      title: Purchase
       description: >
         A purchase is sent to Topsort once a marketplace customer places an order. These events are
         used to measure the effectiveness of an ad campaign.
@@ -2218,6 +2206,7 @@
       examples:
         - eb874c98-bf4d-40a9-ae6d-fcf4cecb535c
     Pageview:
+      title: Pageview
       type: object
       description: >
         A page view represents the navigation of the user throughout the page. They are considered