Outcomes
At the end of onboarding, the team should have:- A production workspace scoped to one app.
- Revenue and attribution sources connected.
- Core product and funnel events mapped or planned.
- Identity joins validated across subscription, attribution, and product systems.
- A first payback report reviewed against source-of-truth numbers.
- Guardrails configured before write access or automation.
- A clear owner for ongoing recommendation review.
Roles
| Role | Responsibilities |
|---|---|
| Growth owner | Defines acquisition goals, target payback, markets, campaign scope, and approval process |
| Data owner | Validates source mappings, identity joins, metric definitions, and warehouse alignment |
| Product owner | Confirms onboarding, paywall, offer, and lifecycle events |
| Finance owner | Confirms revenue source, refund treatment, and reporting tolerance |
| Admin owner | Manages workspace access, API keys, and integration permissions |
Pre-kickoff checklist
- Production app name, platform, bundle ID or package name, and store URLs.
- App Store Connect, Google Play, Stripe, or warehouse revenue access.
- AppsFlyer or Adjust access, if attributed CAC is required.
- Ad platform access, if recommendations will include campaign or budget actions.
- Identifier strategy across anonymous users, app users, subscription customers, and MMP customer IDs.
- Target payback window, such as 30, 60, or 90 days.
- Initial markets, channels, campaigns, and excluded campaigns.
Onboarding process
Create the production workspace
Create one workspace for the production app. Keep staging, sandbox, QA, and demo data in separate workspaces so payback reports are not polluted by test users or fake transactions.
Confirm app identity
Add the app name, platform, store URL, bundle ID or package name, primary markets, and default currency. These values help scope integrations, reports, and recommendations to the right product.
Connect revenue
Connect App Store Connect, Google Play, Stripe, or a warehouse source first. Revenue is the anchor for payback, ROAS, cohort LTV, renewals, refunds, and churn.
Connect attribution
Connect AppsFlyer or Adjust so FloKit can read install source, campaign, ad set, creative, country, and cost context.
Map product and funnel events
Confirm the minimum event set for onboarding and paywall analysis. Start with paywall views, trial starts, subscription starts, cancellations, and important onboarding milestones.
Validate identity joins
Review anonymous IDs, app user IDs, subscription customer IDs, and MMP customer user IDs. Resolve join gaps before relying on campaign-level CAC or payback.
Review the first payback report
Compare CAC, revenue, trial-to-paid conversion, renewal rate, and cohort sizes against your MMP, subscription source, warehouse, or finance reporting.
Set guardrails
Configure budget caps, excluded campaigns, approval thresholds, action types, rollback triggers, and owners before enabling write access.
Data quality acceptance criteria
| Area | Acceptance criteria |
|---|---|
| Revenue | Historical sync completed and totals match source of truth within the agreed tolerance |
| Attribution | Campaign, ad set, creative, country, and cost fields are populated for paid cohorts |
| Identity | Join rate is high enough for campaign-level decisions and unattributed users are understood |
| Events | Required lifecycle events are arriving with stable names and timestamps |
| Reports | Payback report can be explained by growth and data owners without unresolved metric gaps |
| Guardrails | Spend caps, exclusions, approvals, and rollback triggers are configured |
Common onboarding blockers
| Blocker | How to resolve it |
|---|---|
| No payback report appears | Confirm revenue sync completion and enough subscription history |
| CAC does not match source of truth | Check attribution cost windows, currency, campaign naming, and imported spend |
| Too many unattributed users | Review ID mapping between subscription customer IDs and MMP customer user IDs |
| Product funnel is incomplete | Add missing paywall, trial, subscription, and onboarding events |
| Recommendations are too broad | Tighten markets, campaigns, excluded campaigns, and action types |
| Stakeholders disagree on numbers | Document source-of-truth rules before using recommendations |
Launch readiness
Do not move beyond read-only recommendations until:- The first payback report has been reviewed by growth and data owners.
- Known data gaps are documented.
- Guardrails have an accountable owner.
- Finance or leadership understands the reporting tolerance.
- Write access is intentionally configured, if needed.