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.
  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 Google Ads Test Accounts.
  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.
    Make sure that the link you use to log in includes the prweb root domain and the Pega Marketing instance domain, that is, http://host.domain:port/prweb. If you log in using a link without either the root domain or the Pega Marketing 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.
    Under Authorized domains, enter the root domain of your Pega Marketing instance.
  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, http://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.