Platform Setup Guide – RevHapi Documentation

Overview

RevHapi connects to your advertising platforms and Shopify store via their official APIs to fetch revenue, order, and performance data automatically — synced every hour, no manual exports needed.

Each platform uses a one-time OAuth connection or credential setup. Once connected, RevHapi handles token refresh and data fetching in the background.

💡

Start with Shopify

If you run an ecommerce store, connect Shopify first. It's the ground-truth order data that powers True ROAS, P&L reports, Customer LTV, and Product Analytics across all your ad platforms.

Shopify

OAuth · ~5 min

Meta Ads

App + token · ~20 min

Google Ads

OAuth · ~3 min

AdSense

OAuth · ~2 min

Ad Manager

Service account · ~15 min

TikTok Ads

OAuth · ~3 min

⚡

Quick Start

Before connecting any platform, make sure you have the following in place.

✅ Requirements

✓ A RevHapi account — app.revhapi.com
✓ Admin access to each account you want to connect
✓ For Shopify: store owner or staff with app install permissions
✓ For Google platforms: a Google account with Google Cloud Console access
✓ For Meta: a Facebook Business account with ad account access
✓ For TikTok: a TikTok for Business account with ad account access

💡

Use the same Google account across all Google platforms

For Ad Manager, AdSense, and Google Ads — sign in with the same Google account to simplify OAuth and avoid permission conflicts.

Shopify

~5 min · OAuth

Connecting Shopify gives RevHapi access to your real order data — the foundation for True ROAS, P&L reports, Customer LTV, and Product Analytics. RevHapi reads data only and never writes to your store.

🛒

What RevHapi reads from Shopify

Orders, revenue, refunds, customer data, UTM attribution, and product information — read-only. No changes are ever made to your store or products.

📋 What you'll need

✓ A Shopify store
✓ Store owner access or staff with app install permissions
✓ UTM-tagged ad links for full attribution (use the RevHapi UTM Builder)

Open Integrations in RevHapi

Log in to app.revhapi.com and go to Settings → Integrations → Shopify.

Enter your store URL

Type your Shopify domain — e.g. yourstore.myshopify.com — and click Connect Shopify Store. You'll be redirected to Shopify's OAuth page.

Authorise RevHapi in Shopify

Review the permissions and click Install app. You'll be redirected back to RevHapi automatically.

RevHapi requests read-only access to orders, customers, and products
No write permissions are requested

Wait for the initial sync

RevHapi pulls your last 90 days of orders on first sync. This may take a few minutes depending on order volume.

Connect your ad platforms

With Shopify synced, connect Meta Ads, Google Ads, or TikTok Ads. RevHapi will immediately start showing platform-reported ROAS vs your Shopify-verified ROAS.

⚠️

UTM tagging is required for attribution

For RevHapi to match Shopify orders to campaigns, your ad links must use UTM parameters. Use the UTM Builder in RevHapi (under Marketing Attribution) to tag all links correctly before running campaigns.

Meta Ads

~20 min · Access token

Meta Ads requires creating a Facebook App with Marketing API access. This gives RevHapi a long-lived access token to read your ad spend and performance data.

⚠️

Personal ad accounts

If your ad account is personal (not in a Business portfolio), create a Business portfolio first and move your ad account into it at business.facebook.com.

📋 What you'll need

✓ A Facebook account with admin access to your ad account(s)
✓ A Facebook Business portfolio containing your ad accounts
✓ Access to Meta for Developers

Create a Facebook App

Go to Meta for Developers:

Click Create App → Other → Business
Name it "RevHapi Integration" and select your Business portfolio
Click Create App

Add the Marketing API product

In your app dashboard, scroll to Add products to your app
Find Marketing API and click Set up

Link your Business portfolio

Go to App Settings → Business
Click Add Business Portfolio and select the one containing your ad accounts

Add a Privacy Policy URL

Required before token generation:

Go to App Settings → Basic
Add https://revhapi.com/privacy.html as your Privacy Policy URL
Click Save Changes

Generate your Access Token

Go to Marketing API → Tools
Select permissions: ads_read, ads_management, read_insights
Click Generate Token and copy the result

⚠️

Tokens expire in ~60 days

RevHapi will notify you when renewal is needed. For a non-expiring token, create a System User token in Business Settings.

Find your Ad Account ID

Go to Ads Manager — the ID is in the URL (e.g. act_123456789)
Or: Business Settings → Ad Accounts
Copy the numeric ID without the act_ prefix

Connect in RevHapi

Go to Settings → Integrations → Meta Ads
Paste your Access Token and enter your Ad Account ID
Give the account a display name and click Connect

Repeat for each ad account you want to track.

✅

Connected

RevHapi will now fetch Meta Ads spend data hourly. Remember to renew your token before it expires.

Google Ads

~3 min · OAuth

Google Ads connects via OAuth — one-click sign-in. RevHapi reads your spend, impressions, clicks, and conversion data and cross-references it with your Shopify orders for true ROAS.

📋 What you'll need

✓ A Google account with access to your Google Ads account(s)
✓ At least one active Google Ads account
✓ Manager (MCC) account access if tracking multiple clients

Go to Google Ads in RevHapi

Navigate to Settings → Integrations → Google Ads and click Connect Google Ads.

Sign in with Google

Sign in with the account that has access to your Google Ads accounts and click Allow. RevHapi requests read-only access only.

Select accounts to track

RevHapi will list all Google Ads accounts accessible to your Google account. Select the ones you want and click Save.

Initial sync

RevHapi pulls the last 30 days of spend and conversion data. If Shopify is connected, the Attribution tab will immediately show platform vs Shopify-verified ROAS.

💡

Using a Manager (MCC) account?

Sign in with your MCC credentials and RevHapi will list all child accounts. You can select individual client accounts to track separately.

✅

Connected

Google Ads spend and conversion data will sync to RevHapi every hour.

Google AdSense

~2 min · OAuth

AdSense is the easiest platform to connect — just sign in with Google. RevHapi fetches your earnings, RPM, impressions, and URL-level performance data automatically each hour.

📋 What you'll need

✓ A Google account with an active, approved AdSense account
✓ Your AdSense account must be serving ads

Go to AdSense in RevHapi

Navigate to Settings → Integrations → Google AdSense and click Connect AdSense.

Sign in with Google

Sign in with the Google account that owns your AdSense account. Review the read-only permissions and click Allow.

Select your AdSense account

If you have multiple AdSense accounts, select the one to connect. RevHapi will automatically detect your Publisher ID.

Data starts flowing

RevHapi immediately begins fetching earnings data. You'll see RPM, impressions, clicks, and URL-level earnings in the dashboard within a few minutes.

💡

Using both AdSense and Ad Manager?

You can connect both. RevHapi shows a combined publisher revenue view across AdSense content ads and Ad Manager direct deals side by side.

✅

That's it

Earnings, RPM, and URL-level performance will appear in your RevHapi dashboard within minutes.

Google Ad Manager

~15 min · Service account

Ad Manager requires a service account — a one-time setup that gives RevHapi secure automated access to your publisher revenue data without requiring manual sign-in each time.

📋 What you'll need

✓ A Google account with Admin access to your Ad Manager network
✓ Your Ad Manager Network Code (Admin → Network settings)
✓ Access to Google Cloud Console

Create a Google Cloud Project

Go to console.cloud.google.com:

Click Select a project → New Project
Name it "RevHapi Integration" and click Create

Enable the Ad Manager API

Go to APIs & Services → Library
Search "Google Ad Manager API" and click Enable

Create a Service Account

Go to APIs & Services → Credentials → Create Credentials → Service Account
Name it "RevHapi API Access" and click Create and Continue
Skip optional role steps and click Done

Download the JSON key file

Click your new service account → Keys tab
Click Add Key → Create new key → JSON → Create
A JSON file downloads automatically — keep it safe

⚠️

Keep your JSON key secure

Treat this like a password. Never share it publicly. RevHapi encrypts it immediately on upload.

Add the service account to Ad Manager

Go to admanager.google.com
Navigate to Admin → Global settings → Network settings and ensure API access is Enabled
Go to Admin → Users → Service account users → New service account user
Paste the service account email from your JSON file (e.g. name@project-id.iam.gserviceaccount.com)
Set role to Viewer and click Save

Connect in RevHapi

Go to Settings → Integrations → Ad Manager
Enter your Network Code
Open the JSON key file in a text editor, copy the entire contents, and paste into the JSON Key field
Click Connect

✅

Connected

RevHapi will now fetch your Ad Manager revenue data. Initial data may take a few minutes to appear.

TikTok Ads

~3 min · OAuth

TikTok Ads connects via OAuth — the same simple one-click flow as Google and AdSense. Once connected, RevHapi tracks TikTok spend and cross-references it against Shopify orders to show your real ROAS.

💡

Why TikTok attribution matters

TikTok's self-reported ROAS is often significantly inflated due to view-through attribution. Connecting Shopify + TikTok lets RevHapi show you the real gap between what TikTok claims and what your store actually confirmed.

📋 What you'll need

✓ A TikTok for Business account
✓ Admin or Operator access to your TikTok Ads account
✓ At least one active ad account under your Business Center

Go to TikTok Ads in RevHapi

Navigate to Settings → Integrations → TikTok Ads and click Connect TikTok Ads.

