Google Ads Report

For more general information on data collection in Redbird, check out: Getting Started With Data Collection

This guide explains how to set up access and collect data from the Google Ads platform. Advertisers can serve their ads on properties like YouTube and Google Search using Google Ads, and the API provides a programmatic way to pull data.

If you cannot see the Google Ads collection app in the left-side panel on the workflow canvas, refer to: Enabling Collection Apps Guide

Creating a Collection

1. Double-click on the node to enter configuration mode

2. Click the pencil icon next to Configuration Name to name your collection

3. Select the website credentials that you need to pull data from under the Credentials drop-down.\
   
   
   \
   
   

   1. If needed, you can add, edit, or delete logins during this step by selecting the gear icon. To add a new login, click Add New Login

      
      
      

      \
      
      

   2. Name your credentials for easy reference

   3. Click Login with Google and proceed through the Google OAuth steps.

   4. Once you've finished, you'll be redirected back to Redbird. Select your newly created credentials in the Credentials dropdown to access that account

4. Choose the customer that you want to pull data from. Customer refers to the Google Ads profile that you're using - the 10-digit number will appear next to your Google account profile icon in the Google Ads UI.

   1. The customers shown are the ones that have been directly shared to the Google Account used to log in. In some cases, a Google Ads Manager Account may appear in this Available box - selecting a Manager Account will run the report for all customers within that account.

5. (Optional) Select your report type. If you're unsure of what to use or want to select it later, the default is "All Resources". You will have opportunities later to choose your report type.

6. Under Metrics, Segments, and Dimensions, the available options for the selected view will populate in the Available box. Select the options you need and click the top arrow to move it to the Selected box.\
   
   

   

   🚧

   Important:

   Certain Metrics, Segments, and Dimensions are incompatible with one another. As you are making your selections, fields will become un-selectable in the Available boxes. If you select 2 or more incompatible fields at once, you will be prompted to select 1 at a time.

7. Validate your report by clicking on the Validate and Choose Resource button at the top of the configuration screen. This should always be your final step to ensure that your report does not have any errors. If the resulting prompt does not say "Validation Successful!", you will need to remove incompatible fields and validate again.

8. (Optional) Once you've validated your report, you have the option to choose a report type in a dropdown below the validation button. While this is not necessary, it is best practice to choose a report type for reliable and accurate data.

   🚧

   Important:

   The available resources in this dropdown are based on what you've selected under Metrics, Segments, and Dimensions. If you validate your report and make edits before choosing the resource, you may end up with an incompatible report. Only choose a report in this dropdown if you have just clicked the validation button.

9. Date Period allows you to select between a Manual date range or an Automated date range.\
   
   

   
   
   
   1. Manual: At run time, users will be prompted to provide a start and end date for the collection to run.
   2. Automated: Users can define a dynamic date range to include in their configuration by selecting a timeperiod (days, weeks, or months) and initiating the configuration. Since the user selects a time period instead of a specific start and end date, the dates used to run the configuration will change based on the timing of each run
   3. Lookback Window: Users can define a lookback window that refreshes the data for a specified time frame. If set to append, the existing data for that time frame is deleted and recollected. If set to replace, all historical data is deleted and replaced by the data in the specified range.

10. Initial Data Load allows you to upload historical data in bulk as a one-off in the event that you have the data saved on your computer. You can upload your data as a CSV file with no leading/trailing rows or columns and Redbird will run future data collections using the configuration that you set up in previous steps.

11. Click Done

Running a Collection

1. Click on the node.
2. In the right-side panel click Run
3. If date selection is set to manual, then the workflow will be stopped for you to input dates. Click Review on the node.
4. Select the Start date and End date of the period you would like to cover.
5. Click Back to Workflow
6. Click Continue on the node.