Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt

Use this file to discover all available pages before exploring further.

  • Verify the ncPurchase event in Meta Events Manager.
  • Create the NC Purchase custom conversion and optimize it for Purchase.
  • Share the custom conversion with every Meta ad account that needs it.
  • In Meta Ads Manager, customize columns to add NC Purchase metrics.
  • Create the NC-ROAS custom metric: NC Purchase Conversion Value ÷ Amount spent.

​
Prerequisites

Before you start, you need:
  • The Meta destination configured in Upstack Data — see How to configure the Meta Pixel destination
  • At least one real new-customer purchase already processed so the ncPurchase event appears in Meta Events Manager
  • Admin access to the Meta Business Manager that owns the pixel and to every ad account you’ll share the conversion with

​
What you’ll achieve

After completing all three parts below, Meta Ads Manager will display new-customer metrics — NC-ROAS (New Customer Return on Ad Spend), Cost per NC Purchase, and Total NC Purchases — directly in your campaigns, ad sets, and ads tables.

​
Setup process overview

Set up new-customer purchase tracking in three parts. Complete them in order — later steps depend on earlier ones.

​
Part 1 — Verify the ncPurchase event

Before you can create any custom conversions, the ncPurchase event must be verified in Meta Events Manager. Guide to complete this step: How to verify the NC Purchase event in Meta Events Manager →

​
Part 2 — Create and share the custom conversion

Once ncPurchase is verified, create the NC Purchase custom conversion and share it with your ad accounts. Guide to complete this step: How to create and share the NC Purchase custom conversion →

​
Part 3 — Add metrics to Meta Ads Manager

Configure your Ads Manager columns to display the NC Purchase metrics and create the NC-ROAS custom metric. Guide to complete this step: How to add NC Purchase metrics and NC-ROAS to Meta Ads Manager →

​
Verify the setup is complete

Once you’ve finished all three parts, confirm:
  • In Meta Events Manager, the ncPurchase event has no red triangle warning and is listed as Active.
  • In Custom Conversions, NC Purchase is shared with the ad accounts you selected.
  • In your Meta Ads Manager column layout, NC Purchase (Total), NC Purchase (Cost), and NC-ROAS are all visible.
Done 🎉Initially, the new columns may show 0 or — because Meta does not retroactively attribute custom conversions from before they were created. Data starts populating for new-customer purchases that occur after the conversion was created and shared. Allow 24–48 hours of new traffic before judging the values.