From 8bf4295c71aaef97b5962078e4e969824c4fe0e0 Mon Sep 17 00:00:00 2001 From: sonpiaz Date: Mon, 16 Nov 2026 14:29:55 -0800 Subject: [PATCH] docs: send the buyer's email on every lead, the fallback that keeps a sale with the right partner Co-Authored-By: Claude Opus 5.5 --- content/docs/api-reference/track-lead.mdx | 4 ++-- public/docs/skill.md | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/content/docs/api-reference/track-lead.mdx b/content/docs/api-reference/track-lead.mdx index e61ca4b..d75b3d4 100644 --- a/content/docs/api-reference/track-lead.mdx +++ b/content/docs/api-reference/track-lead.mdx @@ -2,7 +2,7 @@ title: Track Lead description: Record a signup or lead event that links a customer to an affiliate click. kind: reference -last_updated: 2026-11-07 +last_updated: 2026-11-16 --- `POST /api/v1/track/lead` @@ -55,7 +55,7 @@ A browser lead settles directly only on a program set to `browser_allowed`. A br Your internal customer or user ID. Send it with the `click_id`: when the lead settles, Affitor saves it on that customer, so later sales can find the customer by your own id. On its own it finds no customer on a first lead, because the key is saved only when a lead settles. - Customer email address. Used for hashed/masked attribution support. + The buyer's email address. Send it on every lead. When the lead settles, Affitor saves a one-way hash of it and a masked form (`j***@example.com`) on the customer, only if the customer has none yet; the lead never stores the address itself. It is the fallback that keeps a sale with the right partner: a Stripe Checkout payment that carries no click id (the buyer paid on another device or cleared their cookies) is matched to this customer by its checkout email, so it can still go to the partner who referred them. A provisional browser lead does not save it. Optional metadata. Supports `test_mode` (boolean), `program_id` (number), and `event_name` (string). diff --git a/public/docs/skill.md b/public/docs/skill.md index 54745ae..11f20ca 100644 --- a/public/docs/skill.md +++ b/public/docs/skill.md @@ -51,6 +51,8 @@ Attribution only works if **one stable internal user ID** is identical across ev If signup uses `user.id` but checkout uses `user.email`, sales will not attribute. **Same id, every time.** +**Also send the buyer's email on every lead** (`signup(customerKey, email)` 2nd arg, `trackLead({ email })`, `email` on the wire). Affitor keeps only a one-way hash and a masked form (`j***@example.com`). It is the fallback that keeps a sale with the right partner: a Stripe Checkout payment without a click id (other device, cleared cookies) is matched to the customer by its checkout email. + --- ## 3. Install the SDK