Google Ads Integration

This is the most involved setup of all the integrations because Google Ads requires a Manager Account for API access. Plan for about 15-20 minutes.

Prerequisites

  • A Google Ads account running app campaigns
  • Access to Google Cloud Console
  • Owner access to your Apps Finboard project

Step 1: Create a Manager Account and get a Developer Token

The API Center (where you get a developer token) is only available in Google Ads Manager Accounts (MCC), not in regular advertiser accounts. If you don’t already have one, you’ll need to create a manager account and link your existing Google Ads account to it.

Create a Manager Account

  1. Go to Google Ads Manager Accounts
  2. Click Create a manager account
  3. Sign in with your Google account (you can use the same Google account that owns your regular Google Ads account)
  4. Enter a name for your manager account and select your use case
  5. Click Submit
  1. In your new manager account, go to Admin > Sub-account settings
  2. Click the + button and select Link existing account
  3. Enter the Customer ID of your regular Google Ads account (the one running your app campaigns)
  4. Click Send request
  5. Sign in to your regular Google Ads account, go to Settings > Manager account access, and accept the link request

Get the Developer Token

  1. In your Manager Account, go to Tools & Settings > Setup > API Center
  2. If you don’t have a developer token yet, apply for one
  3. Copy your Developer Token

Note: Explorer Access level is automatically granted and is sufficient for Apps Finboard to read cost data. You do not need to apply for higher access.

Step 2: Enable the Google Ads API

  1. Go to the Google Cloud Console
  2. Select or create a project
  3. Go to APIs & Services > Library
  4. Search for Google Ads API and enable it

Step 3: Create OAuth credentials

  1. In Google Cloud Console, go to APIs & Services > Credentials
  2. Click Create Credentials > OAuth client ID
  3. If prompted, configure the OAuth consent screen:
    • Choose External user type
    • Fill in the required app information
    • Add your Google Ads account email as a test user
    • Important: Click Publish App so that the refresh token doesn’t expire after 7 days
  4. Select Web application as the application type
  5. Add https://developers.google.com/oauthplayground as an Authorized redirect URI
  6. Click Create
  7. Note the Client ID and Client Secret

Tip: If you already created OAuth credentials for AdMob, you can reuse the same Client ID and Client Secret here. You just need a different refresh token with a different scope.

Step 4: Get a refresh token

  1. Go to Google OAuth Playground
  2. Click the gear icon (⚙️) in the top right
  3. Check Use your own OAuth credentials
  4. Enter your Client ID and Client Secret from Step 3
  5. In the input field at the bottom of the left panel, manually type the scope: https://www.googleapis.com/auth/adwords
  6. Click Authorize APIs
  7. Sign in with the Google account that manages your Google Ads account
  8. Click Exchange authorization code for tokens
  9. Copy the Refresh Token

Step 5: Find your Customer ID

  1. Sign in to Google Ads
  2. Your Customer ID is displayed in the top-right corner - it looks like 123-456-7890

Step 6: Find your Login Customer ID

The Login Customer ID is the ID of your Manager Account (created in Step 1):

  1. Sign in to your Manager Account
  2. The Login Customer ID is displayed in the top-right corner

Step 7: Add to Apps Finboard

  1. In your Apps Finboard dashboard, go to your project’s Data Sources page
  2. Click Add Data Source and select Google Ads
  3. Fill in the required fields:
    • GOOGLE_ADS_CLIENT_ID - The OAuth Client ID from Step 3
    • GOOGLE_ADS_CLIENT_SECRET - The OAuth Client Secret from Step 3
    • GOOGLE_ADS_REFRESH_TOKEN - The Refresh Token from Step 4
    • GOOGLE_ADS_DEVELOPER_TOKEN - The Developer Token from Step 1
    • GOOGLE_ADS_CUSTOMER_ID - Your Customer ID from Step 5
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID - The Login Customer ID from Step 6
  4. Click Save

The first sync will start automatically and pull in your available cost history.

What gets synced

Campaign cost data from Google Ads, filtered to app campaigns only:

  • Daily spend per app across all your app campaigns
  • Both Android and iOS app campaign costs

Data availability

  • Ad revenue data has approximately a 1-hour delay

Data accuracy

  • 99.4% match with bank payout
  • Recent data may fluctuate due to invalid traffic and tax adjustments from Google Ads