Skip to main content

Google Ads API (Conversion Tracking)

Jake MacDonald
  • Updated

How does it work?

The Google Ads API lets developers build applications that interact directly with the Google Ads server. With these applications, advertisers and third parties can more efficiently and creatively manage their large or complex Google Ads accounts and campaigns. When someone schedules an appointment with Zerorez®, the following information is sent to Google:
  • Email
  • Phone Number
  • Which services were booked and their amounts

The Google Ads API tracks conversions that are directly attributed to Google Ads clicks, such as when a user clicks on a Google ad and then completes a conversion on your website.


How to add a click conversion action for the Google Ads API integration

  1. Create a Google Ads account
  2. Sign in to Google Ads 
  3. Click the 'Create' button on the left navigation 
  4. Click 'Conversion action'
  5. Select 'Import'
  6. Select 'Manual import using API or uploads'
  7. Select 'Track conversions from clicks' 
  8. Click 'Continue' 
  9. Select 'Book Appointment' 
  10. Enter a conversion name (i.e. 'Appointments Scheduled, Appointments Canceled, Appointments Completed') 
  11. Select 'Use different values for each conversion'
  12. Enter a default value of '0" 
  13. Select 'Every' under 'Count' 
  14. Select your preferred time period under 'Click-through conversion window' (Recommended: 30 days)
  15. Under "Attribution model", select 'Use attribution in Google Ads' > 'Data-driven' 
  16. Click 'Create and continue'
  17. Turn on enhanced conversions for leads and use the Google tag method.
  18. Click 'Finish'
  19. In Google Ads go to Goals > Summary
  20. Find the newly created conversion action > Click 'Edit goal'
  21. Click Use "[Action Name]" as an account-default goal
  22. Click 'Save changes'

 

How to set up Google Ads Conversion Tracking

Prerequisites:

  • Access to your franchise’s Google Ads manager account OR you can contact someone who does have access to your franchise’s Google Ads manager account.
  • An @zerorez.com user must have Access to the Google Ads Manager account. 
  • Access to your franchise's Google Ads account
  • The developer token from your Google Ads manager account has been approved for the “Basic Access” access level
  • A Google Ads campaign (needs to be active)
  • A conversion action (needs to be enabled and needs to apply to your active campaign)
    • You can check if the conversion action applies to your active campaign by doing the following:
      1. Click Campaigns
      2. Click Campaigns again
      3. Add/change the filters to say 'Campaign status: Enabled'
      4. Find/click your active campaign in the table
        • If it automatically changes to the 'Ad groups' view, click Campaigns again to go back
      5. Click Settings
      6. Expand the Goals section
      7. Look for the "Book appointments (Website)" category and hover your mouse over it
      8. Make sure your conversion action is listed and has a green circle to the left of it
  • Review and accept the customer data terms under Goals > Conversions > Settings > "Customer data terms"
  • Turn on enhanced conversions for leads under Goals > Conversions > Settings > "Enhanced conversions for leads"
  • Enable auto-tagging under Admin > 'Account settings' > Auto-tagging > 'Tag the URL that people click through from my ad'

 

Steps:

  1. Gather your credentials to enter into Zr Ware® > Admin > Company > Conversion Tracking > Google Ads API tab.
    Note: The user that goes through the OAuth consent screen needs to have access to the Google Ads account, and it needs to be an account with a @zerorez.com address.
    Required Credentials: 
    • Developer Token:
      NOTE: YOUR DEVELOPER TOKEN SHOULD BE TREATED AS CONFIDENTIAL INFORMATION AND SHOULD NOT BE SHARED ON PUBLIC CHANNELS. AS MUCH AS POSSIBLE, PLEASE TRY TO LIMIT THE NUMBER OF PEOPLE WITH WHOM IT IS SHARED. You will need to have Zr Ware support create a new Google Console project for your developer token if one has not already been created for it.
      • If you have access to your franchise’s Google Ads manager account:
        • Log in to your Google Ads manager account > Click “Tools and Settings” on the right side of the navigation bar > Under “Setup”, click “API Center” > Find your Developer Token under “API Access” > Copy and save your Developer Token in Zr Ware®
      • If you do not have access to your franchise’s Google Ads manager account:
        • You will need to ask someone who does have access to enter your Developer Token into Zr Ware® for you, or privately share it with you so that you can enter it into Zr Ware® yourself.

        • The OAuth 2.0 flow must be completed using an email account ending in @zerorez.com, and this email account must have access to your Google Ads manager account.

    • Client ID: Please reach out to Zr Ware® support if this has not already been set in Zr Ware® for you. Instruction link for Zr Ware support only
    • Client Secret: Please reach out to Zr Ware® support if this has not already been set in Zr Ware® for you. Instruction link for Zr Ware support only
    • Login Customer ID: Log in to your Google Ads account > Look at the far right side of the navigation bar > Copy and save your Login Customer ID in Zr Ware®
    • Client Customer ID: Log into your Google Ads account > Look at the far left side of the navigation bar > Copy and save your Client Customer ID in Zr Ware®
    • Conversion Action ID: Log into your Google Ads account > Click “Goals” on the left navigation bar (alternatively, hover over “Goals” > expand “Conversions” > click “Summary”) > Click the name of your conversion action (if you can’t find it, try clicking “View all conversion actions” and going through all the pages of conversion actions) > In the URL, look for the URL parameter ctId. Copy the number between ctId= and the & symbol, and save it in Zr Ware.
      • Note: You can have multiple conversion action ID's but you have to have at least one.
  2. Go to Zr Ware® > Admin > Company > Conversion Tracking > Google Ads API tab, and make sure you've entered all the credentials. Test your Google Ads API connection by clicking the “Test Connection” button on the last step. If your connection was successful, you should see all green checkmarks. If any of the tests fail, try the suggested fixes (hover your mouse over the info icon next to the failed test(s)), then test the connection again.
    Please reach out to Zr Ware® support if you are still unable to get your Google Ads API connection working in Zr Ware® after trying the suggested fixes.

Markup

Comments

0 comments

Please sign in to leave a comment.