Skip to content

docs(pixel): Game Page integration guide, CSP docs, and CDN validation#2847

Merged
bkbooth merged 10 commits into
mainfrom
claude/bold-euler
Apr 14, 2026
Merged

docs(pixel): Game Page integration guide, CSP docs, and CDN validation#2847
bkbooth merged 10 commits into
mainfrom
claude/bold-euler

Conversation

@bkbooth

@bkbooth bkbooth commented Apr 10, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a comprehensive README.md for the @imtbl/pixel package covering quick-start snippet, consent modes, auto-tracked events, cookie reference, CSP directives (with nonce-based example), browser support matrix, and the Game Page-specific integration snippet with consent: 'anonymous'
  • Includes a post-installation validation checklist and browser compatibility test matrix matching SDK-54's Definition of Done
  • Adds a scripts/validate-cdn.sh script that verifies the live CDN bundle (HTTP 200, correct content-type, gzip size under 10KB budget, expected content markers)

Related tickets

  • SDK-54 — Pixel: Game Page integration and end-to-end validation

Test plan

  • validate-cdn.sh passes against live https://cdn.immutable.com/pixel/v1/imtbl.js (5.3KB gzipped, all markers present)
  • README snippet can be pasted into a blank HTML page and fires events successfully
  • CSP directives confirmed against production API domain (api.immutable.com)

🤖 Generated with Claude Code

@bkbooth bkbooth requested a review from a team as a code owner April 10, 2026 06:00
@nx-cloud

nx-cloud Bot commented Apr 10, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit 202ae84

Command Status Duration Result
nx affected -t build,lint,test ✅ Succeeded 7s View ↗
nx run-many -p @imtbl/sdk,@imtbl/checkout-widge... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-04-14 02:26:42 UTC

@github-actions

github-actions Bot commented Apr 10, 2026

Copy link
Copy Markdown

✅ Pixel Bundle Size — @imtbl/pixel

Metric Size Delta vs main
Gzipped 5412 bytes (5.28 KB) 0 bytes
Raw (minified) 14741 bytes 0 bytes

Budget: 10.00 KB gzipped (warn at 8.00 KB)

Provide a complete README for the tracking pixel covering the Game Page
snippet, consent modes, auto-tracked events, cookie reference, CSP
directives, and a browser compatibility validation checklist. Also adds
a shell script to verify the CDN bundle is deployed and within the 10KB
gzip budget.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@bkbooth bkbooth force-pushed the claude/bold-euler branch from e38a12c to ceeded5 Compare April 10, 2026 06:04
bkbooth and others added 2 commits April 10, 2026 16:04
The identify() method is being removed from the pixel (PR #2846).
Update the README to remove the Identity section and adjust the
full consent description to reflect that identity signals come
only from form submission auto-capture.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…EADME

Keep the README generic for all integrators. Game Page-specific details
and the validation checklist are tracked separately.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comment thread packages/audience/pixel/README.md Outdated
Comment thread packages/audience/pixel/README.md
bkbooth and others added 6 commits April 13, 2026 14:08
- Add link to Immutable Hub for obtaining the publishable key (nattb8)
- Document consentMode: 'auto' with GCM v2 and IAB TCF v2 detection,
  fallback behavior when no CMP is found, and manual override (nattb8)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add value prop (campaign measurement, player attribution)
- Use diff blocks for init-line changes instead of ambiguous fragments
- Clarify consent vs consentMode are mutually exclusive
- Improve full consent description (identity matching context)
- Remove trailing blank line

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Make it explicit that there is no callback when CMP detection times
out, and show a setTimeout-based fallback pattern.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@bkbooth bkbooth enabled auto-merge April 14, 2026 02:04
@bkbooth bkbooth added this pull request to the merge queue Apr 14, 2026
Merged via the queue into main with commit e39cfed Apr 14, 2026
8 checks passed
@bkbooth bkbooth deleted the claude/bold-euler branch April 14, 2026 02:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants