Platform Setup Guide – RevHapi Documentation

🎯

Overview

RevHapi connects to your advertising platforms via their official APIs to fetch revenue and performance data. Each platform requires different credentials and setup steps. This guide walks you through the process for each platform.

📊

Google Ad Manager

Service account + JSON key

📘

Meta Ads

App + Access token

Google AdSense

OAuth sign-in

🔵

Google Ads

OAuth sign-in

⚡

Quick Start

Before connecting any platform, make sure you have:

✅ Requirements

✓ A RevHapi account (sign up at app.revhapi.com)
✓ Admin access to your advertising accounts
✓ For Google platforms: A Google account with access to Google Cloud Console
✓ For Meta: A Facebook Business account with ad account access

💡

Tip: Use the same Google account

For Google platforms (Ad Manager, AdSense, Google Ads), use the same Google account that has access to your advertising accounts. This simplifies the setup process.

📊

Google Ad Manager

~15 min

Google Ad Manager requires a service account with API access. This is a one-time setup that allows RevHapi to fetch your revenue data securely.

📋 What you'll need

✓ Google account with Ad Manager access
✓ Admin rights to your Ad Manager network
✓ Your Ad Manager Network Code (found in Admin → Network settings)

Setup Steps

Create a Google Cloud Project

Go to Google Cloud Console and sign in with the Google account that has access to your Ad Manager.

Click Select a project → New Project
Name it something like "RevHapi Integration"
Click Create

Enable the Ad Manager API

With your new project selected:

Go to APIs & Services → Library
Search for "Google Ad Manager API"
Click on it and press Enable

Create a Service Account

Service accounts allow secure, automated API access without requiring manual login.

Go to APIs & Services → Credentials
Click Create Credentials → Service Account
Name it "RevHapi API Access" (or similar)
Click Create and Continue
Skip the optional role and access steps, click Done

Download the JSON Key

This key file is what you'll paste into RevHapi.

Click on your newly created service account
Go to the Keys tab
Click Add Key → Create new key
Select JSON and click Create
A JSON file will download – keep this safe!

⚠️

Security Notice

Never share your JSON key file publicly. Treat it like a password. RevHapi encrypts and stores it securely.

Add Service Account to Ad Manager

Now authorize this service account in your Ad Manager network:

Go to Google Ad Manager
Navigate to Admin → Global settings → Network settings
Scroll down to API access
Make sure API access is enabled
Go to Admin → Users → Service account users
Click New service account user
Paste the service account email from your JSON key (looks like name@project.iam.gserviceaccount.com)
Set role to Viewer or higher
Click Save

Connect in RevHapi

Final step – add your credentials to RevHapi:

Go to RevHapi → Ad Manager
Enter your Network Code (found in Admin → Network settings)
Open your downloaded JSON file in a text editor
Copy the entire contents and paste into the JSON Key field
Click Connect

✅

You're connected!

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

📘

Meta Ads (Facebook/Instagram)

~20 min

Meta Ads requires creating a Facebook App with Marketing API access. This gives you a long-lived access token to fetch ad spend data.

📋 What you'll need

✓ Facebook account with admin access to your ad accounts
✓ A Facebook Business account (required for Marketing API)
✓ Your ad accounts must be linked to a Business portfolio

⚠️

Personal Ad Accounts

If you have a personal ad account (not linked to a Business), you'll need to create a Business portfolio first and move your ad account into it. Go to business.facebook.com to set this up.

Setup Steps

Create a Facebook App

Go to Meta for Developers:

Click Create App
Select Other as the use case
Select Business as the app type
Name your app (e.g., "RevHapi Integration")
Select your Business portfolio
Click Create App

Add the Marketing API

Once your app is created:

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

Add Your Business to the App

Link your Business portfolio containing your ad accounts:

Go to App Settings → Business
Click Add Business Portfolio
Select the Business that contains your ad accounts
Grant the required permissions

Add Privacy Policy & Terms URLs

Required before you can generate tokens:

Go to App Settings → Basic
Add a Privacy Policy URL (can be your company's privacy policy)
Add a Terms of Service URL (optional but recommended)
Click Save Changes

💡

Don't have these pages?

You can use any valid URL for now, such as a Google Doc or your company website's privacy page.

Generate Your Access Token

Now create the token that RevHapi will use:

Go to Marketing API → Tools tab
Under Get Access Token, select these permissions:
- ✅ ads_read – Read ad account data
- ✅ ads_management – Required for some metrics
- ✅ read_insights – Access performance data
Click Generate Token
Copy the generated access token

⚠️

Token Expiration

This token expires in ~60 days. RevHapi will notify you when it needs renewal. For a never-expiring token, you can extend it to a System User token (advanced).

Find Your Ad Account ID

You'll need your ad account ID(s):

Option 1: Go to Ads Manager – the ID is in the URL (e.g., act_123456789)
Option 2: Go to Business Settings → Ad Accounts
Copy the numeric ID (without the "act_" prefix)

Connect in RevHapi

Add your credentials to RevHapi:

Go to RevHapi → Meta Ads
Paste your Access Token
Enter your Ad Account ID
Give the account a name for easy identification
Click Connect

Repeat for each ad account you want to track.

✅

You're connected!

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

Google AdSense

~2 min

AdSense uses OAuth sign-in – the easiest setup! Just click connect and authorize with your Google account.

📋 What you'll need

✓ A Google account with an active AdSense account
✓ Your AdSense account must be approved and receiving traffic

Setup Steps

Go to RevHapi AdSense Settings

Navigate to RevHapi → AdSense and click the Connect AdSense button.

Sign In with Google

You'll be redirected to Google. Sign in with the Google account that owns your AdSense account.

Review the permissions requested
Click Allow to grant RevHapi read-only access

Select Your AdSense Account

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

✅

That's it!

AdSense is now connected. RevHapi will fetch your earnings data automatically.

🔵

Google Ads

~2 min

Google Ads also uses OAuth sign-in for quick and secure connection.

📋 What you'll need

✓ A Google account with Google Ads access
✓ At least one active Google Ads account

Setup Steps

Go to RevHapi Google Ads Settings

Navigate to RevHapi → Google Ads and click the Connect Google Ads button.

Sign In with Google

Sign in with the Google account that has access to your Google Ads accounts.

Review the permissions requested
Click Allow to grant RevHapi read-only access

Select Accounts to Track

RevHapi will show all Google Ads accounts you have access to. Select which ones you want to track.

✅

Connected!

Your Google Ads spend data will now be synced to RevHapi.

🔧

Troubleshooting

Running into issues? Here are solutions to common problems:

Google Ad Manager

Make sure you've enabled the Google Ad Manager API in Google Cloud Console. Go to APIs & Services → Library, search for "Google Ad Manager API", and click Enable.

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

Make sure you're copying the entire JSON file contents, including the curly braces. Open the downloaded .json file in a text editor, select all (Ctrl+A), copy, and paste.

Meta Ads

Meta access tokens expire after ~60 days. Go back to your Meta App → Marketing API → Tools, generate a new token with the same permissions, and update it in RevHapi.

Make sure the ad account is linked to the Business portfolio that's connected to your app. Go to Business Settings → Ad Accounts to verify.

You need a Privacy Policy URL set in your app. Go to App Settings → Basic and add a Privacy Policy URL (any valid URL works).

AdSense / Google Ads

Check if your browser is blocking popups. Allow popups from app.revhapi.com in your browser settings.

Make sure you're signing in with the Google account that actually has AdSense/Google Ads access. Try signing out of all Google accounts first, then connect again.

❓

Frequently Asked Questions

Yes. RevHapi uses industry-standard encryption for all stored credentials (AES-256). API tokens are encrypted at rest and we only request read-only permissions where possible. We never store your actual advertising content – only aggregated performance metrics.

RevHapi automatically syncs data every hour for all connected platforms. You can also manually refresh at any time from the Dashboard.

Yes! You can connect multiple ad accounts from the same or different platforms. This is great for agencies managing multiple clients or businesses with separate ad accounts.

RevHapi only requests read-only access to your advertising data. We can view your revenue, spend, and performance metrics, but we cannot modify your campaigns, budgets, or settings.

Go to the platform's settings page in RevHapi and click "Disconnect". Your historical data will be retained, but no new data will be fetched. You can also revoke access from the platform's side (e.g., in Google Account permissions).

Contact our support team at support@revhapi.com or use the Support page in the app. We typically respond within 24 hours.