Cong Pulse

Setup Guide

Connect your accounts and set up attribution in a few minutes. Follow these four sections in order to get accurate ROAS in your dashboard.

Go to ConnectionsCreate an account
What You'll Need

For Meta

  • A Facebook account with admin access to your ad account
  • Your Meta Ad Account ID — found in Meta Ads Manager → top left dropdown → shows Act-XXXXXXXXX — copy the numbers only
  • Your app will be connected via secure OAuth — no need to share passwords or API keys

For Shopify

  • Your Shopify store URL (format: yourstore.myshopify.com)
  • Admin access to your Shopify store
  • Your store will be connected via secure OAuth — no API keys needed

Finding Your Meta Ad Account ID

  1. Go to business.facebook.com/adsmanager
  2. Look at the top left — you'll see your account name and Act-XXXXXXXXX
  3. The numbers after Act- are your Ad Account ID
  4. You'll need this when selecting your account after connecting Meta
Section 1Connect Meta Ads
  1. 1Click Connect Meta on the Connections page
  2. 2Log in with your Facebook account that has access to your ad account
  3. 3Select your ad account from the list
  4. 4Click Authorize— you're done!
We only request read access to your ad data. We never make changes to your campaigns.
Section 2Connect Shopify
  1. 1Click Connect Shopify on the Connections page
  2. 2Enter your Shopify store URL (e.g. yourstore.myshopify.com)
  3. 3Click Authorizein Shopify — you're done!
We sync your orders and revenue data every 6 hours automatically.

Using WooCommerce instead?

On the Connections page, under WooCommerce, enter your full store URL (e.g. https://yourstore.com, or a Multisite subpath like https://yourstore.com/kw) and click Connect. You'll approve read/write access on your own store (~30 seconds; needs WooCommerce admin access and HTTPS). We then sync every 6 hours and, where supported, in real time via webhooks. Full steps and troubleshooting live in docs/skills/woocommerce-onboarding.md.

Section 3Set Up UTM Parameters (Critical for Attribution)

What are UTMs?UTM parameters are small tags added to your ad's destination URL. In plain terms: UTM parameters tell us which ad drove each sale.

Why utm_content={{ad.id}} is critical: Without this, we can't match your Shopify orders to specific Meta ads — so attribution and ROAS can't be calculated.

Step-by-step:

  1. 1Go to Meta Ads Manager → select your campaign → click Edit on any ad
  2. 2Find the “Website URL” field
  3. 3Add the parameters below to the end of your URL
  4. 4If your URL already has a ?, use & instead of ? before utm_source
  5. 5Click Save and Publish

Copy-paste template

?utm_source=facebook&utm_medium=paid&utm_campaign={{campaign.name}}&utm_content={{ad.id}}
If UTMs are not set up, Attributed Revenue and ROAS will show as $0.
Once set up, attribution data appears after your next sync (within 6 hours).
Section 4What to Expect

After connecting: Your first sync runs automatically. Data appears within 10 minutes.

After UTM setup:Attribution data starts appearing for new orders immediately. Historical orders without UTMs won't be attributed.

Dashboard metrics explained

Total Spend
Your Meta ad spend.
Attributed Revenue
Shopify revenue from orders that came through your Meta ads.
ROAS
Attributed Revenue ÷ Total Spend.
CAC
Total Spend ÷ Total Customers.
C1 / C2 / C3
Funnel conversion rates (click → cart → checkout → purchase).

Ready to connect?

Head to your Connections page to link Meta Ads and Shopify.

Go to Connections