Skip to content

docs: brand settings follow today's ship (Program ID, two payment cards, link parameter, attribution window) - #147

Merged
sonpiaz merged 1 commit into
mainfrom
docs/brand-settings-1016
Oct 17, 2026
Merged

sonpiaz merged 1 commit into
mainfrom
docs/brand-settings-1016

Conversation

@sonpiaz

@sonpiaz sonpiaz commented Oct 16, 2026

Copy link
Copy Markdown
Member

What

Brand-side docs follow what shipped to prod on 2026-10-16 (dashboard on main, verified in the prod JS chunks: "Program ID", "Attribution window").

  • brand/settings.mdx: Business shows Program ID (read-only, Copy); Tracking has the Partner link parameter; Payments is two cards; Refer a brand includes Invite via email and the referred brands.
  • brand/quickstart/setup-program.mdx:
    • Business table gains Program ID.
    • Tracking: Connect sheet ends with a prompt; npm provider file is app/affitor-provider.tsx; tracker states and the Continue rule follow today's step; new Partner link parameter paragraph.
    • Payments: two cards (Stripe, Server API) with their states, no method to choose, owner-only Stripe text, the both-connected warning; old screenshot removed (it showed the method choice; a new shot is follow-up media).
    • Go live: "either card" instead of "the method you chose"; PageMeta prerequisite says connecting Stripe needs the owner.
  • Program ID location (Settings → Program settings → Business): glossary, 8 integration pages, tracking quickstart.
  • Attribution window: errors.mdx names the setting attribution_window_days (shown as Attribution window); inviting-partners says attribution window.
  • ?via= next to ?aff=: attribution (cookie section + scenario table), click-tracking, tracking-overview, glossary, public/docs/skill.md.

Sources (affiliate-dashboard origin/main 0b3d39dd, affiliate-cms origin/main 0f7bbaa0)

  • Program ID: dash#711 src/components/AffiliateManagement/Advertiser/Setup/BusinessStep.tsx:234-252 (label, help "Used by the tracking script, the API and AI agents.", Copy, read-only).
  • Payments: dash#680 Setup/PaymentsStep.tsx:51-80 (two cards, done when either), :223-224 heading + "Connect Stripe, your server, or both.", :233 pills, :248 Connect/Finish in Stripe, :255 "Only the program owner can connect Stripe.", :266 Received/No sale yet, :274,277 Send a test sale/Check again, :306 both warning, :325 pipeline check text; Skip for now in setup only.
  • Tracking: dash#691 Setup/TrackingStep.tsx:143 tracked = first click or gate, :153-165 states, :231-234 Check now hidden after first click, :259-267 Continue/Skip; Mcp/ConnectSheet.tsx:67-74,170 prompt; src/lib/trackerSnippets.ts:49-60 app/affitor-provider.tsx.
  • Partner link parameter: dash#674 Setup/LinkParamField.tsx:92-111; CMS src/utils/partner-link.ts:14-28 (LINK_PARAM_VIA_SINCE = 2026-10-16T00:00:00Z, older programs locked to aff); tracker public/js/affitor-tracker.js:126-133 (aff, else via). The npm SDK 2.1.3 loads the same hosted tracker (dist/index.js references affitor-tracker.js).
  • Attribution window: dash#712; CMS src/api/affiliate-commission/services/attribution-window.ts:21,36-40 (attribution_window_days, default 60); click response cookie_window_days carries the effective value (affiliate-tracking/controllers/v1-tracking.ts:597-611).

Not in this PR (reported to p470)

  • CLI --cookie-duration writes only cookie_window_days, which tracking never reads (CMS src/api/cli/services/cli.ts:78): docs brand/cli/* still say default 90. Product decision first.
  • Team roles (Owner/Admin/Member/Viewer) not documented yet.

No terms or money wording changes. Media: setup-payments.png no longer referenced; new shot to be briefed.

🤖 Generated with Claude Code

…ds, partner link parameter, attribution window

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
affitor-docs Ready Ready Preview Oct 16, 2026 11:57pm UTC

Request Review

@sonpiaz
sonpiaz merged commit 130c98f into main Oct 17, 2026
3 checks passed

This branch was successfully deployed

1 active deployment
Preview — 15766ad4 Deployed Oct 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant