@admoai/sdk-scenarios 1.1.0 → 1.3.0

package/fixtures/golden-wire/standard_video.full.json

@@ -0,0 +1,118 @@
+{
+  "success": true,
+  "data": [
+    {
+      "placement": "preroll",
+      "creatives": [
+        {
+          "delivery": "json",
+          "contents": [
+            {
+              "key": "video_asset",
+              "type": "video",
+              "value": "https://cdn.admoai.com/media/volta-15s.mp4"
+            },
+            {
+              "key": "poster_image",
+              "type": "image",
+              "value": "https://cdn.admoai.com/media/volta-poster.jpg"
+            },
+            {
+              "key": "brand_logo",
+              "type": "image",
+              "value": "https://cdn.admoai.com/media/volta-logo.png"
+            },
+            {
+              "key": "headline",
+              "type": "text",
+              "value": "Two lattes, one price"
+            },
+            {
+              "key": "supporting_text",
+              "type": "text",
+              "value": "At every Volta in Santiago until Sunday."
+            },
+            {
+              "key": "cta_text",
+              "type": "text",
+              "value": "See the menu"
+            },
+            {
+              "key": "destination_url",
+              "type": "url",
+              "value": "https://volta.example/menu"
+            },
+            {
+              "key": "disclaimer",
+              "type": "text",
+              "value": "While stocks last."
+            }
+          ],
+          "advertiser": {
+            "name": "Volta Coffee",
+            "legalName": "Volta Coffee SpA",
+            "logoUrl": "https://cdn.admoai.com/media/volta-logo.png"
+          },
+          "template": {
+            "key": "standard_video",
+            "style": "default"
+          },
+          "tracking": {
+            "impressions": [
+              {
+                "key": "default",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.impression"
+              }
+            ],
+            "clicks": [
+              {
+                "key": "default",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.click"
+              }
+            ],
+            "custom": [],
+            "videoEvents": [
+              {
+                "key": "start",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.start"
+              },
+              {
+                "key": "first_quartile",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.first_quartile"
+              },
+              {
+                "key": "midpoint",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.midpoint"
+              },
+              {
+                "key": "third_quartile",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.third_quartile"
+              },
+              {
+                "key": "complete",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.full.complete"
+              }
+            ]
+          },
+          "metadata": {
+            "adId": "ad_01JDDR87YZYWJKANY5ZRAXWS3Q",
+            "creativeId": "creative_01JDGR1RTA3KV7KARB86J1DP84",
+            "advertiserId": "advertiser_01JDH315KXW0FP82VY8WMV97YE",
+            "placementId": "placement_01JDGX7Z9JHJR8PN9HZJPDNFWA",
+            "templateId": "template_01JDM27C055JQSS6R0DV2H5XPB",
+            "priority": "standard",
+            "language": "en",
+            "format": "video",
+            "effectiveStandardFormatKey": "standard_video",
+            "effectiveStandardFormatVersion": 1,
+            "templateSource": "admoai_standard",
+            "duration": 15,
+            "aspectRatio": "16:9"
+          }
+        }
+      ]
+    }
+  ],
+  "errors": null,
+  "warnings": null
+}

package/fixtures/golden-wire/standard_video.minimal.json

