## Summary - **Conversion emails go live.** Andrew approved the copy, the 25% offer, the timings and the 612 Joan St postal address. Adds `CONVERSION_EMAILS_ENABLED=true,REVIEW_LAST_CHANCE_ENABLED=true,CONVERSION_OFFER_PERCENT=25` to the backend `--set-env-vars` in ci.yml (feature shipped dark in #1156). - **Doubled signature fix.** The "About your Nomad Karaoke free credits" (credit-denied) email appended `_get_email_signature()` itself and also got it from the shared footer, so it showed twice. I audited all 22 `send_*` emails by rendering each one; this was the only duplicate. - New regression test: renders every `EmailService.send_*` and asserts the signature appears exactly once. It fails on main with `send_credit_denied_email: 2`. ## Testing - `make test` green (backend 2054 + 6071 + 150, frontend 1692). - Local CodeRabbit review: no findings. @coderabbitai ignore 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_019KuzHAU4rxkv8JfD8NmHTN --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
3.5 KiB
Free-to-paid conversion emails
Added 2026-10 for BACKLOG Frog #2 ("plug the gen revenue leaks"). Funnel context: 44% of signups finish a free video, but only 6% ever pay, and buyers decide fast (median about 5h after signup). Also, 45 users opened lyrics review and let the job expire at 48h.
| When | Stream | Gate | |
|---|---|---|---|
E1 "Your karaoke video is done. What's next?" + CONVERSION_OFFER_PERCENT% off any credit pack for CONVERSION_OFFER_HOURS |
CONVERSION_E1_DELAY_HOURS (2h) after a never-paid consumer's first video completes |
Postmark broadcast |
CONVERSION_EMAILS_ENABLED |
| E2 "Your N% off ends in N hours" | inside the last CONVERSION_E2_HOURS_BEFORE_EXPIRY (8h) of the offer, only if still unpaid |
Postmark broadcast |
CONVERSION_EMAILS_ENABLED |
| R2 "N hours left to finish your karaoke video" | 42h into lyrics review (expiry is 48h; the existing reminder fires at 24h) | outbound (transactional) |
REVIEW_LAST_CHANCE_ENABLED |
All of these are off by default in code. Andrew approved the copy, 25%, the timings and the postal address on 2026-10-15, and they are switched on in production via the Cloud Run env in .github/workflows/ci.yml (v0.273.3).
How it works
backend/services/conversion_emails.py:on_job_completedruns fromJobManagerright aftertotal_jobs_completedis incremented. It setsconversion_e1_due_atplusfirst_video_artist/first_video_titleon eligible users. Excluded: tenant, Made For You and test accounts, anyone who has paid, and anyone who isn't on their first completion.process_conversion_emailsruns hourly at the end of the/api/internal/process-stale-reviewsCloud Scheduler job. It sends E1 and E2 and is idempotent per user (conversion_e1_sent_at,conversion_e2_sent_at). A due time older than 24h is skipped (conversion_e1_skipped=true), so turning the flag on later never mails a backlog.
- Sending E1 grants
promo_discount_percent/promo_discount_expires_at.POST /api/users/credits/checkoutapplies Stripe couponconversion-offer-{pct}pctwhen it beats any active referral discount. The buy dialog shows a "Your N% off is applied at checkout" banner (promo_discount_*onUserPublic). The E1/E2 button links to/app?buy=1, which opens the buy dialog. - Broadcast stream: Postmark-managed unsubscribe (
UnsubscribeHandlingType: Postmark) appends the unsubscribe link and suppresses opted-out recipients; a suppressed send fails with 406 and isn't retried. The CAN-SPAM postal address comes fromCOMMERCIAL_EMAIL_POSTAL_ADDRESS, which defaults to the address published on nomadkaraoke.com. - Copy lives in
backend/translations/*.jsonunderemails.conversion.*andemails.reviewLastChance.*(33 locales).
Measuring (30 days, per D4 of the 2026-10-14 business review)
- Sends: Firestore
email_logwithemail_type=conversion_offer,conversion_offer_reminder,review_last_chance. - Clicks and signups: links carry
utm_source=email&utm_medium=email&utm_campaign=conv_e1|conv_e2|review_last_chance. - Purchases: Stripe coupon
conversion-offer-{pct}pctredemptions. Users withconversion_e1_sent_atandtotal_spent > 0. - Reviews rescued: jobs with
state_data.last_chance_reminder_sentthat then completed.
Turning it on
Add CONVERSION_EMAILS_ENABLED=true,REVIEW_LAST_CHANCE_ENABLED=true (and optionally CONVERSION_OFFER_PERCENT=NN) to the backend --set-env-vars list in .github/workflows/ci.yml (the "Deploy to Cloud Run" step) and ship it as a PR. The next deploy applies it. Roll back the same way.