Close popover

Table of Contents

Creating a Google Ads account and credentials

As part of the process of connecting Paid Media Manager to a Google Ads destination, you must have a manager account in Google Ads and use the credentials for that account to configure a destination in Paid Media Manager. To complete the process, do the following steps:

  1. Create a Google Manager Account in Google Ads.
  2. Optional: Create a test manager account in Google Ads.
  3. Create the OAuth credentials in Google Ads.

Creating a Google Manager Account to call the Google Ads APIs for production accounts

If you do not already have a Google Manager Account, create it, and then apply for access to the AdWords API.

  1. Sign in to Google with a Google account that is not already linked to a Google Ads account.
  2. Go to Google Ads Manager Accounts
  3. Click Create a Manager Account and fill out the registration form.
  4. In Google Ads, click Tools & Settings > Setup > API Center.
    Google Ads API Center access
    "Google Ads API Center access"
    Google Ads API Center access
  5. In the API Center, fill out the access form.
    In the Company type section, select Advertiser.
  6. Click Create Token.
    Make a note of the token. You will need it to configure the connection between Paid Media Manager and Google Ads later. For more information, see Configuring Google Ads destinations in Paid Media Manager.
  7. Go to the Google Ads overview and click Accounts.
  8. Click + to create a new account or link an existing account.
    Google Ads Accounts
    "Google Ads Accounts"
    Google Ads Accounts
    You can use either a Google Ads account or an AdWords Express account, depending on your requirements. For more information, see Compare Smart campaigns with other Google Ads campaign types.
  9. Create the OAuth credentials. For more information, see Creating the OAuth credentials in Google Ads.

Before you can use the Google Ads Manager Account in production, your API token must first be approved by Google. To start testing immediately without waiting for the token to be approved, create a test manager account.

Creating a test manager account

Create a test manager account to test new API implementations or account configurations before implementing the changes in your production environment. Test accounts do not require an approved developer token, so you can start working with the API immediately.

Test accounts cannot be used in production, since they do not actually serve ads to customers.
  1. Sign in to Google with a Google account that is not already linked to a Google Ads account.
  2. Go to Create a Google Ads Test Account.
  3. Fill out the registration form and click Save and continue.
  4. Create the OAuth credentials for use with the test account. For more information, see Creating the OAuth credentials in Google Ads.

Creating the OAuth credentials

Create the OAuth credentials to obtain the client ID and client secret required to configure the connection to a Google Ads destination in Paid Media Manager. You can create these credentials for both the production and test manager accounts.

  1. Log in to Pega Marketing or Pega Customer Decision Hub.
    Make sure that the link you use to log in includes the prweb root domain and the Pega Marketing or Pega Customer Decision Hub instance domain, that is, https://host.domain:port/prweb. If you log in using a link without either the root domain or the Pega Marketing or Pega Customer Decision Hub instance domain, the redirect URL for OAuth will not be valid and authentication will not succeed.
  2. Log in to the Google API Interface console.
  3. Create a new project by clicking Create.
  4. Select the project which you created.
    Sample project
    "Sample project"
    Sample project
  5. Click OAuth consent screen and fill out the required information. Details of some of the critical fields are provided below.
    • Under User type, select External.
    • On the first screen, under Authorized domains, enter the root domain of your Pega Marketing or Pega Customer Decision Hub instance.
    • On the second screen, click Add users and add an email ID that will be used for the OAuth process. This is required while the app has the Testing status. You can move the app to Production status when you start to use it for production systems.
      Domain verification is an optional step for Paid Media Manager integration.
  6. Click Save.
  7. Click Credentials > Create credentials > OAuth client ID.
  8. Under Application type, select Web application.
  9. Under Authorized redirect URLs, click Add and enter the redirect URL for your instance, that is, https://host.domain:port/prweb/PRRestService/oauth2/v1/redirect.
  10. Click Create. Note the client ID and client secret that are displayed.

To continue setting up the Paid Media Manager connection to the Google Ads destination, see Configuring Google Ads destinations in Paid Media Manager.

Enabling the required API permissions

Your Google Ads account must able to access the following APIs:

  • CrmBasedUserList - Mandatory. Paid Media Manager uses this API to manage the audiences in the Google Ads network.
  • OfflineDataUploadService - Optional. This API is required if you want to use Paid Media Manager to upload data about historical offline conversions into Google Ads.

Contact your Google Ads account representative for information about enabling the APIs for your account.

Suggest Edit

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.