Authorise via TikTok OAuth

You'll be redirected to TikTok's authorisation page. Log in with your TikTok for Business account and click Confirm. RevHapi requests read-only access only.

Select your ad accounts

RevHapi will list all ad accounts in your Business Center. Select the ones to track and click Save.

Initial sync

RevHapi pulls your last 30 days of TikTok spend. If Shopify is connected, the Attribution tab immediately shows platform vs Shopify-verified ROAS for TikTok campaigns.

⚠️

UTM parameters are required for order attribution

Tag all TikTok ad destination URLs with UTM parameters using the RevHapi UTM Builder. Without UTMs, orders cannot be matched to TikTok campaigns.

✅

Connected

TikTok Ads spend syncs hourly alongside Meta, Google, and your Shopify order data.

🔧

Troubleshooting

Common issues and how to fix them, organised by platform.

Shopify

The initial sync can take a few minutes depending on your order volume. Wait 5 minutes and refresh the dashboard. If orders still don't appear, try disconnecting and reconnecting your store. Make sure you have at least one order in the last 90 days.

Shopify only captures UTMs when they're present in the URL on the customer's first visit. Ensure your ad links include all UTM parameters and you're not using link shorteners that strip them. Use the RevHapi UTM Builder to create correctly formatted URLs.

Make sure you're logged into Shopify as the store owner or a staff account with the "Manage apps" permission enabled. Ask the store owner to grant this in Staff settings if needed.

Meta Ads

Meta access tokens expire after ~60 days. Go to your Meta App → Marketing API → Tools, generate a new token with the same permissions (ads_read, ads_management, read_insights), and update it in RevHapi under Settings → Integrations → Meta Ads.

The ad account must be in the Business portfolio linked to your Meta app. Go to Business Settings → Ad Accounts to verify. Also check the token was generated with the correct permissions.

A Privacy Policy URL must be set in App Settings → Basic before Meta allows token generation. Use https://revhapi.com/privacy.html if you don't have one.

Google Ads

Sign out of all Google accounts in your browser, then reconnect using the Google account that actually has access to the Google Ads accounts you want to track.

The signed-in Google account may not have access to any active Google Ads accounts. Verify at ads.google.com. For MCC accounts, sign in with the manager account credentials.

Google AdSense

Your browser may be blocking popups from app.revhapi.com. Allow popups for this domain in your browser settings and try again.

AdSense data can have a 24–48 hour processing delay. Missing data for the last 1–2 days is normal and will backfill automatically on the next hourly sync.

Google Ad Manager

Enable the Google Ad Manager API in your Cloud project: APIs & Services → Library → search "Google Ad Manager API" → Enable.

The service account hasn't been added to Ad Manager. Go to Admin → Users → Service account users in Ad Manager and add the service account email with at least Viewer permissions.

Open the downloaded .json file in a plain text editor (not Word), select all, copy, and paste the entire contents — including the opening and closing curly braces — into RevHapi.

TikTok Ads

The TikTok for Business account you authorised may not have any ad accounts under it. Log in at ads.tiktok.com to verify. If accounts are under a different Business Center, reconnect using those credentials.

TikTok Ads data has a ~3 hour processing delay via API. Data for today may be incomplete — yesterday's data should be fully accurate.

❓

Frequently Asked Questions

Yes. All stored credentials are encrypted with AES-256. RevHapi requests read-only permissions on every platform — we can view your revenue and spend data but cannot modify campaigns, budgets, or settings. We never store ad creative or customer PII beyond what's needed for attribution.

RevHapi syncs all connected platforms automatically every hour. You can also trigger a manual refresh from the dashboard at any time using "Fetch All".

Yes — you can connect multiple Meta Ads accounts (each with its own token and account ID), multiple Google Ads accounts, and multiple AdSense accounts. For Shopify, the number of stores depends on your plan: 1 store on Starter and Pro, 3 stores on Business.

Read-only access on every platform. Shopify: orders, products, customer data (read). Meta: ads_read, ads_management, read_insights. Google platforms: read-only OAuth scopes. TikTok: read-only ad account access. RevHapi never requests write permissions.

True ROAS is Shopify-confirmed revenue divided by actual ad spend. It differs from platform-reported ROAS because platforms like Meta and TikTok often claim credit for the same conversion. RevHapi uses UTM data on Shopify orders to attribute revenue to specific campaigns — giving you a number platforms can't inflate.

Go to Settings → Integrations, find the platform, and click Disconnect. Your historical data is retained and no new data will be fetched. You can also revoke access from the platform side (Google Account permissions, Meta App settings, etc.).

Email us at contact@revhapi.com or use the Support link inside the app. We respond within 1 business day. Pro and Business plan users receive priority responses.