Skip to Content

Google Ads Connection Details

Introduction

Connector Version

This documentation is based on version 21.0.8662 of the connector.

Get Started

Google Ads Version Support

The connector provides a relational view of Google Ads data for your Google account or Google Apps domain. The connector includes tables containing often-used dimensions and metrics; additionally, you can customize the table schemas or write your own to combine any valid set of dimensions and metrics. The connector surfaces the columns available through the v201809 version of the AdWords API.

Establish a Connection

Connect to Google Ads

Provide the following connection properties before adding the authentication properties.

  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.

  • ClientCustomerId: Set this to your Google Ads customer ID. You can find your ClientCustomerId at the bottom of the help menu after clicking the help icon in the top right corner of the Google Ads UI.

Note

This connection property is required only when using the 'AdWords' *Schema*.

Retrieve Data from Multiple Accounts

A common use for the driver is retrieving data from multiple customer ids. This is useful when you have a Google Ads MCC account that includes numerous accounts/ClientCustomerIds. You can query and get data from the accounts you want by specifying CustomerId in the WHERE clause, for example:

SELECT * FROM AdGroupAd WHERE CustomerId='3333333333'
SELECT * FROM AdGroupAd WHERE CustomerId IN ('1111111111', '2222222222')

The driver ignores the ClientCustomerId connection property when you specify the CustomerId in WHERE clauses.

Authenticate to Google Ads

All connections to Google Ads are authenticated using OAuth. The connector supports using user accounts, service accounts and GCP instance accounts for authentication.

Authenticate with a User Account

AuthScheme must be set to OAuth in all of the user account flows.

For desktop applications, the connector's default application is the simplest way to authenticate. The only additional requirement is to set InitiateOAuth to GETANDREFRESH.

When the driver starts, it will open a browser and Google Ads will request your login information. The connector will use the credentials you provide to access your Google Ads data. These credentials will be saved and automatically refreshed as needed.

See Using OAuth Authentication for a authentication guide covering all the supported methods in detail.

Authenticate with a Service Account

To authenticate using a service account, you must create a new service account and have a copy of the accounts certificate.

For a JSON file, you will need to set these properties:

  • AuthScheme: Required. Set this to OAuthJWT.
  • InitiateOAuth: Required. Set this to GETANDREFRESH.
  • OAuthJWTCertType: Required. Set this to GOOGLEJSON.
  • OAuthJWTCert: Required. Set this to the path to the .json file provided by Google.
  • OAuthJWTSubject: Required. The service account should be part of a GSuite domain, with delegation enabled. The value of this property should be the email address of the user whose data you want to access.

For a PFX file, you will need to set these properties instead:

  • AuthScheme: Required. Set this to OAuthJWT.
  • InitiateOAuth: Required. Set this to GETANDREFRESH.
  • OAuthJWTCertType: Required. Set this to PFXFILE.
  • OAuthJWTCert: Required. Set this to the path to the .pfx file provided by Google.
  • OAuthJWTCertPassword: Optional. Set this to the .pfx file password. In most cases this will need to be provided since Google encrypts PFX certificates.
  • OAuthJWTCertSubject: Optional. Set this only if you are using a OAuthJWTCertType which stores multiple certificates. Should not be set for PFX certificates generated by Google.
  • OAuthJWTIssuer: Required. Set this to the email address of the service account. This address will usually include the domain iam.gserviceaccount.com.
  • OAuthJWTSubject: Required. The service account should be part of a GSuite domain, with delegation enabled. The value of this property should be the email address of the user whose data you want to access.

If you do not already have a service account, you can create one by following the procedure in Creating a Custom OAuth App.

Authenticate with a GCP Instance Account

When running on a GCP virtual machine, the connector can authenticate using a service account tied to the virtual machine. To use this mode, set AuthScheme to GCPInstanceAccount.

Use OAuth Authentication

Use the OAuth authentication standard to connect to Google Ads. You can authenticate with a user account or a service account. The connector facilitates this as described below.

Use a User Account to Authenticate to Google Ads

The user account flow requires the authenticating user to interact with Google Ads via the browser.

Custom Credentials

When to Create a Custom OAuth App

You might want to create a custom OAuth app to change the information displayed when users log into the Google Ads OAuth endpoint to grant permissions to the connector.

Use a Service Account to Connect to Google Ads

Service accounts have silent authentication, without user authentication in the browser. You can also use a service account to delegate enterprise-wide access scopes to the connector.

You need to create an OAuth application in this flow. You can then connect to Google Ads data that the service account has permission to access. See Custom Credentials for an authentication guide.

Create a Custom OAuth App

See Creating a Custom OAuth App for a procedure.

Custom Credentials

You can use a custom OAuth app to authenticate with a service account or a user account. See Using OAuth Authentication for more information.

Authenticate with a User Account
Desktop Authentication with a Custom OAuth App

Follow the steps below to authenticate with the credentials for a custom OAuth app. See Creating a Custom OAuth App.

Get and Refresh the OAuth Access Token

After setting the following, you are ready to connect:

  • OAuthClientId: Set this to the client ID assigned when you registered your app.
  • OAuthClientSecret: Set this to the client secret assigned when you registered your app.
  • InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

When you connect the connector opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The connector then completes the OAuth process:

  1. Extracts the access token from the callback URL and authenticates requests.
  2. Refreshes the access token when it expires.
  3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.
Authenticate with a Service Account

Service accounts have silent authentication, without user authentication in the browser. You can also use a service account to delegate enterprise-wide access scopes to the connector.

You need to create an OAuth application in this flow. See Creating a Custom OAuth App to create and authorize an app. You can then connect to Google Ads data that the service account has permission to access.

After setting the following connection properties, you are ready to connect:

  • InitiateOAuth: Set this to GETANDREFRESH.
  • OAuthJWTCertType: Set this to "PFXFILE".
  • OAuthJWTCert: Set this to the path to the .p12 file you generated.
  • OAuthJWTCertPassword: Set this to the password of the .pem file.
  • OAuthJWTCertSubject: Set this to "*" to pick the first certificate in the certificate store.
  • OAuthJWTIssuer: In the service accounts section, click Manage Service Accounts and set this field to the email address displayed in the service account ID field.
  • OAuthJWTSubject: Set this to the email address of the user for whom the application is requesting delegate access. Note that delegate access must be granted by an administrator.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

When you connect the connector completes the OAuth flow for a service account.

  1. Creates and signs the JWT with the claim set required by the connector.
  2. Exchanges the JWT for the access token.
  3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.
  4. Submits the JWT for a new access token when the token expires.

Headless Machines

Use OAuth on a Headless Machine

The following sections show how to authenticate a headless server or another machine on which the connector cannot open a browser. You can authenticate with a user account or with a service account.

Authenticate with a User Account

To authenticate with a user account, you need to authenticate from another machine. Authentication is a two-step process.

  1. Instead of installing the connector on another machine, you can follow the steps below to obtain the OAuthVerifier value. Or, you can install the connector on another machine and transfer the OAuth authentication values, after you authenticate through the usual browser-based flow.
  2. You can then configure the connector to automatically refresh the access token from the headless machine.

You can follow the headless OAuth authentication flow using the OAuth credentials for your custom OAuth app.

Use the Credentials for a Custom OAuth App

Create a Custom OAuth App

See Creating a Custom OAuth App for a procedure. You can then follow the procedures below to authenticate and connect to data.

Obtain a Verifier Code

Set the following properties on the headless machine:

  • InitiateOAuth: Set this to OFF.
  • OAuthClientId: Set this to the Client ID in your app settings.
  • OAuthClientSecret: Set this to the Client Secret in your app settings.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

You can then follow the steps below to authenticate from another machine and obtain the OAuthVerifier connection property.

  1. Call the GetOAuthAuthorizationURL stored procedure with the CallbackURL input parameter set to the exact Redirect URI you specified in your app settings.
  2. Open the returned URL in a browser. Log in and grant permissions to the connector. You are then redirected to the callback URL, which contains the verifier code.
  3. Save the value of the verifier code. You will set this in the OAuthVerifier connection property.

On the headless machine, set the following connection properties to obtain the OAuth authentication values:

  • OAuthClientId: Set this to the consumer key in your app settings.
  • OAuthClientSecret: Set this to the consumer secret in your app settings.
  • OAuthVerifier: Set this to the verifier code.
  • OAuthSettingsLocation: Set this to persist the encrypted OAuth authentication values to the specified file.
  • InitiateOAuth: Set this to REFRESH.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

After the OAuth settings file is generated, set the following properties to connect to data:

  • OAuthClientId: Set this to the consumer key in your app settings.
  • OAuthClientSecret: Set this to the consumer secret in your app settings.
  • OAuthSettingsLocation: Set this to the file containing the encrypted OAuth authentication values. Make sure this file gives read and write permissions to the provider to enable the automatic refreshing of the access token.
  • InitiateOAuth: Set this to REFRESH.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

Transfer OAuth Settings

Follow the steps below to install the connector on another machine, authenticate, and then transfer the resulting OAuth values.

On a second machine, install the connector and connect with the following properties set:

  • OAuthSettingsLocation: Set this to a writable text file.
  • InitiateOAuth: Set this to GETANDREFRESH.
  • OAuthClientId: Set this to the client ID assigned when you registered your app.
  • OAuthClientSecret: Set this to the client secret assigned when you registered your app.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

Test the connection to authenticate. The resulting authentication values are written, encrypted, to the path specified by OAuthSettingsLocation. Once you have successfully tested the connection, copy the OAuth settings file to your headless machine. On the headless machine, set the following connection properties to connect to data:

  • InitiateOAuth: Set this to REFRESH.
  • OAuthClientId: Set this to the consumer key in your app settings.
  • OAuthClientSecret: Set this to the consumer secret in your app settings.
  • OAuthSettingsLocation: Set this to the path to your OAuth settings file. Make sure this file gives read and write permissions to the connector to enable the automatic refreshing of the access token.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.
Authenticate with a Service Account

Service accounts have silent authentication, without user authentication in the browser. You can also use a service account to delegate enterprise-wide access scopes to the connector.

You need to create an OAuth application in this flow. See Creating a Custom OAuth App to create and authorize an app. You can then connect to Google Ads data that the service account has permission to access.

After setting the following connection properties, you are ready to connect:

  • InitiateOAuth: Set this to GETANDREFRESH.
  • OAuthJWTCertType: Set this to "PFXFILE".
  • OAuthJWTCert: Set this to the path to the .p12 file you generated.
  • OAuthJWTCertPassword: Set this to the password of the .pem file.
  • OAuthJWTCertSubject: Set this to "*" to pick the first certificate in the certificate store.
  • OAuthJWTIssuer: In the service accounts section, click Manage Service Accounts and set this field to the email address displayed in the service account ID field.
  • OAuthJWTSubject: Set this to the email address of the user for whom the application is requesting delegate access. Note that delegate access must be granted by an administrator.
  • DeveloperToken: Set this to the developer token of the AdWords account. You can get a developer token by signing up for the AdWords API. To do this, log in to the AdWords site with your MCC account and navigate to Settings -> Account Settings -> AdWords API Center. Apply for API access and wait for Google to contact you via email with more instructions. You should receive a token with a pending status. This token is only for testing and does not allow you to connect to live data. Google should contact you to fill out a questionnaire and once this has been received and approved by Google, you will receive your active developer token.
  • ClientCustomerId: Set this to the client customer ID of the AdWords account. You can find this value in your AdWords account. This value is not the same as the ID of the MCC account. You need to provide the lowest-level Ids to retrieve data.

When you connect the connector completes the OAuth flow for a service account.

  1. Creates and signs the JWT with the claim set required by the connector.
  2. Exchanges the JWT for the access token.
  3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.
  4. Submits the JWT for a new access token when the token expires.

Create a Custom OAuth App

You can use a custom OAuth app to authenticate a service account or a user account. See Using OAuth Authentication for more information.

Create an OAuth App for User Account Authentication

Follow the procedure below to register an app and obtain the OAuthClientId and OAuthClientSecret.

Create a Custom OAuth App: Desktop
  1. Log into the Google API Console and open a project.

    Select the API Manager from the main menu.

  2. Click Credentials -> Create Credentials -> OAuth Client Id. Click Other.

Create an OAuth App for Service Account Authentication

Follow the steps below to create an OAuth application and generate a private key. You will then authorize the service account.

  1. Log into the Google API Console and open a project. Select the API Manager from the main menu.
  2. Click Create Credentials -> Service Account Key.
  3. In the Service Account menu, select New Service Account or select an existing service account.
  4. If you are creating a new service account, additionally select one or more roles. You can assign primitive roles at the project level in the IAM and Admin section; other roles enable you to further customize access to Google APIs.
  5. In the Key Type section, select the P12 key type.
  6. Create the app to download the key pair. The private key's password is displayed: Set this in OAuthJWTCertPassword.
  7. In the service accounts section, click Manage Service Accounts and set OAuthJWTIssuer to the email address displayed in the service account ID field.

Retrieve Google AdWords data

Google AdWords data is organized into various metrics (for example, Conversions, Impressions, and InvalidClicks), which can be grouped by various segments (for example, Date and Device). Additionally, there are attributes that represent fixed data or account settings (for example, CampaignName, AdType, and AdGroupStatus). These are called the Behavior for the field. There are many valid combinations of metrics, segments, and attributes. The connector surfaces each separate report type in AdWords as a table.

Select Data

Unlike most database tables, it is not very helpful to select all metrics, segments, and attributes in a given table. In some cases, it is not even possible to do this since some data conflict with each other when selected. As a result, the connector thus interprets the SELECT * query to mean a default set of metrics, segments, and attributes are requested. This includes queries that explicitly select all columns to account for tools that use projection when returning results. These default fields represent the default columns exposed through the Google AdWords console. To select nondefault columns, simply explicitly select these columns in the query rather than issuing a SELECT * query. Finally, it is important to note that at least one metric must be included in the request for any data to be returned.

By default, the column names are the values used by the API.

Other Considerations

Certain percentage fields can return the values '< 10%' or '> 90 %'. In order to allow you to use this column as a numeric field, these values are reported as exactly '10' and '90' respectively.

Fine-Tuning Data Access

Select the API Version

The Google Ads API adheres to a deprecation schedule of approximately every 10 months.
For backwards compatibility, the connector maintains APIs that have been deprecated but not sunset; if your application requires a deprecated API, you can set it in the Schema property.

Fine-Tuning Data Access

You can use the following properties to gain greater control over Google Ads API features and the strategies the connector uses to surface them:

  • IncludeZeroImpressions: This property controls whether records with zero impressions are included in reports.

Important Notes

Configuration Files and Their Paths

  • All references to adding configuration files and their paths refer to files and locations on the Harmony Agent where the connector is installed. These paths are to be adjusted as appropriate depending on the agent and the operating system. If multiple agents are used in an agent group, identical files will be required on each agent.

Advanced Features

This section details a selection of advanced features of the Google Ads connector.

User Defined Views

The connector allows you to define virtual tables, called user defined views, whose contents are decided by a pre-configured query. These views are useful when you cannot directly control queries being issued to the drivers. See User Defined Views for an overview of creating and configuring custom views.

SSL Configuration

Use SSL Configuration to adjust how connector handles TLS/SSL certificate negotiations. You can choose from various certificate formats; see the SSLServerCert property under "Connection String Options" for more information.

Proxy

To configure the connector using Private Agent proxy settings, select the Use Proxy Settings checkbox on the connection configuration screen.

User Defined Views

The Google Ads connector allows you to define a virtual table whose contents are decided by a pre-configured query. These are called User Defined Views, which are useful in situations where you cannot directly control the query being issued to the driver, e.g. when using the driver from Jitterbit. The User Defined Views can be used to define predicates that are always applied. If you specify additional predicates in the query to the view, they are combined with the query already defined as part of the view.

There are two ways to create user defined views:

  • Create a JSON-formatted configuration file defining the views you want.
  • DDL statements.

Define Views Using a Configuration File

User Defined Views are defined in a JSON-formatted configuration file called UserDefinedViews.json. The connector automatically detects the views specified in this file.

You can also have multiple view definitions and control them using the UserDefinedViews connection property. When you use this property, only the specified views are seen by the connector.

This User Defined View configuration file is formatted as follows:

  • Each root element defines the name of a view.
  • Each root element contains a child element, called query, which contains the custom SQL query for the view.

For example:

