From eb49ce492659a8ff938c2bcc764d649122da1826 Mon Sep 17 00:00:00 2001 From: Brian O'Kelley Date: Thu, 30 Apr 2026 08:54:02 -0400 Subject: [PATCH] =?UTF-8?q?docs(creative-channels):=20fix=20url=5Ftype=20t?= =?UTF-8?q?racker=20=E2=86=92=20tracker=5Fpixel=20(#2986)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The display, audio, carousels, and DOOH channel docs use "url_type": "tracker", which is not a valid value in the url-asset-type.json enum (clickthrough / tracker_pixel / tracker_script). Sellers following these docs emit a non-conformant url_type that buyers can't interpret without guessing. Replaces all 10 occurrences with "tracker_pixel" to match the schema. This is step 1 of the rollout proposed by Nastassia Fulconis on adcp#2986: 3.0.x docs cleanup → 3.1 SHOULD + role-based fallback + mechanism-vs-purpose clarification → 4.0 required. The dist/docs/3.0.2 release snapshot still carries the old value; backporting to the snapshot is intentionally out of scope here so the fix lands on the live source first. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../fix-url-type-tracker-pixel-channel-docs.md | 5 +++++ docs/creative/channels/audio.mdx | 4 ++-- docs/creative/channels/carousels.mdx | 2 +- docs/creative/channels/display.mdx | 2 +- docs/creative/channels/dooh.mdx | 12 ++++++------ 5 files changed, 15 insertions(+), 10 deletions(-) create mode 100644 .changeset/fix-url-type-tracker-pixel-channel-docs.md diff --git a/.changeset/fix-url-type-tracker-pixel-channel-docs.md b/.changeset/fix-url-type-tracker-pixel-channel-docs.md new file mode 100644 index 0000000000..04925e2af0 --- /dev/null +++ b/.changeset/fix-url-type-tracker-pixel-channel-docs.md @@ -0,0 +1,5 @@ +--- +"adcontextprotocol": patch +--- + +docs(creative-channels): replace invalid `"url_type": "tracker"` with `"url_type": "tracker_pixel"` in display, audio, carousels, and DOOH channel docs to match the `url-asset-type.json` enum (`clickthrough` / `tracker_pixel` / `tracker_script`). Addresses adcp#2986 step 1 (3.0.x docs cleanup). Wire format unchanged — the published schema enum already excluded `"tracker"`, so the channel docs were emitting an invalid value sellers could not validate against. diff --git a/docs/creative/channels/audio.mdx b/docs/creative/channels/audio.mdx index 4bb3f34eda..99cb9a0c9c 100644 --- a/docs/creative/channels/audio.mdx +++ b/docs/creative/channels/audio.mdx @@ -176,7 +176,7 @@ Multi-segment audio assembled dynamically: }, "impression_tracker": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://track.brand.com/imp?buy={MEDIA_BUY_ID}&station={APP_BUNDLE}&cb={CACHEBUSTER}" }, "landing_url": { @@ -199,7 +199,7 @@ Multi-segment audio assembled dynamically: "assets": { "vast_url": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://ad-server.brand.com/audio-vast?campaign={MEDIA_BUY_ID}&cb={CACHEBUSTER}" } } diff --git a/docs/creative/channels/carousels.mdx b/docs/creative/channels/carousels.mdx index aa7a297098..aa897b0466 100644 --- a/docs/creative/channels/carousels.mdx +++ b/docs/creative/channels/carousels.mdx @@ -670,7 +670,7 @@ https://track.brand.com/view?buy={MEDIA_BUY_ID}&item={CAROUSEL_INDEX}&total={CAR }, "impression_tracker": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://track.brand.com/imp?buy={MEDIA_BUY_ID}&cb={CACHEBUSTER}" } } diff --git a/docs/creative/channels/display.mdx b/docs/creative/channels/display.mdx index 72629ed715..1058da6c6f 100644 --- a/docs/creative/channels/display.mdx +++ b/docs/creative/channels/display.mdx @@ -213,7 +213,7 @@ Display formats in AdCP include: }, "impression_tracker": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://track.brand.com/imp?buy={MEDIA_BUY_ID}&cb={CACHEBUSTER}" } } diff --git a/docs/creative/channels/dooh.mdx b/docs/creative/channels/dooh.mdx index be5b9c15f7..129a221a44 100644 --- a/docs/creative/channels/dooh.mdx +++ b/docs/creative/channels/dooh.mdx @@ -43,7 +43,7 @@ DOOH formats differ from other digital formats: { "asset_id": "impression_tracker", "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "required": true } ] @@ -75,7 +75,7 @@ DOOH formats differ from other digital formats: { "asset_id": "impression_tracker", "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "required": true } ] @@ -109,7 +109,7 @@ DOOH formats differ from other digital formats: { "asset_id": "impression_tracker", "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "required": true } ] @@ -124,7 +124,7 @@ DOOH formats use impression trackers (often called "proof-of-play") to verify wh { "asset_id": "impression_tracker", "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "required": true, "requirements": { "required_macros": [ @@ -158,7 +158,7 @@ The mechanics are identical to digital impression tracking - it's just a URL tha }, "impression_tracker": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://track.brand.com/pop?buy={MEDIA_BUY_ID}&screen={SCREEN_ID}&venue={VENUE_TYPE}&ts={PLAY_TIMESTAMP}&lat={VENUE_LAT}&long={VENUE_LONG}" } } @@ -184,7 +184,7 @@ The mechanics are identical to digital impression tracking - it's just a URL tha }, "impression_tracker": { "asset_type": "url", - "url_type": "tracker", + "url_type": "tracker_pixel", "url": "https://track.brand.com/pop?buy={MEDIA_BUY_ID}&screen={SCREEN_ID}&ts={PLAY_TIMESTAMP}" } }