@admoai/sdk-scenarios 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ Versioning: a scenario added or an `expect` tightened is a **minor** release; a
 removed, or a `request`/`expect` key renamed (every SDK's interpreter must change), is a
 **major** one. Each SDK vendors one version and its own CI checks the vendored bytes against it.
 
+## 1.3.0 — 2026-11-05
+
+Adds fixture scenarios F16–F25 with a `slideTracking` block (admoai/adhub#4733): what the app
+dispatches when it reports slides and interactions on a decoded standard creative, offline.
+A slide view goes out once per served response, keyed on its signed URL, and again for a new
+response (F16, F17). A slide click before its view sends the view, then the click, then the
+creative's applicable third-party click trackers once per click. A slide view never sends them
+(F18-F20). A Carousel has no creative click (F21). `fireClick` with no key sends `default`
+(F22). Expand, close and asset tap are verbatim custom events, not clicks (F23, F24). A
+Standard Video without a destination sends no click (F25). New edit level `tracking` (the
+creative's tracking object), used to inject third-party trackers on `.example` hosts. A
+`schemaVersion` moves to 3, so a runner that knows only 2 refuses the manifest instead of
+skipping `slideTracking` silently; adopting 1.3.0 requires executing it.
+
 ## 1.2.0 — 2026-11-05
 
 Adds `fixtureScenarios` F1–F15 and moves `schemaVersion` to 2 (admoai/adhub#4733): offline

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@admoai/sdk-scenarios",
-  "version": "1.2.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": [

package/scenarios.feature

@@ -6,7 +6,7 @@
 # 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: 2
+# Manifest schemaVersion: 3
 
 Feature: Cross-SDK decision & tracking contract
   Shared cross-SDK E2E scenario manifest. ONE definition, executed by a thin interpreter in each
@@ -22,7 +22,15 @@ Feature: Cross-SDK decision & tracking contract
   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.
+  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
@@ -595,3 +603,141 @@ Feature: Cross-SDK decision & tracking contract
     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

package/scenarios.json

@@ -1,6 +1,6 @@
 {
-  "schemaVersion": 2,
-  "description": "Shared cross-SDK E2E scenario manifest. ONE definition, executed by a thin interpreter in each SDK, so the three suites cannot drift. Declarative only: given a request, expect an outcome. Sponsored Pin tracking scenarios add `pinTracking`: the point-tracking calls an app makes on the served pins, as data, and the beacons that must reach the engine. Procedural scenarios (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. `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.",
+  "schemaVersion": 3,
+  "description": "Shared cross-SDK E2E scenario manifest. ONE definition, executed by a thin interpreter in each SDK, so the three suites cannot drift. Declarative only: given a request, expect an outcome. Sponsored Pin tracking scenarios add `pinTracking`: the point-tracking calls an app makes on the served pins, as data, and the beacons that must reach the engine. Procedural scenarios (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. `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.",
   "scenarios": [
     {
       "id": "L1",
@@ -1591,6 +1591,634 @@
           }
         ]
       }
+    },
+    {
+      "id": "F16",
+      "title": "a slide's view beacon is sent once per served response, however often the slide is shown",
+      "comment": "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).",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "slideView": 1
+          },
+          {
+            "slideView": 1
+          },
+          {
+            "slideView": 2
+          },
+          {
+            "slideView": 1
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "slide": 1,
+              "view": "slide_view"
+            },
+            {
+              "slide": 2,
+              "view": "slide_view"
+            }
+          ],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F17",
+      "title": "the same slide in a new decision response counts again",
+      "comment": "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).",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "slideView": 1
+          },
+          {
+            "newResponse": true
+          },
+          {
+            "slideView": 1
+          },
+          {
+            "slideView": 1
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "slide": 1,
+              "view": "slide_view"
+            },
+            {
+              "slide": 1,
+              "view": "slide_view",
+              "response": 2
+            }
+          ],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F18",
+      "title": "a slide clicked before its view was sent sends the view, then the click, then the creative's applicable third-party click trackers once",
+      "comment": "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).",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "slideClick": 2
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "slide": 2,
+              "view": "slide_view"
+            },
+            {
+              "slide": 2,
+              "click": "default"
+            }
+          ],
+          "thirdPartyBeacons": [
+            "tpt_fixture_click_any",
+            "tpt_fixture_click_default"
+          ]
+        }
+      }
+    },
+    {
+      "id": "F19",
+      "title": "a slide clicked after its view sends only the click, on every click",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "slideView": 2
+          },
+          {
+            "slideClick": 2
+          },
+          {
+            "slideClick": 2
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "slide": 2,
+              "view": "slide_view"
+            },
+            {
+              "slide": 2,
+              "click": "default"
+            },
+            {
+              "slide": 2,
+              "click": "default"
+            }
+          ],
+          "thirdPartyBeacons": [
+            "tpt_fixture_click_any",
+            "tpt_fixture_click_default",
+            "tpt_fixture_click_any",
+            "tpt_fixture_click_default"
+          ]
+        }
+      }
+    },
+    {
+      "id": "F20",
+      "title": "slide views never send third-party click trackers",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "slideView": 1
+          },
+          {
+            "slideView": 2
+          },
+          {
+            "slideView": 3
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "slide": 1,
+              "view": "slide_view"
+            },
+            {
+              "slide": 2,
+              "view": "slide_view"
+            },
+            {
+              "slide": 3,
+              "view": "slide_view"
+            }
+          ],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F21",
+      "title": "a Carousel has no creative-level click: fireClick sends nothing, so slide clicks go through the slide helper",
+      "comment": "Publishers must not route a slide tap through fireClick (BR-SDK-03, Q9).",
+      "fixture": {
+        "golden": "carousel.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "fireClick": null
+          }
+        ],
+        "expect": {
+          "beacons": [],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F22",
+      "title": "fireClick with no key sends the default click of a standard",
+      "comment": "Every standard seeds its click with key `default`, which is what fireClick sends without a key (BR-SDK-06, Q12).",
+      "fixture": {
+        "golden": "card.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "fireClick": null
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "click": "default"
+            }
+          ],
+          "thirdPartyBeacons": [
+            "tpt_fixture_click_any",
+            "tpt_fixture_click_default"
+          ]
+        }
+      }
+    },
+    {
+      "id": "F23",
+      "title": "expand and close are sent verbatim as custom events and are not clicks",
+      "comment": "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).",
+      "fixture": {
+        "golden": "expandable_banner.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "custom": "expand"
+          },
+          {
+            "custom": "close"
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "custom": "expand"
+            },
+            {
+              "custom": "close"
+            }
+          ],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F24",
+      "title": "an asset tap is sent verbatim as a custom event and is not a click",
+      "comment": "BR-SDK-07.",
+      "fixture": {
+        "golden": "branded_assets.full",
+        "edits": [
+          {
+            "at": "tracking",
+            "add": "thirdPartyTrackers",
+            "value": [
+              {
+                "trackerId": "tpt_fixture_click_any",
+                "eventType": "click",
+                "matchType": "any",
+                "url": "https://adserver.example/click?c=any"
+              },
+              {
+                "trackerId": "tpt_fixture_click_default",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "default",
+                "url": "https://adserver.example/click?c=default"
+              },
+              {
+                "trackerId": "tpt_fixture_click_other",
+                "eventType": "click",
+                "matchType": "specific",
+                "eventKey": "save_offer",
+                "url": "https://adserver.example/click?c=other"
+              },
+              {
+                "trackerId": "tpt_fixture_impression",
+                "eventType": "impression",
+                "url": "https://adserver.example/imp"
+              }
+            ]
+          }
+        ]
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "custom": "asset_tap"
+          }
+        ],
+        "expect": {
+          "beacons": [
+            {
+              "custom": "asset_tap"
+            }
+          ],
+          "thirdPartyBeacons": []
+        }
+      }
+    },
+    {
+      "id": "F25",
+      "title": "a Standard Video without a destination sends no click",
+      "comment": "No destination means no click action and no click tracker (BR-SDK-08).",
+      "fixture": {
+        "golden": "standard_video.minimal"
+      },
+      "expect": {
+        "decodes": true
+      },
+      "slideTracking": {
+        "steps": [
+          {
+            "fireClick": null
+          }
+        ],
+        "expect": {
+          "beacons": [],
+          "thirdPartyBeacons": []
+        }
+      }
     }
   ]
 }