@@ -0,0 +1,83 @@
+{
+  "success": true,
+  "data": [
+    {
+      "placement": "preroll",
+      "creatives": [
+        {
+          "delivery": "json",
+          "contents": [
+            {
+              "key": "video_asset",
+              "type": "video",
+              "value": "https://cdn.admoai.com/media/volta-15s.mp4"
+            },
+            {
+              "key": "poster_image",
+              "type": "image",
+              "value": "https://cdn.admoai.com/media/volta-poster.jpg"
+            }
+          ],
+          "advertiser": {
+            "name": "Volta Coffee",
+            "legalName": "Volta Coffee SpA",
+            "logoUrl": "https://cdn.admoai.com/media/volta-logo.png"
+          },
+          "template": {
+            "key": "standard_video",
+            "style": "default"
+          },
+          "tracking": {
+            "impressions": [
+              {
+                "key": "default",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.impression"
+              }
+            ],
+            "clicks": [],
+            "custom": [],
+            "videoEvents": [
+              {
+                "key": "start",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.start"
+              },
+              {
+                "key": "first_quartile",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.first_quartile"
+              },
+              {
+                "key": "midpoint",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.midpoint"
+              },
+              {
+                "key": "third_quartile",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.third_quartile"
+              },
+              {
+                "key": "complete",
+                "url": "https://api.admoai.com/v1/tracking?e=tok.standard_video.minimal.complete"
+              }
+            ]
+          },
+          "metadata": {
+            "adId": "ad_01JDB2BVYVEG36SJ39ZVJ2S7FK",
+            "creativeId": "creative_01JDXWS60TJADDBKW1184GW4DE",
+            "advertiserId": "advertiser_01JDH315KXW0FP82VY8WMV97YE",
+            "placementId": "placement_01JDGX7Z9JHJR8PN9HZJPDNFWA",
+            "templateId": "template_01JDJ0JEE18TK4W82VSCT9NM1F",
+            "priority": "standard",
+            "language": "en",
+            "format": "video",
+            "effectiveStandardFormatKey": "standard_video",
+            "effectiveStandardFormatVersion": 1,
+            "templateSource": "admoai_standard",
+            "duration": 15,
+            "aspectRatio": "16:9"
+          }
+        }
+      ]
+    }
+  ],
+  "errors": null,
+  "warnings": null
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@admoai/sdk-scenarios",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "The cross-SDK decision & tracking scenarios every AdMoai SDK asserts against a real decision-engine. Data only.",
   "license": "MIT",
   "files": [
     "scenarios.json",
     "scenarios.feature",
+    "fixtures/",
     "CHANGELOG.md",
     "README.md"
   ],

package/scenarios.feature

@@ -1,11 +1,12 @@
 # GENERATED from scenarios.json — do not edit; regenerate with: go run ./tools/sdkfeaturegen
 #
-# scenarios.json is what the iOS, Android and Flutter manifest runners execute against a
-# real decision-engine. This is its readable rendering: what every AdMoai SDK promises a
-# publisher's app, in the same words for all three. CI regenerates it and fails on any
-# difference, so it cannot drift from what the runners execute.
+# scenarios.json is what the iOS, Android and Flutter manifest runners execute: the live
+# scenarios against a real decision-engine, the @fixture scenarios offline against the golden
+# decision wire shipped in the package. This is its readable rendering: what every AdMoai SDK
+# promises a publisher's app, in the same words for all three. CI regenerates it and fails on
+# any difference, so it cannot drift from what the runners execute.
 # How it is published and kept fresh: docs/guides/sdk-ci.md, Section 7.
-# Manifest schemaVersion: 1
+# Manifest schemaVersion: 3
 
 Feature: Cross-SDK decision & tracking contract
   Shared cross-SDK E2E scenario manifest. ONE definition, executed by a thin interpreter in each
@@ -15,7 +16,21 @@ Feature: Cross-SDK decision & tracking contract
   (log capture, concurrency, retry, TTL waits) stay hand-written per SDK. Mirrored
   byte-identically into all three repos; a checksum test fails the build if the copies diverge.
   Every expected value here was verified against a live local decision-engine before being
-  written.
+  written. `fixtureScenarios` (schemaVersion 2) run offline: each decodes one golden
+  decision-wire file (ui/platform/lib/ad-formats/golden-wire in adhub, shipped in this package
+  under fixtures/golden-wire/) after optional `edits`, and asserts what the publisher's app
+  reads from the decoded creative. `contentKeys` is the exact set of plain content keys (slides
+  and matched points are asserted through their own fields); a key in `contentKeysAbsent` must
+  decode as absent (null), never as an empty string or a placeholder; a null in `metadata` means
+  absent. A runner that does not execute fixtureScenarios must refuse schemaVersion 2. A fixture
+  scenario may add `slideTracking` (package 1.3.0, schemaVersion 3; a runner that does not
+  execute it must refuse schemaVersion 3): `steps` the app takes on the decoded creative
+  (`slideView`/`slideClick` with a 1-based slide index, `newResponse`, `fireClick` with a key or
+  null for no key, `custom` with a key) and the beacons that must be dispatched: `beacons` is
+  the exact ordered list of first-party beacons, each named by the tracker it must be
+  (`slide`+`view`/`click`, or creative `click`/`custom`, with `response`), and
+  `thirdPartyBeacons` the exact multiset of third-party tracker ids dispatched (their order is
+  not asserted). An edit `at` `tracking` targets the creative's tracking object.
 
   @L @native
   Scenario: L1 — a normal native ad serves with complete, well-formed metadata
@@ -369,3 +384,360 @@ Feature: Cross-SDK decision & tracking contract
     Then each shown pin's view beacon reaches the engine exactly once per response, and no pin the app never showed sends one
     And every tap and every click sends its beacon, on every call
     And the engine accepts every beacon
+
+  @F @fixture
+  Scenario: F1 — a Native Display creative exposes its standard format, version and template source
+    Given the app decodes the golden card.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "card"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "card"
+    And the creative's contents are exactly "image", "brand_logo", "headline", "supporting_text", "cta_text", "destination_url"
+    And the click trackers are exactly "default"
+    And the creative has no custom event tracker
+
+  @F @fixture
+  Scenario: F2 — a Native Display creative leaves every optional field it was served without absent
+    Given the app decodes the golden card.minimal response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "card"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "card"
+    And the creative's contents are exactly "image", "destination_url"
+    And "brand_logo", "headline", "supporting_text", "cta_text" decode as absent, never as an empty string or a placeholder
+    And the click trackers are exactly "default"
+    And the creative has no custom event tracker
+
+  @F @fixture
+  Scenario: F3 — a template based on a standard keeps the standard's identity and exposes the operator's addition by key
+    Given the app decodes the golden card.derived response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "card"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "based_on_standard"
+    And the template key is "city_promo_display"
+    And the creative's contents are exactly "image", "headline", "destination_url", "promo_code"
+    And the click trackers are exactly "default"
+    And the custom event trackers are exactly "save_offer"
+
+  @F @fixture
+  Scenario: F4 — a Carousel exposes its slides in server order, each with its id, position, contents and own trackers, and no creative-level click
+    Given the app decodes the golden carousel.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "carousel"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "carousel"
+    And the creative's contents are exactly "brand_logo", "disclaimer"
+    And the creative has no click tracker
+    And the creative has no custom event tracker
+    And there are 3 slides in server order
+    And slide 1 is "slide_01JDY02N8MA2K2HKQ74989YS99" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 2 is "slide_01JD04H8GY801VF8Y0FHETP6XA" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 3 is "slide_01JDRGMFSTZXQ7ES1QBCF0DR2X" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+
+  @F @fixture
+  Scenario: F5 — a minimal Carousel still exposes its slides and leaves the optional brand logo and disclaimer absent
+    Given the app decodes the golden carousel.minimal response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "carousel"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "carousel"
+    And the creative has no plain contents
+    And "brand_logo", "disclaimer" decode as absent, never as an empty string or a placeholder
+    And the creative has no click tracker
+    And the creative has no custom event tracker
+    And there are 2 slides in server order
+    And slide 1 is "slide_01JDZ725G8017BHW9RQJX7Y56S" with contents "image", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 2 is "slide_01JD4GNH6TH0XPP5YWCMDKN029" with contents "image", "destination_url", view trackers "slide_view" and click trackers "default"
+
+  @F @fixture
+  Scenario: F6 — a Carousel based on a standard exposes its slides and the operator's addition
+    Given the app decodes the golden carousel.derived response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "carousel"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "based_on_standard"
+    And the template key is "city_carousel"
+    And the creative's contents are exactly "promo_code"
+    And the creative has no click tracker
+    And the creative has no custom event tracker
+    And there are 2 slides in server order
+    And slide 1 is "slide_01JDS1H8VEM0ABE2PQ0JY6S38W" with contents "image", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 2 is "slide_01JDDGXJE0JDBY21Y9KEJDD54A" with contents "image", "destination_url", view trackers "slide_view" and click trackers "default"
+
+  @F @fixture
+  Scenario: F7 — a Tap-to-expand creative exposes expand and close as custom events, apart from its click
+    Given the app decodes the golden expandable_banner.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "expandable_banner"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "expandable_banner"
+    And the creative's contents are exactly "teaser_image", "teaser_headline", "expanded_image", "headline", "supporting_text", "cta_text", "destination_url", "disclaimer"
+    And the click trackers are exactly "default"
+    And the custom event trackers are exactly "expand", "close"
+
+  @F @fixture
+  Scenario: F8 — a minimal Tap-to-expand creative leaves its optional texts absent and keeps expand and close
+    Given the app decodes the golden expandable_banner.minimal response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "expandable_banner"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "expandable_banner"
+    And the creative's contents are exactly "teaser_image", "expanded_image", "destination_url"
+    And "teaser_headline", "headline", "supporting_text", "cta_text", "disclaimer" decode as absent, never as an empty string or a placeholder
+    And the click trackers are exactly "default"
+    And the custom event trackers are exactly "expand", "close"
+
+  @F @fixture
+  Scenario: F9 — a Branded Assets creative exposes asset tap as a custom event, apart from its click
+    Given the app decodes the golden branded_assets.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "branded_assets"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "branded_assets"
+    And the creative's contents are exactly "branded_image", "accessible_label", "destination_url"
+    And the click trackers are exactly "default"
+    And the custom event trackers are exactly "asset_tap"
+
+  @F @fixture
+  Scenario: F10 — a Branded Assets creative without a destination has no click, only the asset tap
+    Given the app decodes the golden branded_assets.minimal response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "branded_assets"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "branded_assets"
+    And the creative's contents are exactly "branded_image"
+    And "accessible_label", "destination_url" decode as absent, never as an empty string or a placeholder
+    And the creative has no click tracker
+    And the custom event trackers are exactly "asset_tap"
+
+  @F @fixture
+  Scenario: F11 — a Standard Video exposes its video events and click, and no skippable setting
+    Given the app decodes the golden standard_video.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "standard_video"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "standard_video"
+    And the creative's contents are exactly "video_asset", "poster_image", "brand_logo", "headline", "supporting_text", "cta_text", "destination_url", "disclaimer"
+    And the click trackers are exactly "default"
+    And the creative has no custom event tracker
+    And the video event trackers are exactly "start", "first_quartile", "midpoint", "third_quartile", "complete"
+    And the creative exposes no skippable setting
+
+  @F @fixture
+  Scenario: F12 — a Standard Video without a destination has no click action or click tracker
+    Given the app decodes the golden standard_video.minimal response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "standard_video"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "standard_video"
+    And the creative's contents are exactly "video_asset", "poster_image"
+    And "brand_logo", "headline", "supporting_text", "cta_text", "destination_url", "disclaimer" decode as absent, never as an empty string or a placeholder
+    And the creative has no click tracker
+    And the creative has no custom event tracker
+    And the video event trackers are exactly "start", "first_quartile", "midpoint", "third_quartile", "complete"
+    And the creative exposes no skippable setting
+
+  @F @fixture
+  Scenario: F13 — a Sponsored Pin creative keeps decoding its matched points as it does today
+    Given the app decodes the golden sponsored_pin_location.full response
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "sponsored_pin_location"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "sponsored_pin_location"
+    And the creative's contents are exactly "pinImage", "image", "headline", "description", "ctaText", "defaultDestinationUrl"
+    And the click trackers are exactly "default"
+    And the creative has no custom event tracker
+    And the creative exposes 2 matched points
+
+  @F @fixture
+  Scenario: F14 — a creative served before the standards (gate off) decodes as today, with the three standard fields absent
+    The engine omits the three standard fields while is_standard_native_formats_enabled is off;
+    this is that wire. Absent means null, never an empty string or a placeholder (BR-SDK-01,
+    BR-SDK-09).
+
+    Given the app decodes the golden card.full response
+    And with the metadata field "effectiveStandardFormatKey" removed
+    And with the metadata field "effectiveStandardFormatVersion" removed
+    And with the metadata field "templateSource" removed
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is absent
+    And the creative's effectiveStandardFormatVersion is absent
+    And the creative's templateSource is absent
+    And the template key is "card"
+    And the creative's contents are exactly "image", "brand_logo", "headline", "supporting_text", "cta_text", "destination_url"
+    And the click trackers are exactly "default"
+    And the creative has no custom event tracker
+
+  @F @fixture
+  Scenario: F15 — fields the SDK does not know yet, at any level, never break decoding
+    An additive field the engine starts sending later must be ignored, not fail the response
+    (BR-SDK-01).
+
+    Given the app decodes the golden carousel.full response
+    And with an unknown response field "futureField" added
+    And with an unknown creative field "futureField" added
+    And with an unknown metadata field "futureField" added
+    And with an unknown content field "futureField" added on every content entry
+    And with an unknown slide field "futureField" added on every slide
+    Then the response decodes
+    And the creative's effectiveStandardFormatKey is "carousel"
+    And the creative's effectiveStandardFormatVersion is 1
+    And the creative's templateSource is "admoai_standard"
+    And the template key is "carousel"
+    And the creative's contents are exactly "brand_logo", "disclaimer"
+    And the creative has no click tracker
+    And the creative has no custom event tracker
+    And there are 3 slides in server order
+    And slide 1 is "slide_01JDY02N8MA2K2HKQ74989YS99" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 2 is "slide_01JD04H8GY801VF8Y0FHETP6XA" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+    And slide 3 is "slide_01JDRGMFSTZXQ7ES1QBCF0DR2X" with contents "image", "headline", "supporting_text", "cta_text", "destination_url", view trackers "slide_view" and click trackers "default"
+
+  @F @fixture
+  Scenario: F16 — a slide's view beacon is sent once per served response, however often the slide is shown
+    Keyed on the signed view URL, never on the slideId: re-rendering or scrolling back to a
+    slide must not count it again (BR-SDK-04, Q19).
+
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app reports slide 1 as viewed
+    And the app reports slide 1 as viewed
+    And the app reports slide 2 as viewed
+    And the app reports slide 1 as viewed
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And slide 1's "slide_view" view beacon
+    And slide 2's "slide_view" view beacon
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F17 — the same slide in a new decision response counts again
+    A new response carries new signed URLs for the same slides. The runner simulates it by
+    decoding the same golden file again with every first-party tracker URL suffixed
+    `&response=N` (N = 2, 3, ...); `response` in an expected beacon names which one (default 1).
+
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app reports slide 1 as viewed
+    And the app decodes a new decision response for the same ad
+    And the app reports slide 1 as viewed
+    And the app reports slide 1 as viewed
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And slide 1's "slide_view" view beacon
+    And slide 1's "slide_view" view beacon from response 2
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F18 — a slide clicked before its view was sent sends the view, then the click, then the creative's applicable third-party click trackers once
+    Applicable means a click tracker matching any click, or the `default` click specifically; a
+    tracker for another click key and an impression tracker do not fire (BR-SDK-05, Q14, Q18).
+
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the user clicks slide 2
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And slide 2's "slide_view" view beacon
+    And slide 2's "default" click beacon
+    And the third-party trackers sent are exactly "tpt_fixture_click_any", "tpt_fixture_click_default"
+
+  @F @fixture
+  Scenario: F19 — a slide clicked after its view sends only the click, on every click
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app reports slide 2 as viewed
+    And the user clicks slide 2
+    And the user clicks slide 2
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And slide 2's "slide_view" view beacon
+    And slide 2's "default" click beacon
+    And slide 2's "default" click beacon
+    And the third-party trackers sent are exactly "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_any", "tpt_fixture_click_default"
+
+  @F @fixture
+  Scenario: F20 — slide views never send third-party click trackers
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app reports slide 1 as viewed
+    And the app reports slide 2 as viewed
+    And the app reports slide 3 as viewed
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And slide 1's "slide_view" view beacon
+    And slide 2's "slide_view" view beacon
+    And slide 3's "slide_view" view beacon
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F21 — a Carousel has no creative-level click: fireClick sends nothing, so slide clicks go through the slide helper
+    Publishers must not route a slide tap through fireClick (BR-SDK-03, Q9).
+
+    Given the app decodes the golden carousel.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app calls fireClick with no key
+    Then the response decodes
+    And no first-party beacon is sent
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F22 — fireClick with no key sends the default click of a standard
+    Every standard seeds its click with key `default`, which is what fireClick sends without a
+    key (BR-SDK-06, Q12).
+
+    Given the app decodes the golden card.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app calls fireClick with no key
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And the creative's "default" click beacon
+    And the third-party trackers sent are exactly "tpt_fixture_click_any", "tpt_fixture_click_default"
+
+  @F @fixture
+  Scenario: F23 — expand and close are sent verbatim as custom events and are not clicks
+    The publisher calls them when the banner actually expands or closes; no click is sent and no
+    third-party click tracker fires (BR-SDK-07).
+
+    Given the app decodes the golden expandable_banner.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app sends the custom event "expand"
+    And the app sends the custom event "close"
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And the creative's "expand" custom beacon
+    And the creative's "close" custom beacon
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F24 — an asset tap is sent verbatim as a custom event and is not a click
+    BR-SDK-07.
+
+    Given the app decodes the golden branded_assets.full response
+    And with third-party trackers "tpt_fixture_click_any", "tpt_fixture_click_default", "tpt_fixture_click_other", "tpt_fixture_impression"
+    When the app sends the custom event "asset_tap"
+    Then the response decodes
+    And exactly these beacons are sent, in this order:
+    And the creative's "asset_tap" custom beacon
+    And no third-party tracker is sent
+
+  @F @fixture
+  Scenario: F25 — a Standard Video without a destination sends no click
+    No destination means no click action and no click tracker (BR-SDK-08).
+
+    Given the app decodes the golden standard_video.minimal response
+    When the app calls fireClick with no key
+    Then the response decodes
+    And no first-party beacon is sent
+    And no third-party tracker is sent