Skip to content

Commit e29bed2

Browse files
dannyshmueliclaude
andcommitted
Docs: add URL param variant forcing to skill
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 9e52bf2 commit e29bed2

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

skill/SKILL.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,18 @@ npx @agent-analytics/cli experiments complete exp_abc123 --winner new_cta
150150
npx @agent-analytics/cli experiments delete exp_abc123
151151
```
152152

153+
### Forcing variants via URL param
154+
155+
Force a specific variant with `?aa_variant_<experiment_name>=<variant_key>`. Useful for ad landing pages that should always show the matching headline, QA testing, or sharing a specific variant.
156+
157+
```
158+
https://yoursite.com/pricing/?aa_variant_signup_cta=new_cta&utm_campaign=new-cta-ad
159+
```
160+
161+
- The variant must exist in the experiment config — invalid values fall through to normal hash assignment
162+
- Works with both declarative and programmatic experiments
163+
- Exposure events include `forced: true` so you can filter them in analytics
164+
153165
### Best practices
154166
- Name experiments with snake_case: `signup_cta`, `pricing_layout`, `hero_copy`
155167
- Use 2 variants (A/B) unless you have high traffic — more variants need more data

0 commit comments

Comments
 (0)