Skip to content

Document the Meta Ads performance marketing integration - #267

Open
DreamingInBinary wants to merge 20 commits into
mainfrom
jordan/sw-5719-mmp-docs
Open

Document the Meta Ads performance marketing integration#267
DreamingInBinary wants to merge 20 commits into
mainfrom
jordan/sw-5719-mmp-docs

Conversation

@DreamingInBinary

Copy link
Copy Markdown
Contributor

Summary

Superwall is now its own mobile measurement partner for Meta campaigns. This documents the full feature (SW-5719):

  • New page: Integrations > Meta Ads covering requirements (iOS SDK 4.16.0+, fresh installs, revenue tracking), Meta dataset setup, connecting Meta in the dashboard, event forwarding, ad link creation, the Sales campaign walkthrough, how install attribution works (acquisition_* attributes, attribution_match event), charts, and troubleshooting. Ten real screenshots.
  • Six new chart pages under Dashboard > Charts in a new Advertising group: Ad Spend, ROAS, CPM, CPT, CPP, Blended CPT, following the standard chart page pattern with real screencaps.
  • Cross-link note on the Meta Conversion API page distinguishing the two Meta integrations, plus the Advertising group added to the charts index.
  • Gradual-rollout framing throughout (contact support@superwall.com), since the feature is enabled per app.

Verification

  • Claim audit by a clean-context reviewer against paywall-next and Superwall-iOS: 11 findings, all fixed (7-day window wording, dashboard checkbox labels, save-before-test-events, attribution_match reasons, outdated ROAS rationale, sandbox and eventTrackingBehavior troubleshooting, charts index, link normalization).
  • All behavior claims cite shipped code; every relied-on commit is an ancestor of the current production release.
  • bun run build:cf passes; bun test 64/64 pass; all links, nav entries, and images resolve; images are JPEG at 2000px or less.

🤖 Generated with Claude Code

DreamingInBinary and others added 20 commits August 13, 2026 14:57
New Meta Ads page covering the MMP integration: requirements, dataset setup,
dashboard connection, events, ad links, campaign creation, attribution
reference, charts, and troubleshooting. Placeholder SVGs carry the final
screenshot filenames. Adds a Performance Marketing nav group and a cross-link
from the Meta Conversion API page. Draft content is highlighted in yellow for
review.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Replaces the campaign-objective, ad-set-conversion, and website-URL
placeholders with Jordan's real Ads Manager captures, converted to JPEG and
resized to 2000px. Their placeholder SVGs are removed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…event

Per Yusuf: transaction start signals purchase intent, so it's the event to
optimize the Meta Sales campaign for.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The MDX pipeline drops SVG images, so SVG placeholders never render. JPEG
placeholders show up on the page; filenames are unchanged so the real
screenshots still replace them in place.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Events Manager has no Connect data sources button; datasets are created from
Datasets > Create.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Create in the Datasets view acts on the selected dataset; new datasets come
from the Connect data flow.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ken generation

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…w events step

Swaps in real captures for the Performance Marketing card, dataset/token
setup, and events card. Review events is a button inside the confirm-custom-
events warning on the dataset Overview tab, appearing only after new sw_
events arrive; the step now describes that flow and timing.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ager

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ot table presence

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…e set

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Ad Spend, ROAS, CPM, CPT, CPP, and Blended CPT get the standard chart page
treatment with real screenshots, an Advertising nav group, and links from the
Meta Ads page. Metric behavior (weekly default intervals, breakdown
requirements, no breakdown on Blended CPT) matches the chart definitions.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…nd URL parameters

Matches the App Stack section 4 level of precision: Placements > Show more
settings for the mobile/iOS restriction, and the Tracking section for the URL
parameters to leave empty.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Fixes the 7-day window wording (install, not click), adds dashboard checkbox
labels to the events table, requires saving before test events, documents
Save vs Update, adds ambiguous to attribution_match reasons, reframes the
acquisition breakdowns as always present, adds sandbox and
eventTrackingBehavior troubleshooting, updates the outdated ROAS rationale,
lists the Advertising group on the charts index, and normalizes legacy /docs
link prefixes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@linear-code

linear-code Bot commented Aug 14, 2026

Copy link
Copy Markdown

SW-5719

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
superwall-docs b069371 Commit Preview URL

Branch Preview URL
Aug 14 2026, 09:35 PM

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