{
    "MyView": {
        "query": "SELECT * FROM CampaignPerformance WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use the UserDefinedViews connection property to specify the location of your JSON configuration file. For example:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema for User Defined Views

User Defined Views are exposed in the UserViews schema by default. This is done to avoid the view's name clashing with an actual entity in the data model. You can change the name of the schema used for UserViews by setting the UserViewsSchemaName property.

Work with User Defined Views

For example, a SQL statement with a User Defined View called UserViews.RCustomers only lists customers in Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

An example of a query to the driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resulting in the effective query to the source:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

That is a very simple example of a query to a User Defined View that is effectively a combination of the view query and the view definition. It is possible to compose these queries in much more complex patterns. All SQL operations are allowed in both queries and are combined when appropriate.

SSL Configuration

Customize the SSL Configuration

By default, the connector attempts to negotiate SSL/TLS by checking the server's certificate against the system's trusted certificate store.

To specify another certificate, see the SSLServerCert property for the available formats to do so.

Data Model

The Google Ads connector supports two distinct schemas.

AdWords Data Model

See AdWords Data Model.

Google Ads

See Google Ads Data Model.

AdWords Data Model

The Google Ads connector models Google Ads entities in relational views and stored procedures. The provided views will give you access to your Google AdWords report data using v201809 of the Google AdWords Reporting API.

Views

Views are tables that cannot be modified. Typically, data that are read-only and cannot be updated are shown as views. Additionally, API limitations and requirements are documented in this section.

Stored Procedures

Stored Procedures are function-like interfaces to the data source. They can be used to search, update, and modify information

in the data source.

Views

Views are composed of columns and pseudo columns. Views are similar to tables in the way that data is represented; however, views do not support updates. Entities that are represented as views are typically read-only entities. Often, a stored procedure is available to update the data if such functionality is applicable to the data source.

Queries can be executed against a view as if it were a normal table, and the data that comes back is similar in that regard. To find out more about tables and stored procedures, please navigate to their corresponding entries in this help document.

Name Description
AccountPerformance The Account Performance report includes all statistics aggregated by default at the account level, one row per account.
AdCustomizersFeedItem The Ad Customizers Feed Item report provides statistics for feed items used in Ad Customizers. Statistics are aggregated at the feed item level, one row per feed item.
AdGroupBidLandscape Represents data about a bidlandscape for an adgroup.
AdgroupPerformance The Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group.
AdGroups Service to access details about any ad groups.
AdPerformance The Ad Performance report includes all statistics aggregated at the ad level, one row per ad.
AgeRangePerformance The Age Range Performance report includes all display network statistics aggregated by age range. It also includes automatic audience performance.
AudiencePerformance The Audience Performance report includes performance data from interests and remarketing lists for display ads, and remarketing lists for search ads (RLSA), aggregated at the audience level�one row per audience.
AutomaticPlacementsPerformance The Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement.
BidGoalPerformance The Bid Goal Performance report includes statistics for your bid strategies.
BudgetPerformance The Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget.
CallMetricsCallDetails The Call Metrics Call Details report includes call details for your call extension including call duration and the caller's area code.
CampaignAdScheduleTarget The Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria.
CampaignCriteria The Campaign Criteria report is a structure report that allows you to efficiently retrieve campaign-level criteria.
CampaignCriterionBidLandscape The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.
CampaignGroupPerformance The Campaign Group Performance report includes the overall performance statistics of campaigns that you have included in campaign groups. Statistics are aggregated by default at the campaign group level.
CampaignLocationTarget The Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion.
CampaignNegativeKeywordsPerformance Although negative keywords do not hold statistics, you can use this structured report to efficiently retrieve attributes of keyword-based NegativeCampaignCriterion objects.
CampaignNegativeLocations Although negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects.
CampaignNegativePlacementsPerformance Although negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects.
CampaignPerformance The Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign.
Campaigns Service to access details about any campaign.
CampaignSharedSet The Campaign Shared Set report includes all relationships between SharedSets and campaigns.
ClickPerformance The Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks. The KeywordId field will return any criteria that triggered the click, not just keywords.
ConversionTrackers Service to access details about any conversion tracker.
CreativeConversion Free clicks are interactions that take place before a clickthrough for video ads, display ads, product extensions and location extensions, interactions like a Video play or a Get directions.
CriteriaPerformance The Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination.
CriterionBidLandscape The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.
Customers Service to access basic details about any customer.
DisplayKeywordPerformance The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword.
DisplayTopicsPerformance The Display Topics Performance report includes all display network statistics aggregated at the topic level, one row per topic.
FinalUrl The Final URL report includes all statistics aggregated at the final URL level, one row per final URL. If other segment fields are used, you may get more than one row per final URL.
GenderPerformance The Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance.
GeoPerformance The Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory.
KeywordlessCategory The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.
KeywordlessQuery The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.
KeywordsPerformance The Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword.
Label The Label report is a structure report that lists all labels for your account.
LandingPage The Landing Page report includes all statistics aggregated by default by the UnexpandedFinalUrlString, one row per the URL string.
LocationCriterion Represents data that encapsulates a location criterion.
ManagedCustomers Service to access basic details about any customer.
ManagedCustomersLinks Service to access basic details about any customer links.
MarketplacePerformance The Marketplace Performance report includes all statistics of ads displayed on the Marketplace, aggregated by default at the account level.
PaidOrganicQuery The Paid and Organic Query report provides a holistic view of your search stats across ads and organic listings at the query level. This lets you analyze strengths and gaps in your overall search presence, and gives insight into how your paid and organic search listings work together to connect your business with people searching on Google.
ParentalStatusPerformance The Parental Status Performance report includes statistics aggregated at the parental status level, one row per parental status
Placeholder The Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type.
PlaceholderFeedItem The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink).
PlacementPerformance The Placements Performance report includes all statistics aggregated at the placement level, one row per placement.
ProductPartition The Product Partition report provides shopping campaign statistics aggregated at the product partition (Id field) level.
SearchQueryPerformance The Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms.
SharedSet The Shared Set report includes all SharedSets that can be shareable across campaigns.
SharedSetCriteria The Shared Set Criteria report includes criteria for each SharedSet.
ShoppingPerformance The Shopping Performance report provides shopping campaign statistics aggregated at the product (OfferId field) level.
TopContentPerformance Retrieves TopContentPerformance report data.
UrlPerformance The URL Performance report includes all statistics aggregated at the URL and criterion level.
UserAdDistance The User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions.
VideoPerformance The Video Performance report includes statistics for your account's upgraded AdWords for Video campaigns.
AccountPerformance

The Account Performance report includes all statistics aggregated by default at the account level, one row per account.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AccountPerformance report.
AccountDescriptiveName String Attribute Account Account for the AccountPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AccountPerformance report.
CanManageClients Boolean Attribute Can Manage Clients Can Manage Clients for the AccountPerformance report.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the AccountPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AccountPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AccountPerformance report.
IsAutoTaggingEnabled Boolean Attribute Auto Tagging Enabled Auto Tagging Enabled for the AccountPerformance report.
IsTestAccount Boolean Attribute Test Account Test Account for the AccountPerformance report.
AdNetworkType1 String Segment Network Network for the AccountPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AccountPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the AccountPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AccountPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AccountPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AccountPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AccountPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AccountPerformance report.
Date Date Segment Day Day for the AccountPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AccountPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AccountPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AccountPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segment Hour Of Day Hour Of Day for the AccountPerformance report.
Month String Segment Month Month for the AccountPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AccountPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AccountPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AccountPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the AccountPerformance report.
Year Integer Segment Year Year for the AccountPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AccountPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AccountPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AccountPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AccountPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AccountPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AccountPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AccountPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AccountPerformance report.
AllConversions Double Metric All Conv All Conv for the AccountPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AccountPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AccountPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AccountPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AccountPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AccountPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AccountPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AccountPerformance report.
Clicks Long Metric Clicks Clicks for the AccountPerformance report.
ContentBudgetLostImpressionShare Double Metric Content Lost IS (budget) Content Lost IS (budget) for the AccountPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the AccountPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the AccountPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AccountPerformance report.
Conversions Double Metric Conversions Conversions for the AccountPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AccountPerformance report.
Cost Decimal Metric Cost Cost for the AccountPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AccountPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AccountPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AccountPerformance report.
Ctr Double Metric CTR CTR for the AccountPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AccountPerformance report.
Engagements Long Metric Engagements Engagements for the AccountPerformance report.
Impressions Long Metric Impressions Impressions for the AccountPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AccountPerformance report.
Interactions Long Metric Interactions Interactions for the AccountPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AccountPerformance report.
InvalidClickRate Double Metric Invalid Click Rate Invalid Click Rate for the AccountPerformance report.
InvalidClicks Long Metric Invalid Clicks Invalid Clicks for the AccountPerformance report.
SearchBudgetLostImpressionShare Double Metric Search Lost IS (budget) Search Lost IS (budget) for the AccountPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the AccountPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the AccountPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the AccountPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AccountPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AccountPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AccountPerformance report.
VideoViews Long Metric Views Views for the AccountPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AccountPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AdCustomizersFeedItem

The Ad Customizers Feed Item report provides statistics for feed items used in Ad Customizers. Statistics are aggregated at the feed item level, one row per feed item.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the AdCustomizersFeedItem report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdCustomizersFeedItem report.
AdGroupName String Attribute Ad Group Ad Group for the AdCustomizersFeedItem report.
AdId Long Attribute Ad ID Ad ID for the AdCustomizersFeedItem report.
CampaignId Long Attribute Campaign ID Campaign ID for the AdCustomizersFeedItem report.
CampaignName String Attribute Campaign Campaign for the AdCustomizersFeedItem report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AdCustomizersFeedItem report.
FeedId Long Attribute Feed ID Feed ID for the AdCustomizersFeedItem report.
FeedItemAttributes String Attribute Attribute Values Attribute Values for the AdCustomizersFeedItem report.
FeedItemEndTime Long Attribute End Date End Date for the AdCustomizersFeedItem report.
FeedItemId Long Attribute Item ID Item ID for the AdCustomizersFeedItem report.
FeedItemStartTime Long Attribute Start Date Start Date for the AdCustomizersFeedItem report.
FeedItemStatus String Attribute Item State Item State for the AdCustomizersFeedItem report. The allowed values are ENABLED, REMOVED, UNKNOWN.
GeoTargetingCriterionId Long Attribute Target Location Target Location for the AdCustomizersFeedItem report.
KeywordTargetingId Long Attribute Keyword ID Keyword ID for the AdCustomizersFeedItem report.
KeywordTargetingMatchType String Attribute Target Keyword Match Type Target Keyword Match Type for the AdCustomizersFeedItem report.
KeywordTargetingText String Attribute Target Keyword Text Target Keyword Text for the AdCustomizersFeedItem report.
TargetingAdGroupId Long Attribute Target Ad Group ID Target Ad Group ID for the AdCustomizersFeedItem report.
TargetingCampaignId Long Attribute Target Campaign ID Target Campaign ID for the AdCustomizersFeedItem report.
AdNetworkType1 String Segment Network Network for the AdCustomizersFeedItem report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdCustomizersFeedItem report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AdCustomizersFeedItem report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AdCustomizersFeedItem report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdCustomizersFeedItem report.
Date Date Segment Day Day for the AdCustomizersFeedItem report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdCustomizersFeedItem report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AdCustomizersFeedItem report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AdCustomizersFeedItem report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the AdCustomizersFeedItem report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdCustomizersFeedItem report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AdCustomizersFeedItem report.
Slot String Segment Top Vs Other Top Vs Other for the AdCustomizersFeedItem report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the AdCustomizersFeedItem report.
Year Integer Segment Year Year for the AdCustomizersFeedItem report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdCustomizersFeedItem report.
AllConversions Double Metric All Conv All Conv for the AdCustomizersFeedItem report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdCustomizersFeedItem report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdCustomizersFeedItem report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdCustomizersFeedItem report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdCustomizersFeedItem report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdCustomizersFeedItem report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdCustomizersFeedItem report.
AveragePosition Double Metric Avg Position Avg Position for the AdCustomizersFeedItem report.
Clicks Long Metric Clicks Clicks for the AdCustomizersFeedItem report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdCustomizersFeedItem report.
Conversions Double Metric Conversions Conversions for the AdCustomizersFeedItem report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdCustomizersFeedItem report.
Cost Decimal Metric Cost Cost for the AdCustomizersFeedItem report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdCustomizersFeedItem report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdCustomizersFeedItem report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdCustomizersFeedItem report.
Ctr Double Metric CTR CTR for the AdCustomizersFeedItem report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdCustomizersFeedItem report.
Engagements Long Metric Engagements Engagements for the AdCustomizersFeedItem report.
Impressions Long Metric Impressions Impressions for the AdCustomizersFeedItem report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdCustomizersFeedItem report.
Interactions Long Metric Interactions Interactions for the AdCustomizersFeedItem report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdCustomizersFeedItem report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdCustomizersFeedItem report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdCustomizersFeedItem report.
VideoViewRate Double Metric View Rate View Rate for the AdCustomizersFeedItem report.
VideoViews Long Metric Views Views for the AdCustomizersFeedItem report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AdGroupBidLandscape

Represents data about a bidlandscape for an adgroup.

Columns
Name Type Behavior DisplayName Description
CampaignId Long ID of the campaign that contains the criterion with which this bid landscape is associated.
AdGroupId Long ID of the ad group that contains the criterion with which this bid landscape is associated.
StartDate String First day on which this landscape is based. Typically, it could be up to a week ago.
EndDate String Last day on which this landscape is based.
LandscapeType String The type of this landscape bid.
LandscapeCurrent Boolean If true, then this bid landscape contains the set of ad group criteria that currently do not have criterion-level bid overrides. If false, then this bid landscape was derived from an earlier snapshot of ad group criteria, so it may contain criteria to which bid overrides were recently added, and may not contain criteria from which bid overrides were recently removed.
Bid Long The bid amount used to estimate this landscape point's data.
Clicks Long Estimated number of clicks at this bid.
Cost Long Estimated cost at this bid.
Impressions Long Estimated number of impressions at this bid.
PromotedImpressions Long Estimated number of promoted impressions.
BiddableConversions Double Estimated number of biddable conversions.
BiddableConversionsValue Double Estimated biddable conversions value.
AdgroupPerformance

The Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query. For example, the following query uses Device instead of the default Date segment to query Ad Group Performance data:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API. All filters must be joined by the AND keyword as OR is not supported by the AdWords API. For example, the following query will return only AdGroups in enabled Campaigns with a conversion rate greater than 0:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance WHERE CampaignStatus='ENABLED' AND ConversionRate > 0
Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AdgroupPerformance report.
AccountDescriptiveName String Attribute Account Account for the AdgroupPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AdgroupPerformance report.
AdGroupDesktopBidModifier Double Attribute Desktop Bid Adj Desktop Bid Adj for the AdgroupPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdgroupPerformance report.
AdGroupMobileBidModifier Double Attribute Mobile Bid Adj Mobile Bid Adj for the AdgroupPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AdgroupPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AdgroupPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdGroupTabletBidModifier Double Attribute Tablet Bid Adj Tablet Bid Adj for the AdgroupPerformance report.
AdGroupType String Attribute Ad Group Type Ad Group Type for the AdgroupPerformance report. The allowed values are UNKNOWN, SEARCH_STANDARD, SEARCH_DYNAMIC_ADS, DISPLAY_STANDARD, DISPLAY_ENGAGEMENT, SHOPPING_PRODUCT_ADS, SHOPPING_SHOWCASE_ADS, SHOPPING_GOAL_OPTIMIZED_ADS, VIDEO_TRUE_VIEW_IN_STREAM, VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_BUMPER, VIDEO_NON_SKIPPABLE_IN_STREAM, HOTEL_ADS.
AdRotationMode String Attribute Ad Rotation Mode Ad Rotation Mode for the AdgroupPerformance report. The allowed values are UNKNOWN, OPTIMIZE, ROTATE_FOREVER.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AdgroupPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AdgroupPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AdgroupPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AdgroupPerformance report.
BiddingStrategySource String Attribute Bidding Strategy Source Bidding Strategy Source for the AdgroupPerformance report. The allowed values are CAMPAIGN, ADGROUP, CRITERION.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AdgroupPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Attribute Campaign ID Campaign ID for the AdgroupPerformance report.
CampaignName String Attribute Campaign Campaign for the AdgroupPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AdgroupPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ContentBidCriterionTypeGroup String Attribute Content Network Bid Dimension Content Network Bid Dimension for the AdgroupPerformance report. The allowed values are KEYWORD, USER_INTEREST_AND_LIST, VERTICAL, GENDER, AGE_RANGE, PLACEMENT, PARENT, INCOME_RANGE, NONE, UNKNOWN.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the AdgroupPerformance report.
CpcBid Decimal Attribute Default Max CPC Default Max CPC for the AdgroupPerformance report.
CpmBid Decimal Attribute Max CPM Max CPM for the AdgroupPerformance report.
CpvBid Decimal Attribute Max CPV Max CPV for the AdgroupPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AdgroupPerformance report.
EffectiveTargetRoas Double Attribute Target ROAS Target ROAS for the AdgroupPerformance report.
EffectiveTargetRoasSource String Attribute Target ROAS Source Target ROAS Source for the AdgroupPerformance report. The allowed values are UNKNOWN, ADGROUP, ADGROUP_CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
EnhancedCpcEnabled Boolean Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the AdgroupPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AdgroupPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the AdgroupPerformance report.
LabelIds String Attribute Label IDs Label IDs for the AdgroupPerformance report.
Labels String Attribute Labels Labels for the AdgroupPerformance report.
TargetCpa Decimal Attribute Target CPA Target CPA for the AdgroupPerformance report.
TargetCpaBidSource String Attribute Target CPA Source Target CPA Source for the AdgroupPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AdgroupPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AdgroupPerformance report.
AdNetworkType1 String Segment Network Network for the AdgroupPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdgroupPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the AdgroupPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AdgroupPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AdgroupPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AdgroupPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AdgroupPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdgroupPerformance report.
Date Date Segment Day Day for the AdgroupPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdgroupPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AdgroupPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AdgroupPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segment Hour Of Day Hour Of Day for the AdgroupPerformance report.
Month String Segment Month Month for the AdgroupPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdgroupPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AdgroupPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AdgroupPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the AdgroupPerformance report.
Year Integer Segment Year Year for the AdgroupPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AdgroupPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AdgroupPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AdgroupPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AdgroupPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AdgroupPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AdgroupPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AdgroupPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdgroupPerformance report.
AllConversions Double Metric All Conv All Conv for the AdgroupPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdgroupPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdgroupPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdgroupPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdgroupPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdgroupPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdgroupPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the AdgroupPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AdgroupPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the AdgroupPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the AdgroupPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the AdgroupPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the AdgroupPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the AdgroupPerformance report.
Clicks Long Metric Clicks Clicks for the AdgroupPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the AdgroupPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the AdgroupPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdgroupPerformance report.
Conversions Double Metric Conversions Conversions for the AdgroupPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdgroupPerformance report.
Cost Decimal Metric Cost Cost for the AdgroupPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdgroupPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdgroupPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the AdgroupPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdgroupPerformance report.
Ctr Double Metric CTR CTR for the AdgroupPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the AdgroupPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the AdgroupPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdgroupPerformance report.
Engagements Long Metric Engagements Engagements for the AdgroupPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AdgroupPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AdgroupPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AdgroupPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the AdgroupPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the AdgroupPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the AdgroupPerformance report.
Impressions Long Metric Impressions Impressions for the AdgroupPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdgroupPerformance report.
Interactions Long Metric Interactions Interactions for the AdgroupPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdgroupPerformance report.
NumOfflineImpressions Long Metric Phone Impressions Phone Impressions for the AdgroupPerformance report.
NumOfflineInteractions Long Metric Phone Calls Phone Calls for the AdgroupPerformance report.
OfflineInteractionRate Double Metric PTR PTR for the AdgroupPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the AdgroupPerformance report.
RelativeCtr Double Metric Relative CTR Relative CTR for the AdgroupPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the AdgroupPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the AdgroupPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the AdgroupPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the AdgroupPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdgroupPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdgroupPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the AdgroupPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AdgroupPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AdgroupPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AdgroupPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AdgroupPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AdgroupPerformance report.
VideoViews Long Metric Views Views for the AdgroupPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AdgroupPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AdGroups

Service to access details about any ad groups.

Table Specific Information

Select

There are two ways you can query AdGroups.

  • The following query returns ad group specified.

    SELECT * FROM [AdGroups] WHERE Id=123456789
    
  • The following query returns all ad groups.

    SELECT * FROM [AdGroups]
    
Columns
Name Type Behavior DisplayName Description
Id [KEY] Long ID of this ad group.
CampaignId Long ID of the campaign with which this ad group is associated.
CampaignName String Name of the campaign with which this ad group is associated.
Name String Name of this ad group (at most 255 UTF-8 full-width characters).
Status String Status of this ad group.
ContentBidCriterionTypeGroup String Allows advertisers to specify a criteria dimension on which to place absolute bids.
BaseCampaignId Long ID of the base campaign from which this draft/trial adgroup was created.
BaseAdGroupId Long ID of the base adgroup from which this draft/trial adgroup was created.
TrackingUrlTemplate String URL template for constructing a tracking URL.
FinalUrlSuffix String URL template for appending params to Final URL.
UrlCustomParameters String A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.
AdGroupType String The type of the Ad Group.
BiddingStrategyId Long Id of the bidding strategy to be associated with the campaign, ad group or ad group criteria.
BiddingStrategyName String Name of the bidding strategy.
BiddingStrategyType String The type of the bidding strategy to be attached.
BiddingStrategySource String Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.
AdRotationMode String The ad rotation mode to specify how often the ads in the ad group will be served relative to one another.
AdPerformance

The Ad Performance report includes all statistics aggregated at the ad level, one row per ad.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query. For example, the following query uses ClickType instead of the default Date segment to query Ad Performance data:

SELECT AdType, Headline, CampaignName, ClickType, Clicks, ConversionRate, Impressions FROM AdPerformance

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API. All filters must be joined by the AND keyword as OR is not supported by the AdWords API. For example, this query will return only Ads that are enabled with a conversion rate greater than 0:

SELECT AdType, Headline, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdPerformance WHERE Status='ENABLED' AND ConversionRate > 0
Columns
Name Type Behavior DisplayName Description
AccentColor String Attribute Accent Color (responsive) Accent Color (responsive) for the AdPerformance report.
AccountCurrencyCode String Attribute Currency Currency for the AdPerformance report.
AccountDescriptiveName String Attribute Account Account for the AdPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AdPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AdPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AdPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdStrengthInfo String Attribute Ad Strength Ad Strength for the AdPerformance report.
AdType String Attribute Ad Type Ad Type for the AdPerformance report. The allowed values are DEPRECATED_AD, IMAGE_AD, PRODUCT_AD, TEMPLATE_AD, TEXT_AD, THIRD_PARTY_REDIRECT_AD, DYNAMIC_SEARCH_AD, CALL_ONLY_AD, EXPANDED_TEXT_AD, RESPONSIVE_DISPLAY_AD, SHOWCASE_AD, GOAL_OPTIMIZED_SHOPPING_AD, EXPANDED_DYNAMIC_SEARCH_AD, GMAIL_AD, RESPONSIVE_SEARCH_AD, MULTI_ASSET_RESPONSIVE_DISPLAY_AD, UNKNOWN.
AllowFlexibleColor Boolean Attribute Allow Flexible Color (responsive) Allow Flexible Color (responsive) for the AdPerformance report.
Automated Boolean Attribute Auto-applied Ad Suggestion Auto-applied Ad Suggestion for the AdPerformance report.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AdPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AdPerformance report.
BusinessName String Attribute Business Name Business Name for the AdPerformance report.
CallOnlyPhoneNumber String Attribute Call-only Ad Phone Number Call-only Ad Phone Number for the AdPerformance report.
CallToActionText String Attribute Call To Action Text (responsive) Call To Action Text (responsive) for the AdPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AdPerformance report.
CampaignName String Attribute Campaign Campaign for the AdPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AdPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CombinedApprovalStatus String Attribute Approval Status Approval Status for the AdPerformance report. The allowed values are UNKNOWN, APPROVED, APPROVED_LIMITED, ELIGIBLE, UNDER_REVIEW, DISAPPROVED, SITE_SUSPENDED.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the AdPerformance report.
CreativeDestinationUrl String Attribute Destination URL Destination URL for the AdPerformance report.
CreativeFinalAppUrls String Attribute App Final URL App Final URL for the AdPerformance report.
CreativeFinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AdPerformance report.
CreativeFinalUrls String Attribute Final URL Final URL for the AdPerformance report.
CreativeFinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the AdPerformance report.
CreativeTrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AdPerformance report.
CreativeUrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AdPerformance report.
CriterionType String Attribute Criteria Type Criteria Type for the AdPerformance report. The allowed values are UNKNOWN, AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, CARRIER, CONTENT_LABEL, CUSTOM_AFFINITY, GENDER, LOCATION_GROUPS, IP_BLOCK, KEYWORD, LANGUAGE, LOCATION, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENT, PLACEMENT, PLATFORM, PREFERRED_CONTENT, PRODUCT_PARTITION, PRODUCT_SCOPE, PROXIMITY, USER_INTEREST, USER_LIST, VERTICAL, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO, CUSTOM_IN_MARKET.
CustomerDescriptiveName String Attribute Client Name Client Name for the AdPerformance report.
Description String Attribute Description Description for the AdPerformance report.
Description1 String Attribute Description Line 1 Description Line 1 for the AdPerformance report.
Description2 String Attribute Description Line 2 Description Line 2 for the AdPerformance report.
DevicePreference Long Attribute Device Preference Device Preference for the AdPerformance report.
DisplayUrl String Attribute Display URL Display URL for the AdPerformance report.
EnhancedDisplayCreativeLandscapeLogoImageMediaId Long Attribute Landscape Logo ID (responsive) Landscape Logo ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeLogoImageMediaId Long Attribute Logo ID (responsive) Logo ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeMarketingImageMediaId Long Attribute Image ID (responsive) Image ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeMarketingImageSquareMediaId Long Attribute Square Image ID (responsive) Square Image ID (responsive) for the AdPerformance report.
ExpandedDynamicSearchCreativeDescription2 String Attribute Expanded Dynamic Search Ad Description 2 Expanded Dynamic Search Ad Description 2 for the AdPerformance report.
ExpandedTextAdDescription2 String Attribute Expanded Text Ad Description 2 Expanded Text Ad Description 2 for the AdPerformance report.
ExpandedTextAdHeadlinePart3 String Attribute Expanded Text Ad Headline 3 Expanded Text Ad Headline 3 for the AdPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AdPerformance report.
FormatSetting String Attribute Ad Format Preference (responsive) Ad Format Preference (responsive) for the AdPerformance report. The allowed values are UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.
GmailCreativeHeaderImageMediaId Long Attribute Gmail Ad Header Image Media Id Gmail Ad Header Image Media ID for the AdPerformance report.
GmailCreativeLogoImageMediaId Long Attribute Gmail Ad Logo Image Media Id Gmail Ad Logo Image Media ID for the AdPerformance report.
GmailCreativeMarketingImageMediaId Long Attribute Gmail Ad Marketing Image Media Id Gmail Ad Marketing Image Media ID for the AdPerformance report.
GmailTeaserBusinessName String Attribute Gmail Ad Business Name Gmail Ad Business Name for the AdPerformance report.
GmailTeaserDescription String Attribute Gmail Ad Description Gmail Ad Description for the AdPerformance report.
GmailTeaserHeadline String Attribute Gmail Ad Headline Gmail Ad Headline for the AdPerformance report.
Headline String Attribute Ad Ad for the AdPerformance report.
HeadlinePart1 String Attribute Headline 1 Headline 1 for the AdPerformance report.
HeadlinePart2 String Attribute Headline 2 Headline 2 for the AdPerformance report.
Id Long Attribute Ad ID Ad ID for the AdPerformance report.
ImageAdUrl String Attribute Image Ad URL Image Ad URL for the AdPerformance report.
ImageCreativeImageHeight Integer Attribute Image Height Image Height for the AdPerformance report.
ImageCreativeImageWidth Integer Attribute Image Width Image Width for the AdPerformance report.
ImageCreativeMimeType String Attribute Image Mime Type Image Mime Type for the AdPerformance report.
ImageCreativeName String Attribute Image Ad Name Image Ad Name for the AdPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the AdPerformance report.
LabelIds String Attribute Label IDs Label IDs for the AdPerformance report.
Labels String Attribute Labels Labels for the AdPerformance report.
LongHeadline String Attribute Long Headline Long Headline for the AdPerformance report.
MainColor String Attribute Main Color (responsive) Main Color (responsive) for the AdPerformance report.
MarketingImageCallToActionText String Attribute Gmail Ad Marketing Image Call To Action Text Gmail Ad Marketing Image Call To Action Text for the AdPerformance report.
MarketingImageCallToActionTextColor String Attribute Gmail Ad Marketing Image Call To Action Text Color Gmail Ad Marketing Image Call To Action Text Color for the AdPerformance report.
MarketingImageDescription String Attribute Gmail Ad Marketing Image Description Gmail Ad Marketing Image Description for the AdPerformance report.
MarketingImageHeadline String Attribute Gmail Ad Marketing Image Headline Gmail Ad Marketing Image Headline for the AdPerformance report.
MultiAssetResponsiveDisplayAdAccentColor String Attribute Accent Color (multi Asset Responsive Display) Accent Color (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdAllowFlexibleColor Boolean Attribute Allow Flexible Color (multi Asset Responsive Display) Allow Flexible Color (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdBusinessName String Attribute Business Name (multi Asset Responsive Display) Business Name (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdCallToActionText String Attribute Call To Action Text (multi Asset Responsive Display) Call To Action Text (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDescriptions String Attribute Descriptions (multi Asset Responsive Display) Descriptions (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix String Attribute Price Prefix (multi Asset Responsive Display) Price Prefix (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDynamicSettingsPromoText String Attribute Promotion Text (multi Asset Responsive Display) Promotion Text (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdFormatSetting String Attribute Ad Format Preference (multi Asset Responsive Display) Ad Format Preference (multi Asset Responsive Display) for the AdPerformance report. The allowed values are UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.
MultiAssetResponsiveDisplayAdHeadlines String Attribute Headlines (multi Asset Responsive Display) Headlines (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLandscapeLogoImages String Attribute Landscape Logos (multi Asset Responsive Display) Landscape Logos (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLogoImages String Attribute Logos (multi Asset Responsive Display) Logos (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLongHeadline String Attribute Long Headline (multi Asset Responsive Display) Long Headline (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdMainColor String Attribute Main Color (multi Asset Responsive Display) Main Color (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdMarketingImages String Attribute Images (multi Asset Responsive Display) Images (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdSquareMarketingImages String Attribute Square Images (multi Asset Responsive Display) Square Images (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdYouTubeVideos String Attribute Youtube Videos (multi Asset Responsive Display) Youtube Videos (multi Asset Responsive Display) for the AdPerformance report.
Path1 String Attribute Path 1 Path 1 for the AdPerformance report.
Path2 String Attribute Path 2 Path 2 for the AdPerformance report.
PolicySummary String Attribute Policy Policy for the AdPerformance report.
PricePrefix String Attribute Price Prefix (responsive) Price Prefix (responsive) for the AdPerformance report.
PromoText String Attribute Promotion Text (responsive) Promotion Text (responsive) for the AdPerformance report.
ResponsiveSearchAdDescriptions String Attribute Responsive Search Ad Descriptions Responsive Search Ad Descriptions for the AdPerformance report.
ResponsiveSearchAdHeadlines String Attribute Responsive Search Ad Headlines Responsive Search Ad Headlines for the AdPerformance report.
ResponsiveSearchAdPath1 String Attribute Responsive Search Ad Path 1 Responsive Search Ad Path 1 for the AdPerformance report.
ResponsiveSearchAdPath2 String Attribute Responsive Search Ad Path 2 Responsive Search Ad Path 2 for the AdPerformance report.
ShortHeadline String Attribute Short Headline Short Headline for the AdPerformance report.
Status String Attribute Ad State Ad State for the AdPerformance report. The allowed values are ENABLED, PAUSED, DISABLED.
SystemManagedEntitySource String Attribute System Managed Entity Source System Managed Entity Source for the AdPerformance report. The allowed values are UNKNOWN, AD_VARIATIONS.
AdNetworkType1 String Segment Network Network for the AdPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the AdPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AdPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AdPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AdPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AdPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdPerformance report.
CriterionId Long Segment Keyword ID Keyword ID for the AdPerformance report.
Date Date Segment Day Day for the AdPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AdPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AdPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the AdPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AdPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AdPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the AdPerformance report.
Year Integer Segment Year Year for the AdPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AdPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AdPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AdPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AdPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AdPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AdPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AdPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdPerformance report.
AllConversions Double Metric All Conv All Conv for the AdPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the AdPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AdPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the AdPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the AdPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the AdPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the AdPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the AdPerformance report.
Clicks Long Metric Clicks Clicks for the AdPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdPerformance report.
Conversions Double Metric Conversions Conversions for the AdPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdPerformance report.
Cost Decimal Metric Cost Cost for the AdPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the AdPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdPerformance report.
Ctr Double Metric CTR CTR for the AdPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the AdPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the AdPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdPerformance report.
Engagements Long Metric Engagements Engagements for the AdPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AdPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AdPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AdPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the AdPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the AdPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the AdPerformance report.
Impressions Long Metric Impressions Impressions for the AdPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdPerformance report.
Interactions Long Metric Interactions Interactions for the AdPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the AdPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the AdPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AdPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AdPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AdPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AdPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AdPerformance report.
VideoViews Long Metric Views Views for the AdPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AdPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AgeRangePerformance

The Age Range Performance report includes all display network statistics aggregated by age range. It also includes automatic audience performance.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AgeRangePerformance report.
AccountDescriptiveName String Attribute Account Account for the AgeRangePerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AgeRangePerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AgeRangePerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AgeRangePerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AgeRangePerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AgeRangePerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AgeRangePerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AgeRangePerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AgeRangePerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AgeRangePerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the AgeRangePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AgeRangePerformance report.
CampaignName String Attribute Campaign Campaign for the AgeRangePerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AgeRangePerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the AgeRangePerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the AgeRangePerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the AgeRangePerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the AgeRangePerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Age Range Age Range for the AgeRangePerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the AgeRangePerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AgeRangePerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AgeRangePerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the AgeRangePerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AgeRangePerformance report.
FinalUrls String Attribute Final URL Final URL for the AgeRangePerformance report.
Id Long Attribute Criterion ID Criterion ID for the AgeRangePerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the AgeRangePerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the AgeRangePerformance report.
Status String Attribute Age Range State Age Range State for the AgeRangePerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AgeRangePerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AgeRangePerformance report.
AdNetworkType1 String Segment Network Network for the AgeRangePerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AgeRangePerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the AgeRangePerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AgeRangePerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AgeRangePerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AgeRangePerformance report.
Date Date Segment Day Day for the AgeRangePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AgeRangePerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AgeRangePerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AgeRangePerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the AgeRangePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AgeRangePerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AgeRangePerformance report.
Week String Segment Week Week for the AgeRangePerformance report.
Year Integer Segment Year Year for the AgeRangePerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AgeRangePerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AgeRangePerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AgeRangePerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AgeRangePerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AgeRangePerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AgeRangePerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AgeRangePerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AgeRangePerformance report.
AllConversions Double Metric All Conv All Conv for the AgeRangePerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AgeRangePerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AgeRangePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AgeRangePerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AgeRangePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AgeRangePerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AgeRangePerformance report.
Clicks Long Metric Clicks Clicks for the AgeRangePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AgeRangePerformance report.
Conversions Double Metric Conversions Conversions for the AgeRangePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AgeRangePerformance report.
Cost Decimal Metric Cost Cost for the AgeRangePerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AgeRangePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AgeRangePerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AgeRangePerformance report.
Ctr Double Metric CTR CTR for the AgeRangePerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AgeRangePerformance report.
Engagements Long Metric Engagements Engagements for the AgeRangePerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AgeRangePerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AgeRangePerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AgeRangePerformance report.
Impressions Long Metric Impressions Impressions for the AgeRangePerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AgeRangePerformance report.
Interactions Long Metric Interactions Interactions for the AgeRangePerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AgeRangePerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AgeRangePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AgeRangePerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AgeRangePerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AgeRangePerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AgeRangePerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AgeRangePerformance report.
VideoViewRate Double Metric View Rate View Rate for the AgeRangePerformance report.
VideoViews Long Metric Views Views for the AgeRangePerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AgeRangePerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AudiencePerformance

The Audience Performance report includes performance data from interests and remarketing lists for display ads, and remarketing lists for search ads (RLSA), aggregated at the audience level�one row per audience.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AudiencePerformance report.
AccountDescriptiveName String Attribute Account Account for the AudiencePerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AudiencePerformance report.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AudiencePerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AudiencePerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AudiencePerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AudiencePerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AudiencePerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the AudiencePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AudiencePerformance report.
CampaignName String Attribute Campaign Campaign for the AudiencePerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AudiencePerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the AudiencePerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the AudiencePerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the AudiencePerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the AudiencePerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Audience Audience for the AudiencePerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the AudiencePerformance report.
CriterionAttachmentLevel String Attribute Level Level for the AudiencePerformance report. The allowed values are UNKNOWN, ADGROUP, CAMPAIGN, CUSTOMER.
CustomerDescriptiveName String Attribute Client Name Client Name for the AudiencePerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AudiencePerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the AudiencePerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AudiencePerformance report.
FinalUrls String Attribute Final URL Final URL for the AudiencePerformance report.
Id Long Attribute Criterion ID Criterion ID for the AudiencePerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the AudiencePerformance report.
Status String Attribute Audience State Audience State for the AudiencePerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AudiencePerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AudiencePerformance report.
UserListName String Attribute User List Name User List Name for the AudiencePerformance report.
AdGroupId Long Segment Ad Group ID Ad Group ID for the AudiencePerformance report.
AdGroupName String Segment Ad Group Ad Group for the AudiencePerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the AudiencePerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segment Network Network for the AudiencePerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AudiencePerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the AudiencePerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AudiencePerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AudiencePerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AudiencePerformance report.
Date Date Segment Day Day for the AudiencePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AudiencePerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the AudiencePerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AudiencePerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the AudiencePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AudiencePerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AudiencePerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AudiencePerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the AudiencePerformance report.
Year Integer Segment Year Year for the AudiencePerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AudiencePerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AudiencePerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AudiencePerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AudiencePerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AudiencePerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AudiencePerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AudiencePerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AudiencePerformance report.
AllConversions Double Metric All Conv All Conv for the AudiencePerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AudiencePerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AudiencePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AudiencePerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AudiencePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AudiencePerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AudiencePerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AudiencePerformance report.
Clicks Long Metric Clicks Clicks for the AudiencePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AudiencePerformance report.
Conversions Double Metric Conversions Conversions for the AudiencePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AudiencePerformance report.
Cost Decimal Metric Cost Cost for the AudiencePerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AudiencePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AudiencePerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AudiencePerformance report.
Ctr Double Metric CTR CTR for the AudiencePerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AudiencePerformance report.
Engagements Long Metric Engagements Engagements for the AudiencePerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AudiencePerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AudiencePerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AudiencePerformance report.
Impressions Long Metric Impressions Impressions for the AudiencePerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AudiencePerformance report.
Interactions Long Metric Interactions Interactions for the AudiencePerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AudiencePerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AudiencePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AudiencePerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AudiencePerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AudiencePerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AudiencePerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AudiencePerformance report.
VideoViewRate Double Metric View Rate View Rate for the AudiencePerformance report.
VideoViews Long Metric Views Views for the AudiencePerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AudiencePerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
AutomaticPlacementsPerformance

The Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AutomaticPlacementsPerformance report.
AccountDescriptiveName String Attribute Account Account for the AutomaticPlacementsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AutomaticPlacementsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AutomaticPlacementsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AutomaticPlacementsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the AutomaticPlacementsPerformance report.
CampaignName String Attribute Campaign Campaign for the AutomaticPlacementsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaParameters String Attribute URL URL for the AutomaticPlacementsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AutomaticPlacementsPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the AutomaticPlacementsPerformance report.
Domain String Attribute Domain Domain for the AutomaticPlacementsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AutomaticPlacementsPerformance report.
IsBidOnPath String Attribute Added Added for the AutomaticPlacementsPerformance report.
IsPathExcluded String Attribute Excluded Excluded for the AutomaticPlacementsPerformance report.
AdFormat String Segment Ad Type Ad Type for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segment Network Network for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the AutomaticPlacementsPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the AutomaticPlacementsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AutomaticPlacementsPerformance report.
Date Date Segment Day Day for the AutomaticPlacementsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AutomaticPlacementsPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
ExternalConversionSource String Segment Conversion Source Conversion Source for the AutomaticPlacementsPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
IsAutoOptimized Boolean Segment Targeting Mode Targeting Mode for the AutomaticPlacementsPerformance report.
Month String Segment Month Month for the AutomaticPlacementsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AutomaticPlacementsPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the AutomaticPlacementsPerformance report.
Week String Segment Week Week for the AutomaticPlacementsPerformance report.
Year Integer Segment Year Year for the AutomaticPlacementsPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AutomaticPlacementsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AutomaticPlacementsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AutomaticPlacementsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AutomaticPlacementsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AutomaticPlacementsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AutomaticPlacementsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AutomaticPlacementsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AutomaticPlacementsPerformance report.
AllConversions Double Metric All Conv All Conv for the AutomaticPlacementsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AutomaticPlacementsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AutomaticPlacementsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AutomaticPlacementsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AutomaticPlacementsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AutomaticPlacementsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AutomaticPlacementsPerformance report.
Clicks Long Metric Clicks Clicks for the AutomaticPlacementsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AutomaticPlacementsPerformance report.
Conversions Double Metric Conversions Conversions for the AutomaticPlacementsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AutomaticPlacementsPerformance report.
Cost Decimal Metric Cost Cost for the AutomaticPlacementsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AutomaticPlacementsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AutomaticPlacementsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AutomaticPlacementsPerformance report.
Ctr Double Metric CTR CTR for the AutomaticPlacementsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AutomaticPlacementsPerformance report.
Engagements Long Metric Engagements Engagements for the AutomaticPlacementsPerformance report.
Impressions Long Metric Impressions Impressions for the AutomaticPlacementsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AutomaticPlacementsPerformance report.
Interactions Long Metric Interactions Interactions for the AutomaticPlacementsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AutomaticPlacementsPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AutomaticPlacementsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AutomaticPlacementsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AutomaticPlacementsPerformance report.
VideoViews Long Metric Views Views for the AutomaticPlacementsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AutomaticPlacementsPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
BidGoalPerformance

The Bid Goal Performance report includes statistics for your bid strategies.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the BidGoalPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the BidGoalPerformance report.
Id Long Attribute Bid Strategy ID Bid Strategy ID for the BidGoalPerformance report.
Name String Attribute Bid Strategy Name Bid Strategy Name for the BidGoalPerformance report.
PageOnePromotedBidCeiling Decimal Attribute Bid Limit (Target Search Page Location) Bid Limit (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedBidChangesForRaisesOnly Boolean Attribute Bid Automation (Target Search Page Location) Bid Automation (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedBidModifier Double Attribute Bid Adjustment (Target Search Page Location) Bid Adjustment (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedRaiseBidWhenBudgetConstrained Boolean Attribute Limited Budgets (Target Search Page Location) Limited Budgets (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedRaiseBidWhenLowQualityScore Boolean Attribute Low Quality Keywords (Target Search Page Location) Low Quality Keywords (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedStrategyGoal String Attribute Location (Target Search Page Location) Location (Target Search Page Location) for the BidGoalPerformance report.
Status String Attribute State State for the BidGoalPerformance report. The allowed values are ENABLED, REMOVED, UNKNOWN.
TargetCpa Decimal Attribute Target CPA Target CPA for the BidGoalPerformance report.
TargetCpaMaxCpcBidCeiling Decimal Attribute Upper Bid Limit (Target CPA) Upper Bid Limit (Target CPA) for the BidGoalPerformance report.
TargetCpaMaxCpcBidFloor Decimal Attribute Lower Bid Limit (Target CPA) Lower Bid Limit (Target CPA) for the BidGoalPerformance report.
TargetOutrankShare Double Attribute Target Outranking Share Target Outranking Share for the BidGoalPerformance report.
TargetOutrankShareBidChangesForRaisesOnly Boolean Attribute Bid Automation (Target Outranking Share) Bid Automation (Target Outranking Share) for the BidGoalPerformance report.
TargetOutrankShareCompetitorDomain String Attribute Competitor Domain (Target Outranking Share) Competitor Domain (Target Outranking Share) for the BidGoalPerformance report.
TargetOutrankShareMaxCpcBidCeiling Decimal Attribute Upper Max Cpc Bid Limit (Target Outranking Share) Upper Max Cpc Bid Limit (Target Outranking Share) for the BidGoalPerformance report.
TargetOutrankShareRaiseBidWhenLowQualityScore Boolean Attribute Low Quality Keywords (Target Outranking Share) Low Quality Keywords (Target Outranking Share) for the BidGoalPerformance report.
TargetRoas Double Attribute Target ROAS Target ROAS for the BidGoalPerformance report.
TargetRoasBidCeiling Decimal Attribute Upper Bid Limit (Target ROAS) Upper Bid Limit (Target ROAS) for the BidGoalPerformance report.
TargetRoasBidFloor Decimal Attribute Lower Bid Limit (Target ROAS) Lower Bid Limit (Target ROAS) for the BidGoalPerformance report.
TargetSpendBidCeiling Decimal Attribute Bid Limit (Maximize Clicks) Bid Limit (Maximize Clicks) for the BidGoalPerformance report.
TargetSpendSpendTarget Decimal Attribute Target Spend (Maximize Clicks) Target Spend (Maximize Clicks) for the BidGoalPerformance report.
Type String Attribute Bid Strategy Type Bid Strategy Type for the BidGoalPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the BidGoalPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the BidGoalPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the BidGoalPerformance report.
Date Date Segment Day Day for the BidGoalPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the BidGoalPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the BidGoalPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the BidGoalPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segment Hour Of Day Hour Of Day for the BidGoalPerformance report.
Month String Segment Month Month for the BidGoalPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the BidGoalPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the BidGoalPerformance report.
Week String Segment Week Week for the BidGoalPerformance report.
Year Integer Segment Year Year for the BidGoalPerformance report.
AdGroupCount Integer Metric Ad Groups Ad Groups for the BidGoalPerformance report.
AdGroupCriteriaCount Integer Metric Keywords Keywords for the BidGoalPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the BidGoalPerformance report.
AllConversions Double Metric All Conv All Conv for the BidGoalPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the BidGoalPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the BidGoalPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the BidGoalPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the BidGoalPerformance report.
CampaignCount Integer Metric Campaigns Campaigns for the BidGoalPerformance report.
Clicks Long Metric Clicks Clicks for the BidGoalPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the BidGoalPerformance report.
Conversions Double Metric Conversions Conversions for the BidGoalPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the BidGoalPerformance report.
Cost Decimal Metric Cost Cost for the BidGoalPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the BidGoalPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the BidGoalPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the BidGoalPerformance report.
Ctr Double Metric CTR CTR for the BidGoalPerformance report.
Impressions Long Metric Impressions Impressions for the BidGoalPerformance report.
NonRemovedAdGroupCount Long Metric Non-Removed Ad Groups Non-Removed Ad Groups for the BidGoalPerformance report.
NonRemovedAdGroupCriteriaCount Long Metric Non-Removed Keywords Non-Removed Keywords for the BidGoalPerformance report.
NonRemovedCampaignCount Long Metric Non-Removed Campaigns Non-Removed Campaigns for the BidGoalPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the BidGoalPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the BidGoalPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the BidGoalPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
BudgetPerformance

The Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the BudgetPerformance report.
Amount Decimal Attribute Budget Budget for the BudgetPerformance report.
BudgetId Long Attribute Budget ID Budget ID for the BudgetPerformance report.
BudgetName String Attribute Budget Name Budget Name for the BudgetPerformance report.
BudgetReferenceCount Integer Attribute # Campaigns # Campaigns for the BudgetPerformance report.
BudgetStatus String Attribute Budget State Budget State for the BudgetPerformance report. The allowed values are ENABLED, REMOVED, UNKNOWN.
DeliveryMethod String Attribute Delivery Method Delivery Method for the BudgetPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the BudgetPerformance report.
HasRecommendedBudget Boolean Attribute Has Recommended Budget Has Recommended Budget for the BudgetPerformance report.
IsBudgetExplicitlyShared Boolean Attribute Explicitly Shared Explicitly Shared for the BudgetPerformance report.
Period String Attribute Budget Period Budget Period for the BudgetPerformance report.
RecommendedBudgetAmount Decimal Attribute Recommended Budget Amount Recommended Budget Amount for the BudgetPerformance report.
TotalAmount Decimal Attribute Total Budget Amount Total Budget Amount for the BudgetPerformance report.
AssociatedCampaignId Long Segment Campaign ID Campaign ID for the BudgetPerformance report.
AssociatedCampaignName String Segment Campaign Campaign for the BudgetPerformance report.
AssociatedCampaignStatus String Segment Campaign State Campaign State for the BudgetPerformance report. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN.
BudgetCampaignAssociationStatus String Segment Budget Usage Budget Usage for the BudgetPerformance report. The allowed values are ENABLED, REMOVED, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the BudgetPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the BudgetPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the BudgetPerformance report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the BudgetPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the BudgetPerformance report.
AllConversions Double Metric All Conv All Conv for the BudgetPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the BudgetPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the BudgetPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the BudgetPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the BudgetPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the BudgetPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the BudgetPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the BudgetPerformance report.
Clicks Long Metric Clicks Clicks for the BudgetPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the BudgetPerformance report.
Conversions Double Metric Conversions Conversions for the BudgetPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the BudgetPerformance report.
Cost Decimal Metric Cost Cost for the BudgetPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the BudgetPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the BudgetPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the BudgetPerformance report.
Ctr Double Metric CTR CTR for the BudgetPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the BudgetPerformance report.
Engagements Long Metric Engagements Engagements for the BudgetPerformance report.
Impressions Long Metric Impressions Impressions for the BudgetPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the BudgetPerformance report.
Interactions Long Metric Interactions Interactions for the BudgetPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyClicks Long Metric Estimated Change In Weekly Clicks At Recommended Budget Estimated Change In Weekly Clicks At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyCost Decimal Metric Estimated Change In Weekly Cost At Recommended Budget Estimated Change In Weekly Cost At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyInteractions Long Metric Estimated Change In Weekly Interactions At Recommended Budget Estimated Change In Weekly Interactions At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyViews Long Metric Estimated Change In Weekly Views At Recommended Budget Estimated Change In Weekly Views At Recommended Budget for the BudgetPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the BudgetPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the BudgetPerformance report.
VideoViewRate Double Metric View Rate View Rate for the BudgetPerformance report.
VideoViews Long Metric Views Views for the BudgetPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the BudgetPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CallMetricsCallDetails

The Call Metrics Call Details report includes call details for your call extension including call duration and the caller's area code.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CallMetricsCallDetails report.
AccountDescriptiveName String Attribute Account Account for the CallMetricsCallDetails report.
AccountTimeZone String Attribute Time Zone Time Zone for the CallMetricsCallDetails report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CallMetricsCallDetails report.
AdGroupName String Attribute Ad Group Ad Group for the CallMetricsCallDetails report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CallMetricsCallDetails report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CallDuration Long Attribute Duration (seconds) Duration (seconds) for the CallMetricsCallDetails report.
CallEndTime Long Attribute End Time End Time for the CallMetricsCallDetails report.
CallerCountryCallingCode String Attribute Caller Country Code Caller Country Code for the CallMetricsCallDetails report.
CallerNationalDesignatedCode String Attribute Caller Area Code Caller Area Code for the CallMetricsCallDetails report.
CallStartTime Long Attribute Start Time Start Time for the CallMetricsCallDetails report.
CallStatus String Attribute Status Status for the CallMetricsCallDetails report. The allowed values are RECEIVED, MISSED, UNKNOWN.
CallTrackingDisplayLocation String Attribute Call Source Call Source for the CallMetricsCallDetails report. The allowed values are UNKNOWN, AD, LANDING_PAGE.
CallType String Attribute Call Type Call Type for the CallMetricsCallDetails report. The allowed values are GOOGLE_SEARCH, HIGH_END_MOBILE_SEARCH, UNKNOWN.
CampaignId Long Attribute Campaign ID Campaign ID for the CallMetricsCallDetails report.
CampaignName String Attribute Campaign Campaign for the CallMetricsCallDetails report.
CampaignStatus String Attribute Campaign State Campaign State for the CallMetricsCallDetails report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the CallMetricsCallDetails report.
Date Date Attribute Day Day for the CallMetricsCallDetails report.
DayOfWeek String Attribute Day Of Week Day Of Week for the CallMetricsCallDetails report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CallMetricsCallDetails report.
HourOfDay Integer Attribute Hour Of Day Hour Of Day for the CallMetricsCallDetails report.
Month String Attribute Month Month for the CallMetricsCallDetails report.
MonthOfYear String Attribute Month Of Year Month Of Year for the CallMetricsCallDetails report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Attribute Quarter Quarter for the CallMetricsCallDetails report.
Week String Attribute Week Week for the CallMetricsCallDetails report.
Year Integer Attribute Year Year for the CallMetricsCallDetails report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignAdScheduleTarget

The Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignAdScheduleTarget report.
AccountDescriptiveName String Attribute Account Account for the CampaignAdScheduleTarget report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignAdScheduleTarget report.
BidModifier Double Attribute Bid Adj Bid Adj for the CampaignAdScheduleTarget report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignAdScheduleTarget report.
CampaignName String Attribute Campaign Campaign for the CampaignAdScheduleTarget report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignAdScheduleTarget report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignAdScheduleTarget report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignAdScheduleTarget report.
Id Long Attribute Ad Schedule Ad Schedule for the CampaignAdScheduleTarget report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignAdScheduleTarget report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the CampaignAdScheduleTarget report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignAdScheduleTarget report.
Date Date Segment Day Day for the CampaignAdScheduleTarget report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignAdScheduleTarget report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the CampaignAdScheduleTarget report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignAdScheduleTarget report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the CampaignAdScheduleTarget report.
Week String Segment Week Week for the CampaignAdScheduleTarget report.
Year Integer Segment Year Year for the CampaignAdScheduleTarget report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignAdScheduleTarget report.
AllConversions Double Metric All Conv All Conv for the CampaignAdScheduleTarget report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignAdScheduleTarget report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignAdScheduleTarget report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignAdScheduleTarget report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignAdScheduleTarget report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignAdScheduleTarget report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignAdScheduleTarget report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignAdScheduleTarget report.
Clicks Long Metric Clicks Clicks for the CampaignAdScheduleTarget report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignAdScheduleTarget report.
Conversions Double Metric Conversions Conversions for the CampaignAdScheduleTarget report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignAdScheduleTarget report.
Cost Decimal Metric Cost Cost for the CampaignAdScheduleTarget report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignAdScheduleTarget report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignAdScheduleTarget report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignAdScheduleTarget report.
Ctr Double Metric CTR CTR for the CampaignAdScheduleTarget report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignAdScheduleTarget report.
Engagements Long Metric Engagements Engagements for the CampaignAdScheduleTarget report.
Impressions Long Metric Impressions Impressions for the CampaignAdScheduleTarget report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignAdScheduleTarget report.
Interactions Long Metric Interactions Interactions for the CampaignAdScheduleTarget report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignAdScheduleTarget report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignAdScheduleTarget report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignAdScheduleTarget report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CampaignAdScheduleTarget report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CampaignAdScheduleTarget report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CampaignAdScheduleTarget report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CampaignAdScheduleTarget report.
VideoViewRate Double Metric View Rate View Rate for the CampaignAdScheduleTarget report.
VideoViews Long Metric Views Views for the CampaignAdScheduleTarget report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignAdScheduleTarget report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignCriteria

The Campaign Criteria report is a structure report that allows you to efficiently retrieve campaign-level criteria.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignCriteria report.
AccountDescriptiveName String Attribute Account Account for the CampaignCriteria report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignCriteria report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignCriteria report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignCriteria report.
CampaignName String Attribute Campaign Campaign for the CampaignCriteria report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignCriteria report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Attribute Criterion Criterion for the CampaignCriteria report.
CriteriaType String Attribute Criteria Type Criteria Type for the CampaignCriteria report. The allowed values are CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATFORM, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignCriteria report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignCriteria report.
Id Long Attribute Criterion ID Criterion ID for the CampaignCriteria report.
IsNegative Boolean Attribute Is Negative Is Negative for the CampaignCriteria report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignCriterionBidLandscape

The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.

Columns
Name Type Behavior DisplayName Description
CampaignId Long ID of the campaign that contains the criterion with which this bid landscape is associated.
StartDate String First day on which this landscape is based. Typically, it could be up to a week ago.
EndDate String Last day on which this landscape is based.
CriterionId Long ID of the criterion associated with this landscape.
Clicks Long Estimated number of clicks at this bid.
Cost Long Estimated cost at this bid.
Impressions Long Estimated number of impressions at this bid.
PromotedImpressions Long Estimated number of promoted impressions.
RequiredBudget Long Required daily budget to achieve the predicted stats at this bid.
BidModifier Double The bid modifier value of this point.
TotalLocalImpressions Long Estimated total impressions for all devices in mobile bid modifier landscape.
TotalLocalClicks Long Estimated total clicks for all devices in mobile bid modifier landscape.
TotalLocalCost Long Estimated total cost for all devices in mobile bid modifier landscape.
TotalLocalPromotedImpressions Long Estimated total promoted impressions for all devices in mobile bid modifier landscape.
CampaignGroupPerformance

The Campaign Group Performance report includes the overall performance statistics of campaigns that you have included in campaign groups. Statistics are aggregated by default at the campaign group level.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
Id Long Attribute Campaign Group ID Campaign Group ID for the CampaignGroupPerformance report.
Name String Attribute Campaign Group Name Campaign Group Name for the CampaignGroupPerformance report.
Status String Attribute Campaign Group Status Campaign Group Status for the CampaignGroupPerformance report. The allowed values are UNKNOWN, ENABLED, REMOVED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignGroupPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the CampaignGroupPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignGroupPerformance report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignGroupPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CampaignGroupPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CampaignGroupPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CampaignGroupPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CampaignGroupPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CampaignGroupPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CampaignGroupPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CampaignGroupPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignGroupPerformance report.
AllConversions Double Metric All Conv All Conv for the CampaignGroupPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignGroupPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignGroupPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignGroupPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignGroupPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignGroupPerformance report.
Conversions Double Metric Conversions Conversions for the CampaignGroupPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignGroupPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignGroupPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignGroupPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CampaignGroupPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignGroupPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CampaignGroupPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CampaignGroupPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignGroupPerformance report.
Engagements Long Metric Engagements Engagements for the CampaignGroupPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignGroupPerformance report.
Interactions Long Metric Interactions Interactions for the CampaignGroupPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignGroupPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignGroupPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CampaignGroupPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CampaignGroupPerformance report.
VideoViews Long Metric Views Views for the CampaignGroupPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignGroupPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignLocationTarget

The Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignLocationTarget report.
AccountDescriptiveName String Attribute Account Account for the CampaignLocationTarget report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignLocationTarget report.
BidModifier Double Attribute Bid Adj Bid Adj for the CampaignLocationTarget report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignLocationTarget report.
CampaignName String Attribute Campaign Campaign for the CampaignLocationTarget report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignLocationTarget report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignLocationTarget report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignLocationTarget report.
Id Long Attribute Location Location for the CampaignLocationTarget report.
IsNegative Boolean Attribute Is Negative Is Negative for the CampaignLocationTarget report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignLocationTarget report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the CampaignLocationTarget report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignLocationTarget report.
Date Date Segment Day Day for the CampaignLocationTarget report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignLocationTarget report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the CampaignLocationTarget report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignLocationTarget report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the CampaignLocationTarget report.
Week String Segment Week Week for the CampaignLocationTarget report.
Year Integer Segment Year Year for the CampaignLocationTarget report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignLocationTarget report.
AllConversions Double Metric All Conv All Conv for the CampaignLocationTarget report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignLocationTarget report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignLocationTarget report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignLocationTarget report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignLocationTarget report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignLocationTarget report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignLocationTarget report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignLocationTarget report.
Clicks Long Metric Clicks Clicks for the CampaignLocationTarget report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignLocationTarget report.
Conversions Double Metric Conversions Conversions for the CampaignLocationTarget report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignLocationTarget report.
Cost Decimal Metric Cost Cost for the CampaignLocationTarget report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignLocationTarget report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignLocationTarget report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignLocationTarget report.
Ctr Double Metric CTR CTR for the CampaignLocationTarget report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignLocationTarget report.
Engagements Long Metric Engagements Engagements for the CampaignLocationTarget report.
Impressions Long Metric Impressions Impressions for the CampaignLocationTarget report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignLocationTarget report.
Interactions Long Metric Interactions Interactions for the CampaignLocationTarget report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignLocationTarget report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignLocationTarget report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignLocationTarget report.
VideoViewRate Double Metric View Rate View Rate for the CampaignLocationTarget report.
VideoViews Long Metric Views Views for the CampaignLocationTarget report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignLocationTarget report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignNegativeKeywordsPerformance

Although negative keywords do not hold statistics, you can use this structured report to efficiently retrieve attributes of keyword-based NegativeCampaignCriterion objects.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativeKeywordsPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativeKeywordsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativeKeywordsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativeKeywordsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativeKeywordsPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativeKeywordsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativeKeywordsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Attribute Negative Keyword Negative Keyword for the CampaignNegativeKeywordsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativeKeywordsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativeKeywordsPerformance report.
Id Long Attribute Keyword ID Keyword ID for the CampaignNegativeKeywordsPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the CampaignNegativeKeywordsPerformance report.
KeywordMatchType String Attribute Match Type Match Type for the CampaignNegativeKeywordsPerformance report. The allowed values are EXACT, PHRASE, BROAD.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignNegativeLocations

Although negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativeLocations report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativeLocations report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativeLocations report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativeLocations report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativeLocations report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativeLocations report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativeLocations report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativeLocations report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativeLocations report.
Id Long Attribute Location Location for the CampaignNegativeLocations report.
IsNegative Boolean Attribute Is Negative Is Negative for the CampaignNegativeLocations report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignNegativePlacementsPerformance

Although negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativePlacementsPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativePlacementsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativePlacementsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativePlacementsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativePlacementsPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativePlacementsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativePlacementsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Criteria String Attribute Exclusion Exclusion for the CampaignNegativePlacementsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativePlacementsPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the CampaignNegativePlacementsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativePlacementsPerformance report.
Id Long Attribute Keyword ID Keyword ID for the CampaignNegativePlacementsPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the CampaignNegativePlacementsPerformance report.
KeywordMatchType String Attribute Match Type Match Type for the CampaignNegativePlacementsPerformance report. The allowed values are EXACT, PHRASE, BROAD.
VerticalId Long Attribute Vertical ID Vertical ID for the CampaignNegativePlacementsPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CampaignPerformance

The Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query. For example, the following query uses Device instead of the default Date segment to query Campaign Performance data:

SELECT CampaignId, CampaignName, Device, Clicks, ConversionRate, Impressions FROM CampaignPerformance

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API. For example, this query will return only Campaigns that are enabled (which is the default behavior in the AdWords console) with greater than 100 impressions:

SELECT CampaignName, CampaignStatus, Impressions FROM CampaignPerformance WHERE CampaignStatus='ENABLED' AND Impressions > 100
Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignPerformance report.
AdvertisingChannelSubType String Attribute Advertising Sub Channel Advertising Sub Channel for the CampaignPerformance report. The allowed values are UNKNOWN, SEARCH_MOBILE_APP, DISPLAY_MOBILE_APP, SEARCH_EXPRESS, DISPLAY_EXPRESS, UNIVERSAL_APP_CAMPAIGN, DISPLAY_SMART_CAMPAIGN, SHOPPING_GOAL_OPTIMIZED_ADS, DISPLAY_GMAIL_AD.
AdvertisingChannelType String Attribute Advertising Channel Advertising Channel for the CampaignPerformance report. The allowed values are UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.
Amount Decimal Attribute Budget Budget for the CampaignPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the CampaignPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the CampaignPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the CampaignPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BudgetId Long Attribute Budget ID Budget ID for the CampaignPerformance report.
CampaignDesktopBidModifier Double Attribute Desktop Bid Adj Desktop Bid Adj for the CampaignPerformance report.
CampaignGroupId Long Attribute Campaign Group ID Campaign Group ID for the CampaignPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignPerformance report.
CampaignMobileBidModifier Double Attribute Mobile Bid Adj Mobile Bid Adj for the CampaignPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignTabletBidModifier Double Attribute Tablet Bid Adj Tablet Bid Adj for the CampaignPerformance report.
CampaignTrialType String Attribute Campaign Trial Type Campaign Trial Type for the CampaignPerformance report. The allowed values are UNKNOWN, BASE, DRAFT, TRIAL.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the CampaignPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignPerformance report.
EndDate Date Attribute End Date End Date for the CampaignPerformance report.
EnhancedCpcEnabled Boolean Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the CampaignPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the CampaignPerformance report.
HasRecommendedBudget Boolean Attribute Has Recommended Budget Has Recommended Budget for the CampaignPerformance report.
IsBudgetExplicitlyShared Boolean Attribute Budget Explicitly Shared Budget Explicitly Shared for the CampaignPerformance report.
LabelIds String Attribute Label IDs Label IDs for the CampaignPerformance report.
Labels String Attribute Labels Labels for the CampaignPerformance report.
MaximizeConversionValueTargetRoas Double Attribute Target ROAS (Maximize Conversion Value) Target ROAS (Maximize Conversion Value) for the CampaignPerformance report.
Period String Attribute Budget Period Budget Period for the CampaignPerformance report.
RecommendedBudgetAmount Decimal Attribute Recommended Budget Amount Recommended Budget Amount for the CampaignPerformance report.
ServingStatus String Attribute Campaign Serving Status Campaign Serving Status for the CampaignPerformance report. The allowed values are SERVING, NONE, ENDED, PENDING, SUSPENDED.
StartDate Date Attribute Start Date Start Date for the CampaignPerformance report.
TotalAmount Decimal Attribute Total Budget Amount Total Budget Amount for the CampaignPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the CampaignPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the CampaignPerformance report.
AdNetworkType1 String Segment Network Network for the CampaignPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CampaignPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the CampaignPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the CampaignPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionAttributionEventType String Segment Ad Event Type Ad Event Type for the CampaignPerformance report. The allowed values are UNKNOWN, IMPRESSION, INTERACTION.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the CampaignPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the CampaignPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignPerformance report.
Date Date Segment Day Day for the CampaignPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the CampaignPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the CampaignPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
HourOfDay Integer Segment Hour Of Day Hour Of Day for the CampaignPerformance report.
Month String Segment Month Month for the CampaignPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the CampaignPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the CampaignPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the CampaignPerformance report.
Year Integer Segment Year Year for the CampaignPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CampaignPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CampaignPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CampaignPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CampaignPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CampaignPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CampaignPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CampaignPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignPerformance report.
AllConversions Double Metric All Conv All Conv for the CampaignPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignPerformance report.
AverageFrequency Double Metric Avg Impr Freq Per Cookie Avg Impr Freq Per Cookie for the CampaignPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the CampaignPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the CampaignPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the CampaignPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the CampaignPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the CampaignPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the CampaignPerformance report.
Clicks Long Metric Clicks Clicks for the CampaignPerformance report.
ContentBudgetLostImpressionShare Double Metric Content Lost IS (budget) Content Lost IS (budget) for the CampaignPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the CampaignPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the CampaignPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignPerformance report.
Conversions Double Metric Conversions Conversions for the CampaignPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignPerformance report.
Cost Decimal Metric Cost Cost for the CampaignPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CampaignPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignPerformance report.
Ctr Double Metric CTR CTR for the CampaignPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CampaignPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CampaignPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignPerformance report.
Engagements Long Metric Engagements Engagements for the CampaignPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the CampaignPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the CampaignPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the CampaignPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the CampaignPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the CampaignPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the CampaignPerformance report.
ImpressionReach Long Metric Unique Cookies Unique Cookies for the CampaignPerformance report.
Impressions Long Metric Impressions Impressions for the CampaignPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignPerformance report.
Interactions Long Metric Interactions Interactions for the CampaignPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignPerformance report.
InvalidClickRate Double Metric Invalid Click Rate Invalid Click Rate for the CampaignPerformance report.
InvalidClicks Long Metric Invalid Clicks Invalid Clicks for the CampaignPerformance report.
NumOfflineImpressions Long Metric Phone Impressions Phone Impressions for the CampaignPerformance report.
NumOfflineInteractions Long Metric Phone Calls Phone Calls for the CampaignPerformance report.
OfflineInteractionRate Double Metric PTR PTR for the CampaignPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the CampaignPerformance report.
RelativeCtr Double Metric Relative CTR Relative CTR for the CampaignPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the CampaignPerformance report.
SearchBudgetLostImpressionShare Double Metric Search Lost IS (budget) Search Lost IS (budget) for the CampaignPerformance report.
SearchClickShare Double Metric Click Share Click Share for the CampaignPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the CampaignPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the CampaignPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the CampaignPerformance report.
SearchTopImpressionShare Double Metric Search top IS Search Top IS for the CampaignPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CampaignPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CampaignPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CampaignPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CampaignPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CampaignPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CampaignPerformance report.
VideoViews Long Metric Views Views for the CampaignPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignPerformance report.
Campaigns

Service to access details about any campaign.

Table Specific Information

Select

There are two ways you can query Campaigns.

  • The following query returns campaign specified.

    SELECT * FROM [Campaigns] WHERE Id=123456789
    
  • The following query returns all campaigns.

    SELECT * FROM [Campaigns]
    
Columns
Name Type Behavior DisplayName Description
Id [KEY] Long ID of this campaign.
CampaignGroupId Long Id of the campaign group this campaign belongs to.
Name String Name of this campaign.
Status String Status of this campaign.
ServingStatus String Serving status.
StartDate String Date the campaign begins.
EndDate String Date the campaign ends.
AdServingOptimizationStatus String Ad serving optimization status.
AdvertisingChannelType String The primary serving target for ads within this campaign.
AdvertisingChannelSubType String Optional refinement of advertisingChannelType.
CampaignTrialType String Indicates if this campaign is a normal campaign, a draft campaign, or a trial campaign.
BaseCampaignId Long ID of the base campaign of the draft or trial campaign.
TrackingUrlTemplate String URL template for constructing a tracking URL.
FinalUrlSuffix String URL template for appending params to Final URL.
UrlCustomParameters String A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls.
SelectiveOptimization String Selective optimization setting for this campaign, which includes a set of conversion types to optimize this campaign towards.
BudgetId Long A Budget is created using the BudgetService ADD operation and is assigned a BudgetId.
BudgetName String Name of the Budget.
Amount Long Amount of budget in the local currency for the account.
DeliveryMethod String Delivery method for the Budget which determines the rate at which the Budget is spent.
BudgetReferenceCount Int Number of campaigns actively using this budget.
IsBudgetExplicitlyShared Boolean If true, this budget was created with the purpose of sharing this budget across one or more campaigns.
BudgetStatus String Status of the budget.
Eligible Boolean If the campaign is eligible to enter conversion optimizer.
FrequencyCapMaxImpressions Long Maximum number of impressions allowed during the time range by this cap.
TimeUnit String Unit of time the cap is defined at.
Level String The level on which the cap is to be applied (creative/adgroup).
TargetGoogleSearch Boolean Ads will be served with Google.com search results.
TargetSearchNetwork Boolean Ads will be served on partner sites in the Google Search Network
TargetContentNetwork Boolean Ads will be served on specified placements in the Google Display Network.
TargetPartnerSearchNetwork Boolean Ads will be served on the Google Partner Network.
BiddingStrategyId Long Id of the bidding strategy to be associated with the campaign, ad group or ad group criteria.
BiddingStrategyName String Name of the bidding strategy.
BiddingStrategyType String The type of the bidding strategy to be attached.
BiddingStrategySource String Indicates where the bidding strategy is associated i.e. campaign, ad group or ad group criterion.
TargetRoasOverride Double The target return on average spend (ROAS).
VanityPharmaDisplayUrlMode String The display mode for vanity pharma URLs.
VanityPharmaText String The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
BiddingStrategyGoalType String Represents the goal which the bidding strategy of this app campaign should optimize towards.
AppId String A string that uniquely identifies a mobile application.
AppVendor String The vendor, i.e. application store that distributes this specific app.
CampaignSharedSet

The Campaign Shared Set report includes all relationships between SharedSets and campaigns.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the CampaignSharedSet report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignSharedSet report.
CampaignName String Attribute Campaign Campaign for the CampaignSharedSet report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignSharedSet report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignSharedSet report.
SharedSetId Long Attribute Shared Set ID Shared Set ID for the CampaignSharedSet report.
SharedSetName String Attribute Shared Set Name Shared Set Name for the CampaignSharedSet report.
SharedSetType String Attribute Shared Set Type Shared Set Type for the CampaignSharedSet report. The allowed values are NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.
Status String Attribute State State for the CampaignSharedSet report. The allowed values are ENABLED, REMOVED, UNKNOWN.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
ClickPerformance

The Click Performance report includes stats aggregated at each click level, and includes both valid and invalid clicks. The KeywordId field will return any criteria that triggered the click, not just keywords.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Note that this table only supports queries for a specific day within the past 90 days. You will need to set the StartDate and EndDate to the same value in the WHERE clause.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ClickPerformance report.
AdFormat String Attribute Ad Type Ad Type for the ClickPerformance report. The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ClickPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ClickPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ClickPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Attribute Network Network for the ClickPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Attribute Network (with Search Partners) Network (with Search Partners) for the ClickPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdVariationControlTrialArmId Long Attribute Ad Variation Control Trial Arm ID Ad Variation Control Trial Arm ID for the ClickPerformance report.
AdVariationTreatmentTrialArmId Long Attribute Ad Variation Treatment Trial Arm ID Ad Variation Treatment Trial Arm ID for the ClickPerformance report.
AdVariationTrialId Long Attribute Ad Variation Trial ID Ad Variation Trial ID for the ClickPerformance report.
AoiCityCriteriaId Integer Attribute City (Location Of Interest) City (Location Of Interest) for the ClickPerformance report.
AoiCountryCriteriaId Integer Attribute Country Per Territory (Location Of Interest) Country Per Territory (Location Of Interest) for the ClickPerformance report.
AoiMetroCriteriaId Integer Attribute Metro Area (Location Of Interest) Metro Area (Location Of Interest) for the ClickPerformance report.
AoiMostSpecificTargetId Long Attribute Most Specific Location Target (Location Of Interest) Most Specific Location Target (Location Of Interest) for the ClickPerformance report.
AoiRegionCriteriaId Integer Attribute Region (Location Of Interest) Region (Location Of Interest) for the ClickPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ClickPerformance report.
CampaignLocationTargetId Long Attribute Campaign Location Target Campaign Location Target for the ClickPerformance report.
CampaignName String Attribute Campaign Campaign for the ClickPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the ClickPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Clicks Long Attribute Clicks Clicks for the ClickPerformance report.
ClickType String Attribute Click Type Click Type for the ClickPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
CreativeId Long Attribute Ad ID Ad ID for the ClickPerformance report.
CriteriaId Long Attribute Keyword ID Keyword ID for the ClickPerformance report.
CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the ClickPerformance report.
Date Date Attribute Day Day for the ClickPerformance report.
Device String Attribute Device Device for the ClickPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ClickPerformance report.
GclId String Attribute Google Click ID Google Click ID for the ClickPerformance report.
KeywordMatchType String Attribute Match Type Match Type for the ClickPerformance report. The allowed values are UNKNOWN, EXACT, PHRASE, BROAD.
LopCityCriteriaId Integer Attribute City (Physical Location) City (Physical Location) for the ClickPerformance report.
LopCountryCriteriaId Integer Attribute Country Per Territory (Physical Location) Country Per Territory (Physical Location) for the ClickPerformance report.
LopMetroCriteriaId Integer Attribute Metro Area (Physical Location) Metro Area (Physical Location) for the ClickPerformance report.
LopMostSpecificTargetId Long Attribute Most Specific Location Target (Physical Location) Most Specific Location Target (Physical Location) for the ClickPerformance report.
LopRegionCriteriaId Integer Attribute Region (Physical Location) Region (Physical Location) for the ClickPerformance report.
MonthOfYear String Attribute Month Of Year Month Of Year for the ClickPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Page Integer Attribute Page Page for the ClickPerformance report.
Slot String Attribute Top Vs Other Top Vs Other for the ClickPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
UserListId Long Attribute User List ID User List ID for the ClickPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
ConversionTrackers

Service to access details about any conversion tracker.

Table Specific Information

Select

There are two ways you can query ConversionTrackers.

  • The following query returns conversion tracker specified.

    SELECT * FROM [ConversionTrackers] WHERE Id=123456789
    
  • The following query returns all conversion trackers.

    SELECT * FROM [ConversionTrackers]
    
Columns
Name Type Behavior DisplayName Description
Id [KEY] Long ID of this conversion tracker, null when creating a new one.
OriginalConversionTypeId Long The ID of the original conversion type on which this ConversionType is based.
Name String Name of this conversion tracker.
Status String Status of this conversion tracker.
Category String The category of conversion that is being tracked.
GoogleEventSnippet String The event snippet that works with the global site tag to track actions that should be counted as conversions.
GoogleGlobalSiteTag String The global site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain, which will store information about the ad click that brought a user to your website.
DataDrivenModelStatus String The status of the data-driven attribution model for the conversion type.
ConversionTypeOwnerCustomerId Long The external customer ID of the conversion type owner, or 0 if this is a system-defined conversion type.
ViewthroughLookbackWindow Int Lookback window for view-through conversions in days.
CtcLookbackWindow Int The click-through conversion (ctc) lookback window is the maximum number of days between the time a conversion event happens and the previous corresponding ad click.
CountingType String How to count events for this conversion tracker.
DefaultRevenueValue Double The value to use when the tag for this conversion tracker sends conversion events without values.
DefaultRevenueCurrencyCode String The currency code to use when the tag for this conversion tracker sends conversion events without currency codes.
AlwaysUseDefaultRevenueValue Boolean Controls whether conversion event values and currency codes are taken from the tag snippet or from ConversionTracker.defaultRevenueValue and ConversionTracker.defaultRevenueCurrencyCode.
ExcludeFromBidding Boolean Whether this conversion tracker should be excluded from the
AttributionModelType String Attribution models describing how to distribute credit for a particular conversion across potentially many prior interactions.
MostRecentConversionDate String The date of the most recent ad click that led to a conversion of this conversion type.
LastReceivedRequestTime String The last time a conversion tag for this conversion type successfully fired and was seen by AdWords.
ConversionTrackerType String Indicates that this instance is a subtype of ConversionTracker.
PhoneCallDuration Long The phone-call duration (in seconds) after which a conversion should be reported
TrackingCodeType String Tracking code to use for the conversion type.
AppId String App ID of the app conversion tracker.
AppPlatform String App platform of the app conversion tracker.
AppConversionType String The type of AppConversion, which identifies a conversion as being either download or in-app purchase.
AppPostbackUrl String The postback URL.
Snippet String The generated snippet for this conversion tracker.
IsExternallyAttributed Boolean Whether this conversion is using an external attribution model.
CreativeConversion

Free clicks are interactions that take place before a clickthrough for video ads, display ads, product extensions and location extensions, interactions like a Video play or a Get directions.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CreativeConversion report.
AccountDescriptiveName String Attribute Account Account for the CreativeConversion report.
AccountTimeZone String Attribute Time Zone Time Zone for the CreativeConversion report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CreativeConversion report.
AdGroupName String Attribute Ad Group Ad Group for the CreativeConversion report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CreativeConversion report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the CreativeConversion report.
CampaignName String Attribute Campaign Campaign for the CreativeConversion report.
CampaignStatus String Attribute Campaign State Campaign State for the CreativeConversion report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Attribute Ad ID Ad ID for the CreativeConversion report.
CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the CreativeConversion report.
CriteriaTypeName String Attribute Match Type Match Type for the CreativeConversion report.
CriterionId Long Attribute Keyword ID Keyword ID for the CreativeConversion report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CreativeConversion report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CreativeConversion report.
AdNetworkType1 String Segment Network Network for the CreativeConversion report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CreativeConversion report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionTrackerId Long Segment Free Click Type Free Click Type for the CreativeConversion report.
Date Date Segment Day Day for the CreativeConversion report.
DayOfWeek String Segment Day Of Week Day Of Week for the CreativeConversion report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Month String Segment Month Month for the CreativeConversion report.
Quarter String Segment Quarter Quarter for the CreativeConversion report.
Week String Segment Week Week for the CreativeConversion report.
Year Integer Segment Year Year for the CreativeConversion report.
CreativeConversionRate Double Metric Free Click Rate Free Click Rate for the CreativeConversion report.
CreativeConversions Long Metric Free Clicks Free Clicks for the CreativeConversion report.
Impressions Long Metric Impressions Impressions for the CreativeConversion report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CriteriaPerformance

The Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CriteriaPerformance report.
AccountDescriptiveName String Attribute Account Account for the CriteriaPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CriteriaPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CriteriaPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the CriteriaPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CriteriaPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ApprovalStatus String Attribute Approval Status Approval Status for the CriteriaPerformance report. The allowed values are APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the CriteriaPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CriteriaPerformance report.
BidModifier Double Attribute Bid Adj Bid Adj for the CriteriaPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CriteriaPerformance report.
CampaignName String Attribute Campaign Campaign for the CriteriaPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CriteriaPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the CriteriaPerformance report.
CpcBid Decimal Attribute Max CPC Max CPC for the CriteriaPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the CriteriaPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the CriteriaPerformance report.
CpvBid Decimal Attribute Max CPV Max CPV for the CriteriaPerformance report.
CpvBidSource String Attribute Max CPV Source Max CPV Source for the CriteriaPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CreativeQualityScore String Attribute Ad Relevance Ad Relevance for the CriteriaPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Criteria String Attribute Keyword Per Placement Keyword Per Placement for the CriteriaPerformance report.
CriteriaDestinationUrl String Attribute Keyword Per Placement Destination URL Keyword Per Placement Destination URL for the CriteriaPerformance report.
CriteriaType String Attribute Criteria Type Criteria Type for the CriteriaPerformance report. The allowed values are CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATFORM, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.
CustomerDescriptiveName String Attribute Client Name Client Name for the CriteriaPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the CriteriaPerformance report.
EnhancedCpcEnabled Boolean Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the CriteriaPerformance report.
EstimatedAddClicksAtFirstPositionCpc Long Attribute Est Add Clicks Per wk (first Position Bid) Est Add Clicks Per wk (first Position Bid) for the CriteriaPerformance report.
EstimatedAddCostAtFirstPositionCpc Decimal Attribute Est Add Cost Per wk (first Position Bid) Est Add Cost Per wk (first Position Bid) for the CriteriaPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CriteriaPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the CriteriaPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the CriteriaPerformance report.
FinalUrls String Attribute Final URL Final URL for the CriteriaPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the CriteriaPerformance report.
FirstPageCpc String Attribute First Page CPC First Page CPC for the CriteriaPerformance report.
FirstPositionCpc String Attribute First Position CPC First Position CPC for the CriteriaPerformance report.
HasQualityScore Boolean Attribute Has Quality Score Has Quality Score for the CriteriaPerformance report.
Id Long Attribute Keyword ID Keyword ID for the CriteriaPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the CriteriaPerformance report.
LabelIds String Attribute Label IDs Label IDs for the CriteriaPerformance report.
Labels String Attribute Labels Labels for the CriteriaPerformance report.
Parameter String Attribute Dynamic Ad Target Dynamic Ad Target for the CriteriaPerformance report.
PostClickQualityScore String Attribute Landing Page Experience Landing Page Experience for the CriteriaPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
QualityScore Integer Attribute Quality Score Quality Score for the CriteriaPerformance report.
SearchPredictedCtr String Attribute Expected Clickthrough Rate Expected Clickthrough Rate for the CriteriaPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Status String Attribute Keyword Per Placement State Keyword Per Placement State for the CriteriaPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
SystemServingStatus String Attribute Criterion Serving Status Criterion Serving Status for the CriteriaPerformance report. The allowed values are ELIGIBLE, RARELY_SERVED.
TopOfPageCpc String Attribute Top Of Page CPC Top Of Page CPC for the CriteriaPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the CriteriaPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the CriteriaPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the CriteriaPerformance report.
AdNetworkType1 String Segment Network Network for the CriteriaPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CriteriaPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the CriteriaPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the CriteriaPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CriteriaPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the CriteriaPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the CriteriaPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CriteriaPerformance report.
Date Date Segment Day Day for the CriteriaPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the CriteriaPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the CriteriaPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CriteriaPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the CriteriaPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the CriteriaPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the CriteriaPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the CriteriaPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the CriteriaPerformance report.
Year Integer Segment Year Year for the CriteriaPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CriteriaPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CriteriaPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CriteriaPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CriteriaPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CriteriaPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CriteriaPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CriteriaPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CriteriaPerformance report.
AllConversions Double Metric All Conv All Conv for the CriteriaPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CriteriaPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CriteriaPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CriteriaPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CriteriaPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CriteriaPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CriteriaPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the CriteriaPerformance report.
Clicks Long Metric Clicks Clicks for the CriteriaPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CriteriaPerformance report.
Conversions Double Metric Conversions Conversions for the CriteriaPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CriteriaPerformance report.
Cost Decimal Metric Cost Cost for the CriteriaPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CriteriaPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CriteriaPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CriteriaPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CriteriaPerformance report.
Ctr Double Metric CTR CTR for the CriteriaPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CriteriaPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CriteriaPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CriteriaPerformance report.
Engagements Long Metric Engagements Engagements for the CriteriaPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the CriteriaPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the CriteriaPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the CriteriaPerformance report.
Impressions Long Metric Impressions Impressions for the CriteriaPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CriteriaPerformance report.
Interactions Long Metric Interactions Interactions for the CriteriaPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CriteriaPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CriteriaPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CriteriaPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CriteriaPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CriteriaPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CriteriaPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CriteriaPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CriteriaPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CriteriaPerformance report.
VideoViews Long Metric Views Views for the CriteriaPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CriteriaPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
CriterionBidLandscape

The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.

Columns
Name Type Behavior DisplayName Description
CampaignId Long ID of the campaign that contains the criterion with which this bid landscape is associated.
AdGroupId Long ID of the ad group that contains the criterion with which this bid landscape is associated.
StartDate String First day on which this landscape is based. Typically, it could be up to a week ago.
EndDate String Last day on which this landscape is based.
CriterionId Long ID of the criterion associated with this landscape.
Bid Long The bid amount used to estimate this landscape point's data.
Clicks Long Estimated number of clicks at this bid.
Cost Long Estimated cost at this bid.
Impressions Long Estimated number of impressions at this bid.
PromotedImpressions Long Estimated number of promoted impressions.
BiddableConversions Double Estimated number of biddable conversions.
BiddableConversionsValue Double Estimated biddable conversions value.
Customers

Service to access basic details about any customer.

Table Specific Information

Select

There are two ways you can query Customers.

  • The following query returns customer specified.

    SELECT * FROM [Customers] WHERE CustomerID=6101846543
    
  • The following query returns all customers.

    SELECT * FROM [Customers]
    
Columns
Name Type Behavior DisplayName Description
CustomerId [KEY] String Client Customer Id.
CurrencyCode String CurrencyCode of the customer.
DateTimeZone String DateTimeZone of the customer.
DescriptiveName String Name of the Customer.
CanManageClients Boolean Boolean showing if Customer can manage clients.
TestAccount Boolean Boolean showing if the account is a test account.
AutoTaggingEnabled Boolean Boolean shofing if the AutoTagging is enabled.
ParallelTrackingEnabled Boolean Boolean shofing if the ParallellTracking is enabled.
EffectiveConversionTrackingId Long ID of EffectiveConversionTracking.
UsesCrossAccountConversionTracking String Boolean shofing if the UsesCrossAccountConversionTracking is enabled.
Snippet String Snippet.
GoogleGlobalSiteTag String GoogleGlobalSiteTag.
DisplayKeywordPerformance

The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the DisplayKeywordPerformance report.
AccountDescriptiveName String Attribute Account Account for the DisplayKeywordPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the DisplayKeywordPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the DisplayKeywordPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the DisplayKeywordPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the DisplayKeywordPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the DisplayKeywordPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the DisplayKeywordPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the DisplayKeywordPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the DisplayKeywordPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Attribute Campaign ID Campaign ID for the DisplayKeywordPerformance report.
CampaignName String Attribute Campaign Campaign for the DisplayKeywordPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the DisplayKeywordPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the DisplayKeywordPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the DisplayKeywordPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the DisplayKeywordPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpvBid Decimal Attribute Max CPV Max CPV for the DisplayKeywordPerformance report.
CpvBidSource String Attribute Max CPV Source Max CPV Source for the DisplayKeywordPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Keyword Keyword for the DisplayKeywordPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the DisplayKeywordPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the DisplayKeywordPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the DisplayKeywordPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the DisplayKeywordPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the DisplayKeywordPerformance report.
FinalUrls String Attribute Final URL Final URL for the DisplayKeywordPerformance report.
Id Long Attribute Keyword ID Keyword ID for the DisplayKeywordPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the DisplayKeywordPerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the DisplayKeywordPerformance report.
Status String Attribute Keyword State Keyword State for the DisplayKeywordPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the DisplayKeywordPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the DisplayKeywordPerformance report.
AdNetworkType1 String Segment Network Network for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the DisplayKeywordPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the DisplayKeywordPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the DisplayKeywordPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the DisplayKeywordPerformance report.
Date Date Segment Day Day for the DisplayKeywordPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the DisplayKeywordPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the DisplayKeywordPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the DisplayKeywordPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the DisplayKeywordPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the DisplayKeywordPerformance report.
Week String Segment Week Week for the DisplayKeywordPerformance report.
Year Integer Segment Year Year for the DisplayKeywordPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the DisplayKeywordPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the DisplayKeywordPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the DisplayKeywordPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the DisplayKeywordPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the DisplayKeywordPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the DisplayKeywordPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the DisplayKeywordPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the DisplayKeywordPerformance report.
AllConversions Double Metric All Conv All Conv for the DisplayKeywordPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the DisplayKeywordPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the DisplayKeywordPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the DisplayKeywordPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the DisplayKeywordPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the DisplayKeywordPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the DisplayKeywordPerformance report.
Clicks Long Metric Clicks Clicks for the DisplayKeywordPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the DisplayKeywordPerformance report.
Conversions Double Metric Conversions Conversions for the DisplayKeywordPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the DisplayKeywordPerformance report.
Cost Decimal Metric Cost Cost for the DisplayKeywordPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the DisplayKeywordPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the DisplayKeywordPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the DisplayKeywordPerformance report.
Ctr Double Metric CTR CTR for the DisplayKeywordPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the DisplayKeywordPerformance report.
Engagements Long Metric Engagements Engagements for the DisplayKeywordPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the DisplayKeywordPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the DisplayKeywordPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the DisplayKeywordPerformance report.
Impressions Long Metric Impressions Impressions for the DisplayKeywordPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the DisplayKeywordPerformance report.
Interactions Long Metric Interactions Interactions for the DisplayKeywordPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the DisplayKeywordPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the DisplayKeywordPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the DisplayKeywordPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the DisplayKeywordPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the DisplayKeywordPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the DisplayKeywordPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the DisplayKeywordPerformance report.
VideoViewRate Double Metric View Rate View Rate for the DisplayKeywordPerformance report.
VideoViews Long Metric Views Views for the DisplayKeywordPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the DisplayKeywordPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
DisplayTopicsPerformance

The Display Topics Performance report includes all display network statistics aggregated at the topic level, one row per topic.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the DisplayTopicsPerformance report.
AccountDescriptiveName String Attribute Account Account for the DisplayTopicsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the DisplayTopicsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the DisplayTopicsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the DisplayTopicsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the DisplayTopicsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the DisplayTopicsPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the DisplayTopicsPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the DisplayTopicsPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the DisplayTopicsPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the DisplayTopicsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the DisplayTopicsPerformance report.
CampaignName String Attribute Campaign Campaign for the DisplayTopicsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the DisplayTopicsPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the DisplayTopicsPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the DisplayTopicsPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the DisplayTopicsPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Topic Topic for the DisplayTopicsPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the DisplayTopicsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the DisplayTopicsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the DisplayTopicsPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the DisplayTopicsPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the DisplayTopicsPerformance report.
FinalUrls String Attribute Final URL Final URL for the DisplayTopicsPerformance report.
Id Long Attribute Criterion ID Criterion ID for the DisplayTopicsPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the DisplayTopicsPerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the DisplayTopicsPerformance report.
Status String Attribute Topic State Topic State for the DisplayTopicsPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the DisplayTopicsPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the DisplayTopicsPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the DisplayTopicsPerformance report.
AdNetworkType1 String Segment Network Network for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the DisplayTopicsPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the DisplayTopicsPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the DisplayTopicsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the DisplayTopicsPerformance report.
Date Date Segment Day Day for the DisplayTopicsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the DisplayTopicsPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the DisplayTopicsPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the DisplayTopicsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the DisplayTopicsPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the DisplayTopicsPerformance report.
Week String Segment Week Week for the DisplayTopicsPerformance report.
Year Integer Segment Year Year for the DisplayTopicsPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the DisplayTopicsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the DisplayTopicsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the DisplayTopicsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the DisplayTopicsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the DisplayTopicsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the DisplayTopicsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the DisplayTopicsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the DisplayTopicsPerformance report.
AllConversions Double Metric All Conv All Conv for the DisplayTopicsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the DisplayTopicsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the DisplayTopicsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the DisplayTopicsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the DisplayTopicsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the DisplayTopicsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the DisplayTopicsPerformance report.
Clicks Long Metric Clicks Clicks for the DisplayTopicsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the DisplayTopicsPerformance report.
Conversions Double Metric Conversions Conversions for the DisplayTopicsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the DisplayTopicsPerformance report.
Cost Decimal Metric Cost Cost for the DisplayTopicsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the DisplayTopicsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the DisplayTopicsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the DisplayTopicsPerformance report.
Ctr Double Metric CTR CTR for the DisplayTopicsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the DisplayTopicsPerformance report.
Engagements Long Metric Engagements Engagements for the DisplayTopicsPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the DisplayTopicsPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the DisplayTopicsPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the DisplayTopicsPerformance report.
Impressions Long Metric Impressions Impressions for the DisplayTopicsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the DisplayTopicsPerformance report.
Interactions Long Metric Interactions Interactions for the DisplayTopicsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the DisplayTopicsPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the DisplayTopicsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the DisplayTopicsPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the DisplayTopicsPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the DisplayTopicsPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the DisplayTopicsPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the DisplayTopicsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the DisplayTopicsPerformance report.
VideoViews Long Metric Views Views for the DisplayTopicsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the DisplayTopicsPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
FinalUrl

The Final URL report includes all statistics aggregated at the final URL level, one row per final URL. If other segment fields are used, you may get more than one row per final URL.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the FinalUrl report.
AccountDescriptiveName String Attribute Account Account for the FinalUrl report.
AccountTimeZone String Attribute Time Zone Time Zone for the FinalUrl report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the FinalUrl report.
AdGroupName String Attribute Ad Group Ad Group for the FinalUrl report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the FinalUrl report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdvertisingChannelType String Attribute Advertising Channel Advertising Channel for the FinalUrl report. The allowed values are UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.
CampaignId Long Attribute Campaign ID Campaign ID for the FinalUrl report.
CampaignName String Attribute Campaign Campaign for the FinalUrl report.
CampaignStatus String Attribute Campaign State Campaign State for the FinalUrl report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaTypeName String Attribute Match Type Match Type for the FinalUrl report.
CustomerDescriptiveName String Attribute Client Name Client Name for the FinalUrl report.
EffectiveFinalUrl String Attribute Final URL Final URL for the FinalUrl report.
EffectiveTrackingUrlTemplate String Attribute Tracking Template Tracking Template for the FinalUrl report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the FinalUrl report.
AdNetworkType1 String Segment Network Network for the FinalUrl report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the FinalUrl report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the FinalUrl report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the FinalUrl report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the FinalUrl report.
ConversionTypeName String Segment Conversion Name Conversion Name for the FinalUrl report.
CriteriaParameters String Segment Keyword Per Placement Keyword Per Placement for the FinalUrl report.
Date Date Segment Day Day for the FinalUrl report.
DayOfWeek String Segment Day Of Week Day Of Week for the FinalUrl report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the FinalUrl report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the FinalUrl report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the FinalUrl report.
MonthOfYear String Segment Month Of Year Month Of Year for the FinalUrl report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the FinalUrl report.
Slot String Segment Top Vs Other Top Vs Other for the FinalUrl report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the FinalUrl report.
Year Integer Segment Year Year for the FinalUrl report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the FinalUrl report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the FinalUrl report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the FinalUrl report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the FinalUrl report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the FinalUrl report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the FinalUrl report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the FinalUrl report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the FinalUrl report.
AllConversions Double Metric All Conv All Conv for the FinalUrl report.
AllConversionValue Double Metric All Conv Value All Conv Value for the FinalUrl report.
AverageCost Decimal Metric Avg Cost Avg Cost for the FinalUrl report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the FinalUrl report.
AverageCpe Double Metric Avg CPE Avg CPE for the FinalUrl report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the FinalUrl report.
AverageCpv Double Metric Avg CPV Avg CPV for the FinalUrl report.
AveragePosition Double Metric Avg Position Avg Position for the FinalUrl report.
Clicks Long Metric Clicks Clicks for the FinalUrl report.
ConversionRate Double Metric Conv Rate Conv Rate for the FinalUrl report.
Conversions Double Metric Conversions Conversions for the FinalUrl report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the FinalUrl report.
Cost Decimal Metric Cost Cost for the FinalUrl report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the FinalUrl report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the FinalUrl report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the FinalUrl report.
Ctr Double Metric CTR CTR for the FinalUrl report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the FinalUrl report.
Engagements Long Metric Engagements Engagements for the FinalUrl report.
Impressions Long Metric Impressions Impressions for the FinalUrl report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the FinalUrl report.
Interactions Long Metric Interactions Interactions for the FinalUrl report.
InteractionTypes String Metric Interaction Types Interaction Types for the FinalUrl report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the FinalUrl report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the FinalUrl report.
VideoViewRate Double Metric View Rate View Rate for the FinalUrl report.
VideoViews Long Metric Views Views for the FinalUrl report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the FinalUrl report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
GenderPerformance

The Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the GenderPerformance report.
AccountDescriptiveName String Attribute Account Account for the GenderPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the GenderPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the GenderPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the GenderPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the GenderPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the GenderPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the GenderPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the GenderPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the GenderPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the GenderPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the GenderPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the GenderPerformance report.
CampaignName String Attribute Campaign Campaign for the GenderPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the GenderPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the GenderPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the GenderPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the GenderPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the GenderPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Gender Gender for the GenderPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the GenderPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the GenderPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the GenderPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the GenderPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the GenderPerformance report.
FinalUrls String Attribute Final URL Final URL for the GenderPerformance report.
Id Long Attribute Criterion ID Criterion ID for the GenderPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the GenderPerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the GenderPerformance report.
Status String Attribute Gender State Gender State for the GenderPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the GenderPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the GenderPerformance report.
AdNetworkType1 String Segment Network Network for the GenderPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the GenderPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the GenderPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the GenderPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the GenderPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the GenderPerformance report.
Date Date Segment Day Day for the GenderPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the GenderPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the GenderPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the GenderPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the GenderPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the GenderPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the GenderPerformance report.
Week String Segment Week Week for the GenderPerformance report.
Year Integer Segment Year Year for the GenderPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the GenderPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the GenderPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the GenderPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the GenderPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the GenderPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the GenderPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the GenderPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the GenderPerformance report.
AllConversions Double Metric All Conv All Conv for the GenderPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the GenderPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the GenderPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the GenderPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the GenderPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the GenderPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the GenderPerformance report.
Clicks Long Metric Clicks Clicks for the GenderPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the GenderPerformance report.
Conversions Double Metric Conversions Conversions for the GenderPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the GenderPerformance report.
Cost Decimal Metric Cost Cost for the GenderPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the GenderPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the GenderPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the GenderPerformance report.
Ctr Double Metric CTR CTR for the GenderPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the GenderPerformance report.
Engagements Long Metric Engagements Engagements for the GenderPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the GenderPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the GenderPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the GenderPerformance report.
Impressions Long Metric Impressions Impressions for the GenderPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the GenderPerformance report.
Interactions Long Metric Interactions Interactions for the GenderPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the GenderPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the GenderPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the GenderPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the GenderPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the GenderPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the GenderPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the GenderPerformance report.
VideoViewRate Double Metric View Rate View Rate for the GenderPerformance report.
VideoViews Long Metric Views Views for the GenderPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the GenderPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
GeoPerformance

The Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Note that the CountryCriteriaId field is always required in the SELECT columns (SELECT * should automatically account for this.)

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the GeoPerformance report.
AccountDescriptiveName String Attribute Account Account for the GeoPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the GeoPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the GeoPerformance report.
CampaignName String Attribute Campaign Campaign for the GeoPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the GeoPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CityCriteriaId Integer Attribute City City for the GeoPerformance report.
CountryCriteriaId Integer Attribute Country Per Territory Country Per Territory for the GeoPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the GeoPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the GeoPerformance report.
IsTargetingLocation Boolean Attribute Is Targetable Is Targetable for the GeoPerformance report.
MetroCriteriaId Integer Attribute Metro Area Metro Area for the GeoPerformance report.
MostSpecificCriteriaId Long Attribute Most Specific Location Most Specific Location for the GeoPerformance report.
RegionCriteriaId Integer Attribute Region Region for the GeoPerformance report.
AdFormat String Segment Ad Type Ad Type for the GeoPerformance report. The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdGroupId Long Segment Ad Group ID Ad Group ID for the GeoPerformance report.
AdGroupName String Segment Ad Group Ad Group for the GeoPerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the GeoPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segment Network Network for the GeoPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the GeoPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the GeoPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the GeoPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the GeoPerformance report.
Date Date Segment Day Day for the GeoPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the GeoPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the GeoPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the GeoPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
LocationType String Segment Location Type Location Type for the GeoPerformance report. The allowed values are AREA_OF_INTEREST, LOCATION_OF_PRESENCE, UNKNOWN.
Month String Segment Month Month for the GeoPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the GeoPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the GeoPerformance report.
Week String Segment Week Week for the GeoPerformance report.
Year Integer Segment Year Year for the GeoPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the GeoPerformance report.
AllConversions Double Metric All Conv All Conv for the GeoPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the GeoPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the GeoPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the GeoPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the GeoPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the GeoPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the GeoPerformance report.
Clicks Long Metric Clicks Clicks for the GeoPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the GeoPerformance report.
Conversions Double Metric Conversions Conversions for the GeoPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the GeoPerformance report.
Cost Decimal Metric Cost Cost for the GeoPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the GeoPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the GeoPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the GeoPerformance report.
Ctr Double Metric CTR CTR for the GeoPerformance report.
Impressions Long Metric Impressions Impressions for the GeoPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the GeoPerformance report.
Interactions Long Metric Interactions Interactions for the GeoPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the GeoPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the GeoPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the GeoPerformance report.
VideoViewRate Double Metric View Rate View Rate for the GeoPerformance report.
VideoViews Long Metric Views Views for the GeoPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the GeoPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
KeywordlessCategory

The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordlessCategory report.
AccountDescriptiveName String Attribute Account Account for the KeywordlessCategory report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordlessCategory report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordlessCategory report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordlessCategory report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordlessCategory report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the KeywordlessCategory report.
CampaignName String Attribute Campaign Campaign for the KeywordlessCategory report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordlessCategory report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Category0 String Attribute Top Level Categories Top Level Categories for the KeywordlessCategory report.
Category1 String Attribute First Level Sub-categories First Level Sub-categories for the KeywordlessCategory report.
Category2 String Attribute Second Level Sub-categories Second Level Sub-categories for the KeywordlessCategory report.
CriterionId Long Attribute Keyword ID Keyword ID for the KeywordlessCategory report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordlessCategory report.
Domain String Attribute Domain Domain for the KeywordlessCategory report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordlessCategory report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordlessCategory report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the KeywordlessCategory report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordlessCategory report.
Date Date Segment Day Day for the KeywordlessCategory report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordlessCategory report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordlessCategory report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the KeywordlessCategory report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordlessCategory report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the KeywordlessCategory report.
Week String Segment Week Week for the KeywordlessCategory report.
Year Integer Segment Year Year for the KeywordlessCategory report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordlessCategory report.
AllConversions Double Metric All Conv All Conv for the KeywordlessCategory report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordlessCategory report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordlessCategory report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordlessCategory report.
Clicks Long Metric Clicks Clicks for the KeywordlessCategory report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordlessCategory report.
Conversions Double Metric Conversions Conversions for the KeywordlessCategory report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordlessCategory report.
Cost Decimal Metric Cost Cost for the KeywordlessCategory report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordlessCategory report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordlessCategory report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordlessCategory report.
Ctr Double Metric CTR CTR for the KeywordlessCategory report.
Impressions Long Metric Impressions Impressions for the KeywordlessCategory report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordlessCategory report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordlessCategory report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
KeywordlessQuery

The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordlessQuery report.
AccountDescriptiveName String Attribute Account Account for the KeywordlessQuery report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordlessQuery report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordlessQuery report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordlessQuery report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordlessQuery report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the KeywordlessQuery report.
CampaignName String Attribute Campaign Campaign for the KeywordlessQuery report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordlessQuery report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CategoryPaths String Attribute Categories Categories for the KeywordlessQuery report.
CriterionId Long Attribute Keyword ID Keyword ID for the KeywordlessQuery report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordlessQuery report.
Domain String Attribute Domain Domain for the KeywordlessQuery report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordlessQuery report.
Line1 String Attribute Dynamically Generated Headline Dynamically Generated Headline for the KeywordlessQuery report.
Query String Attribute Search Term Search Term for the KeywordlessQuery report.
QueryTargetingStatus String Attribute Added Per Excluded Added Per Excluded for the KeywordlessQuery report. The allowed values are ADDED, EXCLUDED, BOTH, NONE.
Title String Attribute Landing Page Title Landing Page Title for the KeywordlessQuery report.
Url String Attribute URL URL for the KeywordlessQuery report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordlessQuery report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the KeywordlessQuery report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordlessQuery report.
Date Date Segment Day Day for the KeywordlessQuery report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordlessQuery report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordlessQuery report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the KeywordlessQuery report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordlessQuery report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the KeywordlessQuery report.
Week String Segment Week Week for the KeywordlessQuery report.
Year Integer Segment Year Year for the KeywordlessQuery report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordlessQuery report.
AllConversions Double Metric All Conv All Conv for the KeywordlessQuery report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordlessQuery report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordlessQuery report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordlessQuery report.
Clicks Long Metric Clicks Clicks for the KeywordlessQuery report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordlessQuery report.
Conversions Double Metric Conversions Conversions for the KeywordlessQuery report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordlessQuery report.
Cost Decimal Metric Cost Cost for the KeywordlessQuery report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordlessQuery report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordlessQuery report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordlessQuery report.
Ctr Double Metric CTR CTR for the KeywordlessQuery report.
Impressions Long Metric Impressions Impressions for the KeywordlessQuery report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordlessQuery report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordlessQuery report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
KeywordsPerformance

The Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordsPerformance report.
AccountDescriptiveName String Attribute Account Account for the KeywordsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ApprovalStatus String Attribute Approval Status Approval Status for the KeywordsPerformance report. The allowed values are APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the KeywordsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the KeywordsPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the KeywordsPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the KeywordsPerformance report.
BiddingStrategySource String Attribute Bidding Strategy Source Bidding Strategy Source for the KeywordsPerformance report. The allowed values are CAMPAIGN, ADGROUP, CRITERION.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the KeywordsPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Attribute Campaign ID Campaign ID for the KeywordsPerformance report.
CampaignName String Attribute Campaign Campaign for the KeywordsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordsPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ConversionAdjustment Boolean Attribute Conversion Adjustment Conversion Adjustment for the KeywordsPerformance report.
CpcBid Decimal Attribute Max CPC Max CPC for the KeywordsPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the KeywordsPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the KeywordsPerformance report.
CreativeQualityScore String Attribute Ad Relevance Ad Relevance for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Criteria String Attribute Keyword Keyword for the KeywordsPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the KeywordsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordsPerformance report.
EnhancedCpcEnabled Boolean Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the KeywordsPerformance report.
EstimatedAddClicksAtFirstPositionCpc Long Attribute Est Add Clicks Per wk (first Position Bid) Est Add Clicks Per wk (first Position Bid) for the KeywordsPerformance report.
EstimatedAddCostAtFirstPositionCpc Decimal Attribute Est Add Cost Per wk (first Position Bid) Est Add Cost Per wk (first Position Bid) for the KeywordsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordsPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the KeywordsPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the KeywordsPerformance report.
FinalUrls String Attribute Final URL Final URL for the KeywordsPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the KeywordsPerformance report.
FirstPageCpc String Attribute First Page CPC First Page CPC for the KeywordsPerformance report.
FirstPositionCpc String Attribute First Position CPC First Position CPC for the KeywordsPerformance report.
HasQualityScore Boolean Attribute Has Quality Score Has Quality Score for the KeywordsPerformance report.
Id Long Attribute Keyword ID Keyword ID for the KeywordsPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the KeywordsPerformance report.
KeywordMatchType String Attribute Match Type Match Type for the KeywordsPerformance report. The allowed values are EXACT, PHRASE, BROAD.
LabelIds String Attribute Label IDs Label IDs for the KeywordsPerformance report.
Labels String Attribute Labels Labels for the KeywordsPerformance report.
PostClickQualityScore String Attribute Landing Page Experience Landing Page Experience for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
QualityScore Integer Attribute Quality Score Quality Score for the KeywordsPerformance report.
SearchPredictedCtr String Attribute Expected Clickthrough Rate Expected Clickthrough Rate for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
Status String Attribute Keyword State Keyword State for the KeywordsPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
SystemServingStatus String Attribute Criterion Serving Status Criterion Serving Status for the KeywordsPerformance report. The allowed values are ELIGIBLE, RARELY_SERVED.
TopOfPageCpc String Attribute Top Of Page CPC Top Of Page CPC for the KeywordsPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the KeywordsPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the KeywordsPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the KeywordsPerformance report.
AdNetworkType1 String Segment Network Network for the KeywordsPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the KeywordsPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the KeywordsPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the KeywordsPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordsPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the KeywordsPerformance report. The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the KeywordsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordsPerformance report.
Date Date Segment Day Day for the KeywordsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordsPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the KeywordsPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordsPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the KeywordsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordsPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the KeywordsPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the KeywordsPerformance report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the KeywordsPerformance report.
Year Integer Segment Year Year for the KeywordsPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the KeywordsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the KeywordsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the KeywordsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the KeywordsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the KeywordsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the KeywordsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the KeywordsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordsPerformance report.
AllConversions Double Metric All Conv All Conv for the KeywordsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the KeywordsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the KeywordsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the KeywordsPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the KeywordsPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the KeywordsPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the KeywordsPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the KeywordsPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the KeywordsPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the KeywordsPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the KeywordsPerformance report.
Clicks Long Metric Clicks Clicks for the KeywordsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordsPerformance report.
Conversions Double Metric Conversions Conversions for the KeywordsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordsPerformance report.
Cost Decimal Metric Cost Cost for the KeywordsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordsPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the KeywordsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordsPerformance report.
Ctr Double Metric CTR CTR for the KeywordsPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the KeywordsPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the KeywordsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the KeywordsPerformance report.
Engagements Long Metric Engagements Engagements for the KeywordsPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the KeywordsPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the KeywordsPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the KeywordsPerformance report.
HistoricalCreativeQualityScore String Metric Ad Relevance (hist) Ad Relevance (hist) for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalLandingPageQualityScore String Metric Landing Page Experience (hist) Landing Page Experience (hist) for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalQualityScore Integer Metric Qual Score (hist) Qual Score (hist) for the KeywordsPerformance report.
HistoricalSearchPredictedCtr String Metric Expected Clickthrough Rate (hist) Expected Clickthrough Rate (hist) for the KeywordsPerformance report. The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the KeywordsPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the KeywordsPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the KeywordsPerformance report.
Impressions Long Metric Impressions Impressions for the KeywordsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the KeywordsPerformance report.
Interactions Long Metric Interactions Interactions for the KeywordsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the KeywordsPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the KeywordsPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the KeywordsPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the KeywordsPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the KeywordsPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the KeywordsPerformance report.
SearchTopImpressionShare Double Metric Search top IS Search Top IS for the KeywordsPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordsPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the KeywordsPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the KeywordsPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the KeywordsPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the KeywordsPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the KeywordsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the KeywordsPerformance report.
VideoViews Long Metric Views Views for the KeywordsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the KeywordsPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
Label

The Label report is a structure report that lists all labels for your account.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the Label report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the Label report.
LabelId Long Attribute Label ID Label ID for the Label report.
LabelName String Attribute Label Name Label Name for the Label report.
AdGroupCreativesCount Long Metric Ad Group Creatives Count Ad Group Creatives Count for the Label report.
AdGroupCriteriaCount Long Metric Ad Group Criteria Count Ad Group Criteria Count for the Label report.
AdGroupsCount Long Metric Ad Groups Count Ad Groups Count for the Label report.
CampaignsCount Long Metric Campaigns Count Campaigns Count for the Label report.
UserListsCount Long Metric User Lists Count User Lists Count for the Label report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
LandingPage

The Landing Page report includes all statistics aggregated by default by the UnexpandedFinalUrlString, one row per the URL string.

Columns
Name Type Behavior DisplayName Description
AdGroupId Long Attribute Ad Group ID Ad Group ID for the LandingPage report.
AdGroupName String Attribute Ad Group Ad Group for the LandingPage report.
CampaignId Long Attribute Campaign ID Campaign ID for the LandingPage report.
CampaignName String Attribute Campaign Campaign for the LandingPage report.
ExpandedFinalUrlString String Attribute Expanded Landing Page Expanded Landing Page for the LandingPage report.
UnexpandedFinalUrlString String Attribute Landing Page Landing Page for the LandingPage report.
AdNetworkType1 String Segment Network Network for the LandingPage report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the LandingPage report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
Date Date Segment Day Day for the LandingPage report.
DayOfWeek String Segment Day Of Week Day Of Week for the LandingPage report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the LandingPage report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
Month String Segment Month Month for the LandingPage report.
MonthOfYear String Segment Month Of Year Month Of Year for the LandingPage report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the LandingPage report.
Slot String Segment Top Vs Other Top Vs Other for the LandingPage report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the LandingPage report.
Year Integer Segment Year Year for the LandingPage report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the LandingPage report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the LandingPage report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the LandingPage report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the LandingPage report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the LandingPage report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the LandingPage report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the LandingPage report.
AverageCost Decimal Metric Avg Cost Avg Cost for the LandingPage report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the LandingPage report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the LandingPage report.
AveragePosition Double Metric Avg Position Avg Position for the LandingPage report.
Clicks Long Metric Clicks Clicks for the LandingPage report.
ConversionRate Double Metric Conv Rate Conv Rate for the LandingPage report.
Conversions Double Metric Conversions Conversions for the LandingPage report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the LandingPage report.
Cost Decimal Metric Cost Cost for the LandingPage report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the LandingPage report.
Ctr Double Metric CTR CTR for the LandingPage report.
Impressions Long Metric Impressions Impressions for the LandingPage report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the LandingPage report.
Interactions Long Metric Interactions Interactions for the LandingPage report.
InteractionTypes String Metric Interaction Types Interaction Types for the LandingPage report.
PercentageMobileFriendlyClicks Double Metric Mobile-friendly Click Rate Mobile-friendly Click Rate for the LandingPage report.
PercentageValidAcceleratedMobilePagesClicks Double Metric Valid AMP Click Rate Valid AMP Click Rate for the LandingPage report.
SpeedScore Long Metric Mobile Speed Score Mobile Speed Score for the LandingPage report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the LandingPage report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
LocationCriterion

Represents data that encapsulates a location criterion.

Table Specific Information

Select

There is only one way you can query Location Criterions. The LocationName column is required and should be always specified!

  • The following query returns all location criterions that fulfill the condition.

    SELECT * FROM [LocationCriterion] WHERE LocationName='Ontario'
    
Columns
Name Type Behavior DisplayName Description
CriterionId String ID of this criterion.
CriterionType String Indicates that this instance is a subtype of Criterion.
DisplayType String Display type of the location criterion.
TargetingStatus String The targeting status of the location criterion.
CanonicalName String Canonical name of the location criterion.
Reach Long Approximate user population that will be targeted, rounded to the nearest 100.
SearchTerm String Original search term, as specified in the input request for search by name.
CountryCode String This is used as a hint and suggestions are restricted to this country when applicable.
Locale String Preferred locale to be used as a hint for determining the list of locations to return.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
LocationName String Name of the location criterion.
ManagedCustomers

Service to access basic details about any customer.

Table Specific Information

Select

There are two ways you can query ManagedCustomers.

  • The following query returns all customers managed by the specified ParentCustomerID.

    SELECT * FROM [ManagedCustomers] WHERE ParentCustomerID=6101846543
    
  • The following query returns all customers that are on the GoogleAdwords Account.The driver will get all the customers by querying Customers view internally and for each customer will get the ManagedCustomers.

    SELECT * FROM [ManagedCustomers]
    
  • The following query returns all customers that are not hidden on the GoogleAdwords Account.

    SELECT * FROM [ManagedCustomers] WHERE ExcludeHiddenAccounts = true
    
Columns
Name Type Behavior DisplayName Description
ParentCustomerId [KEY] String Management Customer Id.
CustomerId String Client Customer Id.
Name String Name of the Customer.
CanManageClients String Boolean showing if Customer can manage clients.
CurrencyCode String CurrencyCode of the customer.
DateTimeZone String DateTimeZone
TestAccount Boolean Boolean showing if the account is a test account.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ExcludeHiddenAccounts Boolean Name of the place.

Service to access basic details about any customer links.

Table Specific Information

Select

There are two ways you can query ManagedCustomers Links.

  • The following query returns all customers links managed by the specified ParentCustomerID.

    SELECT * FROM [ManagedCustomersLinks] WHERE ParentCustomerID=6101846543
    
  • The following query returns all customers that are on the GoogleAdwords Account.The driver will get all the customers by querying Customers view internally and for each customer will get the ManagedCustomers Links.

    SELECT * FROM [ManagedCustomersLinks]
    
Columns
Name Type Behavior DisplayName Description
ParentCustomerId [KEY] String Management Customer Id.
ManagerCustomerId String linked ManagerCustomer Id.
ClientCustomerId String linked Client Customer Id.
IsHidden Boolean Boolean showing if is hidden.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
CustomerId String Client Customer Id. Used as input for api calling
Name String Name of the Customer. Used as input for api calling
CanManageClients String Boolean showing if Customer can manage clients. Used as input for api calling
CurrencyCode String CurrencyCode of the customer. Used as input for api calling
DateTimeZone String DateTimeZone Used as input for api calling
TestAccount Boolean Boolean showing if the account is a test account. Used as input for api calling
ExcludeHiddenAccounts Boolean Name of the place. Used as input for api calling
MarketplacePerformance

The Marketplace Performance report includes all statistics of ads displayed on the Marketplace, aggregated by default at the account level.

Columns
Name Type Behavior DisplayName Description
AdGroupId Long Attribute Ad Group ID Ad Group ID for the MarketplacePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the MarketplacePerformance report.
Date Date Segment Day Day for the MarketplacePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the MarketplacePerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Month String Segment Month Month for the MarketplacePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the MarketplacePerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the MarketplacePerformance report.
Week String Segment Week Week for the MarketplacePerformance report.
Year Integer Segment Year Year for the MarketplacePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the MarketplacePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the MarketplacePerformance report.
Clicks Long Metric Clicks Clicks for the MarketplacePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the MarketplacePerformance report.
Conversions Double Metric Conversions Conversions for the MarketplacePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the MarketplacePerformance report.
Cost Decimal Metric Cost Cost for the MarketplacePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the MarketplacePerformance report.
Ctr Double Metric CTR CTR for the MarketplacePerformance report.
Impressions Long Metric Impressions Impressions for the MarketplacePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the MarketplacePerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
PaidOrganicQuery

The Paid and Organic Query report provides a holistic view of your search stats across ads and organic listings at the query level. This lets you analyze strengths and gaps in your overall search presence, and gives insight into how your paid and organic search listings work together to connect your business with people searching on Google.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PaidOrganicQuery report.
AccountDescriptiveName String Attribute Account Account for the PaidOrganicQuery report.
AccountTimeZone String Attribute Time Zone Time Zone for the PaidOrganicQuery report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the PaidOrganicQuery report.
AdGroupName String Attribute Ad Group Ad Group for the PaidOrganicQuery report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the PaidOrganicQuery report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the PaidOrganicQuery report.
CampaignName String Attribute Campaign Campaign for the PaidOrganicQuery report.
CampaignStatus String Attribute Campaign State Campaign State for the PaidOrganicQuery report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the PaidOrganicQuery report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PaidOrganicQuery report.
KeywordId Long Attribute Keyword ID Keyword ID for the PaidOrganicQuery report.
KeywordTextMatchingQuery String Attribute Keyword Keyword for the PaidOrganicQuery report.
SearchQuery String Attribute Query Query for the PaidOrganicQuery report.
Date Date Segment Day Day for the PaidOrganicQuery report.
DayOfWeek String Segment Day Of Week Day Of Week for the PaidOrganicQuery report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Month String Segment Month Month for the PaidOrganicQuery report.
MonthOfYear String Segment Month Of Year Month Of Year for the PaidOrganicQuery report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the PaidOrganicQuery report.
QueryMatchType String Segment Match Type Match Type for the PaidOrganicQuery report. The allowed values are AUTO, BROAD, EXACT, EXPANDED, PHRASE.
SerpType String Segment Search Result Type Search Result Type for the PaidOrganicQuery report. The allowed values are UNKNOWN, ADS_ONLY, ORGANIC_ONLY, ADS_AND_ORGANIC.
Week String Segment Week Week for the PaidOrganicQuery report.
Year Integer Segment Year Year for the PaidOrganicQuery report.
AverageCpc Decimal Metric Ad Avg CPC Ad Avg CPC for the PaidOrganicQuery report.
AveragePosition Double Metric Ad Avg Position Ad Avg Position for the PaidOrganicQuery report.
Clicks Long Metric Ad Clicks Ad Clicks for the PaidOrganicQuery report.
CombinedAdsOrganicClicks Long Metric Combined Clicks Combined Clicks for the PaidOrganicQuery report.
CombinedAdsOrganicClicksPerQuery Double Metric Combined Clicks Per Query Combined Clicks Per Query for the PaidOrganicQuery report.
CombinedAdsOrganicQueries Long Metric Combined Queries Combined Queries for the PaidOrganicQuery report.
Ctr Double Metric Ad CTR Ad CTR for the PaidOrganicQuery report.
Impressions Long Metric Ad Impressions Ad Impressions for the PaidOrganicQuery report.
OrganicAveragePosition Double Metric Organic Average Position Organic Average Position for the PaidOrganicQuery report.
OrganicClicks Long Metric Organic Clicks Organic Clicks for the PaidOrganicQuery report.
OrganicClicksPerQuery Double Metric Organic Clicks Per Query Organic Clicks Per Query for the PaidOrganicQuery report.
OrganicImpressions Long Metric Organic Listings Organic Listings for the PaidOrganicQuery report.
OrganicImpressionsPerQuery Double Metric Organic Listings Per Query Organic Listings Per Query for the PaidOrganicQuery report.
OrganicQueries Long Metric Organic Queries Organic Queries for the PaidOrganicQuery report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
ParentalStatusPerformance

The Parental Status Performance report includes statistics aggregated at the parental status level, one row per parental status

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the ParentalStatusPerformance report.
AccountDescriptiveName String Attribute Account Account for the ParentalStatusPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the ParentalStatusPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ParentalStatusPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ParentalStatusPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ParentalStatusPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the ParentalStatusPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the ParentalStatusPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the ParentalStatusPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the ParentalStatusPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the ParentalStatusPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the ParentalStatusPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ParentalStatusPerformance report.
CampaignName String Attribute Campaign Campaign for the ParentalStatusPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the ParentalStatusPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the ParentalStatusPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the ParentalStatusPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the ParentalStatusPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the ParentalStatusPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Parental Status Parental Status for the ParentalStatusPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the ParentalStatusPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the ParentalStatusPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ParentalStatusPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the ParentalStatusPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the ParentalStatusPerformance report.
FinalUrls String Attribute Final URL Final URL for the ParentalStatusPerformance report.
Id Long Attribute Criterion ID Criterion ID for the ParentalStatusPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the ParentalStatusPerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the ParentalStatusPerformance report.
Status String Attribute Parental Status State Parental Status State for the ParentalStatusPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the ParentalStatusPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the ParentalStatusPerformance report.
AdNetworkType1 String Segment Network Network for the ParentalStatusPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ParentalStatusPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the ParentalStatusPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the ParentalStatusPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the ParentalStatusPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ParentalStatusPerformance report.
Date Date Segment Day Day for the ParentalStatusPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the ParentalStatusPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the ParentalStatusPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the ParentalStatusPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the ParentalStatusPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the ParentalStatusPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the ParentalStatusPerformance report.
Week String Segment Week Week for the ParentalStatusPerformance report.
Year Integer Segment Year Year for the ParentalStatusPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the ParentalStatusPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the ParentalStatusPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the ParentalStatusPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the ParentalStatusPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the ParentalStatusPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the ParentalStatusPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the ParentalStatusPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ParentalStatusPerformance report.
AllConversions Double Metric All Conv All Conv for the ParentalStatusPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ParentalStatusPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the ParentalStatusPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ParentalStatusPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the ParentalStatusPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the ParentalStatusPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the ParentalStatusPerformance report.
Clicks Long Metric Clicks Clicks for the ParentalStatusPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the ParentalStatusPerformance report.
Conversions Double Metric Conversions Conversions for the ParentalStatusPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ParentalStatusPerformance report.
Cost Decimal Metric Cost Cost for the ParentalStatusPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ParentalStatusPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ParentalStatusPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ParentalStatusPerformance report.
Ctr Double Metric CTR CTR for the ParentalStatusPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the ParentalStatusPerformance report.
Engagements Long Metric Engagements Engagements for the ParentalStatusPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the ParentalStatusPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the ParentalStatusPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the ParentalStatusPerformance report.
Impressions Long Metric Impressions Impressions for the ParentalStatusPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the ParentalStatusPerformance report.
Interactions Long Metric Interactions Interactions for the ParentalStatusPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the ParentalStatusPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ParentalStatusPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ParentalStatusPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the ParentalStatusPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the ParentalStatusPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the ParentalStatusPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the ParentalStatusPerformance report.
VideoViewRate Double Metric View Rate View Rate for the ParentalStatusPerformance report.
VideoViews Long Metric Views Views for the ParentalStatusPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the ParentalStatusPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
Placeholder

The Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the Placeholder report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the Placeholder report.
AdGroupName String Attribute Ad Group Ad Group for the Placeholder report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the Placeholder report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the Placeholder report.
CampaignName String Attribute Campaign Campaign for the Placeholder report.
CampaignStatus String Attribute Campaign State Campaign State for the Placeholder report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ExtensionPlaceholderCreativeId Long Attribute Ad ID Ad ID for the Placeholder report.
ExtensionPlaceholderType String Attribute Feed Placeholder Type Feed Placeholder Type for the Placeholder report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the Placeholder report.
AdNetworkType1 String Segment Network Network for the Placeholder report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the Placeholder report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the Placeholder report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the Placeholder report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the Placeholder report.
ConversionTypeName String Segment Conversion Name Conversion Name for the Placeholder report.
Date Date Segment Day Day for the Placeholder report.
DayOfWeek String Segment Day Of Week Day Of Week for the Placeholder report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the Placeholder report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the Placeholder report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the Placeholder report.
MonthOfYear String Segment Month Of Year Month Of Year for the Placeholder report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the Placeholder report.
Slot String Segment Top Vs Other Top Vs Other for the Placeholder report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the Placeholder report.
Year Integer Segment Year Year for the Placeholder report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the Placeholder report.
AllConversions Double Metric All Conv All Conv for the Placeholder report.
AllConversionValue Double Metric All Conv Value All Conv Value for the Placeholder report.
AverageCost Decimal Metric Avg Cost Avg Cost for the Placeholder report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the Placeholder report.
AverageCpe Double Metric Avg CPE Avg CPE for the Placeholder report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the Placeholder report.
AverageCpv Double Metric Avg CPV Avg CPV for the Placeholder report.
AveragePosition Double Metric Avg Position Avg Position for the Placeholder report.
Clicks Long Metric Clicks Clicks for the Placeholder report.
ConversionRate Double Metric Conv Rate Conv Rate for the Placeholder report.
Conversions Double Metric Conversions Conversions for the Placeholder report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the Placeholder report.
Cost Decimal Metric Cost Cost for the Placeholder report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the Placeholder report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the Placeholder report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the Placeholder report.
Ctr Double Metric CTR CTR for the Placeholder report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the Placeholder report.
Engagements Long Metric Engagements Engagements for the Placeholder report.
Impressions Long Metric Impressions Impressions for the Placeholder report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the Placeholder report.
Interactions Long Metric Interactions Interactions for the Placeholder report.
InteractionTypes String Metric Interaction Types Interaction Types for the Placeholder report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the Placeholder report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the Placeholder report.
VideoViewRate Double Metric View Rate View Rate for the Placeholder report.
VideoViews Long Metric Views Views for the Placeholder report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the Placeholder report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
PlaceholderFeedItem

The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink).

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PlaceholderFeedItem report.
AccountDescriptiveName String Attribute Account Account for the PlaceholderFeedItem report.
AccountTimeZone String Attribute Time Zone Time Zone for the PlaceholderFeedItem report.
AdId Long Attribute Ad ID Ad ID for the PlaceholderFeedItem report.
AttributeValues String Attribute Attribute Values Attribute Values for the PlaceholderFeedItem report.
Criteria String Attribute Target Keyword Text Target Keyword Text for the PlaceholderFeedItem report.
CustomerDescriptiveName String Attribute Client Name Client Name for the PlaceholderFeedItem report.
DevicePreference String Attribute Device Preference Device Preference for the PlaceholderFeedItem report.
DisapprovalShortNames String Attribute Disapproval Reasons Disapproval Reasons for the PlaceholderFeedItem report.
EndTime String Attribute End Date End Date for the PlaceholderFeedItem report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PlaceholderFeedItem report.
FeedId Long Attribute Feed ID Feed ID for the PlaceholderFeedItem report.
FeedItemId Long Attribute Item ID Item ID for the PlaceholderFeedItem report.
GeoTargetingCriterionId Long Attribute Target Location Target Location for the PlaceholderFeedItem report.
GeoTargetingRestriction String Attribute Target Location Restriction Target Location Restriction for the PlaceholderFeedItem report. The allowed values are UNKNOWN, LOCATION_OF_PRESENCE.
IsSelfAction Boolean Attribute This Extension Vs Other This Extension Vs Other for the PlaceholderFeedItem report.
KeywordMatchType String Attribute Target Keyword Match Type Target Keyword Match Type for the PlaceholderFeedItem report. The allowed values are EXACT, PHRASE, BROAD.
KeywordTargetingId Long Attribute Keyword ID Keyword ID for the PlaceholderFeedItem report.
PlaceholderType Integer Attribute Feed Placeholder Type Feed Placeholder Type for the PlaceholderFeedItem report.
Scheduling String Attribute Scheduling Scheduling for the PlaceholderFeedItem report.
StartTime String Attribute Start Date Start Date for the PlaceholderFeedItem report.
Status String Attribute Item State Item State for the PlaceholderFeedItem report. The allowed values are ENABLED, REMOVED, UNKNOWN.
TargetingAdGroupId Long Attribute Target Ad Group ID Target Ad Group ID for the PlaceholderFeedItem report.
TargetingCampaignId Long Attribute Target Campaign ID Target Campaign ID for the PlaceholderFeedItem report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the PlaceholderFeedItem report.
ValidationDetails String Attribute Approval Status Approval Status for the PlaceholderFeedItem report.
AdGroupId Long Segment Ad Group ID Ad Group ID for the PlaceholderFeedItem report.
AdGroupName String Segment Ad Group Ad Group for the PlaceholderFeedItem report.
AdGroupStatus String Segment Ad Group State Ad Group State for the PlaceholderFeedItem report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segment Network Network for the PlaceholderFeedItem report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the PlaceholderFeedItem report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
CampaignId Long Segment Campaign ID Campaign ID for the PlaceholderFeedItem report.
CampaignName String Segment Campaign Campaign for the PlaceholderFeedItem report.
CampaignStatus String Segment Campaign State Campaign State for the PlaceholderFeedItem report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
ClickType String Segment Click Type Click Type for the PlaceholderFeedItem report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the PlaceholderFeedItem report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the PlaceholderFeedItem report.
ConversionTypeName String Segment Conversion Name Conversion Name for the PlaceholderFeedItem report.
Date Date Segment Day Day for the PlaceholderFeedItem report.
DayOfWeek String Segment Day Of Week Day Of Week for the PlaceholderFeedItem report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the PlaceholderFeedItem report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the PlaceholderFeedItem report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the PlaceholderFeedItem report.
MonthOfYear String Segment Month Of Year Month Of Year for the PlaceholderFeedItem report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the PlaceholderFeedItem report.
Slot String Segment Top Vs Other Top Vs Other for the PlaceholderFeedItem report. The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.
Week String Segment Week Week for the PlaceholderFeedItem report.
Year Integer Segment Year Year for the PlaceholderFeedItem report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the PlaceholderFeedItem report.
AllConversions Double Metric All Conv All Conv for the PlaceholderFeedItem report.
AllConversionValue Double Metric All Conv Value All Conv Value for the PlaceholderFeedItem report.
AverageCost Decimal Metric Avg Cost Avg Cost for the PlaceholderFeedItem report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the PlaceholderFeedItem report.
AverageCpe Double Metric Avg CPE Avg CPE for the PlaceholderFeedItem report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the PlaceholderFeedItem report.
AverageCpv Double Metric Avg CPV Avg CPV for the PlaceholderFeedItem report.
AveragePosition Double Metric Avg Position Avg Position for the PlaceholderFeedItem report.
Clicks Long Metric Clicks Clicks for the PlaceholderFeedItem report.
ConversionRate Double Metric Conv Rate Conv Rate for the PlaceholderFeedItem report.
Conversions Double Metric Conversions Conversions for the PlaceholderFeedItem report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the PlaceholderFeedItem report.
Cost Decimal Metric Cost Cost for the PlaceholderFeedItem report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the PlaceholderFeedItem report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the PlaceholderFeedItem report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the PlaceholderFeedItem report.
Ctr Double Metric CTR CTR for the PlaceholderFeedItem report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the PlaceholderFeedItem report.
Engagements Long Metric Engagements Engagements for the PlaceholderFeedItem report.
Impressions Long Metric Impressions Impressions for the PlaceholderFeedItem report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the PlaceholderFeedItem report.
Interactions Long Metric Interactions Interactions for the PlaceholderFeedItem report.
InteractionTypes String Metric Interaction Types Interaction Types for the PlaceholderFeedItem report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the PlaceholderFeedItem report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the PlaceholderFeedItem report.
VideoViewRate Double Metric View Rate View Rate for the PlaceholderFeedItem report.
VideoViews Long Metric Views Views for the PlaceholderFeedItem report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
PlacementPerformance

The Placements Performance report includes all statistics aggregated at the placement level, one row per placement.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PlacementPerformance report.
AccountDescriptiveName String Attribute Account Account for the PlacementPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the PlacementPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the PlacementPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the PlacementPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the PlacementPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the PlacementPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the PlacementPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the PlacementPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the PlacementPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the PlacementPerformance report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
BidModifier Double Attribute Bid Adj Bid Adj for the PlacementPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the PlacementPerformance report.
CampaignName String Attribute Campaign Campaign for the PlacementPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the PlacementPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the PlacementPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the PlacementPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
CpmBid Decimal Attribute Max CPM Max CPM for the PlacementPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the PlacementPerformance report. The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.
Criteria String Attribute Placement Placement for the PlacementPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the PlacementPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the PlacementPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the PlacementPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PlacementPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the PlacementPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the PlacementPerformance report.
FinalUrls String Attribute Final URL Final URL for the PlacementPerformance report.
Id Long Attribute Criterion ID Criterion ID for the PlacementPerformance report.
IsNegative Boolean Attribute Is Negative Is Negative for the PlacementPerformance report.
IsRestrict Boolean Attribute Is Restricting Is Restricting for the PlacementPerformance report.
Status String Attribute Placement State Placement State for the PlacementPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the PlacementPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the PlacementPerformance report.
AdNetworkType1 String Segment Network Network for the PlacementPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the PlacementPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the PlacementPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the PlacementPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the PlacementPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the PlacementPerformance report.
Date Date Segment Day Day for the PlacementPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the PlacementPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the PlacementPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the PlacementPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the PlacementPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the PlacementPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the PlacementPerformance report.
Week String Segment Week Week for the PlacementPerformance report.
Year Integer Segment Year Year for the PlacementPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the PlacementPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the PlacementPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the PlacementPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the PlacementPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the PlacementPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the PlacementPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the PlacementPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the PlacementPerformance report.
AllConversions Double Metric All Conv All Conv for the PlacementPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the PlacementPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the PlacementPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the PlacementPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the PlacementPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the PlacementPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the PlacementPerformance report.
Clicks Long Metric Clicks Clicks for the PlacementPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the PlacementPerformance report.
Conversions Double Metric Conversions Conversions for the PlacementPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the PlacementPerformance report.
Cost Decimal Metric Cost Cost for the PlacementPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the PlacementPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the PlacementPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the PlacementPerformance report.
Ctr Double Metric CTR CTR for the PlacementPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the PlacementPerformance report.
Engagements Long Metric Engagements Engagements for the PlacementPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the PlacementPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the PlacementPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the PlacementPerformance report.
Impressions Long Metric Impressions Impressions for the PlacementPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the PlacementPerformance report.
Interactions Long Metric Interactions Interactions for the PlacementPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the PlacementPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the PlacementPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the PlacementPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the PlacementPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the PlacementPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the PlacementPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the PlacementPerformance report.
VideoViewRate Double Metric View Rate View Rate for the PlacementPerformance report.
VideoViews Long Metric Views Views for the PlacementPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the PlacementPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
ProductPartition

The Product Partition report provides shopping campaign statistics aggregated at the product partition (Id field) level.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ProductPartition report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ProductPartition report.
AdGroupName String Attribute Ad Group Ad Group for the ProductPartition report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ProductPartition report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the ProductPartition report. The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.
CampaignId Long Attribute Campaign ID Campaign ID for the ProductPartition report.
CampaignName String Attribute Campaign Campaign for the ProductPartition report.
CampaignStatus String Attribute Campaign State Campaign State for the ProductPartition report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CpcBid Decimal Attribute Max CPC Max CPC for the ProductPartition report.
CriteriaDestinationUrl String Attribute Keyword Per Placement Destination URL Keyword Per Placement Destination URL for the ProductPartition report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ProductPartition report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the ProductPartition report.
Id Long Attribute Criterion ID Criterion ID for the ProductPartition report.
IsNegative Boolean Attribute Is Negative Is Negative for the ProductPartition report.
ParentCriterionId Long Attribute Parent Criterion ID Parent Criterion ID for the ProductPartition report.
ProductGroup String Attribute Product Group Product Group for the ProductPartition report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the ProductPartition report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the ProductPartition report.
AdNetworkType1 String Segment Network Network for the ProductPartition report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ProductPartition report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the ProductPartition report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the ProductPartition report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the ProductPartition report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ProductPartition report.
Date Date Segment Day Day for the ProductPartition report.
DayOfWeek String Segment Day Of Week Day Of Week for the ProductPartition report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the ProductPartition report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the ProductPartition report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the ProductPartition report.
MonthOfYear String Segment Month Of Year Month Of Year for the ProductPartition report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
PartitionType String Segment Partition Type Partition Type for the ProductPartition report. The allowed values are UNKNOWN, SUBDIVISION, UNIT.
Quarter String Segment Quarter Quarter for the ProductPartition report.
Week String Segment Week Week for the ProductPartition report.
Year Integer Segment Year Year for the ProductPartition report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ProductPartition report.
AllConversions Double Metric All Conv All Conv for the ProductPartition report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ProductPartition report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ProductPartition report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the ProductPartition report.
BenchmarkAverageMaxCpc Decimal Metric Benchmark Max CPC Benchmark Max CPC for the ProductPartition report.
BenchmarkCtr Double Metric Benchmark CTR Benchmark CTR for the ProductPartition report.
Clicks Long Metric Clicks Clicks for the ProductPartition report.
ConversionRate Double Metric Conv Rate Conv Rate for the ProductPartition report.
Conversions Double Metric Conversions Conversions for the ProductPartition report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ProductPartition report.
Cost Decimal Metric Cost Cost for the ProductPartition report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ProductPartition report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ProductPartition report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ProductPartition report.
Ctr Double Metric CTR CTR for the ProductPartition report.
Impressions Long Metric Impressions Impressions for the ProductPartition report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the ProductPartition report.
SearchClickShare Double Metric Click Share Click Share for the ProductPartition report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the ProductPartition report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ProductPartition report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ProductPartition report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the ProductPartition report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
SearchQueryPerformance

The Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the SearchQueryPerformance report.
AccountDescriptiveName String Attribute Account Account for the SearchQueryPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the SearchQueryPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the SearchQueryPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the SearchQueryPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the SearchQueryPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the SearchQueryPerformance report.
CampaignName String Attribute Campaign Campaign for the SearchQueryPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the SearchQueryPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Attribute Ad ID Ad ID for the SearchQueryPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the SearchQueryPerformance report.
DestinationUrl String Attribute Destination URL Destination URL for the SearchQueryPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SearchQueryPerformance report.
FinalUrl String Attribute Final URL Final URL for the SearchQueryPerformance report.
KeywordId Long Attribute Keyword ID Keyword ID for the SearchQueryPerformance report.
KeywordTextMatchingQuery String Attribute Keyword Keyword for the SearchQueryPerformance report.
Query String Attribute Search Term Search Term for the SearchQueryPerformance report.
QueryTargetingStatus String Attribute Added Per Excluded Added Per Excluded for the SearchQueryPerformance report. The allowed values are ADDED, EXCLUDED, BOTH, NONE.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the SearchQueryPerformance report.
AdFormat String Segment Ad Type Ad Type for the SearchQueryPerformance report. The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segment Network Network for the SearchQueryPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the SearchQueryPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the SearchQueryPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the SearchQueryPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the SearchQueryPerformance report.
Date Date Segment Day Day for the SearchQueryPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the SearchQueryPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the SearchQueryPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the SearchQueryPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the SearchQueryPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the SearchQueryPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the SearchQueryPerformance report.
QueryMatchTypeWithVariant String Segment Match Type Match Type for the SearchQueryPerformance report. The allowed values are AUTO, BROAD, EXACT, EXPANDED, PHRASE, NEAR_EXACT, NEAR_PHRASE.
Week String Segment Week Week for the SearchQueryPerformance report.
Year Integer Segment Year Year for the SearchQueryPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the SearchQueryPerformance report.
AllConversions Double Metric All Conv All Conv for the SearchQueryPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the SearchQueryPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the SearchQueryPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the SearchQueryPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the SearchQueryPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the SearchQueryPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the SearchQueryPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the SearchQueryPerformance report.
Clicks Long Metric Clicks Clicks for the SearchQueryPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the SearchQueryPerformance report.
Conversions Double Metric Conversions Conversions for the SearchQueryPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the SearchQueryPerformance report.
Cost Decimal Metric Cost Cost for the SearchQueryPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the SearchQueryPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the SearchQueryPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the SearchQueryPerformance report.
Ctr Double Metric CTR CTR for the SearchQueryPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the SearchQueryPerformance report.
Engagements Long Metric Engagements Engagements for the SearchQueryPerformance report.
Impressions Long Metric Impressions Impressions for the SearchQueryPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the SearchQueryPerformance report.
Interactions Long Metric Interactions Interactions for the SearchQueryPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the SearchQueryPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the SearchQueryPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the SearchQueryPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the SearchQueryPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the SearchQueryPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the SearchQueryPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the SearchQueryPerformance report.
VideoViewRate Double Metric View Rate View Rate for the SearchQueryPerformance report.
VideoViews Long Metric Views Views for the SearchQueryPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the SearchQueryPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
SharedSet

The Shared Set report includes all SharedSets that can be shareable across campaigns.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the SharedSet report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SharedSet report.
Name String Attribute Shared Set Name Shared Set Name for the SharedSet report.
SharedSetId Long Attribute Shared Set ID Shared Set ID for the SharedSet report.
Status String Attribute State State for the SharedSet report. The allowed values are ENABLED, REMOVED, UNKNOWN.
Type String Attribute Shared Set Type Shared Set Type for the SharedSet report. The allowed values are NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.
MemberCount String Metric Member Count Member Count for the SharedSet report.
ReferenceCount String Metric Reference Count Reference Count for the SharedSet report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
SharedSetCriteria

The Shared Set Criteria report includes criteria for each SharedSet.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the SharedSetCriteria report.
Criteria String Attribute Negative Keyword Negative Keyword for the SharedSetCriteria report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SharedSetCriteria report.
Id Long Attribute Keyword ID Keyword ID for the SharedSetCriteria report.
KeywordMatchType String Attribute Match Type Match Type for the SharedSetCriteria report. The allowed values are EXACT, PHRASE, BROAD.
SharedSetId Long Attribute Shared Set ID Shared Set ID for the SharedSetCriteria report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
ShoppingPerformance

The Shopping Performance report provides shopping campaign statistics aggregated at the product (OfferId field) level.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ShoppingPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ShoppingPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ShoppingPerformance report.
AggregatorId Long Attribute MCA Id MCA ID for the ShoppingPerformance report.
Brand String Attribute Brand Brand for the ShoppingPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ShoppingPerformance report.
CampaignName String Attribute Campaign Campaign for the ShoppingPerformance report.
CategoryL1 String Attribute Category (1st Level) Category (1st Level) for the ShoppingPerformance report.
CategoryL2 String Attribute Category (2nd Level) Category (2nd Level) for the ShoppingPerformance report.
CategoryL3 String Attribute Category (3rd Level) Category (3rd Level) for the ShoppingPerformance report.
CategoryL4 String Attribute Category (4th Level) Category (4th Level) for the ShoppingPerformance report.
CategoryL5 String Attribute Category (5th Level) Category (5th Level) for the ShoppingPerformance report.
CountryCriteriaId Integer Attribute Country Per Territory Country Per Territory for the ShoppingPerformance report.
CustomAttribute0 String Attribute Custom Label 0 Custom Label 0 for the ShoppingPerformance report.
CustomAttribute1 String Attribute Custom Label 1 Custom Label 1 for the ShoppingPerformance report.
CustomAttribute2 String Attribute Custom Label 2 Custom Label 2 for the ShoppingPerformance report.
CustomAttribute3 String Attribute Custom Label 3 Custom Label 3 for the ShoppingPerformance report.
CustomAttribute4 String Attribute Custom Label 4 Custom Label 4 for the ShoppingPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ShoppingPerformance report.
LanguageCriteriaId Integer Attribute Language Language for the ShoppingPerformance report.
MerchantId Long Attribute MC Id MC ID for the ShoppingPerformance report.
OfferId String Attribute Item Id Item ID for the ShoppingPerformance report.
ProductTitle String Attribute Product Title Product Title for the ShoppingPerformance report.
ProductTypeL1 String Attribute Product Type (1st Level) Product Type (1st Level) for the ShoppingPerformance report.
ProductTypeL2 String Attribute Product Type (2nd Level) Product Type (2nd Level) for the ShoppingPerformance report.
ProductTypeL3 String Attribute Product Type (3rd Level) Product Type (3rd Level) for the ShoppingPerformance report.
ProductTypeL4 String Attribute Product Type (4th Level) Product Type (4th Level) for the ShoppingPerformance report.
ProductTypeL5 String Attribute Product Type (5th Level) Product Type (5th Level) for the ShoppingPerformance report.
StoreId String Attribute Store Id Store ID for the ShoppingPerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the ShoppingPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
AdNetworkType1 String Segment Network Network for the ShoppingPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ShoppingPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
CampaignStatus String Segment Campaign State Campaign State for the ShoppingPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
Channel String Segment Channel Channel for the ShoppingPerformance report. The allowed values are UNKNOWN, ONLINE, LOCAL.
ChannelExclusivity String Segment Channel Exclusivity Channel Exclusivity for the ShoppingPerformance report. The allowed values are UNKNOWN, SINGLE_CHANNEL, MULTI_CHANNEL.
ClickType String Segment Click Type Click Type for the ShoppingPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the ShoppingPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the ShoppingPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ShoppingPerformance report.
Date Date Segment Day Day for the ShoppingPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the ShoppingPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the ShoppingPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the ShoppingPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the ShoppingPerformance report.
ProductCondition String Segment Condition Condition for the ShoppingPerformance report. The allowed values are UNKNOWN, NEW, REFURBISHED, USED.
Quarter String Segment Quarter Quarter for the ShoppingPerformance report.
Week String Segment Week Week for the ShoppingPerformance report.
Year Integer Segment Year Year for the ShoppingPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ShoppingPerformance report.
AllConversions Double Metric All Conv All Conv for the ShoppingPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ShoppingPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ShoppingPerformance report.
Clicks Long Metric Clicks Clicks for the ShoppingPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the ShoppingPerformance report.
Conversions Double Metric Conversions Conversions for the ShoppingPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ShoppingPerformance report.
Cost Decimal Metric Cost Cost for the ShoppingPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ShoppingPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ShoppingPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ShoppingPerformance report.
Ctr Double Metric CTR CTR for the ShoppingPerformance report.
Impressions Long Metric Impressions Impressions for the ShoppingPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the ShoppingPerformance report.
SearchClickShare Double Metric Click Share Click Share for the ShoppingPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the ShoppingPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ShoppingPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ShoppingPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
TopContentPerformance

Retrieves TopContentPerformance report data.

Columns
Name Type Behavior DisplayName Description
AdGroupId Long Attribute Ad Group ID Ad Group ID for the TopContentPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the TopContentPerformance report.
BidModifier Double Attribute Bid Adj Bid Adj for the TopContentPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the TopContentPerformance report.
CampaignName String Attribute Campaign Campaign for the TopContentPerformance report.
Id Long Attribute Criterion ID Criterion ID for the TopContentPerformance report.
Date Date Segment Day Day for the TopContentPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the TopContentPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the TopContentPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the TopContentPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the TopContentPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the TopContentPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the TopContentPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the TopContentPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the TopContentPerformance report.
Clicks Long Metric Clicks Clicks for the TopContentPerformance report.
Cost Decimal Metric Cost Cost for the TopContentPerformance report.
Ctr Double Metric CTR CTR for the TopContentPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the TopContentPerformance report.
Engagements Long Metric Engagements Engagements for the TopContentPerformance report.
Impressions Long Metric Impressions Impressions for the TopContentPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the TopContentPerformance report.
Interactions Long Metric Interactions Interactions for the TopContentPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the TopContentPerformance report.
VideoViewRate Double Metric View Rate View Rate for the TopContentPerformance report.
VideoViews Long Metric Views Views for the TopContentPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
UrlPerformance

The URL Performance report includes all statistics aggregated at the URL and criterion level.

Table Specific Information

Select

Google AdWords does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the AdWords console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the AdWords API.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the UrlPerformance report.
AccountDescriptiveName String Attribute Account Account for the UrlPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the UrlPerformance report.
AdGroupCriterionStatus String Attribute Keyword Per Placement State Keyword Per Placement State for the UrlPerformance report. The allowed values are ENABLED, REMOVED, PAUSED.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the UrlPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the UrlPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the UrlPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the UrlPerformance report.
CampaignName String Attribute Campaign Campaign for the UrlPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the UrlPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the UrlPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the UrlPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the UrlPerformance report.
Domain String Attribute Domain Domain for the UrlPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the UrlPerformance report.
IsBidOnPath String Attribute Added Added for the UrlPerformance report.
IsPathExcluded String Attribute Excluded Excluded for the UrlPerformance report.
Url String Attribute URL URL for the UrlPerformance report.
AdFormat String Segment Ad Type Ad Type for the UrlPerformance report. The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.
AdNetworkType1 String Segment Network Network for the UrlPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the UrlPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the UrlPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the UrlPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the UrlPerformance report.
Date Date Segment Day Day for the UrlPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the UrlPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the UrlPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the UrlPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
IsAutoOptimized Boolean Segment Targeting Mode Targeting Mode for the UrlPerformance report.
Month String Segment Month Month for the UrlPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the UrlPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the UrlPerformance report.
Week String Segment Week Week for the UrlPerformance report.
Year Integer Segment Year Year for the UrlPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the UrlPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the UrlPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the UrlPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the UrlPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the UrlPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the UrlPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the UrlPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the UrlPerformance report.
AllConversions Double Metric All Conv All Conv for the UrlPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the UrlPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the UrlPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the UrlPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the UrlPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the UrlPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the UrlPerformance report.
Clicks Long Metric Clicks Clicks for the UrlPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the UrlPerformance report.
Conversions Double Metric Conversions Conversions for the UrlPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the UrlPerformance report.
Cost Decimal Metric Cost Cost for the UrlPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the UrlPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the UrlPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the UrlPerformance report.
Ctr Double Metric CTR CTR for the UrlPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the UrlPerformance report.
Engagements Long Metric Engagements Engagements for the UrlPerformance report.
Impressions Long Metric Impressions Impressions for the UrlPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the UrlPerformance report.
Interactions Long Metric Interactions Interactions for the UrlPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the UrlPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the UrlPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the UrlPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the UrlPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the UrlPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the UrlPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the UrlPerformance report.
VideoViewRate Double Metric View Rate View Rate for the UrlPerformance report.
VideoViews Long Metric Views Views for the UrlPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the UrlPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
UserAdDistance

The User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the UserAdDistance report.
AccountDescriptiveName String Attribute Account Account for the UserAdDistance report.
AccountTimeZone String Attribute Time Zone Time Zone for the UserAdDistance report.
CampaignId Long Attribute Campaign ID Campaign ID for the UserAdDistance report.
CampaignName String Attribute Campaign Campaign for the UserAdDistance report.
CampaignStatus String Attribute Campaign State Campaign State for the UserAdDistance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CustomerDescriptiveName String Attribute Client Name Client Name for the UserAdDistance report.
DistanceBucket String Attribute Distance From Location Extensions Distance From Location Extensions for the UserAdDistance report. The allowed values are DISTANCE_BUCKET_WITHIN_200M, DISTANCE_BUCKET_WITHIN_500M, DISTANCE_BUCKET_WITHIN_700M, DISTANCE_BUCKET_WITHIN_1KM, DISTANCE_BUCKET_WITHIN_5KM, DISTANCE_BUCKET_WITHIN_10KM, DISTANCE_BUCKET_WITHIN_15KM, DISTANCE_BUCKET_WITHIN_20KM, DISTANCE_BUCKET_WITHIN_25KM, DISTANCE_BUCKET_WITHIN_30KM, DISTANCE_BUCKET_WITHIN_35KM, DISTANCE_BUCKET_WITHIN_40KM, DISTANCE_BUCKET_WITHIN_45KM, DISTANCE_BUCKET_WITHIN_50KM, DISTANCE_BUCKET_WITHIN_55KM, DISTANCE_BUCKET_WITHIN_60KM, DISTANCE_BUCKET_WITHIN_65KM, DISTANCE_BUCKET_BEYOND_65KM, DISTANCE_BUCKET_WITHIN_0_2MILES, DISTANCE_BUCKET_WITHIN_0_5MILES, DISTANCE_BUCKET_WITHIN_0_7MILES, DISTANCE_BUCKET_WITHIN_1MILE, DISTANCE_BUCKET_WITHIN_5MILES, DISTANCE_BUCKET_WITHIN_10MILES, DISTANCE_BUCKET_WITHIN_15MILES, DISTANCE_BUCKET_WITHIN_20MILES, DISTANCE_BUCKET_WITHIN_25MILES, DISTANCE_BUCKET_WITHIN_30MILES, DISTANCE_BUCKET_WITHIN_35MILES, DISTANCE_BUCKET_WITHIN_40MILES, DISTANCE_BUCKET_BEYOND_40MILES, UNKNOWN.
ExternalCustomerId Long Attribute Customer ID Customer ID for the UserAdDistance report.
AdNetworkType1 String Segment Network Network for the UserAdDistance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the UserAdDistance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ConversionCategoryName String Segment Conversion Category Conversion Category for the UserAdDistance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the UserAdDistance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the UserAdDistance report.
Date Date Segment Day Day for the UserAdDistance report.
DayOfWeek String Segment Day Of Week Day Of Week for the UserAdDistance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the UserAdDistance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the UserAdDistance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the UserAdDistance report.
MonthOfYear String Segment Month Of Year Month Of Year for the UserAdDistance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the UserAdDistance report.
Week String Segment Week Week for the UserAdDistance report.
Year Integer Segment Year Year for the UserAdDistance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the UserAdDistance report.
AllConversions Double Metric All Conv All Conv for the UserAdDistance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the UserAdDistance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the UserAdDistance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the UserAdDistance report.
AveragePosition Double Metric Avg Position Avg Position for the UserAdDistance report.
Clicks Long Metric Clicks Clicks for the UserAdDistance report.
ConversionRate Double Metric Conv Rate Conv Rate for the UserAdDistance report.
Conversions Double Metric Conversions Conversions for the UserAdDistance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the UserAdDistance report.
Cost Decimal Metric Cost Cost for the UserAdDistance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the UserAdDistance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the UserAdDistance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the UserAdDistance report.
Ctr Double Metric CTR CTR for the UserAdDistance report.
Impressions Long Metric Impressions Impressions for the UserAdDistance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the UserAdDistance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the UserAdDistance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the UserAdDistance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
VideoPerformance

The Video Performance report includes statistics for your account's upgraded AdWords for Video campaigns.

Columns
Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the VideoPerformance report.
AccountDescriptiveName String Attribute Account Account for the VideoPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the VideoPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the VideoPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the VideoPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the VideoPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CampaignId Long Attribute Campaign ID Campaign ID for the VideoPerformance report.
CampaignName String Attribute Campaign Campaign for the VideoPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the VideoPerformance report. The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.
CreativeId Long Attribute Ad ID Ad ID for the VideoPerformance report.
CreativeStatus String Attribute Ad State Ad State for the VideoPerformance report. The allowed values are ENABLED, PAUSED, DISABLED.
CustomerDescriptiveName String Attribute Client Name Client Name for the VideoPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the VideoPerformance report.
VideoChannelId String Attribute Video Channel Id Video Channel ID for the VideoPerformance report.
VideoDuration Long Attribute Video Duration Video Duration for the VideoPerformance report.
VideoId String Attribute Video Id Video ID for the VideoPerformance report.
VideoTitle String Attribute Video Title Video Title for the VideoPerformance report.
AdNetworkType1 String Segment Network Network for the VideoPerformance report. The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the VideoPerformance report. The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.
ClickType String Segment Click Type Click Type for the VideoPerformance report. The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.
ConversionCategoryName String Segment Conversion Category Conversion Category for the VideoPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker ID for the VideoPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the VideoPerformance report.
Date Date Segment Day Day for the VideoPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the VideoPerformance report. The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
Device String Segment Device Device for the VideoPerformance report. The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.
ExternalConversionSource String Segment Conversion Source Conversion Source for the VideoPerformance report. The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.
Month String Segment Month Month for the VideoPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the VideoPerformance report. The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.
Quarter String Segment Quarter Quarter for the VideoPerformance report.
Week String Segment Week Week for the VideoPerformance report.
Year Integer Segment Year Year for the VideoPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the VideoPerformance report.
AllConversions Double Metric All Conv All Conv for the VideoPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the VideoPerformance report.
AverageCpm Double Metric Avg CPM Avg CPM for the VideoPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the VideoPerformance report.
Clicks Long Metric Clicks Clicks for the VideoPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the VideoPerformance report.
Conversions Double Metric Conversions Conversions for the VideoPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the VideoPerformance report.
Cost Decimal Metric Cost Cost for the VideoPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the VideoPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the VideoPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the VideoPerformance report.
Ctr Double Metric CTR CTR for the VideoPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the VideoPerformance report.
Engagements Long Metric Engagements Engagements for the VideoPerformance report.
Impressions Long Metric Impressions Impressions for the VideoPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the VideoPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the VideoPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the VideoPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the VideoPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the VideoPerformance report.
VideoViewRate Double Metric View Rate View Rate for the VideoPerformance report.
VideoViews Long Metric Views Views for the VideoPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the VideoPerformance report.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
StartDate String Start date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.
EndDate String End date for fetching AdWords data. Both StartDate and EndDate must be set to specify a custom date range. The default range in the last seven days.

Stored Procedures

Stored procedures are available to complement the data available from the Data Model. It may be necessary to update data available from a view using a stored procedure because the data does not provide for direct, table-like, two-way updates. In these situations, the retrieval of the data is done using the appropriate view or table, while the update is done by calling a stored procedure. Stored procedures take a list of parameters and return back a dataset that contains the collection of tuples that constitute the response.

Name Description
GetOAuthAccessToken Obtains the OAuth access token to be used for authentication with various Google services.
GetOAuthAuthorizationURL Obtains the OAuth authorization URL used for authentication with various Google services.
RefreshOAuthAccessToken Obtains the OAuth access token to be used for authentication with various Google services.
GetOAuthAccessToken

Obtains the OAuth access token to be used for authentication with various Google services.

Input
Name Type Required Description
AuthMode String True The type of authentication mode to use. The allowed values are APP, WEB. The default value is WEB.
Scope String True The scope of access to Google APIs. By default, access to all APIs used by this data provider will be specified. The default value is https://www.googleapis.com/auth/adwords.
Verifier String False The verifier code returned by Google after permission for the app to connect has been granted. WEB AuthMode only.
CallbackURL String False This field determines where the response is sent. The value of this parameter must exactly match one of the values registered in the APIs Console, including the HTTP or HTTPS schemes, capitalization, and trailing forward slash ('/').
Prompt String True This field indicates the prompt to present the user. It accepts one of the following values: NONE, CONSENT, SELECT ACCOUNT. The default is SELECT_ACCOUNT, so a given user will be prompted to select the account to connect to. If it is set to CONSENT, the user will see a consent page every time, even if they have previously given consent to the application for a given set of scopes. Lastly, if it is set to NONE, no authentication or consent screens will be displayed to the user. The default value is SELECT_ACCOUNT.
AccessType String True This field indicates if your application needs to access a Google API when the user is not present at the browser. This parameter defaults to OFFLINE. If your application needs to refresh access tokens when the user is not present at the browser, then use OFFLINE. This will result in your application obtaining a refresh token the first time your application exchanges an authorization code for a user. The allowed values are ONLINE, OFFLINE. The default value is OFFLINE.
State String False This field indicates any state that may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to Google authorization server and back. Uses include redirecting the user to the correct resource in your site, using nonces, and mitigating cross-site request forgery.
Result Set Columns
Name Type Description
OAuthAccessToken String The authentication token returned from Google. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken String A token that may be used to obtain a new access token.
ExpiresIn String The remaining lifetime on the access token.
GetOAuthAuthorizationURL

Obtains the OAuth authorization URL used for authentication with various Google services.

Input
Name Type Required Description
Scope String True The scope of access to Google APIs. By default, access to all APIs used by this data provider will be specified. The default value is https://www.googleapis.com/auth/adwords.
CallbackURL String False This field determines where the response is sent. The value of this parameter must exactly match one of the values registered in the APIs Console, including the HTTP or HTTPS schemes, case, and trailing forward slash ('/').
Prompt String True This field indicates the prompt to present the user. It accepts one of the following values: NONE, CONSENT, SELECT ACCOUNT. The default is SELECT_ACCOUNT, so a given user will be prompted to select the account to connect to. If it is set to CONSENT, the user will see a consent page every time, even if they have previously given consent to the application for a given set of scopes. Lastly, if it is set to NONE, no authentication or consent screens will be displayed to the user. The default value is SELECT_ACCOUNT.
AccessType String True This field indicates if your application needs to access a Google API when the user is not present at the browser. This parameter defaults to OFFLINE. If your application needs to refresh access tokens when the user is not present at the browser, then use OFFLINE. This will result in your application obtaining a refresh token the first time your application exchanges an authorization code for a user. The allowed values are ONLINE, OFFLINE. The default value is OFFLINE.
State String False This field indicates any state that may be useful to your application upon receipt of the response. Your application receives the same value it sent, as this parameter makes a round-trip to the Google authorization server and back. Possible uses include redirecting the user to the correct resource in your site, using nonces, and mitigating cross-site request forgery.
Result Set Columns
Name Type Description
URL String The URL to complete user authentication.
RefreshOAuthAccessToken

Obtains the OAuth access token to be used for authentication with various Google services.

Input
Name Type Required Description
OAuthRefreshToken String True The refresh token returned from the original authorization code exchange.
Result Set Columns
Name Type Description
OAuthAccessToken String The authentication token returned from Google. This can be used in subsequent calls to other operations for this particular service.
OAuthRefreshToken String The authentication token returned from Google. This can be used in subsequent calls to other operations for this particular service.
ExpiresIn String The remaining lifetime on the access token.

Google Ads Data Model

Overview

The Google Ads connector models Google Ads entities in relational views and stored procedures. The provided views will give you access to your Google Ads data using the Google Ads API.

Changes from the old Google Adwords API Reports

All report names, in addition to several field names have now changed from the Google Ads provider. Please refer to Google's documentation for name mappings between the deprecated Google AdWords API and the current Google Ads API.

Key Features

  • The connector models Google Ads entities like documents, folders, and groups as relational views, allowing you to write SQL to query Google Ads data.
  • Stored procedures allow you to execute operations to Google Ads.
  • Live connectivity to these objects means any changes to your Google Ads account are immediately reflected when using the connector.

Views

Views describes the available views. Views are statically defined to model Campaigns, AdGroups, Customers, and more. They are mainly used as a way to create your custom reports instead of being used standalone.

The Resources view shows the names of the resources, attribute resources and segmenting resources, which you need for the CreateReportSchema stored procedure.

Stored Procedures

Stored Procedures are function-like interfaces to Google Ads. Stored procedures allow you to execute operations to Google Ads, the most important being CreateReportSchema, which is used to create views from resources (like 'distance_view') with attribute resources (like 'customer' in this case) and segmenting resources (like 'campaign' in this case).

Collaborative Query Processing

The connector offloads as much of the SELECT statement processing as possible to Google Ads and then processes the rest of the query in memory. API limitations and requirements are also documented in this section.

See SupportEnhancedSQL for more information on how the connector circumvents API limitations with in-memory client-side processing.

Views

Views are composed of columns and pseudo columns. Views are similar to tables in the way that data is represented; however, views do not support updates. Entities that are represented as views are typically read-only entities. Often, a stored procedure is available to update the data if such functionality is applicable to the data source.

Queries can be executed against a view as if it were a normal table, and the data that comes back is similar in that regard. To find out more about tables and stored procedures, please navigate to their corresponding entries in this help document.

Name Description
AccessibleBiddingStrategy Represents a view of BiddingStrategies owned by and shared with the customer. In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.
AccountBudget An account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pending_proposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (e.g. spending limit), these differences are juxtaposed via 'proposed_', 'approved_', and possibly 'adjusted_' fields. This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pending_proposal. Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.
AccountBudgetProposal An account-level budget proposal. All fields prefixed with 'proposed' may not necessarily be applied directly. For example, proposed spending limits may be adjusted before their application. This is true if the 'proposed' field has an 'approved' counterpart, e.g. spending limits. Please note that the proposal type (proposal_type) changes which fields are required and which must remain empty.
AccountLink Represents the data sharing connection between a Google Ads account and another account
AdGroup An ad group.
AdGroupAd An ad group ad.
AdGroupAdAssetCombinationView A view on the usage of ad group ad asset combination. Now we only support AdGroupAdAssetCombinationView for Responsive Search Ads, with more ad types planned for the future.
AdGroupAdAssetView A link between an AdGroupAd and an Asset. Currently we only support AdGroupAdAssetView for AppAds.
AdGroupAdLabel A relationship between an ad group ad and a label.
AdGroupAsset A link between an ad group and an asset.
AdGroupAudienceView An ad group audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.
AdGroupBidModifier Represents an ad group bid modifier.
AdGroupCriterion An ad group criterion.
AdGroupCriterionCustomizer A customizer value for the associated CustomizerAttribute at the AdGroupCriterion level.
AdGroupCriterionLabel A relationship between an ad group criterion and a label.
AdGroupCriterionSimulation An ad group criterion simulation. Supported combinations of advertising channel type, criterion type, simulation type, and simulation modification method are detailed below respectively. Hotel AdGroupCriterion simulation operations starting in V5. 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM 2. SEARCH - KEYWORD - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
AdGroupCustomizer A customizer value for the associated CustomizerAttribute at the AdGroup level.
AdGroupExtensionSetting An ad group extension setting.
AdGroupFeed An ad group feed.
AdGroupLabel A relationship between an ad group and a label.
AdGroupSimulation An ad group simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively. 1. SEARCH - CPC_BID - DEFAULT 2. SEARCH - CPC_BID - UNIFORM 3. SEARCH - TARGET_CPA - UNIFORM 4. SEARCH - TARGET_ROAS - UNIFORM 5. DISPLAY - CPC_BID - DEFAULT 6. DISPLAY - CPC_BID - UNIFORM 7. DISPLAY - TARGET_CPA - UNIFORM
AdParameter An ad parameter that is used to update numeric values (such as prices or inventory levels) in any text line of an ad (including URLs). There can be a maximum of two AdParameters per ad group criterion. (One with parameter_index = 1 and one with parameter_index = 2.) In the ad the parameters are referenced by a placeholder of the form "{param#:value}". E.g. "{param1:$17}"
AdScheduleView An ad schedule view summarizes the performance of campaigns by AdSchedule criteria.
AgeRangeView An age range view.
Asset Asset is a part of an ad which can be shared across multiple ads. It can be an image (ImageAsset), a video (YouTubeVideoAsset), etc. Assets are immutable and cannot be removed. To stop an asset from serving, remove the asset from the entity that is using it.
AssetFieldTypeView An asset field type view. This view reports non-overcounted metrics for each asset field type when the asset is used as extension.
AssetGroup An asset group. AssetGroupAsset will be used to link an asset to the asset group. AssetGroupHint will be used to associate a hint to an asset group.
AssetGroupAsset AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.
AssetGroupListingGroupFilter AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.
AssetGroupSignal AssetGroupSignal represents a signal in an asset group. The existence of a signal tells the performance max campaign who's most likely to convert. Performance Max uses the signal to look for new people with similar or stronger intent to find conversions across Search, Display, Video, and more.
AssetSet An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set.
AssetSetAsset AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set.
Audience Audience is an effective targeting option that allows you to intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.
BatchJob A list of mutates being processed asynchronously. The mutates are uploaded by the user. The mutates themselves aren't readable and the results of the job can only be read using BatchJobService.ListBatchJobResults.
BiddingDataExclusion Represents a bidding data exclusion. See "About data exclusions" at https://support.google.com/google-ads/answer/10370710.
BiddingSeasonalityAdjustment Represents a bidding seasonality adjustment. See "About seasonality adjustments" at https://support.google.com/google-ads/answer/10369906.
BiddingStrategy A bidding strategy.
BiddingStrategySimulation A bidding strategy simulation. Supported combinations of simulation type and simulation modification method are detailed below respectively. 1. TARGET_CPA - UNIFORM 2. TARGET_ROAS - UNIFORM
BillingSetup A billing setup, which associates a payments account and an advertiser. A billing setup is specific to one advertiser.
CallView A call view that includes data for call tracking of call-only ads or call extensions.
Campaign A campaign.
CampaignAsset A link between a Campaign and an Asset.
CampaignAssetSet CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.
CampaignAudienceView A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.
CampaignBidModifier Represents a bid-modifiable only criterion at the campaign level.
CampaignBudget A campaign budget.
CampaignConversionGoal The biddability setting for the specified campaign only for all conversion actions with a matching category and origin.
CampaignCriterion A campaign criterion.
CampaignCriterionSimulation A campaign criterion simulation. Supported combinations of advertising channel type, criterion ids, simulation type and simulation modification method is detailed below respectively. 1. SEARCH - 30000, 30001, 30002 - BID_MODIFIER - UNIFORM 2. DISPLAY - 30001 - BID_MODIFIER - UNIFORM
CampaignCustomizer A customizer value for the associated CustomizerAttribute at the Campaign level.
CampaignDraft A campaign draft.
CampaignExperiment An A/B experiment that compares the performance of the base campaign (the control) and a variation of that campaign (the experiment).
CampaignExtensionSetting A campaign extension setting.
CampaignFeed A campaign feed.
CampaignLabel Represents a relationship between a campaign and a label.
CampaignSharedSet CampaignSharedSets are used for managing the shared sets associated with a campaign.
CampaignSimulation A campaign simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively. SEARCH - CPC_BID - UNIFORM SEARCH - CPC_BID - SCALING SEARCH - TARGET_CPA - UNIFORM SEARCH - TARGET_CPA - SCALING SEARCH - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM SEARCH - BUDGET - UNIFORM SHOPPING - BUDGET - UNIFORM SHOPPING - TARGET_ROAS - UNIFORM MULTIPLE - TARGET_CPA - UNIFORM OWNED_AND_OPERATED - TARGET_CPA - DEFAULT DISPLAY - TARGET_CPA - UNIFORM
CarrierConstant A carrier criterion that can be used in campaign targeting.
ChangeEvent Describes the granular change of returned resource of certain resource types. Changes made through UI, API and new versions of Editor by external users (including external users, and internal users that can be shown externally) in the past 30 days will be shown. The change shows the old values of the changed fields before the change and the new values right after the change. ChangeEvent could have up to 3 minutes delay to reflect a new change.
ChangeStatus Describes the status of returned resource. ChangeStatus could have up to 3 minutes delay to reflect a new change.
ClickView A click view with metrics aggregated at each click level, including both valid and invalid clicks. For non-Search campaigns, metrics.clicks represents the number of valid and invalid interactions. Queries including ClickView must have a filter limiting the results to one day and can be requested for dates back to 90 days before the time of the request.
CombinedAudience Describe a resource for combined audiences which includes different audiences.
ConversionAction A conversion action.
ConversionCustomVariable A conversion custom variable See "About custom variables for conversions" at https://support.google.com/google-ads/answer/9964350
ConversionGoalCampaignConfig Conversion goal settings for a Campaign.
ConversionValueRule A conversion value rule
ConversionValueRuleSet A conversion value rule set
CurrencyConstant A currency constant.
CustomAudience A custom audience. This is a list of users by interest.
CustomConversionGoal Custom conversion goal that can make arbitrary conversion actions biddable.
Customer A customer.
CustomerAsset A link between a customer and an asset.
CustomerClient A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.
CustomerClientLink The links between customer client accounts and manager accounts
CustomerConversionGoal Biddability control for conversion actions with a matching category and origin.
CustomerCustomizer A customizer value for the associated CustomizerAttribute at the Customer level.
CustomerExtensionSetting A customer extension setting.
CustomerFeed A customer feed.
CustomerLabel Represents a relationship between a customer and a label. This customer may not have access to all the labels attached to it. Additional CustomerLabels may be returned by increasing permissions with login-customer-id.
CustomerManagerLink Represents customer-manager link relationship.
CustomerNegativeCriterion A negative criterion for exclusions at the customer level.
CustomerUserAccess Represents the permission of a single user onto a single customer.
CustomerUserAccessInvitation Represent an invitation to a new user on this customer account.
CustomInterest A custom interest. This is a list of users by interest.
CustomizerAttribute A customizer attribute. Use CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer, or AdGroupCriterionCustomizer to associate a customizer attribute and set its value at the customer, campaign, ad group, or ad group criterion level, respectively.
DetailedDemographic A detailed demographic: a particular interest-based vertical to be targeted to reach users based on long-term life facts.
DetailPlacementView A view with metrics aggregated by ad group and URL or YouTube video.
DisplayKeywordView A display keyword view.
DistanceView A distance view with metrics aggregated by the user's distance from an advertiser's location extensions. Each DistanceBucket includes all impressions that fall within its distance and a single impression will contribute to the metrics for all DistanceBuckets that include the user's distance.
DomainCategory A category generated automatically by crawling a domain. If a campaign uses the DynamicSearchAdsSetting, then domain categories will be generated for the domain. The categories can be targeted using WebpageConditionInfo. See: https://support.google.com/google-ads/answer/2471185
DynamicSearchAdsSearchTermView A dynamic search ads search term view.
ExpandedLandingPageView A landing page view with metrics aggregated at the expanded final URL level.
Experiment A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.
ExperimentArm A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.
ExtensionFeedItem An extension feed item.
Feed A feed.
FeedItem A feed item.
FeedItemSet Represents a set of feed items. The set can be used and shared among certain feed item features. For instance, the set can be referenced within the matching functions of CustomerFeed, CampaignFeed, and AdGroupFeed.
FeedItemSetLink Represents a link between a FeedItem and a FeedItemSet.
FeedItemTarget A feed item target.
FeedMapping A feed mapping.
FeedPlaceholderView A feed placeholder view.
GenderView A gender view.
GeographicView A geographic view. Geographic View includes all metrics aggregated at the country level, one row per country. It reports metrics at either actual physical location of the user or an area of interest. If other segment fields are used, you may get more than one row per country.
GeoTargetConstant A geo target constant.
GroupPlacementView A group placement view.
HotelGroupView A hotel group view.
HotelPerformanceView A hotel performance view.
HotelReconciliation A hotel reconciliation. It contains conversion information from Hotel bookings to reconcile with advertiser records. These rows may be updated or canceled before billing via Bulk Uploads.
IncomeRangeView An income range view.
KeywordPlan A Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached.
KeywordPlanAdGroup A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200.
KeywordPlanAdGroupKeyword A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000.
KeywordPlanCampaign A Keyword Plan campaign. Max number of keyword plan campaigns per plan allowed: 1.
KeywordPlanCampaignKeyword A Keyword Plan Campaign keyword. Only negative keywords are supported for Campaign Keyword.
KeywordThemeConstant A Smart Campaign keyword theme constant.
KeywordView A keyword view.
Label A label.
LandingPageView A landing page view with metrics aggregated at the unexpanded final URL level.
LanguageConstant A language.
LifeEvent A life event: a particular interest-based vertical to be targeted to reach users when they are in the midst of important life milestones.
LocationView A location view summarizes the performance of campaigns by Location criteria.
ManagedPlacementView A managed placement view.
MediaFile A media file.
MobileAppCategoryConstant A mobile application category constant.
MobileDeviceConstant A mobile device constant.
OfflineUserDataJob A job containing offline user data of store visitors, or user list members that will be processed asynchronously. The uploaded data isn't readable and the processing results of the job can only be read using GoogleAdsService.Search/SearchStream.
OperatingSystemVersionConstant A mobile operating system version or a range of versions, depending on operator_type. List of available mobile platforms at https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms
PaidOrganicSearchTermView A paid organic search term view providing a view of search stats across ads and organic listings aggregated by search term at the ad group level.
ParentalStatusView A parental status view.
ProductBiddingCategoryConstant A Product Bidding Category.
ProductGroupView A product group view.
Recommendation A recommendation.
RemarketingAction A remarketing action. A snippet of JavaScript code that will collect the product ID and the type of page people visited (product page, shopping cart page, purchase page, general site visit) on an advertiser's website.
Resources List of resources that can be used in order to generate new Reports or re-generate the old one.
SearchTermView A search term view with metrics aggregated by search term at the ad group level.
SharedCriterion A criterion belonging to a shared set.
SharedSet SharedSets are used for sharing criterion exclusions across multiple campaigns.
ShoppingPerformanceView Shopping performance view. Provides Shopping campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.
SmartCampaignSearchTermView A Smart campaign search term view.
SmartCampaignSetting Settings for configuring Smart campaigns.
ThirdPartyAppAnalyticsLink A data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.
TopicConstant Use topics to target or exclude placements in the Google Display Network based on the category into which the placement falls (for example, "Pets & Animals/Pets/Dogs").
TopicView A topic view.
UserInterest A user interest: a particular interest-based vertical to be targeted.
UserList A user list. This is a list of users a customer may target.
UserLocationView A user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.
Video A video.
WebpageView A webpage view.
AccessibleBiddingStrategy

Represents a view of BiddingStrategies owned by and shared with the customer. In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.

Columns
Name Type Behavior Description
AccessibleBiddingStrategyId Long ATTRIBUTE Output only. The ID of the bidding strategy.
AccessibleBiddingStrategyMaximizeConversionValueTargetRoas Double ATTRIBUTE The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.
AccessibleBiddingStrategyMaximizeConversionsTargetCpa Long ATTRIBUTE Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
AccessibleBiddingStrategyName String ATTRIBUTE Output only. The name of the bidding strategy.
AccessibleBiddingStrategyOwnerCustomerId Long ATTRIBUTE Output only. The ID of the Customer which owns the bidding strategy.
AccessibleBiddingStrategyOwnerDescriptiveName String ATTRIBUTE Output only. descriptive_name of the Customer which owns the bidding strategy.
AccessibleBiddingStrategyResourceName String ATTRIBUTE Output only. The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
AccessibleBiddingStrategyTargetCpaTargetCpaMicros Long ATTRIBUTE Output only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
AccessibleBiddingStrategyTargetImpressionShareCpcBidCeilingMicros Long ATTRIBUTE Output only. The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.
AccessibleBiddingStrategyTargetImpressionShareLocation String ATTRIBUTE Output only. The targeted location on the search results page. The allowed values are ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
AccessibleBiddingStrategyTargetImpressionShareLocationFractionMicros Long ATTRIBUTE The desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10, 000.
AccessibleBiddingStrategyTargetRoasTargetRoas Double ATTRIBUTE Required. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
AccessibleBiddingStrategyTargetSpendCpcBidCeilingMicros Long ATTRIBUTE Output only. Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
AccessibleBiddingStrategyTargetSpendTargetSpendMicros Long ATTRIBUTE Output only. The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.
AccessibleBiddingStrategyType String ATTRIBUTE Output only. The type of the bidding strategy. The allowed values are COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, PAGE_ONE_PROMOTED, PERCENT_CPC, TARGET_CPA, TARGET_CPM, TARGET_IMPRESSION_SHARE, TARGET_OUTRANK_SHARE, TARGET_ROAS, TARGET_SPEND, UNKNOWN, UNSPECIFIED.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AccountBudget

An account-level budget. It contains information about the budget itself, as well as the most recently approved changes to the budget and proposed changes that are pending approval. The proposed changes that are pending approval, if any, are found in 'pending_proposal'. Effective details about the budget are found in fields prefixed 'approved_', 'adjusted_' and those without a prefix. Since some effective details may differ from what the user had originally requested (e.g. spending limit), these differences are juxtaposed via 'proposed_', 'approved_', and possibly 'adjusted_' fields. This resource is mutated using AccountBudgetProposal and cannot be mutated directly. A budget may have at most one pending proposal at any given time. It is read through pending_proposal. Once approved, a budget may be subject to adjustments, such as credit adjustments. Adjustments create differences between the 'approved' and 'adjusted' fields, which would otherwise be identical.

Columns
Name Type Behavior Description
AccountBudgetAdjustedSpendingLimitMicros Long ATTRIBUTE Output only. The adjusted spending limit in micros. One million is equivalent to one unit. If the approved spending limit is finite, the adjusted spending limit may vary depending on the types of adjustments applied to this budget, if applicable. The different kinds of adjustments are described here: https://support.google.com/google-ads/answer/1704323 For example, a debit adjustment reduces how much the account is allowed to spend.
AccountBudgetAdjustedSpendingLimitType String ATTRIBUTE Output only. The adjusted spending limit as a well-defined type, e.g. INFINITE. This will only be populated if the adjusted spending limit is INFINITE, which is guaranteed to be true if the approved spending limit is INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetAmountServedMicros Long ATTRIBUTE Output only. The value of Ads that have been served, in micros. This includes overdelivery costs, in which case a credit might be automatically applied to the budget (see total_adjustments_micros).
AccountBudgetApprovedEndDateTime Date ATTRIBUTE Output only. The approved end time in yyyy-MM-dd HH🇲🇲ss format.
AccountBudgetApprovedEndTimeType String ATTRIBUTE Output only. The approved end time as a well-defined type, e.g. FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
AccountBudgetApprovedSpendingLimitMicros Long ATTRIBUTE Output only. The approved spending limit in micros. One million is equivalent to one unit. This will only be populated if the proposed spending limit is finite, and will always be greater than or equal to the proposed spending limit.
AccountBudgetApprovedSpendingLimitType String ATTRIBUTE Output only. The approved spending limit as a well-defined type, e.g. INFINITE. This will only be populated if the approved spending limit is INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetApprovedStartDateTime Date ATTRIBUTE Output only. The approved start time of the account-level budget in yyyy-MM-dd HH🇲🇲ss format. For example, if a new budget is approved after the proposed start time, the approved start time is the time of approval.
AccountBudgetBillingSetup String ATTRIBUTE Output only. The resource name of the billing setup associated with this account-level budget. BillingSetup resource names have the form: customers/{customer_id}/billingSetups/{billing_setup_id}
AccountBudgetId Long ATTRIBUTE Output only. The ID of the account-level budget.
AccountBudgetName String ATTRIBUTE Output only. The name of the account-level budget.
AccountBudgetNotes String ATTRIBUTE Output only. Notes associated with the budget.
AccountBudgetPendingProposalAccountBudgetProposal String ATTRIBUTE Output only. The resource name of the proposal. AccountBudgetProposal resource names have the form: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
AccountBudgetPendingProposalCreationDateTime Date ATTRIBUTE Output only. The time when this account-level budget proposal was created. Formatted as yyyy-MM-dd HH🇲🇲ss.
AccountBudgetPendingProposalEndDateTime Date ATTRIBUTE Output only. The end time in yyyy-MM-dd HH🇲🇲ss format.
AccountBudgetPendingProposalEndTimeType String ATTRIBUTE Output only. The end time as a well-defined type, e.g. FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
AccountBudgetPendingProposalName String ATTRIBUTE Output only. The name to assign to the account-level budget.
AccountBudgetPendingProposalNotes String ATTRIBUTE Output only. Notes associated with this budget.
AccountBudgetPendingProposalProposalType String ATTRIBUTE Output only. The type of this proposal, e.g. END to end the budget associated with this proposal. The allowed values are CREATE, END, REMOVE, UNKNOWN, UNSPECIFIED, UPDATE.
AccountBudgetPendingProposalPurchaseOrderNumber String ATTRIBUTE Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices.
AccountBudgetPendingProposalSpendingLimitMicros Long ATTRIBUTE Output only. The spending limit in micros. One million is equivalent to one unit.
AccountBudgetPendingProposalSpendingLimitType String ATTRIBUTE Output only. The spending limit as a well-defined type, e.g. INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetPendingProposalStartDateTime Date ATTRIBUTE Output only. The start time in yyyy-MM-dd HH🇲🇲ss format.
AccountBudgetProposedEndDateTime Date ATTRIBUTE Output only. The proposed end time in yyyy-MM-dd HH🇲🇲ss format.
AccountBudgetProposedEndTimeType String ATTRIBUTE Output only. The proposed end time as a well-defined type, e.g. FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
AccountBudgetProposedSpendingLimitMicros Long ATTRIBUTE Output only. The proposed spending limit in micros. One million is equivalent to one unit.
AccountBudgetProposedSpendingLimitType String ATTRIBUTE Output only. The proposed spending limit as a well-defined type, e.g. INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetProposedStartDateTime Date ATTRIBUTE Output only. The proposed start time of the account-level budget in yyyy-MM-dd HH🇲🇲ss format. If a start time type of NOW was proposed, this is the time of request.
AccountBudgetPurchaseOrderNumber String ATTRIBUTE Output only. A purchase order number is a value that helps users reference this budget in their monthly invoices.
AccountBudgetResourceName String ATTRIBUTE Output only. The resource name of the account-level budget. AccountBudget resource names have the form: customers/{customer_id}/accountBudgets/{account_budget_id}
AccountBudgetStatus String ATTRIBUTE Output only. The status of this account-level budget. The allowed values are APPROVED, CANCELLED, PENDING, UNKNOWN, UNSPECIFIED.
AccountBudgetTotalAdjustmentsMicros Long ATTRIBUTE Output only. The total adjustments amount. An example of an adjustment is courtesy credits.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AccountBudgetProposal

An account-level budget proposal. All fields prefixed with 'proposed' may not necessarily be applied directly. For example, proposed spending limits may be adjusted before their application. This is true if the 'proposed' field has an 'approved' counterpart, e.g. spending limits. Please note that the proposal type (proposal_type) changes which fields are required and which must remain empty.

Columns
Name Type Behavior Description
AccountBudgetProposalAccountBudget String ATTRIBUTE Immutable. The resource name of the account-level budget associated with this proposal.
AccountBudgetProposalApprovalDateTime Date ATTRIBUTE Output only. The date time when this account-level budget was approved, if applicable.
AccountBudgetProposalApprovedEndDateTime Date ATTRIBUTE Output only. The approved end date time in yyyy-mm-dd hh🇲🇲ss format.
AccountBudgetProposalApprovedEndTimeType String ATTRIBUTE Output only. The approved end date time as a well-defined type, e.g. FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalApprovedSpendingLimitMicros Long ATTRIBUTE Output only. The approved spending limit in micros. One million is equivalent to one unit.
AccountBudgetProposalApprovedSpendingLimitType String ATTRIBUTE Output only. The approved spending limit as a well-defined type, e.g. INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalApprovedStartDateTime Date ATTRIBUTE Output only. The approved start date time in yyyy-mm-dd hh🇲🇲ss format.
AccountBudgetProposalBillingSetup String ATTRIBUTE Immutable. The resource name of the billing setup associated with this proposal.
AccountBudgetProposalCreationDateTime Date ATTRIBUTE Output only. The date time when this account-level budget proposal was created, which is not the same as its approval date time, if applicable.
AccountBudgetProposalId Long ATTRIBUTE Output only. The ID of the proposal.
AccountBudgetProposalProposalType String ATTRIBUTE Immutable. The type of this proposal, e.g. END to end the budget associated with this proposal. The allowed values are CREATE, END, REMOVE, UNKNOWN, UNSPECIFIED, UPDATE.
AccountBudgetProposalProposedEndDateTime Date ATTRIBUTE Immutable. The proposed end date time in yyyy-mm-dd hh🇲🇲ss format.
AccountBudgetProposalProposedEndTimeType String ATTRIBUTE Immutable. The proposed end date time as a well-defined type, e.g. FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalProposedName String ATTRIBUTE Immutable. The name to assign to the account-level budget.
AccountBudgetProposalProposedNotes String ATTRIBUTE Immutable. Notes associated with this budget.
AccountBudgetProposalProposedPurchaseOrderNumber String ATTRIBUTE Immutable. A purchase order number is a value that enables the user to help them reference this budget in their monthly invoices.
AccountBudgetProposalProposedSpendingLimitMicros Long ATTRIBUTE Immutable. The proposed spending limit in micros. One million is equivalent to one unit.
AccountBudgetProposalProposedSpendingLimitType String ATTRIBUTE Immutable. The proposed spending limit as a well-defined type, e.g. INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalProposedStartDateTime Date ATTRIBUTE Immutable. The proposed start date time in yyyy-mm-dd hh🇲🇲ss format.
AccountBudgetProposalResourceName String ATTRIBUTE Immutable. The resource name of the proposal. AccountBudgetProposal resource names have the form: customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}
AccountBudgetProposalStatus String ATTRIBUTE Output only. The status of this proposal. When a new proposal is created, the status defaults to PENDING. The allowed values are APPROVED, APPROVED_HELD, CANCELLED, PENDING, REJECTED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.

Represents the data sharing connection between a Google Ads account and another account

Columns
Name Type Behavior Description
AccountLinkAccountLinkId Long ATTRIBUTE Output only. The ID of the link. This field is read only.
AccountLinkDataPartnerDataPartnerId Long ATTRIBUTE Immutable. The customer ID of the Data partner account. This field is required and should not be empty when creating a new data partner link. It is unable to be modified after the creation of the link.
AccountLinkGoogleAdsCustomer String ATTRIBUTE Immutable. The resource name of the Google Ads account. This field is required and should not be empty when creating a new Google Ads link. It is unable to be modified after the creation of the link.
AccountLinkResourceName String ATTRIBUTE Immutable. Resource name of the account link. AccountLink resource names have the form: customers/{customer_id}/accountLinks/{account_link_id}
AccountLinkStatus String ATTRIBUTE The status of the link. The allowed values are ENABLED, PENDING_APPROVAL, REJECTED, REMOVED, REQUESTED, REVOKED, UNKNOWN, UNSPECIFIED.
AccountLinkThirdPartyAppAnalyticsAppAnalyticsProviderId Long ATTRIBUTE Immutable. The ID of the app analytics provider. This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link.
AccountLinkThirdPartyAppAnalyticsAppId String ATTRIBUTE Immutable. A string that uniquely identifies a mobile application from which the data was collected to the Google Ads API. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (e.g., "422689480" for "Gmail" whose App Store link is https://apps.apple.com/us/app/gmail-email-by-google/id422689480). For Android, the ID string is the application's package name (e.g., "com.google.android.gm" for "Gmail" given Google Play link https://play.google.com/store/apps/details?id=com.google.android.gm) This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link.
AccountLinkThirdPartyAppAnalyticsAppVendor String ATTRIBUTE Immutable. The vendor of the app. This field should not be empty when creating a new third party app analytics link. It is unable to be modified after the creation of the link. The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
AccountLinkType String ATTRIBUTE Output only. The type of the linked account. The allowed values are DATA_PARTNER, GOOGLE_ADS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroup

An ad group.

Table Specific Information

Select

Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.

Columns
Name Type Behavior Description
AdGroupAdRotationMode String ATTRIBUTE The ad rotation mode of the ad group. The allowed values are OPTIMIZE, ROTATE_FOREVER, UNKNOWN, UNSPECIFIED.
AdGroupAudienceSettingUseAudienceGrouped Bool ATTRIBUTE Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
AdGroupBaseAdGroup String ATTRIBUTE Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only.
AdGroupCampaign String ATTRIBUTE Immutable. The campaign to which the ad group belongs.
AdGroupCpcBidMicros Long ATTRIBUTE The maximum CPC (cost-per-click) bid.
AdGroupCpmBidMicros Long ATTRIBUTE The maximum CPM (cost-per-thousand viewable impressions) bid.
AdGroupCpvBidMicros Long ATTRIBUTE Output only. The CPV (cost-per-view) bid.
AdGroupDisplayCustomBidDimension String ATTRIBUTE Allows advertisers to specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. The allowed values are AGE_RANGE, AUDIENCE, GENDER, INCOME_RANGE, KEYWORD, PARENTAL_STATUS, PLACEMENT, TOPIC, UNKNOWN, UNSPECIFIED.
AdGroupEffectiveCpcBidMicros Long ATTRIBUTE Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null.
AdGroupEffectiveTargetCpaMicros Long ATTRIBUTE Output only. The effective target CPA (cost-per-acquisition). This field is read-only.
AdGroupEffectiveTargetCpaSource String ATTRIBUTE Output only. Source of the effective target CPA. This field is read-only. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupEffectiveTargetRoas Double ATTRIBUTE Output only. The effective target ROAS (return-on-ad-spend). This field is read-only.
AdGroupEffectiveTargetRoasSource String ATTRIBUTE Output only. Source of the effective target ROAS. This field is read-only. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupExcludedParentAssetFieldTypes String ATTRIBUTE The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. The allowed values are BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOTION, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED, VIDEO, YOUTUBE_VIDEO.
AdGroupExplorerAutoOptimizerSettingOptIn Bool ATTRIBUTE Indicates whether the optimizer is turned on.
AdGroupFinalUrlSuffix String ATTRIBUTE URL template for appending params to Final URL.
AdGroupId Long ATTRIBUTE Output only. The ID of the ad group.
AdGroupLabels String ATTRIBUTE Output only. The resource names of labels attached to this ad group.
AdGroupName String ATTRIBUTE The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
AdGroupPercentCpcBidMicros Long ATTRIBUTE The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0, 1) and the value stored here is 1, 000, 000 * [fraction].
AdGroupResourceName String ATTRIBUTE Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
AdGroupStatus String ATTRIBUTE The status of the ad group. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
AdGroupTargetCpaMicros Long ATTRIBUTE The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored.
AdGroupTargetCpmMicros Long ATTRIBUTE Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown.
AdGroupTargetRoas Double ATTRIBUTE The target ROAS (return-on-ad-spend) override. If the ad group's campaign bidding strategy is TargetRoas or MaximizeConversionValue (with its target_roas field set), then this field overrides the target ROAS specified in the campaign's bidding strategy. Otherwise, this value is ignored.
AdGroupTargetingSettingTargetRestrictions String ATTRIBUTE The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
AdGroupTrackingUrlTemplate String ATTRIBUTE The URL template for constructing a tracking URL.
AdGroupType String ATTRIBUTE Immutable. The type of the ad group. The allowed values are DISPLAY_STANDARD, HOTEL_ADS, PROMOTED_HOTEL_ADS, SEARCH_DYNAMIC_ADS, SEARCH_STANDARD, SHOPPING_COMPARISON_LISTING_ADS, SHOPPING_PRODUCT_ADS, SHOPPING_SMART_ADS, SMART_CAMPAIGN_ADS, UNKNOWN, UNSPECIFIED, VIDEO_BUMPER, VIDEO_EFFICIENT_REACH, VIDEO_NON_SKIPPABLE_IN_STREAM, VIDEO_OUTSTREAM, VIDEO_RESPONSIVE, VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_TRUE_VIEW_IN_STREAM.
AdGroupUrlCustomParameters String ATTRIBUTE The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
AbsoluteTopImpressionPercentage Double METRIC The percent of your ad impressions that are shown as the very first ad above the organic search results.
ActiveViewCpm Double METRIC Average cost of viewable impressions (active_view_impressions).
ActiveViewCtr Double METRIC Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
ActiveViewImpressions Long METRIC A measurement of how often your ad has become viewable on a Display Network site.
ActiveViewMeasurability Double METRIC The ratio of impressions that could be measured by Active View over the number of served impressions.
ActiveViewMeasurableCostMicros Long METRIC The cost of the impressions you received that were measurable by Active View.
ActiveViewMeasurableImpressions Long METRIC The number of times your ads are appearing on placements in positions where they can be seen.
ActiveViewViewability Double METRIC The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
AllConversionsByConversionDate Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double METRIC All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsValue Double METRIC The value of all conversions.
AllConversionsValueByConversionDate Double METRIC The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AverageCost Double METRIC The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks received.
AverageCpe Double METRIC The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.
AverageCpm Double METRIC Average cost-per-thousand impressions (CPM).
AverageCpv Double METRIC The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
AveragePageViews Double METRIC Average number of pages viewed per session.
AverageTimeOnSite Double METRIC Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
BounceRate Double METRIC Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
Clicks Long METRIC The number of clicks.
ContentImpressionShare Double METRIC The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
ContentRankLostImpressionShare Double METRIC The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Conversions Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsByConversionDate Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double METRIC Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValueByConversionDate Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CostPerCurrentModelAttributedConversion Double METRIC The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CrossDeviceConversions Double METRIC Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
CurrentModelAttributedConversions Double METRIC Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CurrentModelAttributedConversionsValue Double METRIC The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
EngagementRate Double METRIC How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagements Long METRIC The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
GmailForwards Long METRIC The number of times the ad was forwarded to someone else as a message.
GmailSaves Long METRIC The number of times someone has saved your Gmail ad to their inbox as a message.
GmailSecondaryClicks Long METRIC The number of clicks to the landing page on the expanded state of Gmail ads.
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
InteractionEventTypes String METRIC The types of payable and free interactions. The allowed values are UNSPECIFIED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double METRIC How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactions Long METRIC The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
PercentNewVisitors Double METRIC Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
PhoneCalls Long METRIC Number of offline phone calls.
PhoneImpressions Long METRIC Number of offline phone impressions.
PhoneThroughRate Double METRIC Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
RelativeCtr Double METRIC Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites.
SearchAbsoluteTopImpressionShare Double METRIC The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999.
SearchBudgetLostAbsoluteTopImpressionShare Double METRIC The number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
SearchBudgetLostTopImpressionShare Double METRIC The number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
SearchExactMatchImpressionShare Double METRIC The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
SearchImpressionShare Double METRIC The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
SearchRankLostAbsoluteTopImpressionShare Double METRIC The number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
SearchRankLostImpressionShare Double METRIC The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
SearchRankLostTopImpressionShare Double METRIC The number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
SearchTopImpressionShare Double METRIC The impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
TopImpressionPercentage Double METRIC The percent of your ad impressions that are shown anywhere above the organic search results.
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerAllConversionsByConversionDate Double METRIC The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ValuePerConversionsByConversionDate Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double METRIC The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
VideoQuartileP100Rate Double METRIC Percentage of impressions where the viewer watched all of your video.
VideoQuartileP25Rate Double METRIC Percentage of impressions where the viewer watched 25% of your video.
VideoQuartileP50Rate Double METRIC Percentage of impressions where the viewer watched 50% of your video.
VideoQuartileP75Rate Double METRIC Percentage of impressions where the viewer watched 75% of your video.
VideoViewRate Double METRIC The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
VideoViews Long METRIC The number of times your video ads were viewed.
ViewThroughConversions Long METRIC The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
AdDestinationType String SEGMENT Ad Destination type. The allowed values are APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, UNSPECIFIED, WEBSITE, YOUTUBE.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENT Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, UNKNOWN, UNSPECIFIED, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENT Resource name of the conversion action.
ConversionActionCategory String SEGMENT Conversion action category. The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, UNSPECIFIED.
ConversionActionName String SEGMENT Conversion action name.
ConversionAdjustment Bool SEGMENT This segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.
ConversionLagBucket String SEGMENT An enum value representing the number of days between the impression and the conversion. The allowed values are EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS, SIXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, THIRTEEN_TO_FOURTEEN_DAYS, THIRTY_TO_FORTY_FIVE_DAYS, THREE_TO_FOUR_DAYS, TWELVE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, TWO_TO_THREE_DAYS, UNKNOWN, UNSPECIFIED.
ConversionOrAdjustmentLagBucket String SEGMENT An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. The allowed values are ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_EIGHT_DAYS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, UNKNOWN, UNSPECIFIED.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Device String SEGMENT Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENT External conversion source. The allowed values are AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_ATTRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Hour Int SEGMENT Hour of day as a number between 0 and 23, inclusive.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
MonthOfYear String SEGMENT Month of the year, e.g., January. The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN, UNSPECIFIED.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAd

An ad group ad.

Table Specific Information

Select

Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.

Columns
Name Type Behavior Description
AdGroupAdActionItems String ATTRIBUTE Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Your headlines are a little too similar. Try adding more distinct headlines.".
AdGroupAdAdAddedByGoogleAds Bool ATTRIBUTE Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing.
AdGroupAdAdAppAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
AdGroupAdAdAppAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list.
AdGroupAdAdAppAdHtml5MediaBundles String ATTRIBUTE List of media bundle assets that may be used with the ad.
AdGroupAdAdAppAdImages String ATTRIBUTE List of image assets that may be displayed with the ad.
AdGroupAdAdAppAdMandatoryAdText String ATTRIBUTE Mandatory ad text.
AdGroupAdAdAppAdYoutubeVideos String ATTRIBUTE List of YouTube video assets that may be displayed with the ad.
AdGroupAdAdAppEngagementAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
AdGroupAdAdAppEngagementAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list.
AdGroupAdAdAppEngagementAdImages String ATTRIBUTE List of image assets that may be displayed with the ad.
AdGroupAdAdAppEngagementAdVideos String ATTRIBUTE List of video assets that may be displayed with the ad.
AdGroupAdAdAppPreRegistrationAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
AdGroupAdAdAppPreRegistrationAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list.
AdGroupAdAdAppPreRegistrationAdImages String ATTRIBUTE List of image asset IDs whose images may be displayed with the ad.
AdGroupAdAdAppPreRegistrationAdYoutubeVideos String ATTRIBUTE List of YouTube video asset IDs whose videos may be displayed with the ad.
AdGroupAdAdCallAdBusinessName String ATTRIBUTE The business name in the ad.
AdGroupAdAdCallAdCallTracked Bool ATTRIBUTE Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
AdGroupAdAdCallAdConversionAction String ATTRIBUTE The conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
AdGroupAdAdCallAdConversionReportingState String ATTRIBUTE The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. The allowed values are DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AdGroupAdAdCallAdCountryCode String ATTRIBUTE The country code in the ad.
AdGroupAdAdCallAdDescription1 String ATTRIBUTE The first line of the ad's description.
AdGroupAdAdCallAdDescription2 String ATTRIBUTE The second line of the ad's description.
AdGroupAdAdCallAdDisableCallConversion Bool ATTRIBUTE Whether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
AdGroupAdAdCallAdHeadline1 String ATTRIBUTE First headline in the ad.
AdGroupAdAdCallAdHeadline2 String ATTRIBUTE Second headline in the ad.
AdGroupAdAdCallAdPath1 String ATTRIBUTE First part of text that can be appended to the URL in the ad. Optional.
AdGroupAdAdCallAdPath2 String ATTRIBUTE Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
AdGroupAdAdCallAdPhoneNumber String ATTRIBUTE The phone number in the ad.
AdGroupAdAdCallAdPhoneNumberVerificationUrl String ATTRIBUTE The URL to be used for phone number verification.
AdGroupAdAdDevicePreference String ATTRIBUTE The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
AdGroupAdAdDisplayUploadAdDisplayUploadProductType String ATTRIBUTE The product type of this ad. See comments on the enum for details. The allowed values are DYNAMIC_HTML5_CUSTOM_AD, DYNAMIC_HTML5_EDUCATION_AD, DYNAMIC_HTML5_FLIGHT_AD, DYNAMIC_HTML5_HOTEL_AD, DYNAMIC_HTML5_HOTEL_RENTAL_AD, DYNAMIC_HTML5_JOB_AD, DYNAMIC_HTML5_LOCAL_AD, DYNAMIC_HTML5_REAL_ESTATE_AD, DYNAMIC_HTML5_TRAVEL_AD, HTML5_UPLOAD_AD, UNKNOWN, UNSPECIFIED.
AdGroupAdAdDisplayUploadAdMediaBundle String ATTRIBUTE A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information.
AdGroupAdAdDisplayUrl String ATTRIBUTE The URL that appears in the ad description for some ad formats.
AdGroupAdAdExpandedDynamicSearchAdDescription String ATTRIBUTE The description of the ad.
AdGroupAdAdExpandedDynamicSearchAdDescription2 String ATTRIBUTE The second description of the ad.
AdGroupAdAdExpandedTextAdDescription String ATTRIBUTE The description of the ad.
AdGroupAdAdExpandedTextAdDescription2 String ATTRIBUTE The second description of the ad.
AdGroupAdAdExpandedTextAdHeadlinePart1 String ATTRIBUTE The first part of the ad's headline.
AdGroupAdAdExpandedTextAdHeadlinePart2 String ATTRIBUTE The second part of the ad's headline.
AdGroupAdAdExpandedTextAdHeadlinePart3 String ATTRIBUTE The third part of the ad's headline.
AdGroupAdAdExpandedTextAdPath1 String ATTRIBUTE The text that can appear alongside the ad's displayed URL.
AdGroupAdAdExpandedTextAdPath2 String ATTRIBUTE Additional text that can appear alongside the ad's displayed URL.
AdGroupAdAdFinalAppUrls String ATTRIBUTE A list of final app URLs that will be used on mobile if the user has the specific app installed.
AdGroupAdAdFinalMobileUrls String ATTRIBUTE The list of possible final mobile URLs after all cross-domain redirects for the ad.
AdGroupAdAdFinalUrlSuffix String ATTRIBUTE The suffix to use when constructing a final URL.
AdGroupAdAdFinalUrls String ATTRIBUTE The list of possible final URLs after all cross-domain redirects for the ad.
AdGroupAdAdGmailAdHeaderImage String ATTRIBUTE The MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
AdGroupAdAdGmailAdMarketingImage String ATTRIBUTE The MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
AdGroupAdAdGmailAdMarketingImageDescription String ATTRIBUTE Description of the marketing image.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionText String ATTRIBUTE Text for the display-call-to-action.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionTextColor String ATTRIBUTE Text color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
AdGroupAdAdGmailAdMarketingImageDisplayCallToActionUrlCollectionId String ATTRIBUTE Identifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
AdGroupAdAdGmailAdMarketingImageHeadline String ATTRIBUTE Headline of the marketing image.
AdGroupAdAdGmailAdProductImages String ATTRIBUTE Product images. Up to 15 images are supported.
AdGroupAdAdGmailAdProductVideos String ATTRIBUTE Product videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
AdGroupAdAdGmailAdTeaserBusinessName String ATTRIBUTE Business name of the advertiser.
AdGroupAdAdGmailAdTeaserDescription String ATTRIBUTE Description of the teaser.
AdGroupAdAdGmailAdTeaserHeadline String ATTRIBUTE Headline of the teaser.
AdGroupAdAdGmailAdTeaserLogoImage String ATTRIBUTE The MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
AdGroupAdAdHotelAd String ATTRIBUTE Details pertaining to a hotel ad.
AdGroupAdAdId Long ATTRIBUTE Output only. The ID of the ad.
AdGroupAdAdImageAdImageUrl String ATTRIBUTE URL of the full size image.
AdGroupAdAdImageAdMimeType String ATTRIBUTE The mime type of the image. The allowed values are AUDIO_MP3, AUDIO_WAV, FLASH, HTML5_AD_ZIP, IMAGE_GIF, IMAGE_JPEG, IMAGE_PNG, MSEXCEL, MSWORD, PDF, RTF, TEXT_HTML, UNKNOWN, UNSPECIFIED.
AdGroupAdAdImageAdName String ATTRIBUTE The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty.
AdGroupAdAdImageAdPixelHeight Long ATTRIBUTE Height in pixels of the full size image.
AdGroupAdAdImageAdPixelWidth Long ATTRIBUTE Width in pixels of the full size image.
AdGroupAdAdImageAdPreviewImageUrl String ATTRIBUTE URL of the preview size image.
AdGroupAdAdImageAdPreviewPixelHeight Long ATTRIBUTE Height in pixels of the preview size image.
AdGroupAdAdImageAdPreviewPixelWidth Long ATTRIBUTE Width in pixels of the preview size image.
AdGroupAdAdLegacyAppInstallAd String ATTRIBUTE Immutable. Details pertaining to a legacy app install ad.
AdGroupAdAdLegacyResponsiveDisplayAdAccentColor String ATTRIBUTE The accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
AdGroupAdAdLegacyResponsiveDisplayAdAllowFlexibleColor Bool ATTRIBUTE Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
AdGroupAdAdLegacyResponsiveDisplayAdBusinessName String ATTRIBUTE The business name in the ad.
AdGroupAdAdLegacyResponsiveDisplayAdCallToActionText String ATTRIBUTE The call-to-action text for the ad.
AdGroupAdAdLegacyResponsiveDisplayAdDescription String ATTRIBUTE The description of the ad.
AdGroupAdAdLegacyResponsiveDisplayAdFormatSetting String ATTRIBUTE Specifies which format the ad will be served in. Default is ALL_FORMATS. The allowed values are ALL_FORMATS, NATIVE, NON_NATIVE, UNKNOWN, UNSPECIFIED.
AdGroupAdAdLegacyResponsiveDisplayAdLogoImage String ATTRIBUTE The MediaFile resource name of the logo image used in the ad.
AdGroupAdAdLegacyResponsiveDisplayAdLongHeadline String ATTRIBUTE The long version of the ad's headline.
AdGroupAdAdLegacyResponsiveDisplayAdMainColor String ATTRIBUTE The main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
AdGroupAdAdLegacyResponsiveDisplayAdMarketingImage String ATTRIBUTE The MediaFile resource name of the marketing image used in the ad.
AdGroupAdAdLegacyResponsiveDisplayAdPricePrefix String ATTRIBUTE Prefix before price. E.g. 'as low as'.
AdGroupAdAdLegacyResponsiveDisplayAdPromoText String ATTRIBUTE Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
AdGroupAdAdLegacyResponsiveDisplayAdShortHeadline String ATTRIBUTE The short version of the ad's headline.
AdGroupAdAdLegacyResponsiveDisplayAdSquareLogoImage String ATTRIBUTE The MediaFile resource name of the square logo image used in the ad.
AdGroupAdAdLegacyResponsiveDisplayAdSquareMarketingImage String ATTRIBUTE The MediaFile resource name of the square marketing image used in the ad.
AdGroupAdAdLocalAdCallToActions String ATTRIBUTE List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified.
AdGroupAdAdLocalAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified.
AdGroupAdAdLocalAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified.
AdGroupAdAdLocalAdLogoImages String ATTRIBUTE List of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified.
AdGroupAdAdLocalAdMarketingImages String ATTRIBUTE List of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified.
AdGroupAdAdLocalAdPath1 String ATTRIBUTE First part of optional text that can be appended to the URL in the ad.
AdGroupAdAdLocalAdPath2 String ATTRIBUTE Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
AdGroupAdAdLocalAdVideos String ATTRIBUTE List of YouTube video assets that may be displayed with the ad. Videos are optional and at most 20 can be specified.
AdGroupAdAdName String ATTRIBUTE Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
AdGroupAdAdResourceName String ATTRIBUTE Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
AdGroupAdAdResponsiveDisplayAdAccentColor String ATTRIBUTE The accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
AdGroupAdAdResponsiveDisplayAdAllowFlexibleColor Bool ATTRIBUTE Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.
AdGroupAdAdResponsiveDisplayAdBusinessName String ATTRIBUTE The advertiser/brand name. Maximum display width is 25.
AdGroupAdAdResponsiveDisplayAdCallToActionText String ATTRIBUTE The call-to-action text for the ad. Maximum display width is 30.
AdGroupAdAdResponsiveDisplayAdControlSpecEnableAssetEnhancements Bool ATTRIBUTE Whether the advertiser has opted into the asset enhancements feature.
AdGroupAdAdResponsiveDisplayAdControlSpecEnableAutogenVideo Bool ATTRIBUTE Whether the advertiser has opted into auto-gen video feature.
AdGroupAdAdResponsiveDisplayAdDescriptions String ATTRIBUTE Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
AdGroupAdAdResponsiveDisplayAdFormatSetting String ATTRIBUTE Specifies which format the ad will be served in. Default is ALL_FORMATS. The allowed values are ALL_FORMATS, NATIVE, NON_NATIVE, UNKNOWN, UNSPECIFIED.
AdGroupAdAdResponsiveDisplayAdHeadlines String ATTRIBUTE Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
AdGroupAdAdResponsiveDisplayAdLogoImages String ATTRIBUTE Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.
AdGroupAdAdResponsiveDisplayAdLongHeadline String ATTRIBUTE A required long format headline. The maximum length is 90 characters.
AdGroupAdAdResponsiveDisplayAdMainColor String ATTRIBUTE The main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
AdGroupAdAdResponsiveDisplayAdMarketingImages String ATTRIBUTE Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.
AdGroupAdAdResponsiveDisplayAdPricePrefix String ATTRIBUTE Prefix before price. E.g. 'as low as'.
AdGroupAdAdResponsiveDisplayAdPromoText String ATTRIBUTE Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
AdGroupAdAdResponsiveDisplayAdSquareLogoImages String ATTRIBUTE Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with square_logo_images, the maximum is 5.
AdGroupAdAdResponsiveDisplayAdSquareMarketingImages String ATTRIBUTE Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.
AdGroupAdAdResponsiveDisplayAdYoutubeVideos String ATTRIBUTE Optional YouTube videos for the ad. A maximum of 5 videos can be specified.
AdGroupAdAdResponsiveSearchAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
AdGroupAdAdResponsiveSearchAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list.
AdGroupAdAdResponsiveSearchAdPath1 String ATTRIBUTE First part of text that can be appended to the URL in the ad.
AdGroupAdAdResponsiveSearchAdPath2 String ATTRIBUTE Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
AdGroupAdAdShoppingComparisonListingAdHeadline String ATTRIBUTE Headline of the ad. This field is required. Allowed length is between 25 and 45 characters.
AdGroupAdAdShoppingProductAd String ATTRIBUTE Details pertaining to a Shopping product ad.
AdGroupAdAdShoppingSmartAd String ATTRIBUTE Details pertaining to a Smart Shopping ad.
AdGroupAdAdSmartCampaignAdDescriptions String ATTRIBUTE List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
AdGroupAdAdSmartCampaignAdHeadlines String ATTRIBUTE List of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
AdGroupAdAdSystemManagedResourceSource String ATTRIBUTE Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. The allowed values are AD_VARIATIONS, UNKNOWN, UNSPECIFIED.
AdGroupAdAdTextAdDescription1 String ATTRIBUTE The first line of the ad's description.
AdGroupAdAdTextAdDescription2 String ATTRIBUTE The second line of the ad's description.
AdGroupAdAdTextAdHeadline String ATTRIBUTE The headline of the ad.
AdGroupAdAdTrackingUrlTemplate String ATTRIBUTE The URL template for constructing a tracking URL.
AdGroupAdAdType String ATTRIBUTE Output only. The type of ad. The allowed values are APP_AD, APP_ENGAGEMENT_AD, APP_PRE_REGISTRATION_AD, CALL_AD, DYNAMIC_HTML5_AD, EXPANDED_DYNAMIC_SEARCH_AD, EXPANDED_TEXT_AD, GMAIL_AD, HOTEL_AD, HTML5_UPLOAD_AD, IMAGE_AD, IN_FEED_VIDEO_AD, LEGACY_APP_INSTALL_AD, LEGACY_RESPONSIVE_DISPLAY_AD, LOCAL_AD, RESPONSIVE_DISPLAY_AD, RESPONSIVE_SEARCH_AD, SHOPPING_COMPARISON_LISTING_AD, SHOPPING_PRODUCT_AD, SHOPPING_SMART_AD, SMART_CAMPAIGN_AD, TEXT_AD, UNKNOWN, UNSPECIFIED, VIDEO_AD, VIDEO_BUMPER_AD, VIDEO_NON_SKIPPABLE_IN_STREAM_AD, VIDEO_OUTSTREAM_AD, VIDEO_RESPONSIVE_AD, VIDEO_TRUEVIEW_IN_STREAM_AD.
AdGroupAdAdUrlCollections String ATTRIBUTE Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
AdGroupAdAdUrlCustomParameters String ATTRIBUTE The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, please use URL custom parameter operations.
AdGroupAdAdVideoAdBumperCompanionBannerAsset String ATTRIBUTE The Asset resource name of this image.
AdGroupAdAdVideoAdInFeedDescription1 String ATTRIBUTE First text line for the ad.
AdGroupAdAdVideoAdInFeedDescription2 String ATTRIBUTE Second text line for the ad.
AdGroupAdAdVideoAdInFeedHeadline String ATTRIBUTE The headline of the ad.
AdGroupAdAdVideoAdInFeedThumbnail String ATTRIBUTE Video thumbnail image to use. The allowed values are DEFAULT_THUMBNAIL, THUMBNAIL_1, THUMBNAIL_2, THUMBNAIL_3, UNKNOWN, UNSPECIFIED.
AdGroupAdAdVideoAdInStreamActionButtonLabel String ATTRIBUTE Label on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise.
AdGroupAdAdVideoAdInStreamActionHeadline String ATTRIBUTE Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
AdGroupAdAdVideoAdInStreamCompanionBannerAsset String ATTRIBUTE The Asset resource name of this image.
AdGroupAdAdVideoAdNonSkippableActionButtonLabel String ATTRIBUTE Label on the "Call To Action" button taking the user to the video ad's final URL.
AdGroupAdAdVideoAdNonSkippableActionHeadline String ATTRIBUTE Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button.
AdGroupAdAdVideoAdNonSkippableCompanionBannerAsset String ATTRIBUTE The Asset resource name of this image.
AdGroupAdAdVideoAdOutStreamDescription String ATTRIBUTE The description line.
AdGroupAdAdVideoAdOutStreamHeadline String ATTRIBUTE The headline of the ad.
AdGroupAdAdVideoAdVideoAsset String ATTRIBUTE The Asset resource name of this video.
AdGroupAdAdVideoResponsiveAdCallToActions String ATTRIBUTE List of text assets used for the button, e.g. the "Call To Action" button. Currently, only a single value for the button is supported.
AdGroupAdAdVideoResponsiveAdCompanionBanners String ATTRIBUTE List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
AdGroupAdAdVideoResponsiveAdDescriptions String ATTRIBUTE List of text assets used for the description. Currently, only a single value for the description is supported.
AdGroupAdAdVideoResponsiveAdHeadlines String ATTRIBUTE List of text assets used for the short headline, e.g. the "Call To Action" banner. Currently, only a single value for the short headline is supported.
AdGroupAdAdVideoResponsiveAdLongHeadlines String ATTRIBUTE List of text assets used for the long headline. Currently, only a single value for the long headline is supported.
AdGroupAdAdVideoResponsiveAdVideos String ATTRIBUTE List of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
AdGroupAdAdGroup String ATTRIBUTE Immutable. The ad group to which the ad belongs.
AdGroupAdAdStrength String ATTRIBUTE Output only. Overall ad strength for this ad group ad. The allowed values are AVERAGE, EXCELLENT, GOOD, NO_ADS, PENDING, POOR, UNKNOWN, UNSPECIFIED.
AdGroupAdLabels String ATTRIBUTE Output only. The resource names of labels attached to this ad group ad.
AdGroupAdPolicySummaryApprovalStatus String ATTRIBUTE Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. The allowed values are APPROVED, APPROVED_LIMITED, AREA_OF_INTEREST_ONLY, DISAPPROVED, UNKNOWN, UNSPECIFIED.
AdGroupAdPolicySummaryPolicyTopicEntries String ATTRIBUTE Output only. The list of policy findings for this ad.
AdGroupAdPolicySummaryReviewStatus String ATTRIBUTE Output only. Where in the review process this ad is. The allowed values are ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AdGroupAdResourceName String ATTRIBUTE Immutable. The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
AdGroupAdStatus String ATTRIBUTE The status of the ad. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
AbsoluteTopImpressionPercentage Double METRIC The percent of your ad impressions that are shown as the very first ad above the organic search results.
ActiveViewCpm Double METRIC Average cost of viewable impressions (active_view_impressions).
ActiveViewCtr Double METRIC Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
ActiveViewImpressions Long METRIC A measurement of how often your ad has become viewable on a Display Network site.
ActiveViewMeasurability Double METRIC The ratio of impressions that could be measured by Active View over the number of served impressions.
ActiveViewMeasurableCostMicros Long METRIC The cost of the impressions you received that were measurable by Active View.
ActiveViewMeasurableImpressions Long METRIC The number of times your ads are appearing on placements in positions where they can be seen.
ActiveViewViewability Double METRIC The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
AllConversionsByConversionDate Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double METRIC All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsValue Double METRIC The value of all conversions.
AllConversionsValueByConversionDate Double METRIC The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AverageCost Double METRIC The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks received.
AverageCpe Double METRIC The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.
AverageCpm Double METRIC Average cost-per-thousand impressions (CPM).
AverageCpv Double METRIC The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
AveragePageViews Double METRIC Average number of pages viewed per session.
AverageTimeOnSite Double METRIC Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
BounceRate Double METRIC Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
Clicks Long METRIC The number of clicks.
Conversions Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsByConversionDate Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double METRIC Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValueByConversionDate Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CostPerCurrentModelAttributedConversion Double METRIC The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CrossDeviceConversions Double METRIC Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
CurrentModelAttributedConversions Double METRIC Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CurrentModelAttributedConversionsValue Double METRIC The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
EngagementRate Double METRIC How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagements Long METRIC The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
GmailForwards Long METRIC The number of times the ad was forwarded to someone else as a message.
GmailSaves Long METRIC The number of times someone has saved your Gmail ad to their inbox as a message.
GmailSecondaryClicks Long METRIC The number of clicks to the landing page on the expanded state of Gmail ads.
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
InteractionEventTypes String METRIC The types of payable and free interactions. The allowed values are UNSPECIFIED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double METRIC How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactions Long METRIC The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
PercentNewVisitors Double METRIC Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
TopImpressionPercentage Double METRIC The percent of your ad impressions that are shown anywhere above the organic search results.
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerAllConversionsByConversionDate Double METRIC The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ValuePerConversionsByConversionDate Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ValuePerCurrentModelAttributedConversion Double METRIC The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
VideoQuartileP100Rate Double METRIC Percentage of impressions where the viewer watched all of your video.
VideoQuartileP25Rate Double METRIC Percentage of impressions where the viewer watched 25% of your video.
VideoQuartileP50Rate Double METRIC Percentage of impressions where the viewer watched 50% of your video.
VideoQuartileP75Rate Double METRIC Percentage of impressions where the viewer watched 75% of your video.
VideoViewRate Double METRIC The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
VideoViews Long METRIC The number of times your video ads were viewed.
ViewThroughConversions Long METRIC The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
AdDestinationType String SEGMENT Ad Destination type. The allowed values are APP_DEEP_LINK, APP_STORE, LEAD_FORM, LOCATION_LISTING, MAP_DIRECTIONS, MESSAGE, NOT_APPLICABLE, PHONE_CALL, UNKNOWN, UNMODELED_FOR_CONVERSIONS, UNSPECIFIED, WEBSITE, YOUTUBE.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENT Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, UNKNOWN, UNSPECIFIED, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENT Resource name of the conversion action.
ConversionActionCategory String SEGMENT Conversion action category. The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, UNSPECIFIED.
ConversionActionName String SEGMENT Conversion action name.
ConversionAdjustment Bool SEGMENT This segments your conversion columns by the original conversion and conversion value vs. the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data.
ConversionLagBucket String SEGMENT An enum value representing the number of days between the impression and the conversion. The allowed values are EIGHT_TO_NINE_DAYS, ELEVEN_TO_TWELVE_DAYS, FIVE_TO_SIX_DAYS, FORTY_FIVE_TO_SIXTY_DAYS, FOURTEEN_TO_TWENTY_ONE_DAYS, FOUR_TO_FIVE_DAYS, LESS_THAN_ONE_DAY, NINE_TO_TEN_DAYS, ONE_TO_TWO_DAYS, SEVEN_TO_EIGHT_DAYS, SIXTY_TO_NINETY_DAYS, SIX_TO_SEVEN_DAYS, TEN_TO_ELEVEN_DAYS, THIRTEEN_TO_FOURTEEN_DAYS, THIRTY_TO_FORTY_FIVE_DAYS, THREE_TO_FOUR_DAYS, TWELVE_TO_THIRTEEN_DAYS, TWENTY_ONE_TO_THIRTY_DAYS, TWO_TO_THREE_DAYS, UNKNOWN, UNSPECIFIED.
ConversionOrAdjustmentLagBucket String SEGMENT An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. The allowed values are ADJUSTMENT_EIGHT_TO_NINE_DAYS, ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS, ADJUSTMENT_FIVE_TO_SIX_DAYS, ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS, ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS, ADJUSTMENT_FOUR_TO_FIVE_DAYS, ADJUSTMENT_LESS_THAN_ONE_DAY, ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS, ADJUSTMENT_NINE_TO_TEN_DAYS, ADJUSTMENT_ONE_TO_TWO_DAYS, ADJUSTMENT_SEVEN_TO_EIGHT_DAYS, ADJUSTMENT_SIXTY_TO_NINETY_DAYS, ADJUSTMENT_SIX_TO_SEVEN_DAYS, ADJUSTMENT_TEN_TO_ELEVEN_DAYS, ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS, ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS, ADJUSTMENT_THREE_TO_FOUR_DAYS, ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS, ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS, ADJUSTMENT_TWO_TO_THREE_DAYS, ADJUSTMENT_UNKNOWN, CONVERSION_EIGHT_TO_NINE_DAYS, CONVERSION_ELEVEN_TO_TWELVE_DAYS, CONVERSION_FIVE_TO_SIX_DAYS, CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS, CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS, CONVERSION_FOUR_TO_FIVE_DAYS, CONVERSION_LESS_THAN_ONE_DAY, CONVERSION_NINE_TO_TEN_DAYS, CONVERSION_ONE_TO_TWO_DAYS, CONVERSION_SEVEN_TO_EIGHT_DAYS, CONVERSION_SIXTY_TO_NINETY_DAYS, CONVERSION_SIX_TO_SEVEN_DAYS, CONVERSION_TEN_TO_ELEVEN_DAYS, CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS, CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS, CONVERSION_THREE_TO_FOUR_DAYS, CONVERSION_TWELVE_TO_THIRTEEN_DAYS, CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS, CONVERSION_TWO_TO_THREE_DAYS, CONVERSION_UNKNOWN, UNKNOWN, UNSPECIFIED.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Device String SEGMENT Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENT External conversion source. The allowed values are AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_ATTRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
KeywordAdGroupCriterion String SEGMENT The AdGroupCriterion resource name.
KeywordInfoMatchType String SEGMENT The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordInfoText String SEGMENT The text of the keyword (at most 80 characters and 10 words).
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
MonthOfYear String SEGMENT Month of the year, e.g., January. The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN, UNSPECIFIED.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAdAssetCombinationView

A view on the usage of ad group ad asset combination. Now we only support AdGroupAdAssetCombinationView for Responsive Search Ads, with more ad types planned for the future.

Columns
Name Type Behavior Description
AdGroupAdAssetCombinationViewResourceName String ATTRIBUTE Output only. The resource name of the ad group ad asset combination view. The combination ID is 128 bits long, where the upper 64 bits are stored in asset_combination_id_high, and the lower 64 bits are stored in asset_combination_id_low. AdGroupAd Asset Combination view resource names have the form: customers/{customer_id}/adGroupAdAssetCombinationViews/{AdGroupAd.ad_group_id}~{AdGroupAd.ad.ad_id}~{AssetCombination.asset_combination_id_low}~{AssetCombination.asset_combination_id_high}
AdGroupAdAssetCombinationViewServedAssets String ATTRIBUTE Output only. Served assets.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAdAssetView

A link between an AdGroupAd and an Asset. Currently we only support AdGroupAdAssetView for AppAds.

Table Specific Information

Select

Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.

Columns
Name Type Behavior Description
AdGroupAdAssetViewAdGroupAd String ATTRIBUTE Output only. The ad group ad to which the asset is linked.
AdGroupAdAssetViewAsset String ATTRIBUTE Output only. The asset which is linked to the ad group ad.
AdGroupAdAssetViewEnabled Bool ATTRIBUTE Output only. The status between the asset and the latest version of the ad. If true, the asset is linked to the latest version of the ad. If false, it means the link once existed but has been removed and is no longer present in the latest version of the ad.
AdGroupAdAssetViewFieldType String ATTRIBUTE Output only. Role that the asset takes in the ad. The allowed values are BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOTION, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED, VIDEO, YOUTUBE_VIDEO.
AdGroupAdAssetViewPerformanceLabel String ATTRIBUTE Output only. Performance of an asset linkage. The allowed values are BEST, GOOD, LEARNING, LOW, PENDING, UNKNOWN, UNSPECIFIED.
AdGroupAdAssetViewPolicySummary String ATTRIBUTE Output only. Policy information for the ad group ad asset.
AdGroupAdAssetViewResourceName String ATTRIBUTE Output only. The resource name of the ad group ad asset view. Ad group ad asset view resource names have the form (Before V4): customers/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type} Ad group ad asset view resource names have the form (Beginning from V4): customers/{customer_id}/adGroupAdAssetViews/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.field_type}
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
AllConversionsValue Double METRIC The value of all conversions.
AllConversionsValuePerCost Double METRIC The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks received.
BiddableAppInstallConversions Double METRIC Number of app installs.
BiddableAppPostInstallConversions Double METRIC Number of in-app actions.
Clicks Long METRIC The number of clicks.
Conversions Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValuePerCost Double METRIC The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ViewThroughConversions Long METRIC The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAdLabel

A relationship between an ad group ad and a label.

Columns
Name Type Behavior Description
AdGroupAdLabelAdGroupAd String ATTRIBUTE Immutable. The ad group ad to which the label is attached.
AdGroupAdLabelLabel String ATTRIBUTE Immutable. The label assigned to the ad group ad.
AdGroupAdLabelResourceName String ATTRIBUTE Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAsset

A link between an ad group and an asset.

Columns
Name Type Behavior Description
AdGroupAssetAdGroup String ATTRIBUTE Required. Immutable. The ad group to which the asset is linked.
AdGroupAssetAsset String ATTRIBUTE Required. Immutable. The asset which is linked to the ad group.
AdGroupAssetFieldType String ATTRIBUTE Required. Immutable. Role that the asset takes under the linked ad group. The allowed values are BOOK_ON_GOOGLE, BUSINESS_NAME, CALL, CALLOUT, CALL_TO_ACTION_SELECTION, DESCRIPTION, HEADLINE, HOTEL_CALLOUT, LANDSCAPE_LOGO, LEAD_FORM, LOGO, LONG_HEADLINE, MANDATORY_AD_TEXT, MARKETING_IMAGE, MEDIA_BUNDLE, MOBILE_APP, PORTRAIT_MARKETING_IMAGE, PRICE, PROMOTION, SITELINK, SQUARE_MARKETING_IMAGE, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED, VIDEO, YOUTUBE_VIDEO.
AdGroupAssetResourceName String ATTRIBUTE Immutable. The resource name of the ad group asset. AdGroupAsset resource names have the form: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
AdGroupAssetStatus String ATTRIBUTE Status of the ad group asset. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
AbsoluteTopImpressionPercentage Double METRIC The percent of your ad impressions that are shown as the very first ad above the organic search results.
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
AllConversionsFromInteractionsRate Double METRIC All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsValue Double METRIC The value of all conversions.
AverageCost Double METRIC The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks received.
AverageCpe Double METRIC The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.
AverageCpm Double METRIC Average cost-per-thousand impressions (CPM).
AverageCpv Double METRIC The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicks Long METRIC The number of clicks.
Conversions Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsFromInteractionsRate Double METRIC Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CrossDeviceConversions Double METRIC Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
EngagementRate Double METRIC How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagements Long METRIC The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
InteractionEventTypes String METRIC The types of payable and free interactions. The allowed values are UNSPECIFIED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double METRIC How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactions Long METRIC The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
PhoneCalls Long METRIC Number of offline phone calls.
PhoneImpressions Long METRIC Number of offline phone impressions.
PhoneThroughRate Double METRIC Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
TopImpressionPercentage Double METRIC The percent of your ad impressions that are shown anywhere above the organic search results.
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
VideoViewRate Double METRIC The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
VideoViews Long METRIC The number of times your video ads were viewed.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
AssetInteractionTargetAsset String SEGMENT The asset resource name.
AssetInteractionTargetInteractionOnThisAsset Bool SEGMENT Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.
ClickType String SEGMENT Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, UNKNOWN, UNSPECIFIED, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENT Resource name of the conversion action.
ConversionActionCategory String SEGMENT Conversion action category. The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, UNSPECIFIED.
ConversionActionName String SEGMENT Conversion action name.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Device String SEGMENT Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENT External conversion source. The allowed values are AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_ATTRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
MonthOfYear String SEGMENT Month of the year, e.g., January. The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN, UNSPECIFIED.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
ManagerId Long Id of the manager account on behalf of which you are requesting customer data.
AdGroupAudienceView

An ad group audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated at the audience level.

Table Specific Information

Select

Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.

Columns
Name Type Behavior Description
AdGroupAudienceViewResourceName String ATTRIBUTE Output only. The resource name of the ad group audience view. Ad group audience view resource names have the form: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}
CustomerId Long ATTRIBUTE Output only. The ID of the customer.
ActiveViewCpm Double METRIC Average cost of viewable impressions (active_view_impressions).
ActiveViewCtr Double METRIC Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
ActiveViewImpressions Long METRIC A measurement of how often your ad has become viewable on a Display Network site.
ActiveViewMeasurability Double METRIC The ratio of impressions that could be measured by Active View over the number of served impressions.
ActiveViewMeasurableCostMicros Long METRIC The cost of the impressions you received that were measurable by Active View.
ActiveViewMeasurableImpressions Long METRIC The number of times your ads are appearing on placements in positions where they can be seen.
ActiveViewViewability Double METRIC The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
AllConversions Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
AllConversionsByConversionDate Double METRIC The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AllConversionsFromInteractionsRate Double METRIC All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsFromInteractionsValuePerInteraction Double METRIC The value of all conversions from interactions divided by the total number of interactions.
AllConversionsValue Double METRIC The value of all conversions.
AllConversionsValueByConversionDate Double METRIC The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
AllConversionsValuePerCost Double METRIC The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
AverageCost Double METRIC The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
AverageCpc Double METRIC The total cost of all clicks divided by the total number of clicks received.
AverageCpe Double METRIC The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.
AverageCpm Double METRIC Average cost-per-thousand impressions (CPM).
AverageCpv Double METRIC The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicks Long METRIC The number of clicks.
Conversions Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsByConversionDate Double METRIC The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ConversionsFromInteractionsRate Double METRIC Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValue Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ConversionsValueByConversionDate Double METRIC The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
CostMicros Long METRIC The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CostPerAllConversions Double METRIC The cost of ad interactions divided by all conversions.
CostPerConversion Double METRIC The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
CrossDeviceConversions Double METRIC Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Ctr Double METRIC The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
EngagementRate Double METRIC How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagements Long METRIC The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
GmailForwards Long METRIC The number of times the ad was forwarded to someone else as a message.
GmailSaves Long METRIC The number of times someone has saved your Gmail ad to their inbox as a message.
GmailSecondaryClicks Long METRIC The number of clicks to the landing page on the expanded state of Gmail ads.
Impressions Long METRIC Count of how often your ad has appeared on a search results page or website on the Google Network.
InteractionEventTypes String METRIC The types of payable and free interactions. The allowed values are UNSPECIFIED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.
InteractionRate Double METRIC How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactions Long METRIC The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
ValuePerAllConversions Double METRIC The value of all conversions divided by the number of all conversions.
ValuePerAllConversionsByConversionDate Double METRIC The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
ValuePerConversion Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
ValuePerConversionsByConversionDate Double METRIC The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
VideoQuartileP100Rate Double METRIC Percentage of impressions where the viewer watched all of your video.
VideoQuartileP25Rate Double METRIC Percentage of impressions where the viewer watched 25% of your video.
VideoQuartileP50Rate Double METRIC Percentage of impressions where the viewer watched 50% of your video.
VideoQuartileP75Rate Double METRIC Percentage of impressions where the viewer watched 75% of your video.
VideoViewRate Double METRIC The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
VideoViews Long METRIC The number of times your video ads were viewed.
ViewThroughConversions Long METRIC The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
AdNetworkType String SEGMENT Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
ClickType String SEGMENT Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, GET_DIRECTIONS, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION, HOTEL_PRICE, LOCATION_EXPANSION, LOCATION_FORMAT_CALL, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_IMAGE, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_MAP, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_TEXT, MOBILE_CALL_TRACKING, OFFER_PRINTS, OTHER, PRICE_EXTENSION, PRODUCT_AD_APP_DEEPLINK, PRODUCT_EXTENSION_CLICKS, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_CLICKS, PRODUCT_LISTING_AD_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_AD_TRANSACTABLE, PROMOTION_EXTENSION, SHOPPING_COMPARISON_LISTING, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SITELINKS, STORE_LOCATOR, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SWIPES, UNKNOWN, UNSPECIFIED, URL_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, VIDEO_WEBSITE_CLICKS, VISUAL_SITELINKS, WIRELESS_PLAN.
ConversionAction String SEGMENT Resource name of the conversion action.
ConversionActionCategory String SEGMENT Conversion action category. The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, UNSPECIFIED.
ConversionActionName String SEGMENT Conversion action name.
Date Date SEGMENT Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
DayOfWeek String SEGMENT Day of the week, e.g., MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
Device String SEGMENT Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
ExternalConversionSource String SEGMENT External conversion source. The allowed values are AD_CALL_METRICS, ANALYTICS, ANALYTICS_SEARCH_ADS_360, ANDROID_FIRST_OPEN, ANDROID_IN_APP, APP_UNSPECIFIED, CLICK_TO_CALL, DISPLAY_AND_VIDEO_360_FLOODLIGHT, FIREBASE, FIREBASE_SEARCH_ADS_360, FLOODLIGHT, GOOGLE_ATTRIBUTION, GOOGLE_HOSTED, GOOGLE_PLAY, IOS_FIRST_OPEN, IOS_IN_APP, SALESFORCE, SEARCH_ADS_360, STORE_SALES, STORE_SALES_CRM, STORE_SALES_DIRECT_UPLOAD, STORE_SALES_PAYMENT_NETWORK, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS, UNKNOWN, UNSPECIFIED, UPLOAD, UPLOAD_CALLS, WEBPAGE, WEBSITE_CALL_METRICS.
HotelDateSelectionType String SEGMENT Hotel date selection type. The allowed values are DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
Month Date SEGMENT Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
MonthOfYear String SEGMENT Month of the year, e.g., January. The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN, UNSPECIFIED.
Period String SEGMENT Predefined date range. The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN.
Quarter Date SEGMENT Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Slot String SEGMENT Position of the ad. The allowed values are CONTENT, MIXED, SEARCH_OTHER, SEARCH_PARTNER_OTHER, SEARCH_PARTNER_TOP, SEARCH_SIDE, SEARCH_TOP, UNKNOWN, UNSPECIFIED.
Week Date SEGMENT Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Year Int SEGMENT Year, formatted as yyyy.
Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the d