• Connection String Options
• Views

Connection String OptionsBack To Top

1. AuthScheme
2. DeveloperToken
3. ClientCustomerId
4. ManagerId
5. APIVersion
6. InitiateOAuth
7. OAuthClientId
8. OAuthClientSecret
9. OAuthAccessToken
10. OAuthSettingsLocation
11. OAuthVerifier
12. OAuthRefreshToken
13. OAuthExpiresIn
14. OAuthTokenTimestamp
15. OAuthJWTCert
16. OAuthJWTCertType
17. OAuthJWTCertPassword
18. OAuthJWTCertSubject
19. OAuthJWTIssuer
20. OAuthJWTSubject
21. SSLServerCert
22. FirewallType
23. FirewallServer
24. FirewallPort
25. FirewallUser
26. FirewallPassword
27. ProxyAutoDetect
28. ProxyServer
29. ProxyPort
30. ProxyAuthScheme
31. ProxyUser
32. ProxyPassword
33. ProxySSLType
34. ProxyExceptions
35. Logfile
36. Verbosity
37. LogModules
38. MaxLogFileSize
39. MaxLogFileCount
40. Location
41. BrowsableSchemas
42. Tables
43. Views
44. AutoCache
45. CacheDriver
46. CacheConnection
47. CacheLocation
48. CacheTolerance
49. Offline
50. CacheMetadata
51. BatchSize
52. ConnectionLifeTime
53. ConnectOnOpen
54. MaxRows
55. Other
56. PoolIdleTimeout
57. PoolMaxSize
58. PoolMinSize
59. PoolWaitTime
60. PseudoColumns
61. QueryPassthrough
62. RecurseChildren
63. RTK
64. SupportEnhancedSQL
65. Timeout
66. UseConnectionPooling
67. UserDefinedViews

AuthScheme

Data Type

string

Default Value

"Auto"

Remarks

• Auto: Lets the driver decide automatically based on the other connection properties you have set.
• OAuth: Set this to perform OAuth authentication using a standard user account.
• OAuthJWT: Set this to perform OAuth authentication using an OAuth service account.
• GCPInstanceAccount: Set this to get Access Token from Google Cloud Platform instance.

DeveloperToken

Data Type

string

Default Value

""

Remarks

Together with ClientCustomerId, this field is used to authenticate against the Google Ads servers and is required for use with Google Ads.

To retrieve your developer token, sign in to your manager account. You must be signed in to a Google Ads manager account before continuing. Navigate to TOOLS & SETTINGS > SETUP > API Center. This option appears only for Google Ads manager accounts. If your developer token is pending approval, you can start developing immediately with the pending token you received during signup, using a test manager account. Your pending developer token must be approved before using it with production Google Ads accounts.

ClientCustomerId

Data Type

string

Default Value

""

Remarks

Together with DeveloperToken, this field is used to authenticate against the Google Ads servers and is required for use with Google Ads.

You can find this value in your Google Ads 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.

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 specify multiple IDs by separating them with a comma or you can get all IDs by setting the value to 'All'. Ex: ClientCustomerId=2055114546,3055114546; or ClientCustomerId=All; Note that not all client customer IDs may be enabled. You can also 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 the WHERE clauses.

ManagerId

Data Type

string

Default Value

""

Remarks

The Id of the MCC (MyClientCenter) account.

If access to a client customer account is inherited only through a manager account, this property is required and must be set to the customer ID of the manager account. If your account has access directly to the client customer account as a User, it is not required. In other words, the client customer's Tools & Settings --> Account Access must show your email under the Users tab in order to access the account without this property, otherwise access has been granted via the manager account, under the Managers tab.

APIVersion

Data Type

string

Default Value

"v12"

Remarks

The latest Google Ads API version. You can find this information in the API documentation page.

InitiateOAuth

Data Type

string

Default Value

"OFF"

Remarks

The following options are available:

1. OFF: Indicates that the OAuth flow will be handled entirely by the user. An OAuthAccessToken will be required to authenticate.
2. GETANDREFRESH: Indicates that the entire OAuth Flow will be handled by the driver. If no token currently exists, it will be obtained by prompting the user via the browser. If a token exists, it will be refreshed when applicable.
3. REFRESH: Indicates that the driver will only handle refreshing the OAuthAccessToken. The user will never be prompted by the driver to authenticate via the browser. The user must handle obtaining the OAuthAccessToken and OAuthRefreshToken initially.

OAuthClientId

Data Type

string

Default Value

""

Remarks

As part of registering an OAuth application, you will receive the OAuthClientId value, sometimes also called a consumer key, and a client secret, the OAuthClientSecret.

OAuthClientSecret

Data Type

string

Default Value

""

Remarks

As part of registering an OAuth application, you will receive the OAuthClientId, also called a consumer key. You will also receive a client secret, also called a consumer secret. Set the client secret in the OAuthClientSecret property.

OAuthAccessToken

Data Type

string

Default Value

""

Remarks

The OAuthAccessToken property is used to connect using OAuth. The OAuthAccessToken is retrieved from the OAuth server as part of the authentication process. It has a server-dependent timeout and can be reused between requests.

The access token is used in place of your user name and password. The access token protects your credentials by keeping them on the server.

OAuthSettingsLocation

Data Type

string

Default Value

"%APPDATA%\\CData\\GoogleAds Data Provider\\OAuthSettings.txt"

Remarks

When InitiateOAuth is set to GETANDREFRESH or REFRESH, the driver saves OAuth values to avoid requiring the user to manually enter OAuth connection properties and allowing the credentials to be shared across connections or processes.

Alternatively to specifying a file path, memory storage can be used instead. Memory locations are specified by using a value starting with 'memory://' followed by a unique identifier for that set of credentials (ex: memory://user1). The identifier can be anything you choose but should be unique to the user. Unlike with the file based storage, you must manually store the credentials when closing the connection with memory storage to be able to set them in the connection when the process is started again. The OAuth property values can be retrieved with a query to the sys_connection_props system table. If there are multiple connections using the same credentials, the properties should be read from the last connection to be closed.

If left unspecified, the default location is "%APPDATA%\\CData\\GoogleAds Data Provider\\OAuthSettings.txt" with %APPDATA% being set to the user's configuration directory:

Platform	%APPDATA%
Windows	The value of the APPDATA environment variable
Mac	~/Library/Application Support
Linux	~/.config

OAuthVerifier

Data Type

string

Default Value

""

Remarks

The verifier code returned from the OAuth authorization URL. This can be used on systems where a browser cannot be launched such as headless systems.

Authentication on Headless Machines

See Establishing a Connection to obtain the OAuthVerifier value.

Set OAuthSettingsLocation along with OAuthVerifier. When you connect, the driver exchanges the OAuthVerifier for the OAuth authentication tokens and saves them, encrypted, to the specified file. Set InitiateOAuth to GETANDREFRESH automate the exchange.

Once the OAuth settings file has been generated, you can remove OAuthVerifier from the connection properties and connect with OAuthSettingsLocation set.

To automatically refresh the OAuth token values, set OAuthSettingsLocation and additionally set InitiateOAuth to REFRESH.

OAuthRefreshToken

Data Type

string

Default Value

""

Remarks

The OAuthRefreshToken property is used to refresh the OAuthAccessToken when using OAuth authentication.

OAuthExpiresIn

Data Type

string

Default Value

""

Remarks

Pair with OAuthTokenTimestamp to determine when the AccessToken will expire.

OAuthTokenTimestamp

Data Type

string

Default Value

""

Remarks

Pair with OAuthExpiresIn to determine when the AccessToken will expire.

OAuthJWTCert

Data Type

string

Default Value

""

Remarks

The name of the certificate store for the client certificate.

The OAuthJWTCertType field specifies the type of the certificate store specified by OAuthJWTCert. If the store is password protected, specify the password in OAuthJWTCertPassword.

OAuthJWTCert is used in conjunction with the OAuthJWTCertSubject field in order to specify client certificates. If OAuthJWTCert has a value, and OAuthJWTCertSubject is set, a search for a certificate is initiated. Please refer to the OAuthJWTCertSubject field for details.

Designations of certificate stores are platform-dependent.

The following are designations of the most common User and Machine certificate stores in Windows:

MY	A certificate store holding personal certificates with their associated private keys.
CA	Certifying authority certificates.
ROOT	Root certificates.
SPC	Software publisher certificates.

In Java, the certificate store normally is a file containing certificates and optional private keys.

When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e. PKCS12 certificate store).

OAuthJWTCertType

Data Type

string

Default Value

"USER"

Remarks

This property can take one of the following values:

USER	For Windows, this specifies that the certificate store is a certificate store owned by the current user. Note: This store type is not available in Java.
MACHINE	For Windows, this specifies that the certificate store is a machine store. Note: this store type is not available in Java.
PFXFILE	The certificate store is the name of a PFX (PKCS12) file containing certificates.
PFXBLOB	The certificate store is a string (base-64-encoded) representing a certificate store in PFX (PKCS12) format.
JKSFILE	The certificate store is the name of a Java key store (JKS) file containing certificates. Note: this store type is only available in Java.
JKSBLOB	The certificate store is a string (base-64-encoded) representing a certificate store in Java key store (JKS) format. Note: this store type is only available in Java.
PEMKEY_FILE	The certificate store is the name of a PEM-encoded file that contains a private key and an optional certificate.
PEMKEY_BLOB	The certificate store is a string (base64-encoded) that contains a private key and an optional certificate.
PUBLIC_KEY_FILE	The certificate store is the name of a file that contains a PEM- or DER-encoded public key certificate.
PUBLIC_KEY_BLOB	The certificate store is a string (base-64-encoded) that contains a PEM- or DER-encoded public key certificate.
SSHPUBLIC_KEY_FILE	The certificate store is the name of a file that contains an SSH-style public key.
SSHPUBLIC_KEY_BLOB	The certificate store is a string (base-64-encoded) that contains an SSH-style public key.
P7BFILE	The certificate store is the name of a PKCS7 file containing certificates.
PPKFILE	The certificate store is the name of a file that contains a PPK (PuTTY Private Key).
XMLFILE	The certificate store is the name of a file that contains a certificate in XML format.
XMLBLOB	The certificate store is a string that contains a certificate in XML format.
GOOGLEJSON	The certificate store is the name of a JSON file containing the service account information. Only valid when connecting to a Google service.
GOOGLEJSONBLOB	The certificate store is a string that contains the service account JSON. Only valid when connecting to a Google service.

OAuthJWTCertPassword

Data Type

string

Default Value

""

Remarks

If the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.

This is not required when using the GOOGLEJSON OAuthJWTCertType. Google JSON keys are not encrypted.

OAuthJWTCertSubject

Data Type

string

Default Value

"*"

Remarks

When loading a certificate the subject is used to locate the certificate in the store.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks the first certificate in the certificate store.

The certificate subject is a comma separated list of distinguished name fields and values. For instance "CN=www.server.com, OU=test, C=US, E=support@cdata.com". Common fields and their meanings are displayed below.

Field	Meaning
CN	Common Name. This is commonly a host name like www.server.com.
O	Organization
OU	Organizational Unit
L	Locality
S	State
C	Country
E	Email Address

If a field value contains a comma it must be quoted.

OAuthJWTIssuer

Data Type

string

Default Value

""

Remarks

The issuer of the Java Web Token. This is typically either the Client Id or Email Address of the OAuth Application.

This is not required when using the GOOGLEJSON OAuthJWTCertType. Google JSON keys contain a copy of the issuer account.

OAuthJWTSubject

Data Type

string

Default Value

""

Remarks

The user subject for which the application is requesting delegated access. Typically, the user account name or email address.

SSLServerCert

Data Type

string

Default Value

""

Remarks

If using a TLS/SSL connection, this property can be used to specify the TLS/SSL certificate to be accepted from the server. Any other certificate that is not trusted by the machine is rejected.

This property can take the following forms:

Description	Example
A full PEM Certificate (example shortened for brevity)	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
A path to a local file containing the certificate	C:\cert.cer
The public key (example shortened for brevity)	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
The MD5 Thumbprint (hex values can also be either space or colon separated)	ecadbdda5a1529c58a1e9e09828d70e4
The SHA1 Thumbprint (hex values can also be either space or colon separated)	34a929226ae0819f2ec14b4a3d904f801cbb150d

If not specified, any certificate trusted by the machine is accepted.

Certificates are validated as trusted by the machine based on the System's trust store. The trust store used is the 'javax.net.ssl.trustStore' value specified for the system. If no value is specified for this property, Java's default trust store is used (for example, JAVA_HOME\lib\security\cacerts).

Use '*' to signify to accept all certificates. Note that this is not recommended due to security concerns.

FirewallType

Data Type

string

Default Value

"NONE"

Remarks

This property specifies the protocol that the driver will use to tunnel traffic through the FirewallServer proxy. Note that by default, the driver connects to the system proxy; to disable this behavior and connect to one of the following proxy types, set ProxyAutoDetect to false.

Type	Default Port	Description
TUNNEL	80	When this is set, the driver opens a connection to Google Ads and traffic flows back and forth through the proxy.
SOCKS4	1080	When this is set, the driver sends data through the SOCKS 4 proxy specified by FirewallServer and FirewallPort and passes the FirewallUser value to the proxy, which determines if the connection request should be granted.
SOCKS5	1080	When this is set, the driver sends data through the SOCKS 5 proxy specified by FirewallServer and FirewallPort. If your proxy requires authentication, set FirewallUser and FirewallPassword to credentials the proxy recognizes.

To connect to HTTP proxies, use ProxyServer and ProxyPort. To authenticate to HTTP proxies, use ProxyAuthScheme, ProxyUser, and ProxyPassword.

FirewallServer

Data Type

string

Default Value

""

Remarks

This property specifies the IP address, DNS name, or host name of a proxy allowing traversal of a firewall. The protocol is specified by FirewallType: Use FirewallServer with this property to connect through SOCKS or do tunneling. Use ProxyServer to connect to an HTTP proxy.

Note that the driver uses the system proxy by default. To use a different proxy, set ProxyAutoDetect to false.

FirewallPort

Data Type

int

Default Value

0

Remarks

This specifies the TCP port for a proxy allowing traversal of a firewall. Use FirewallServer to specify the name or IP address. Specify the protocol with FirewallType.

FirewallUser

Data Type

string

Default Value

""

Remarks

The FirewallUser and FirewallPassword properties are used to authenticate against the proxy specified in FirewallServer and FirewallPort, following the authentication method specified in FirewallType.

FirewallPassword

Data Type

string

Default Value

""

Remarks

This property is passed to the proxy specified by FirewallServer and FirewallPort, following the authentication method specified by FirewallType.

ProxyAutoDetect

Data Type

bool

Default Value

false

Remarks

This takes precedence over other proxy settings, so you'll need to set ProxyAutoDetect to FALSE in order use custom proxy settings.

NOTE: When this property is set to True, the proxy used is determined as follows:

• A search from the JVM properties (http.proxy, https.proxy, socksProxy, etc.) is performed.
• In the case that the JVM properties don't exist, a search from java.home/lib/net.properties is performed.
• In the case that java.net.useSystemProxies is set to True, a search from the SystemProxy is performed.
• In Windows only, an attempt is made to retrieve these properties from the Internet Options in the registry.

To connect to an HTTP proxy, see ProxyServer. For other proxies, such as SOCKS or tunneling, see FirewallType.

ProxyServer

Data Type

string

Default Value

""

Remarks

The hostname or IP address of a proxy to route HTTP traffic through. The driver can use the HTTP, Windows (NTLM), or Kerberos authentication types to authenticate to an HTTP proxy.

If you need to connect through a SOCKS proxy or tunnel the connection, see FirewallType.

By default, the driver uses the system proxy. If you need to use another proxy, set ProxyAutoDetect to false.

ProxyPort

Data Type

int

Default Value

80

Remarks

The port the HTTP proxy is running on that you want to redirect HTTP traffic through. Specify the HTTP proxy in ProxyServer. For other proxy types, see FirewallType.

ProxyAuthScheme

Data Type

string

Default Value

"BASIC"

Remarks

This value specifies the authentication type to use to authenticate to the HTTP proxy specified by ProxyServer and ProxyPort.

Note that the driver will use the system proxy settings by default, without further configuration needed; if you want to connect to another proxy, you will need to set ProxyAutoDetect to false, in addition to ProxyServer and ProxyPort. To authenticate, set ProxyAuthScheme and set ProxyUser and ProxyPassword, if needed.

The authentication type can be one of the following:

• BASIC: The driver performs HTTP BASIC authentication.
• DIGEST: The driver performs HTTP DIGEST authentication.
• NEGOTIATE: The driver retrieves an NTLM or Kerberos token based on the applicable protocol for authentication.
• PROPRIETARY: The driver does not generate an NTLM or Kerberos token. You must supply this token in the Authorization header of the HTTP request.

If you need to use another authentication type, such as SOCKS 5 authentication, see FirewallType.

ProxyUser

Data Type

string

Default Value

""

Remarks

The ProxyUser and ProxyPassword options are used to connect and authenticate against the HTTP proxy specified in ProxyServer.

You can select one of the available authentication types in ProxyAuthScheme. If you are using HTTP authentication, set this to the user name of a user recognized by the HTTP proxy. If you are using Windows or Kerberos authentication, set this property to a user name in one of the following formats:

user@domain

domain\user

ProxyPassword

Data Type

string

Default Value

""

Remarks

This property is used to authenticate to an HTTP proxy server that supports NTLM (Windows), Kerberos, or HTTP authentication. To specify the HTTP proxy, you can set ProxyServer and ProxyPort. To specify the authentication type, set ProxyAuthScheme.

If you are using HTTP authentication, additionally set ProxyUser and ProxyPassword to HTTP proxy.

If you are using NTLM authentication, set ProxyUser and ProxyPassword to your Windows password. You may also need these to complete Kerberos authentication.

For SOCKS 5 authentication or tunneling, see FirewallType.

By default, the driver uses the system proxy. If you want to connect to another proxy, set ProxyAutoDetect to false.

ProxySSLType

Data Type

string

Default Value

"AUTO"

Remarks

This property determines when to use SSL for the connection to an HTTP proxy specified by ProxyServer. This value can be AUTO, ALWAYS, NEVER, or TUNNEL. The applicable values are the following:

AUTO	Default setting. If the URL is an HTTPS URL, the driver will use the TUNNEL option. If the URL is an HTTP URL, the component will use the NEVER option.
ALWAYS	The connection is always SSL enabled.
NEVER	The connection is not SSL enabled.
TUNNEL	The connection is through a tunneling proxy. The proxy server opens a connection to the remote host and traffic flows back and forth through the proxy.

ProxyExceptions

Data Type

string

Default Value

""

Remarks

The ProxyServer is used for all addresses, except for addresses defined in this property. Use semicolons to separate entries.

Note that the driver uses the system proxy settings by default, without further configuration needed; if you want to explicitly configure proxy exceptions for this connection, you need to set ProxyAutoDetect = false, and configure ProxyServer and ProxyPort. To authenticate, set ProxyAuthScheme and set ProxyUser and ProxyPassword, if needed.

Logfile

Data Type

string

Default Value

""

Remarks

Once this property is set, the driver will populate the log file as it carries out various tasks, such as when authentication is performed or queries are executed. If the specified file doesn't already exist, it will be created.

Connection strings and version information are also logged, though connection properties containing sensitive information are masked automatically.

If a relative filepath is supplied, the location of the log file will be resolved based on the path found in the Location connection property.

For more control over what is written to the log file, you can adjust the Verbosity property.

Log contents are categorized into several modules. You can show/hide individual modules using the LogModules property.

To edit the maximum size of a single logfile before a new one is created, see MaxLogFileSize.

If you would like to place a cap on the number of logfiles generated, use MaxLogFileCount.

Java Logging

Java logging is also supported. To enable Java logging, set Logfile to:

Logfile=JAVALOG://myloggername

As in the above sample, JAVALOG:// is a required prefix to use Java logging, and you will substitute your own Logger.

The supplied Logger's getLogger method is then called, using the supplied value to create the Logger instance. If a logging instance already exists, it will reference the existing instance.

When Java logging is enabled, the Verbosity will now correspond to specific logging levels.

Verbosity

Data Type

string

Default Value

"1"

Remarks

The verbosity level determines the amount of detail that the driver reports to the Logfile. Verbosity levels from 1 to 5 are supported. These are detailed in the Logging page.

LogModules

Data Type

string

Default Value

""

Remarks

Only the modules specified (separated by ';') will be included in the log file. By default all modules are included.

See the Logging page for an overview.

MaxLogFileSize

Data Type

string

Default Value

"100MB"

Remarks

When the limit is hit, a new log is created in the same folder with the date and time appended to the end. The default limit is 100 MB. Values lower than 100 kB will use 100 kB as the value instead.

Adjust the maximum number of logfiles generated with MaxLogFileCount.

MaxLogFileCount

Data Type

int

Default Value

-1

Remarks

When the limit is hit, a new log is created in the same folder with the date and time appended to the end and the oldest log file will be deleted.

The minimum supported value is 2. A value of 0 or a negative value indicates no limit on the count.

Adjust the maximum size of the logfiles generated with MaxLogFileSize.

Location

Data Type

string

Default Value

"%APPDATA%\\CData\\GoogleAds Data Provider\\Schema"

Remarks

The path to a directory which contains the schema files for the driver (.rsd files for tables and views, .rsb files for stored procedures). The folder location can be a relative path from the location of the executable. The Location property is only needed if you want to customize definitions (for example, change a column name, ignore a column, and so on) or extend the data model with new tables, views, or stored procedures.

Note: Given that this driver supports multiple schemas, the structure for Google Ads custom schema files is as follows:

• Each schema is given a folder corresponding to that schema name.
• These schema folders are contained in a parent folder.
• The parent folder should be set as the Location, not an individual schema's folder.

If left unspecified, the default location is "%APPDATA%\\CData\\GoogleAds Data Provider\\Schema" with %APPDATA% being set to the user's configuration directory:

Platform	%APPDATA%
Windows	The value of the APPDATA environment variable
Mac	~/Library/Application Support
Linux	~/.config

BrowsableSchemas

Data Type

string

Default Value

""

Remarks

Listing the schemas from databases can be expensive. Providing a list of schemas in the connection string improves the performance.

Tables

Data Type

string

Default Value

""

Remarks

Listing the tables from some databases can be expensive. Providing a list of tables in the connection string improves the performance of the driver.

This property can also be used as an alternative to automatically listing views if you already know which ones you want to work with and there would otherwise be too many to work with.

Specify the tables you want in a comma-separated list. Each table should be a valid SQL identifier with any special characters escaped using square brackets, double-quotes or backticks. For example, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Note that when connecting to a data source with multiple schemas or catalogs, you will need to provide the fully qualified name of the table in this property, as in the last example here, to avoid ambiguity between tables that exist in multiple catalogs or schemas.

Views

Data Type

string

Default Value

""

Remarks

Listing the views from some databases can be expensive. Providing a list of views in the connection string improves the performance of the driver.

This property can also be used as an alternative to automatically listing views if you already know which ones you want to work with and there would otherwise be too many to work with.

Specify the views you want in a comma-separated list. Each view should be a valid SQL identifier with any special characters escaped using square brackets, double-quotes or backticks. For example, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Note that when connecting to a data source with multiple schemas or catalogs, you will need to provide the fully qualified name of the table in this property, as in the last example here, to avoid ambiguity between tables that exist in multiple catalogs or schemas.

AutoCache

Data Type

bool

Default Value

false

Remarks

When AutoCache = true, the driver automatically maintains a cache of your table's data in the database of your choice.

Setting the Caching Database

When AutoCache = true, the driver caches to a simple, file-based cache. You can configure its location or cache to a different database with the following properties:

• CacheLocation: Specifies the path to the file store.
• CacheDriver and CacheConnection: Specifies a driver to a database and the connection string.

See Also

• CacheMetadata: This property reduces the amount of metadata that crosses the network by persisting table schemas retrieved from the Google Ads metadata. Metadata then needs to be retrieved only once instead of every connection.
• Explicitly Caching Data: This section provides more examples of using AutoCache in Offline mode.
• CACHE Statements: You can use the CACHE statement to persist any SELECT query, as well as manage the cache; for example, refreshing schemas.

CacheDriver

Data Type

string

Default Value

""

Remarks

You can cache to any database for which you have a JDBC driver, including CData JDBC drivers.

The cache database is determined by the CacheDriver and CacheConnection properties. The CacheDriver is the name of the JDBC driver class that you want to use to cache data.

Note: you must add the CacheDriver JAR file to the classpath.

Examples

The following examples show how to cache to several major databases. Refer to CacheConnection for more information on the JDBC URL syntax and typical connection properties.

Derby and Java DB

The driver simplifies Derby configuration. Java DB is the Oracle distribution of Derby. The JAR file is shipped in the JDK. You can find the JAR file, derby.jar, in the db subfolder of the JDK installation. In most caching scenarios, you need to specify only the following, after adding derby.jar to the classpath:

jdbc:googleads:CacheLocation='c:/Temp/cachedir';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

To customize the Derby JDBC URL, use CacheDriver and CacheConnection. For example, to cache to an in-memory database, use a JDBC URL like the following:

jdbc:googleads:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

SQLite

The following is a JDBC URL for the SQLite JDBC driver:

jdbc:googleads:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

MySQL

The following is a JDBC URL for the included CData JDBC Driver for MySQL:

  jdbc:googleads:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

  

SQL Server

The following JDBC URL uses the Microsoft JDBC Driver for SQL Server:

jdbc:googleads:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

Oracle

The following is a JDBC URL for the Oracle Thin Client:

jdbc:googleads:Cache Driver=oracle.jdbc.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

NOTE: If using a version of Oracle older than 9i, the cache driver will instead be oracle.jdbc.driver.OracleDriver .

PostgreSQL

The following JDBC URL uses the official PostgreSQL JDBC driver:

jdbc:googleads:CacheDriver=cdata.jdbc.postgresql.PostgreSQLDriver;CacheConnection='jdbc:postgresql:User=postgres;Password=admin;Database=postgres;Server=localhost;Port=5432;';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;

CacheConnection

Data Type

string

Default Value

""

Remarks

The cache database is determined based on the CacheDriver and CacheConnection properties. Both properties are required to use the cache database. Examples of common cache database settings can be found below. For more information on setting the caching database's driver, refer to CacheDriver.

The connection string specified in the CacheConnection property is passed directly to the underlying CacheDriver. Consult the documentation for the specific JDBC driver for more information on the available properties. Make sure to include the JDBC driver in your application's classpath.

Derby and Java DB

The driver simplifies caching to Derby, only requiring you to set the CacheLocation property to make a basic connection.

Alternatively, you can configure the connection to Derby manually using CacheDriver and CacheConnection. The following is the Derby JDBC URL syntax:

jdbc:derby:[subsubprotocol:][databaseName][;attribute=value[;attribute=value] ... ]

For example, to cache to an in-memory database, use the following:

jdbc:derby:memory

SQLite

To cache to SQLite, you can use the SQLite JDBC driver. The following is the syntax of the JDBC URL:

jdbc:sqlite:dataSource

• Data Source: The path to an SQLite database file. Or, use a value of :memory to cache in memory.

MySQL

The installation includes the CData JDBC Driver for MySQL. The following is an example JDBC URL:

jdbc:mysql:User=root;Password=root;Server=localhost;Port=3306;Database=cache

The following are typical connection properties:

• Server: The IP address or domain name of the server you want to connect to.
• Port: The port that the server is running on.
• User: The user name provided for authentication to the database.
• Password: The password provided for authentication to the database.
• Database: The name of the database.

SQL Server

The JDBC URL for the Microsoft JDBC Driver for SQL Server has the following syntax:

jdbc:sqlserver://[serverName[\instance][:port]][;database=databaseName][;property=value[;property=value] ... ]

For example:

jdbc:sqlserver://localhost\sqlexpress:1433;integratedSecurity=true

The following are typical SQL Server connection properties:

• Server: The name or network address of the computer running SQL Server. To connect to a named instance instead of the default instance, this property can be used to specify the host name and the instance, separated by a backslash.
• Port: The port SQL Server is running on.
• Database: The name of the SQL Server database.
• Integrated Security: Set this option to true to use the current Windows account for authentication. Set this option to false if you are setting the User and Password in the connection.

  To use integrated security, you will also need to add sqljdbc_auth.dll to a folder on the Windows system path. This file is located in the auth subfolder of the Microsoft JDBC Driver for SQL Server installation. The bitness of the assembly must match the bitness of your JVM.

• User Id: The user name provided for authentication with SQL Server. This property is only needed if you are not using integrated security.
• Password: The password provided for authentication with SQL Server. This property is only needed if you are not using integrated security.

Oracle

The following is the conventional JDBC URL syntax for the Oracle JDBC Thin driver:

jdbc:oracle:thin:[userId/password]@[//]host[[:port][:sid]]

For example:

jdbc:oracle:thin:scott/tiger@myhost:1521:orcl

The following are typical connection properties:

• Data Source: The connect descriptor that identifies the Oracle database. This can be a TNS connect descriptor, an Oracle Net Services name that resolves to a connect descriptor, or, after version 11g, an Easy Connect naming (the host name of the Oracle server with an optional port and service name).

• Password: The password provided for authentication with the Oracle database.
• User Id: The user Id provided for authentication with the Oracle database.

PostgreSQL

The following is the JDBC URL syntax for the official PostgreSQL JDBC driver:

jdbc:postgresql:[//[host[:port]]/]database[[?option=value][[&option=value][&option=value] ... ]]

For example, the following connection string connects to a database on the default host (localhost) and port (5432):

jdbc:postgresql:postgres

The following are typical connection properties:

• Host: The address of the server hosting the PostgreSQL database.
• Port: The port used to connect to the server hosting the PostgreSQL database.
• Database: The name of the database.
• User name: The user Id provided for authentication with the PostgreSQL database. You can specify this in the JDBC URL with the "user" parameter.
• Password: The password provided for authentication with the PostgreSQL database.

CacheLocation

Data Type

string

Default Value

"%APPDATA%\\CData\\GoogleAds Data Provider"

Remarks

The CacheLocation is a simple, file-based cache. The driver uses Java DB, Oracle's distribution of the Derby database. To cache to Java DB, you will need to add the Java DB JAR file to the classpath. The JAR file, derby.jar, is shipped in the JDK and located in the db subfolder of the JDK installation.

If left unspecified, the default location is "%APPDATA%\\CData\\GoogleAds Data Provider" with %APPDATA% being set to the user's configuration directory:

Platform	%APPDATA%
Windows	The value of the APPDATA environment variable
Mac	~/Library/Application Support
Linux	~/.config

See Also

• AutoCache: Set to implicitly create and maintain a cache for later offline use.
• CacheMetadata: Set to persist the Google Ads catalog in CacheLocation.

CacheTolerance

Data Type

int

Default Value

600

Remarks

The tolerance for stale data in the cache specified in seconds. This only applies when AutoCache is used. The driver checks with the data source for newer records after the tolerance interval has expired. Otherwise, it returns the data directly from the cache.

Offline

Data Type

bool

Default Value

false

Remarks

When Offline = true, all queries execute against the cache as opposed to the live data source. In this mode, certain queries like INSERT, UPDATE, DELETE, and CACHE are not allowed.

CacheMetadata

Data Type

bool

Default Value

false

Remarks

As you execute queries with this property set, table metadata in the Google Ads catalog are cached to the file store specified by CacheLocation if set or the user's home directory otherwise. A table's metadata will be retrieved only once, when the table is queried for the first time.

When to Use CacheMetadata

The driver automatically persists metadata in memory for up to two hours when you first discover the metadata for a table or view and therefore, CacheMetadata is generally not required. CacheMetadata becomes useful when metadata operations are expensive such as when you are working with large amounts of metadata or when you have many short-lived connections.

When Not to Use CacheMetadata

• When you are working with volatile metadata: Metadata for a table is only retrieved the first time the connection to the table is made. To pick up new, changed, or deleted columns, you would need to delete and rebuild the metadata cache. Therefore, it is best to rely on the in-memory caching for cases where metadata changes often.
• When you are caching to a database: CacheMetadata can only be used with CacheLocation. If you are caching to another database with the CacheDriver and CacheConnection properties, use AutoCache to cache implicitly. Or, use CACHE Statements to cache explicitly.

BatchSize

Data Type

int

Default Value

0

Remarks

When BatchSize is set to a value greater than 0, the batch operation will split the entire batch into separate batches of size BatchSize. The split batches will then be submitted to the server individually. This is useful when the server has limitations on the size of the request that can be submitted.

Setting BatchSize to 0 will submit the entire batch as specified.

ConnectionLifeTime

Data Type

int

Default Value

0

Remarks

The maximum lifetime of a connection in seconds. Once the time has elapsed, the connection object is disposed. The default is 0 which indicates there is no limit to the connection lifetime.

ConnectOnOpen

Data Type

bool

Default Value

false

Remarks

When set to true, a connection will be made to Google Ads when the connection is opened. This property enables the Test Connection feature available in various database tools.

This feature acts as a NOOP command as it is used to verify a connection can be made to Google Ads and nothing from this initial connection is maintained.

Setting this property to false may provide performance improvements (depending upon the number of times a connection is opened).

MaxRows

Data Type

int

Default Value

-1

Remarks

Limits the number of rows returned rows when no aggregation or group by is used in the query. This helps avoid performance issues at design time.

Other

Data Type

string

Default Value

""

Remarks

The properties listed below are available for specific use cases. Normal driver use cases and functionality should not require these properties.

Specify multiple properties in a semicolon-separated list.

Caching Configuration

CachePartial=True	Caches only a subset of columns, which you can specify in your query.
QueryPassthrough=True	Passes the specified query to the cache database instead of using the SQL parser of the driver.

Integration and Formatting

DefaultColumnSize	Sets the default length of string fields when the data source does not provide column length in the metadata. The default value is 2000.
ConvertDateTimeToGMT	Determines whether to convert date-time values to GMT, instead of the local time of the machine.
RecordToFile=filename	Records the underlying socket data transfer to the specified file.

PoolIdleTimeout

Data Type

int

Default Value

60

Remarks

The allowed idle time a connection can remain in the pool until the connection is closed. The default is 60 seconds.

PoolMaxSize

Data Type

int

Default Value

100

Remarks

The maximum connections in the pool. The default is 100. To disable this property, set the property value to 0 or less.

PoolMinSize

Data Type

int

Default Value

1

Remarks

The minimum number of connections in the pool. The default is 1.

PoolWaitTime

Data Type

int

Default Value

60

Remarks

The max seconds to wait for a connection to become available. If a new connection request is waiting for an available connection and exceeds this time, an error is thrown. By default, new requests wait forever for an available connection.

PseudoColumns

Data Type

string

Default Value

""

Remarks

This setting is particularly helpful in Entity Framework, which does not allow you to set a value for a pseudo column unless it is a table column. The value of this connection setting is of the format "Table1=Column1, Table1=Column2, Table2=Column3". You can use the "*" character to include all tables and all columns; for example, "*=*".

QueryPassthrough

Data Type

bool

Default Value

false

Remarks

When this is set, queries are passed through directly to Google Ads.

RecurseChildren

Data Type

bool

Default Value

true

Remarks

Set this to false if you want to avoid recursing over customer client ids to get the full hierarchy for CustomerClientLink table.

RTK

Data Type

string

Default Value

""

Remarks

The RTK property may be used to license a build. See the included licensing file to see how to set this property. The runtime key is only available if you purchased an OEM license.

SupportEnhancedSQL

Data Type

bool

Default Value

false

Remarks

When SupportEnhancedSQL = true, the driver offloads as much of the SELECT statement processing as possible to Google Ads and then processes the rest of the query in memory. In this way, the driver can execute unsupported predicates, joins, and aggregation.

When SupportEnhancedSQL = false, the driver limits SQL execution to what is supported by the Google Ads API.

Execution of Predicates

The driver determines which of the clauses are supported by the data source and then pushes them to the source to get the smallest superset of rows that would satisfy the query. It then filters the rest of the rows locally. The filter operation is streamed, which enables the driver to filter effectively for even very large datasets.

Execution of Joins

The driver uses various techniques to join in memory. The driver trades off memory utilization against the requirement of reading the same table more than once.

Execution of Aggregates

The driver retrieves all rows necessary to process the aggregation in memory.

Timeout

Data Type

int

Default Value

60

Remarks

If Timeout = 0, operations do not time out. The operations run until they complete successfully or until they encounter an error condition.

If Timeout expires and the operation is not yet complete, the driver throws an exception.

UseConnectionPooling

Data Type

bool

Default Value

false

Remarks

This property enables connection pooling. The default is false. See Connection Pooling for information on using connection pools.

UserDefinedViews

Data Type

string

Default Value

""

Remarks

User Defined Views are defined in a JSON-formatted configuration file called UserDefinedViews.json. The driver 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 driver.

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"

ViewsBack To Top

1. AccessibleBiddingStrategy
2. AccountBudget
3. AccountBudgetProposal
4. AccountLink
5. AdGroup
6. AdGroupAd
7. AdGroupAdAssetCombinationView
8. AdGroupAdAssetView
9. AdGroupAdLabel
10. AdGroupAsset
11. AdGroupAssetSet
12. AdGroupAudienceView
13. AdGroupBidModifier
14. AdGroupCriterion
15. AdGroupCriterionCustomizer
16. AdGroupCriterionLabel
17. AdGroupCriterionSimulation
18. AdGroupCustomizer
19. AdGroupExtensionSetting
20. AdGroupFeed
21. AdGroupLabel
22. AdGroupSimulation
23. AdParameter
24. AdScheduleView
25. AgeRangeView
26. Asset
27. AssetFieldTypeView
28. AssetGroup
29. AssetGroupAsset
30. AssetGroupListingGroupFilter
31. AssetGroupSignal
32. AssetSet
33. AssetSetAsset
34. AssetSetTypeView
35. Audience
36. BatchJob
37. BiddingDataExclusion
38. BiddingSeasonalityAdjustment
39. BiddingStrategy
40. BiddingStrategySimulation
41. BillingSetup
42. CallView
43. Campaign
44. CampaignAsset
45. CampaignAssetSet
46. CampaignAudienceView
47. CampaignBidModifier
48. CampaignBudget
49. CampaignConversionGoal
50. CampaignCriterion
51. CampaignCriterionSimulation
52. CampaignCustomizer
53. CampaignDraft
54. CampaignExperiment
55. CampaignExtensionSetting
56. CampaignFeed
57. CampaignGroup
58. CampaignLabel
59. CampaignSharedSet
60. CampaignSimulation
61. CarrierConstant
62. ChangeEvent
63. ChangeStatus
64. ClickView
65. CombinedAudience
66. ConversionAction
67. ConversionCustomVariable
68. ConversionGoalCampaignConfig
69. ConversionValueRule
70. ConversionValueRuleSet
71. CurrencyConstant
72. CustomAudience
73. CustomConversionGoal
74. Customer
75. CustomerAsset
76. CustomerAssetSet
77. CustomerClient
78. CustomerClientLink
79. CustomerConversionGoal
80. CustomerCustomizer
81. CustomerExtensionSetting
82. CustomerFeed
83. CustomerLabel
84. CustomerManagerLink
85. CustomerNegativeCriterion
86. CustomerUserAccess
87. CustomerUserAccessInvitation
88. CustomInterest
89. CustomizerAttribute
90. DetailedDemographic
91. DetailPlacementView
92. DisplayKeywordView
93. DistanceView
94. DomainCategory
95. DynamicSearchAdsSearchTermView
96. ExpandedLandingPageView
97. Experiment
98. ExperimentArm
99. ExtensionFeedItem
100. Feed
101. FeedItem
102. FeedItemSet
103. FeedItemSetLink
104. FeedItemTarget
105. FeedMapping
106. FeedPlaceholderView
107. GenderView
108. GeographicView
109. GeoTargetConstant
110. GroupPlacementView
111. HotelGroupView
112. HotelPerformanceView
113. HotelReconciliation
114. IncomeRangeView
115. KeywordPlan
116. KeywordPlanAdGroup
117. KeywordPlanAdGroupKeyword
118. KeywordPlanCampaign
119. KeywordPlanCampaignKeyword
120. KeywordThemeConstant
121. KeywordView
122. Label
123. LandingPageView
124. LanguageConstant
125. LeadFormSubmissionData
126. LifeEvent
127. LocationView
128. ManagedPlacementView
129. MediaFile
130. MobileAppCategoryConstant
131. MobileDeviceConstant
132. OfflineUserDataJob
133. OperatingSystemVersionConstant
134. PaidOrganicSearchTermView
135. ParentalStatusView
136. PerStoreView
137. ProductBiddingCategoryConstant
138. ProductGroupView
139. Recommendation
140. RemarketingAction
141. Resources
142. SearchTermView
143. SharedCriterion
144. SharedSet
145. ShoppingPerformanceView
146. SmartCampaignSearchTermView
147. SmartCampaignSetting
148. ThirdPartyAppAnalyticsLink
149. TopicConstant
150. TopicView
151. UserInterest
152. UserList
153. UserLocationView
154. Video
155. WebpageView

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	Output only. 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.
AccessibleBiddingStrategyMaximizeConversionsTargetCpaMicros	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	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	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	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 chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
AccessibleBiddingStrategyTargetRoasTargetRoas	Double	ATTRIBUTE	Output only. The chosen revenue (based on conversion data) per unit of spend.
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_CPA, 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 (for example, spending limit), these differences are juxtaposed through '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, for example, 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:mm:ss format.
AccountBudgetApprovedEndTimeType	String	ATTRIBUTE	Output only. The approved end time as a well-defined type, for example, 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, for example, 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:mm: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:mm:ss.
AccountBudgetPendingProposalEndDateTime	Date	ATTRIBUTE	Output only. The end time in yyyy-MM-dd HH:mm:ss format.
AccountBudgetPendingProposalEndTimeType	String	ATTRIBUTE	Output only. The end time as a well-defined type, for example, 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, for example, 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, for example, INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetPendingProposalStartDateTime	Date	ATTRIBUTE	Output only. The start time in yyyy-MM-dd HH:mm:ss format.
AccountBudgetProposedEndDateTime	Date	ATTRIBUTE	Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format.
AccountBudgetProposedEndTimeType	String	ATTRIBUTE	Output only. The proposed end time as a well-defined type, for example, 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, for example, 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:mm: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, for example, spending limits. 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:mm:ss format.
AccountBudgetProposalApprovedEndTimeType	String	ATTRIBUTE	Output only. The approved end date time as a well-defined type, for example, 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, for example, INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalApprovedStartDateTime	Date	ATTRIBUTE	Output only. The approved start date time in yyyy-mm-dd hh:mm: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, for example, 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:mm:ss format.
AccountBudgetProposalProposedEndTimeType	String	ATTRIBUTE	Immutable. The proposed end date time as a well-defined type, for example, 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, for example, INFINITE. The allowed values are INFINITE, UNKNOWN, UNSPECIFIED.
AccountBudgetProposalProposedStartDateTime	Date	ATTRIBUTE	Immutable. The proposed start date time in yyyy-mm-dd hh:mm: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.

AccountLink

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.
AccountLinkAdvertisingPartnerCustomer	String	ATTRIBUTE	Immutable. The resource name of the advertising partner Google Ads account. This field is required and should not be empty when creating a new Advertising Partner link. It is unable to be modified after the creation of the link.
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.
AccountLinkHotelCenterHotelCenterId	Long	ATTRIBUTE	Output only. The hotel center id of the hotel account.
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 (for example, '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 (for example, '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 ADVERTISING_PARTNER, DATA_PARTNER, GOOGLE_ADS, HOTEL_CENTER, 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	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 AD_IMAGE, 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.
AdGroupExcludedParentAssetSetTypes	String	ATTRIBUTE	The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, UNKNOWN, UNSPECIFIED.
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 (for example, 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.
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.
AuctionInsightDomain	String	SEGMENT	Domain (visible URL) of a participant in the Auction Insights report.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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 versus 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.
AdGroupAdAdCallAdPath6	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, for example, 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.
AdGroupAdAdDiscoveryCarouselAdBusinessName	String	ATTRIBUTE	Required. The Advertiser/brand name.
AdGroupAdAdDiscoveryCarouselAdCallToActionText	String	ATTRIBUTE	Call to action text.
AdGroupAdAdDiscoveryCarouselAdCarouselCards	String	ATTRIBUTE	Required. Carousel cards that will display with the ad. Min 2 max 10.
AdGroupAdAdDiscoveryCarouselAdDescription	String	ATTRIBUTE	Required. The descriptive text of the ad.
AdGroupAdAdDiscoveryCarouselAdHeadline	String	ATTRIBUTE	Required. Headline of the ad.
AdGroupAdAdDiscoveryCarouselAdLogoImage	String	ATTRIBUTE	Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%).
AdGroupAdAdDiscoveryMultiAssetAdBusinessName	String	ATTRIBUTE	The Advertiser/brand name. Maximum display width is 25. Required.
AdGroupAdAdDiscoveryMultiAssetAdCallToActionText	String	ATTRIBUTE	Call to action text.
AdGroupAdAdDiscoveryMultiAssetAdDescriptions	String	ATTRIBUTE	The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified.
AdGroupAdAdDiscoveryMultiAssetAdHeadlines	String	ATTRIBUTE	Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified.
AdGroupAdAdDiscoveryMultiAssetAdLeadFormOnly	Bool	ATTRIBUTE	Boolean option that indicates if this ad must be served with lead form.
AdGroupAdAdDiscoveryMultiAssetAdLogoImages	String	ATTRIBUTE	Logo image assets 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%). At least 1 and max 5 logo images can be specified.
AdGroupAdAdDiscoveryMultiAssetAdMarketingImages	String	ATTRIBUTE	Marketing image assets 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%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20.
AdGroupAdAdDiscoveryMultiAssetAdPortraitMarketingImages	String	ATTRIBUTE	Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20.
AdGroupAdAdDiscoveryMultiAssetAdSquareMarketingImages	String	ATTRIBUTE	Square marketing image assets 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%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20.
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.
AdGroupAdAdExpandedTextAdPath6	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.
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, for example, #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, for example, #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. For example, '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. At least 1 and at most 5 call-to-actions must 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.
AdGroupAdAdLocalAdPath6	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. At least 1 and at most 20 video assets must 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, for example, #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, for example, #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. For example, '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.
AdGroupAdAdResponsiveSearchAdPath6	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, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets.
AdGroupAdAdSmartCampaignAdHeadlines	String	ATTRIBUTE	List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets.
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, DISCOVERY_CAROUSEL_AD, DISCOVERY_MULTI_ASSET_AD, DYNAMIC_HTML5_AD, EXPANDED_DYNAMIC_SEARCH_AD, EXPANDED_TEXT_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, 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.
AdGroupAdAdVideoResponsiveAdBreadcrumb1	String	ATTRIBUTE	First part of text that appears in the ad with the displayed URL.
AdGroupAdAdVideoResponsiveAdBreadcrumb2	String	ATTRIBUTE	Second part of text that appears in the ad with the displayed URL.
AdGroupAdAdVideoResponsiveAdCallToActions	String	ATTRIBUTE	List of text assets used for the button, for example, 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, for example, 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 (for example, 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, CROSS_NETWORK, 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 versus 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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
AdGroupAdAssetCombinationViewEnabled	Bool	ATTRIBUTE	Output only. The status between the asset combination and the latest version of the ad. If true, the asset combination 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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 and Responsive Search Ads.

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 AD_IMAGE, 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.
AdGroupAdAssetViewPinnedField	String	ATTRIBUTE	Output only. Pinned field. The allowed values are DESCRIPTION_1, DESCRIPTION_2, HEADLINE_1, HEADLINE_2, HEADLINE_3, 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 (for example, 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.
ConversionAction	String	SEGMENT	Resource name of the conversion action.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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 AD_IMAGE, 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}
AdGroupAssetSource	String	ATTRIBUTE	Output only. Source of the adgroup asset link. The allowed values are ADVERTISER, AUTOMATICALLY_CREATED, UNKNOWN, UNSPECIFIED.
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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

AdGroupAssetSet

AdGroupAssetSet is the linkage between an ad group and an asset set. Creating an AdGroupAssetSet links an asset set with an ad group.

Columns

Name	Type	Behavior	Description
AdGroupAssetSetAdGroup	String	ATTRIBUTE	Immutable. The ad group to which this asset set is linked.
AdGroupAssetSetAssetSet	String	ATTRIBUTE	Immutable. The asset set which is linked to the ad group.
AdGroupAssetSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group asset set. Ad group asset set resource names have the form: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
AdGroupAssetSetStatus	String	ATTRIBUTE	Output only. The status of the ad group asset set. Read-only. The allowed values are ENABLED, REMOVED, 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.

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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

AdGroupBidModifier

Represents an ad group bid modifier.

Columns

Name	Type	Behavior	Description
AdGroupBidModifierAdGroup	String	ATTRIBUTE	Immutable. The ad group to which this criterion belongs.
AdGroupBidModifierBaseAdGroup	String	ATTRIBUTE	Output only. The base ad group from which this draft/trial adgroup bid modifier was created. If ad_group is a base ad group then this field will be equal to ad_group. If the ad group was created in the draft or trial and has no corresponding base ad group, then this field will be null. This field is readonly.
AdGroupBidModifierBidModifier	Double	ATTRIBUTE	The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. Use 0 to opt out of a Device type.
AdGroupBidModifierBidModifierSource	String	ATTRIBUTE	Output only. Bid modifier source. The allowed values are AD_GROUP, CAMPAIGN, UNKNOWN, UNSPECIFIED.
AdGroupBidModifierCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
AdGroupBidModifierDeviceType	String	ATTRIBUTE	Type of the device. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
AdGroupBidModifierHotelAdvanceBookingWindowMaxDays	Long	ATTRIBUTE	High end of the number of days prior to the stay.
AdGroupBidModifierHotelAdvanceBookingWindowMinDays	Long	ATTRIBUTE	Low end of the number of days prior to the stay.
AdGroupBidModifierHotelCheckInDateRangeEndDate	String	ATTRIBUTE	End date in the YYYY-MM-DD format.
AdGroupBidModifierHotelCheckInDateRangeStartDate	String	ATTRIBUTE	Start date in the YYYY-MM-DD format.
AdGroupBidModifierHotelCheckInDayDayOfWeek	String	ATTRIBUTE	The day of the week. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
AdGroupBidModifierHotelDateSelectionTypeType	String	ATTRIBUTE	Type of the hotel date selection The allowed values are DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
AdGroupBidModifierHotelLengthOfStayMaxNights	Long	ATTRIBUTE	High end of the number of nights in the stay.
AdGroupBidModifierHotelLengthOfStayMinNights	Long	ATTRIBUTE	Low end of the number of nights in the stay.
AdGroupBidModifierPreferredContentType	String	ATTRIBUTE	Type of the preferred content. The allowed values are UNKNOWN, UNSPECIFIED, YOUTUBE_TOP_CONTENT.
AdGroupBidModifierResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group bid modifier. Ad group bid modifier resource names have the form: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_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.

AdGroupCriterion

An ad group criterion.

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
AdGroupCriterionAdGroup	String	ATTRIBUTE	Immutable. The ad group to which the criterion belongs.
AdGroupCriterionAgeRangeType	String	ATTRIBUTE	Type of the age range. The allowed values are AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44, AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP, AGE_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionAppPaymentModelType	String	ATTRIBUTE	Type of the app payment model. The allowed values are PAID, UNKNOWN, UNSPECIFIED.
AdGroupCriterionApprovalStatus	String	ATTRIBUTE	Output only. Approval status of the criterion. The allowed values are APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW, UNKNOWN, UNSPECIFIED.
AdGroupCriterionAudienceAudience	String	ATTRIBUTE	The Audience resource name.
AdGroupCriterionBidModifier	Double	ATTRIBUTE	The modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
AdGroupCriterionCombinedAudienceCombinedAudience	String	ATTRIBUTE	The CombinedAudience resource name.
AdGroupCriterionCpcBidMicros	Long	ATTRIBUTE	The CPC (cost-per-click) bid.
AdGroupCriterionCpmBidMicros	Long	ATTRIBUTE	The CPM (cost-per-thousand viewable impressions) bid.
AdGroupCriterionCpvBidMicros	Long	ATTRIBUTE	The CPV (cost-per-view) bid.
AdGroupCriterionCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion. This field is ignored for mutates.
AdGroupCriterionCustomAffinityCustomAffinity	String	ATTRIBUTE	The CustomInterest resource name.
AdGroupCriterionCustomAudienceCustomAudience	String	ATTRIBUTE	The CustomAudience resource name.
AdGroupCriterionCustomIntentCustomIntent	String	ATTRIBUTE	The CustomInterest resource name.
AdGroupCriterionDisapprovalReasons	String	ATTRIBUTE	Output only. List of disapproval reasons of the criterion. The different reasons for disapproving a criterion can be found here: https://support.google.com/adspolicy/answer/6008942 This field is read-only.
AdGroupCriterionDisplayName	String	ATTRIBUTE	Output only. The display name of the criterion. This field is ignored for mutates.
AdGroupCriterionEffectiveCpcBidMicros	Long	ATTRIBUTE	Output only. The effective CPC (cost-per-click) bid.
AdGroupCriterionEffectiveCpcBidSource	String	ATTRIBUTE	Output only. Source of the effective CPC bid. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectiveCpmBidMicros	Long	ATTRIBUTE	Output only. The effective CPM (cost-per-thousand viewable impressions) bid.
AdGroupCriterionEffectiveCpmBidSource	String	ATTRIBUTE	Output only. Source of the effective CPM bid. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectiveCpvBidMicros	Long	ATTRIBUTE	Output only. The effective CPV (cost-per-view) bid.
AdGroupCriterionEffectiveCpvBidSource	String	ATTRIBUTE	Output only. Source of the effective CPV bid. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionEffectivePercentCpcBidMicros	Long	ATTRIBUTE	Output only. The effective Percent CPC bid amount.
AdGroupCriterionEffectivePercentCpcBidSource	String	ATTRIBUTE	Output only. Source of the effective Percent CPC bid. The allowed values are AD_GROUP, AD_GROUP_CRITERION, CAMPAIGN_BIDDING_STRATEGY, UNKNOWN, UNSPECIFIED.
AdGroupCriterionFinalMobileUrls	String	ATTRIBUTE	The list of possible final mobile URLs after all cross-domain redirects.
AdGroupCriterionFinalUrlSuffix	String	ATTRIBUTE	URL template for appending params to final URL.
AdGroupCriterionFinalUrls	String	ATTRIBUTE	The list of possible final URLs after all cross-domain redirects for the ad.
AdGroupCriterionGenderType	String	ATTRIBUTE	Type of the gender. The allowed values are FEMALE, MALE, UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionIncomeRangeType	String	ATTRIBUTE	Type of the income range. The allowed values are INCOME_RANGE_0_50, INCOME_RANGE_50_60, INCOME_RANGE_60_70, INCOME_RANGE_70_80, INCOME_RANGE_80_90, INCOME_RANGE_90_UP, INCOME_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionKeywordMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionKeywordText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
AdGroupCriterionLabels	String	ATTRIBUTE	Output only. The resource names of labels attached to this ad group criterion.
AdGroupCriterionListingGroupCaseValueHotelCityCityCriterion	String	ATTRIBUTE	The Geo Target Constant resource name.
AdGroupCriterionListingGroupCaseValueHotelClassValue	Long	ATTRIBUTE	Long value of the hotel class.
AdGroupCriterionListingGroupCaseValueHotelCountryRegionCountryRegionCriterion	String	ATTRIBUTE	The Geo Target Constant resource name.
AdGroupCriterionListingGroupCaseValueHotelIdValue	String	ATTRIBUTE	String value of the hotel ID.
AdGroupCriterionListingGroupCaseValueHotelStateStateCriterion	String	ATTRIBUTE	The Geo Target Constant resource name.
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryCountryCode	String	ATTRIBUTE	Two-letter upper-case country code of the product bidding category. It must match the campaign.shopping_setting.sales_country field.
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryId	Long	ATTRIBUTE	ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
AdGroupCriterionListingGroupCaseValueProductBiddingCategoryLevel	String	ATTRIBUTE	Level of the product bidding category. The allowed values are LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductBrandValue	String	ATTRIBUTE	String value of the product brand.
AdGroupCriterionListingGroupCaseValueProductChannelChannel	String	ATTRIBUTE	Value of the locality. The allowed values are LOCAL, ONLINE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductChannelExclusivityChannelExclusivity	String	ATTRIBUTE	Value of the availability. The allowed values are MULTI_CHANNEL, SINGLE_CHANNEL, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductConditionCondition	String	ATTRIBUTE	Value of the condition. The allowed values are NEW, REFURBISHED, UNKNOWN, UNSPECIFIED, USED.
AdGroupCriterionListingGroupCaseValueProductCustomAttributeIndex	String	ATTRIBUTE	Indicates the index of the custom attribute. The allowed values are INDEX0, INDEX1, INDEX2, INDEX3, INDEX4, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductCustomAttributeValue	String	ATTRIBUTE	String value of the product custom attribute.
AdGroupCriterionListingGroupCaseValueProductItemIdValue	String	ATTRIBUTE	Value of the id.
AdGroupCriterionListingGroupCaseValueProductTypeLevel	String	ATTRIBUTE	Level of the type. The allowed values are LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AdGroupCriterionListingGroupCaseValueProductTypeValue	String	ATTRIBUTE	Value of the type.
AdGroupCriterionListingGroupParentAdGroupCriterion	String	ATTRIBUTE	Resource name of ad group criterion which is the parent listing group subdivision. Null for the root group.
AdGroupCriterionListingGroupType	String	ATTRIBUTE	Type of the listing group. The allowed values are SUBDIVISION, UNIT, UNKNOWN, UNSPECIFIED.
AdGroupCriterionMobileAppCategoryMobileAppCategoryConstant	String	ATTRIBUTE	The mobile app category constant resource name.
AdGroupCriterionMobileApplicationAppId	String	ATTRIBUTE	A string that uniquely identifies a mobile application to Google Ads API. The format of this string is '{platform}-{platform_native_id}', where platform is '1' for iOS apps and '2' for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, '476943146' for 'Flood-It! 2' whose App Store link is 'http://itunes.apple.com/us/app/flood-it!-2/id476943146'). For Android, this native identifier is the application's package name (for example, 'com.labpixies.colordrips' for 'Color Drips' given Google Play link 'https://play.google.com/store/apps/details?id=com.labpixies.colordrips'). A well formed app id for Google Ads API would thus be '1-476943146' for iOS and '2-com.labpixies.colordrips' for Android. This field is required and must be set in CREATE operations.
AdGroupCriterionMobileApplicationName	String	ATTRIBUTE	Name of this mobile application.
AdGroupCriterionNegative	Bool	ATTRIBUTE	Immutable. Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
AdGroupCriterionParentalStatusType	String	ATTRIBUTE	Type of the parental status. The allowed values are NOT_A_PARENT, PARENT, UNDETERMINED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionPercentCpcBidMicros	Long	ATTRIBUTE	The 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].
AdGroupCriterionPlacementUrl	String	ATTRIBUTE	URL of the placement. For example, 'http://www.domain.com'.
AdGroupCriterionPositionEstimatesEstimatedAddClicksAtFirstPositionCpc	Long	ATTRIBUTE	Output only. Estimate of how many clicks per week you might get by changing your keyword bid to the value in first_position_cpc_micros.
AdGroupCriterionPositionEstimatesEstimatedAddCostAtFirstPositionCpc	Long	ATTRIBUTE	Output only. Estimate of how your cost per week might change when changing your keyword bid to the value in first_position_cpc_micros.
AdGroupCriterionPositionEstimatesFirstPageCpcMicros	Long	ATTRIBUTE	Output only. The estimate of the CPC bid required for ad to be shown on first page of search results.
AdGroupCriterionPositionEstimatesFirstPositionCpcMicros	Long	ATTRIBUTE	Output only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
AdGroupCriterionPositionEstimatesTopOfPageCpcMicros	Long	ATTRIBUTE	Output only. The estimate of the CPC bid required for ad to be displayed at the top of the first page of search results.
AdGroupCriterionQualityInfoCreativeQualityScore	String	ATTRIBUTE	Output only. The performance of the ad compared to other advertisers. The allowed values are ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionQualityInfoPostClickQualityScore	String	ATTRIBUTE	Output only. The quality score of the landing page. The allowed values are ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionQualityInfoQualityScore	Int	ATTRIBUTE	Output only. The quality score. This field may not be populated if Google does not have enough information to determine a value.
AdGroupCriterionQualityInfoSearchPredictedCtr	String	ATTRIBUTE	Output only. The click-through rate compared to that of other advertisers. The allowed values are ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE, UNKNOWN, UNSPECIFIED.
AdGroupCriterionResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group criterion. Ad group criterion resource names have the form: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
AdGroupCriterionStatus	String	ATTRIBUTE	The status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as 'enabled', since they're eligible to see the ads; but AdGroupCriterion.status will show 'removed', since no positive criterion was added. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionSystemServingStatus	String	ATTRIBUTE	Output only. Serving status of the criterion. The allowed values are ELIGIBLE, RARELY_SERVED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionTopicPath	String	ATTRIBUTE	The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, 'Pets & Animals', 'Pets', 'Dogs' represents the 'Pets & Animals/Pets/Dogs' category.
AdGroupCriterionTopicTopicConstant	String	ATTRIBUTE	The Topic Constant resource name.
AdGroupCriterionTrackingUrlTemplate	String	ATTRIBUTE	The URL template for constructing a tracking URL.
AdGroupCriterionType	String	ATTRIBUTE	Output only. The type of the criterion. The allowed values are AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LISTING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
AdGroupCriterionUrlCustomParameters	String	ATTRIBUTE	The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
AdGroupCriterionUserInterestUserInterestCategory	String	ATTRIBUTE	The UserInterest resource name.
AdGroupCriterionUserListUserList	String	ATTRIBUTE	The User List resource name.
AdGroupCriterionWebpageConditions	String	ATTRIBUTE	Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
AdGroupCriterionWebpageCoveragePercentage	Double	ATTRIBUTE	Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
AdGroupCriterionWebpageCriterionName	String	ATTRIBUTE	The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
AdGroupCriterionWebpageSampleSampleUrls	String	ATTRIBUTE	Webpage sample urls
AdGroupCriterionYoutubeChannelChannelId	String	ATTRIBUTE	The YouTube uploader channel id or the channel code of a YouTube channel.
AdGroupCriterionYoutubeVideoVideoId	String	ATTRIBUTE	YouTube video id as it appears on the YouTube watch page.
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.

AdGroupCriterionCustomizer

A customizer value for the associated CustomizerAttribute at the AdGroupCriterion level.

Columns

Name	Type	Behavior	Description
AdGroupCriterionCustomizerAdGroupCriterion	String	ATTRIBUTE	Immutable. The ad group criterion to which the customizer attribute is linked. It must be a keyword criterion.
AdGroupCriterionCustomizerCustomizerAttribute	String	ATTRIBUTE	Required. Immutable. The customizer attribute which is linked to the ad group criterion.
AdGroupCriterionCustomizerResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group criterion customizer. Ad group criterion customizer resource names have the form: customers/{customer_id}/adGroupCriterionCustomizers/{ad_group_id}~{criterion_id}~{customizer_attribute_id}
AdGroupCriterionCustomizerStatus	String	ATTRIBUTE	Output only. The status of the ad group criterion customizer. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
AdGroupCriterionCustomizerValueStringValue	String	ATTRIBUTE	Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
AdGroupCriterionCustomizerValueType	String	ATTRIBUTE	Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. The allowed values are NUMBER, PERCENT, PRICE, TEXT, 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.

AdGroupCriterionLabel

A relationship between an ad group criterion and a label.

Columns

Name	Type	Behavior	Description
AdGroupCriterionLabelAdGroupCriterion	String	ATTRIBUTE	Immutable. The ad group criterion to which the label is attached.
AdGroupCriterionLabelLabel	String	ATTRIBUTE	Immutable. The label assigned to the ad group criterion.
AdGroupCriterionLabelResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group criterion label. Ad group criterion label resource names have the form: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_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.

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

Columns

Name	Type	Behavior	Description
AdGroupCriterionSimulationAdGroupId	Long	ATTRIBUTE	Output only. AdGroup ID of the simulation.
AdGroupCriterionSimulationCpcBidPointListPoints	String	ATTRIBUTE	Projected metrics for a series of CPC bid amounts.
AdGroupCriterionSimulationCriterionId	Long	ATTRIBUTE	Output only. Criterion ID of the simulation.
AdGroupCriterionSimulationEndDate	Date	ATTRIBUTE	Output only. Last day on which the simulation is based, in YYYY-MM-DD format.
AdGroupCriterionSimulationModificationMethod	String	ATTRIBUTE	Output only. How the simulation modifies the field. The allowed values are DEFAULT, SCALING, UNIFORM, UNKNOWN, UNSPECIFIED.
AdGroupCriterionSimulationPercentCpcBidPointListPoints	String	ATTRIBUTE	Projected metrics for a series of percent CPC bid amounts.
AdGroupCriterionSimulationResourceName	String	ATTRIBUTE	Output only. The resource name of the ad group criterion simulation. Ad group criterion simulation resource names have the form: customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}
AdGroupCriterionSimulationStartDate	Date	ATTRIBUTE	Output only. First day on which the simulation is based, in YYYY-MM-DD format.
AdGroupCriterionSimulationType	String	ATTRIBUTE	Output only. The field that the simulation modifies. The allowed values are BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, 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.

AdGroupCustomizer

A customizer value for the associated CustomizerAttribute at the AdGroup level.

Columns

Name	Type	Behavior	Description
AdGroupCustomizerAdGroup	String	ATTRIBUTE	Immutable. The ad group to which the customizer attribute is linked.
AdGroupCustomizerCustomizerAttribute	String	ATTRIBUTE	Required. Immutable. The customizer attribute which is linked to the ad group.
AdGroupCustomizerResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group customizer. Ad group customizer resource names have the form: customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}
AdGroupCustomizerStatus	String	ATTRIBUTE	Output only. The status of the ad group customizer. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
AdGroupCustomizerValueStringValue	String	ATTRIBUTE	Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
AdGroupCustomizerValueType	String	ATTRIBUTE	Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. The allowed values are NUMBER, PERCENT, PRICE, TEXT, 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.

AdGroupExtensionSetting

An ad group extension setting.

Columns

Name	Type	Behavior	Description
AdGroupExtensionSettingAdGroup	String	ATTRIBUTE	Immutable. The resource name of the ad group. The linked extension feed items will serve under this ad group. AdGroup resource names have the form: customers/{customer_id}/adGroups/{ad_group_id}
AdGroupExtensionSettingDevice	String	ATTRIBUTE	The device for which the extensions will serve. Optional. The allowed values are DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
AdGroupExtensionSettingExtensionFeedItems	String	ATTRIBUTE	The resource names of the extension feed items to serve under the ad group. ExtensionFeedItem resource names have the form: customers/{customer_id}/extensionFeedItems/{feed_item_id}
AdGroupExtensionSettingExtensionType	String	ATTRIBUTE	Immutable. The extension type of the ad group extension setting. The allowed values are AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
AdGroupExtensionSettingResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group extension setting. AdGroupExtensionSetting resource names have the form: customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}
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.

AdGroupFeed

An ad group feed.

Columns

Name	Type	Behavior	Description
AdGroupFeedAdGroup	String	ATTRIBUTE	Immutable. The ad group being linked to the feed.
AdGroupFeedFeed	String	ATTRIBUTE	Immutable. The feed being linked to the ad group.
AdGroupFeedMatchingFunctionFunctionString	String	ATTRIBUTE	String representation of the Function. Examples: 1. IDENTITY(true) or IDENTITY(false). All or no feed items served. 2. EQUALS(CONTEXT.DEVICE,'Mobile') 3. IN(FEED_ITEM_ID,{1000001,1000002,1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678,0],{'Mars cruise','Venus cruise'}) 5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,'Mobile')) For more details, visit https://developers.google.com/adwords/api/docs/guides/feed-matching-functions Note that because multiple strings may represent the same underlying function (whitespace and single versus double quotation marks, for example), the value returned may not be identical to the string sent in a mutate request.
AdGroupFeedMatchingFunctionLeftOperands	String	ATTRIBUTE	The operands on the left hand side of the equation. This is also the operand to be used for single operand expressions such as NOT.
AdGroupFeedMatchingFunctionOperator	String	ATTRIBUTE	Operator for a function. The allowed values are AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
AdGroupFeedMatchingFunctionRightOperands	String	ATTRIBUTE	The operands on the right hand side of the equation.
AdGroupFeedPlaceholderTypes	String	ATTRIBUTE	Indicates which placeholder types the feed may populate under the connected ad group. Required. The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
AdGroupFeedResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group feed. Ad group feed resource names have the form: `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id}
AdGroupFeedStatus	String	ATTRIBUTE	Output only. Status of the ad group feed. This field is read-only. The allowed values are ENABLED, REMOVED, 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.

AdGroupLabel

A relationship between an ad group and a label.

Columns

Name	Type	Behavior	Description
AdGroupLabelAdGroup	String	ATTRIBUTE	Immutable. The ad group to which the label is attached.
AdGroupLabelLabel	String	ATTRIBUTE	Immutable. The label assigned to the ad group.
AdGroupLabelResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad group label. Ad group label resource names have the form: customers/{customer_id}/adGroupLabels/{ad_group_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.

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

Columns

Name	Type	Behavior	Description
AdGroupSimulationAdGroupId	Long	ATTRIBUTE	Output only. Ad group id of the simulation.
AdGroupSimulationCpcBidPointListPoints	String	ATTRIBUTE	Projected metrics for a series of CPC bid amounts.
AdGroupSimulationCpvBidPointListPoints	String	ATTRIBUTE	Projected metrics for a series of CPV bid amounts.
AdGroupSimulationEndDate	Date	ATTRIBUTE	Output only. Last day on which the simulation is based, in YYYY-MM-DD format
AdGroupSimulationModificationMethod	String	ATTRIBUTE	Output only. How the simulation modifies the field. The allowed values are DEFAULT, SCALING, UNIFORM, UNKNOWN, UNSPECIFIED.
AdGroupSimulationResourceName	String	ATTRIBUTE	Output only. The resource name of the ad group simulation. Ad group simulation resource names have the form: customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}
AdGroupSimulationStartDate	Date	ATTRIBUTE	Output only. First day on which the simulation is based, in YYYY-MM-DD format.
AdGroupSimulationTargetCpaPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target CPA amounts.
AdGroupSimulationTargetRoasPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target ROAS amounts.
AdGroupSimulationType	String	ATTRIBUTE	Output only. The field that the simulation modifies. The allowed values are BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, 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.

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}'. For example, '{param1:$17}'

Columns

Name	Type	Behavior	Description
AdParameterAdGroupCriterion	String	ATTRIBUTE	Immutable. The ad group criterion that this ad parameter belongs to.
AdParameterInsertionText	String	ATTRIBUTE	Numeric value to insert into the ad text. The following restrictions apply: - Can use comma or period as a separator, with an optional period or comma (respectively) for fractional values. For example, 1,000,000.00 and 2.000.000,10 are valid. - Can be prepended or appended with a currency symbol. For example, $99.99 is valid. - Can be prepended or appended with a currency code. For example, 99.99USD and EUR200 are valid. - Can use '%'. For example, 1.0% and 1,0% are valid. - Can use plus or minus. For example, -10.99 and 25+ are valid. - Can use '/' between two numbers. For example 4/1 and 0.95/0.45 are valid.
AdParameterParameterIndex	Long	ATTRIBUTE	Immutable. The unique index of this ad parameter. Must be either 1 or 2.
AdParameterResourceName	String	ATTRIBUTE	Immutable. The resource name of the ad parameter. Ad parameter resource names have the form: customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}
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.

AdScheduleView

An ad schedule view summarizes the performance of campaigns by AdSchedule criteria.

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
AdScheduleViewResourceName	String	ATTRIBUTE	Output only. The resource name of the ad schedule view. AdSchedule view resource names have the form: customers/{customer_id}/adScheduleViews/{campaign_id}~{criterion_id}
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.
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.
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.
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 (for example, clicking on) another ad.
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, for example, 2018-04-17.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

AgeRangeView

An age range view.

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
AgeRangeViewResourceName	String	ATTRIBUTE	Output only. The resource name of the age range view. Age range view resource names have the form: customers/{customer_id}/ageRangeViews/{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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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.

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
AssetBookOnGoogleAsset	String	ATTRIBUTE	A book on google asset.
AssetCallAssetAdScheduleTargets	String	ATTRIBUTE	List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
AssetCallAssetCallConversionAction	String	ATTRIBUTE	The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AssetCallAssetCallConversionReportingState	String	ATTRIBUTE	Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. The allowed values are DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
AssetCallAssetCountryCode	String	ATTRIBUTE	Required. Two-letter country code of the phone number. Examples: 'US', 'us'.
AssetCallAssetPhoneNumber	String	ATTRIBUTE	Required. The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'
AssetCallToActionAssetCallToAction	String	ATTRIBUTE	Call to action. The allowed values are APPLY_NOW, BOOK_NOW, CONTACT_US, DOWNLOAD, GET_QUOTE, LEARN_MORE, SHOP_NOW, SIGN_UP, SUBSCRIBE, UNKNOWN, UNSPECIFIED.
AssetCalloutAssetAdScheduleTargets	String	ATTRIBUTE	List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
AssetCalloutAssetCalloutText	String	ATTRIBUTE	Required. The callout text. The length of this string should be between 1 and 25, inclusive.
AssetCalloutAssetEndDate	Date	ATTRIBUTE	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
AssetCalloutAssetStartDate	Date	ATTRIBUTE	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
AssetDiscoveryCarouselCardAssetCallToActionText	String	ATTRIBUTE	Call to action text.
AssetDiscoveryCarouselCardAssetHeadline	String	ATTRIBUTE	Required. Headline of the carousel card.
AssetDiscoveryCarouselCardAssetMarketingImageAsset	String	ATTRIBUTE	Asset resource name of the associated 1.91:1 marketing image. This and/or square marketing image asset is required.
AssetDiscoveryCarouselCardAssetPortraitMarketingImageAsset	String	ATTRIBUTE	Asset resource name of the associated 4:5 portrait marketing image.
AssetDiscoveryCarouselCardAssetSquareMarketingImageAsset	String	ATTRIBUTE	Asset resource name of the associated square marketing image. This and/or a marketing image asset is required.
AssetDynamicCustomAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicCustomAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Sedans, 4 door sedans.
AssetDynamicCustomAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $20,000.00.
AssetDynamicCustomAssetFormattedSalePrice	String	ATTRIBUTE	Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $15,000.00.
AssetDynamicCustomAssetId	String	ATTRIBUTE	Required. ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag, for example, sedan. Required.
AssetDynamicCustomAssetId2	String	ATTRIBUTE	ID2 which can be any sequence of letters and digits, for example, red. ID sequence (ID + ID2) must be unique.
AssetDynamicCustomAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicCustomAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicCustomAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicCustomAssetItemAddress	String	ATTRIBUTE	Item address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
AssetDynamicCustomAssetItemCategory	String	ATTRIBUTE	Item category, for example, Sedans.
AssetDynamicCustomAssetItemDescription	String	ATTRIBUTE	Item description, for example, Best selling mid-size car.
AssetDynamicCustomAssetItemSubtitle	String	ATTRIBUTE	Item subtitle, for example, At your Mountain View dealership.
AssetDynamicCustomAssetItemTitle	String	ATTRIBUTE	Required. Item title, for example, Mid-size sedan. Required.
AssetDynamicCustomAssetPrice	String	ATTRIBUTE	Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 20,000.00 USD.
AssetDynamicCustomAssetSalePrice	String	ATTRIBUTE	Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 15,000.00 USD. Must be less than the 'price' field.
AssetDynamicCustomAssetSimilarIds	String	ATTRIBUTE	Similar IDs.
AssetDynamicEducationAssetAddress	String	ATTRIBUTE	School address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
AssetDynamicEducationAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicEducationAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Nursing certification, Health, Mountain View.
AssetDynamicEducationAssetImageUrl	String	ATTRIBUTE	Image url, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicEducationAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicEducationAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicEducationAssetLocationId	String	ATTRIBUTE	Location ID which can be any sequence of letters and digits and must be unique.
AssetDynamicEducationAssetProgramDescription	String	ATTRIBUTE	Program description, for example, Nursing Certification.
AssetDynamicEducationAssetProgramId	String	ATTRIBUTE	Required. Program ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicEducationAssetProgramName	String	ATTRIBUTE	Required. Program name, for example, Nursing. Required.
AssetDynamicEducationAssetSchoolName	String	ATTRIBUTE	School name, for example, Mountain View School of Nursing.
AssetDynamicEducationAssetSimilarProgramIds	String	ATTRIBUTE	Similar program IDs.
AssetDynamicEducationAssetSubject	String	ATTRIBUTE	Subject of study, for example, Health.
AssetDynamicEducationAssetThumbnailImageUrl	String	ATTRIBUTE	Thumbnail image url, for example, http://www.example.com/thumbnail.png. The thumbnail image will not be uploaded as image asset.
AssetDynamicFlightsAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicFlightsAssetCustomMapping	String	ATTRIBUTE	A custom field which can be multiple key to values mapping separated by delimiters (',', '|' and ':'), in the forms of ': , , ... , | : , ... , | ... | : , ... ,' for example, wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32'.
AssetDynamicFlightsAssetDestinationId	String	ATTRIBUTE	Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicFlightsAssetDestinationName	String	ATTRIBUTE	Destination name, for example, Paris.
AssetDynamicFlightsAssetFlightDescription	String	ATTRIBUTE	Required. Flight description, for example, Book your ticket. Required.
AssetDynamicFlightsAssetFlightPrice	String	ATTRIBUTE	Flight price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
AssetDynamicFlightsAssetFlightSalePrice	String	ATTRIBUTE	Flight sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'flight_price' field.
AssetDynamicFlightsAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
AssetDynamicFlightsAssetFormattedSalePrice	String	ATTRIBUTE	Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
AssetDynamicFlightsAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicFlightsAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicFlightsAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicFlightsAssetOriginId	String	ATTRIBUTE	Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
AssetDynamicFlightsAssetOriginName	String	ATTRIBUTE	Origin name, for example, London.
AssetDynamicFlightsAssetSimilarDestinationIds	String	ATTRIBUTE	Similar destination IDs, for example, PAR,LON.
AssetDynamicHotelsAndRentalsAssetAddress	String	ATTRIBUTE	Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
AssetDynamicHotelsAndRentalsAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicHotelsAndRentalsAssetCategory	String	ATTRIBUTE	Category, for example, Hotel suite.
AssetDynamicHotelsAndRentalsAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Mountain View 'Hotels', South Bay hotels.
AssetDynamicHotelsAndRentalsAssetDescription	String	ATTRIBUTE	Description, for example, Close to SJC Airport.
AssetDynamicHotelsAndRentalsAssetDestinationName	String	ATTRIBUTE	Destination name, for example, Downtown Mountain View.
AssetDynamicHotelsAndRentalsAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
AssetDynamicHotelsAndRentalsAssetFormattedSalePrice	String	ATTRIBUTE	Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
AssetDynamicHotelsAndRentalsAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicHotelsAndRentalsAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicHotelsAndRentalsAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicHotelsAndRentalsAssetPrice	String	ATTRIBUTE	Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
AssetDynamicHotelsAndRentalsAssetPropertyId	String	ATTRIBUTE	Required. Property ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicHotelsAndRentalsAssetPropertyName	String	ATTRIBUTE	Required. Property name, for example, Mountain View Hotel. Required.
AssetDynamicHotelsAndRentalsAssetSalePrice	String	ATTRIBUTE	ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
AssetDynamicHotelsAndRentalsAssetSimilarPropertyIds	String	ATTRIBUTE	Similar property IDs.
AssetDynamicHotelsAndRentalsAssetStarRating	Long	ATTRIBUTE	Star rating. Must be a number between 1 to 5, inclusive.
AssetDynamicJobsAssetAddress	String	ATTRIBUTE	Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
AssetDynamicJobsAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicJobsAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Software engineering job.
AssetDynamicJobsAssetDescription	String	ATTRIBUTE	Description, for example, Apply your technical skills.
AssetDynamicJobsAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicJobsAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicJobsAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicJobsAssetJobCategory	String	ATTRIBUTE	Job category, for example, Technical.
AssetDynamicJobsAssetJobId	String	ATTRIBUTE	Required. Job ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicJobsAssetJobSubtitle	String	ATTRIBUTE	Job subtitle, for example, Level II.
AssetDynamicJobsAssetJobTitle	String	ATTRIBUTE	Required. Job title, for example, Software engineer. Required.
AssetDynamicJobsAssetLocationId	String	ATTRIBUTE	Location ID which can be any sequence of letters and digits. The ID sequence (job ID + location ID) must be unique.
AssetDynamicJobsAssetSalary	String	ATTRIBUTE	Salary, for example, $100,000.
AssetDynamicJobsAssetSimilarJobIds	String	ATTRIBUTE	Similar job IDs, for example, 1275.
AssetDynamicLocalAssetAddress	String	ATTRIBUTE	Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
AssetDynamicLocalAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicLocalAssetCategory	String	ATTRIBUTE	Category, for example, Food.
AssetDynamicLocalAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Save groceries coupons.
AssetDynamicLocalAssetDealId	String	ATTRIBUTE	Required. Deal ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicLocalAssetDealName	String	ATTRIBUTE	Required. Deal name, for example, 50% off at Mountain View Grocers. Required.
AssetDynamicLocalAssetDescription	String	ATTRIBUTE	Description, for example, Save on your weekly bill.
AssetDynamicLocalAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
AssetDynamicLocalAssetFormattedSalePrice	String	ATTRIBUTE	Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
AssetDynamicLocalAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicLocalAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicLocalAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicLocalAssetPrice	String	ATTRIBUTE	Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
AssetDynamicLocalAssetSalePrice	String	ATTRIBUTE	Sale price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
AssetDynamicLocalAssetSimilarDealIds	String	ATTRIBUTE	Similar deal IDs, for example, 1275.
AssetDynamicLocalAssetSubtitle	String	ATTRIBUTE	Subtitle, for example, Groceries.
AssetDynamicRealEstateAssetAddress	String	ATTRIBUTE	Address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403
AssetDynamicRealEstateAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicRealEstateAssetCityName	String	ATTRIBUTE	City name, for example, Mountain View, California.
AssetDynamicRealEstateAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, For sale; Houses for sale.
AssetDynamicRealEstateAssetDescription	String	ATTRIBUTE	Description, for example, 3 beds, 2 baths, 1568 sq. ft.
AssetDynamicRealEstateAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $200,000.00.
AssetDynamicRealEstateAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicRealEstateAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicRealEstateAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicRealEstateAssetListingId	String	ATTRIBUTE	Required. Listing ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicRealEstateAssetListingName	String	ATTRIBUTE	Required. Listing name, for example, Boulevard Bungalow. Required.
AssetDynamicRealEstateAssetListingType	String	ATTRIBUTE	Listing type, for example, For sale.
AssetDynamicRealEstateAssetPrice	String	ATTRIBUTE	Price which can be number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 200,000.00 USD.
AssetDynamicRealEstateAssetPropertyType	String	ATTRIBUTE	Property type, for example, House.
AssetDynamicRealEstateAssetSimilarListingIds	String	ATTRIBUTE	Similar listing IDs.
AssetDynamicTravelAssetAndroidAppLink	String	ATTRIBUTE	Android deep link, for example, android-app://com.example.android/http/example.com/gizmos?1234.
AssetDynamicTravelAssetCategory	String	ATTRIBUTE	Category, for example, Express.
AssetDynamicTravelAssetContextualKeywords	String	ATTRIBUTE	Contextual keywords, for example, Paris trains.
AssetDynamicTravelAssetDestinationAddress	String	ATTRIBUTE	Destination address which can be specified in one of the following formats. (1) City, state, code, country, for example, Mountain View, CA, USA. (2) Full address, for example, 123 Boulevard St, Mountain View, CA 94043. (3) Latitude-longitude in the DDD format, for example, 41.40338, 2.17403.
AssetDynamicTravelAssetDestinationId	String	ATTRIBUTE	Required. Destination ID which can be any sequence of letters and digits, and must be unique and match the values of remarketing tag. Required.
AssetDynamicTravelAssetDestinationName	String	ATTRIBUTE	Destination name, for example, Paris.
AssetDynamicTravelAssetFormattedPrice	String	ATTRIBUTE	Formatted price which can be any characters. If set, this attribute will be used instead of 'price', for example, Starting at $100.00.
AssetDynamicTravelAssetFormattedSalePrice	String	ATTRIBUTE	Formatted sale price which can be any characters. If set, this attribute will be used instead of 'sale price', for example, On sale for $80.00.
AssetDynamicTravelAssetImageUrl	String	ATTRIBUTE	Image URL, for example, http://www.example.com/image.png. The image will not be uploaded as image asset.
AssetDynamicTravelAssetIosAppLink	String	ATTRIBUTE	iOS deep link, for example, exampleApp://content/page.
AssetDynamicTravelAssetIosAppStoreId	Long	ATTRIBUTE	iOS app store ID. This is used to check if the user has the app installed on their device before deep linking. If this field is set, then the ios_app_link field must also be present.
AssetDynamicTravelAssetOriginId	String	ATTRIBUTE	Origin ID which can be any sequence of letters and digits. The ID sequence (destination ID + origin ID) must be unique.
AssetDynamicTravelAssetOriginName	String	ATTRIBUTE	Origin name, for example, London.
AssetDynamicTravelAssetPrice	String	ATTRIBUTE	Price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 100.00 USD.
AssetDynamicTravelAssetSalePrice	String	ATTRIBUTE	Sale price which can be a number followed by the alphabetic currency code, ISO 4217 standard. Use '.' as the decimal mark, for example, 80.00 USD. Must be less than the 'price' field.
AssetDynamicTravelAssetSimilarDestinationIds	String	ATTRIBUTE	Similar destination IDs, for example, NYC.
AssetDynamicTravelAssetTitle	String	ATTRIBUTE	Required. Title, for example, Book your train ticket. Required.
AssetFinalMobileUrls	String	ATTRIBUTE	A list of possible final mobile URLs after all cross domain redirects.
AssetFinalUrlSuffix	String	ATTRIBUTE	URL template for appending params to landing page URLs served with parallel tracking.
AssetFinalUrls	String	ATTRIBUTE	A list of possible final URLs after all cross domain redirects.
AssetHotelCalloutAssetLanguageCode	String	ATTRIBUTE	Required. The language of the hotel callout. Represented as BCP 47 language tag.
AssetHotelCalloutAssetText	String	ATTRIBUTE	Required. The text of the hotel callout asset. The length of this string should be between 1 and 25, inclusive.
AssetId	Long	ATTRIBUTE	Output only. The ID of the asset.
AssetImageAssetFileSize	Long	ATTRIBUTE	File size of the image asset in bytes.
AssetImageAssetFullSizeHeightPixels	Long	ATTRIBUTE	Height of the image.
AssetImageAssetFullSizeUrl	String	ATTRIBUTE	A URL that returns the image with this height and width.
AssetImageAssetFullSizeWidthPixels	Long	ATTRIBUTE	Width of the image.
AssetImageAssetMimeType	String	ATTRIBUTE	MIME type of the image asset. 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.
AssetLeadFormAssetBackgroundImageAsset	String	ATTRIBUTE	Asset resource name of the background image. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%).
AssetLeadFormAssetBusinessName	String	ATTRIBUTE	Required. The name of the business being advertised.
AssetLeadFormAssetCallToActionDescription	String	ATTRIBUTE	Required. Text giving a clear value proposition of what users expect once they expand the form.
AssetLeadFormAssetCallToActionType	String	ATTRIBUTE	Required. Pre-defined display text that encourages user to expand the form. The allowed values are APPLY_NOW, BOOK_NOW, CONTACT_US, DOWNLOAD, GET_INFO, GET_OFFER, GET_QUOTE, GET_STARTED, JOIN_NOW, LEARN_MORE, REGISTER, REQUEST_DEMO, SIGN_UP, SUBSCRIBE, UNKNOWN, UNSPECIFIED.
AssetLeadFormAssetCustomDisclosure	String	ATTRIBUTE	Custom disclosure shown along with Google disclaimer on the lead form. Accessible to allowed customers only.
AssetLeadFormAssetCustomQuestionFields	String	ATTRIBUTE	Ordered list of custom question fields.
AssetLeadFormAssetDeliveryMethods	String	ATTRIBUTE	Configured methods for collected lead data to be delivered to advertiser. Only one method typed as WebhookDelivery can be configured.
AssetLeadFormAssetDescription	String	ATTRIBUTE	Required. Detailed description of the expanded form to describe what the form is asking for or facilitating.
AssetLeadFormAssetDesiredIntent	String	ATTRIBUTE	Chosen intent for the lead form, for example, more volume or more qualified. The allowed values are HIGH_INTENT, LOW_INTENT, UNKNOWN, UNSPECIFIED.
AssetLeadFormAssetFields	String	ATTRIBUTE	Ordered list of input fields. This field can be updated by reordering questions, but not by adding or removing questions.
AssetLeadFormAssetHeadline	String	ATTRIBUTE	Required. Headline of the expanded form to describe what the form is asking for or facilitating.
AssetLeadFormAssetPostSubmitCallToActionType	String	ATTRIBUTE	Pre-defined display text that encourages user action after the form is submitted. The allowed values are DOWNLOAD, LEARN_MORE, SHOP_NOW, UNKNOWN, UNSPECIFIED, VISIT_SITE.
AssetLeadFormAssetPostSubmitDescription	String	ATTRIBUTE	Detailed description shown after form submission that describes how the advertiser will follow up with the user.
AssetLeadFormAssetPostSubmitHeadline	String	ATTRIBUTE	Headline of text shown after form submission that describes how the advertiser will follow up with the user.
AssetLeadFormAssetPrivacyPolicyUrl	String	ATTRIBUTE	Required. Link to a page describing the policy on how the collected data is handled by the advertiser/business.
AssetLocationAssetBusinessProfileLocations	String	ATTRIBUTE	The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.
AssetLocationAssetLocationOwnershipType	String	ATTRIBUTE	The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. The allowed values are AFFILIATE, BUSINESS_OWNER, UNKNOWN, UNSPECIFIED.
AssetLocationAssetPlaceId	String	ATTRIBUTE	Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.
AssetMobileAppAssetAppId	String	ATTRIBUTE	Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like 'com.android.ebay' for Android or '12345689' for iOS.
AssetMobileAppAssetAppStore	String	ATTRIBUTE	Required. The application store that distributes this specific app. The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
AssetMobileAppAssetEndDate	Date	ATTRIBUTE	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
AssetMobileAppAssetLinkText	String	ATTRIBUTE	Required. The visible text displayed when the link is rendered in an ad. The length of this string should be between 1 and 25, inclusive.
AssetMobileAppAssetStartDate	Date	ATTRIBUTE	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
AssetName	String	ATTRIBUTE	Optional name of the asset.
AssetPageFeedAssetLabels	String	ATTRIBUTE	Labels used to group the page urls.
AssetPageFeedAssetPageUrl	String	ATTRIBUTE	Required. The webpage that advertisers want to target.
AssetPolicySummaryApprovalStatus	String	ATTRIBUTE	Output only. The overall approval status of this asset, 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.
AssetPolicySummaryPolicyTopicEntries	String	ATTRIBUTE	Output only. The list of policy findings for this asset.
AssetPolicySummaryReviewStatus	String	ATTRIBUTE	Output only. Where in the review process this asset is. The allowed values are ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AssetPriceAssetLanguageCode	String	ATTRIBUTE	Required. The language of the price asset. Represented as BCP 47 language tag.
AssetPriceAssetPriceOfferings	String	ATTRIBUTE	The price offerings of the price asset. The size of this collection should be between 3 and 8, inclusive.
AssetPriceAssetPriceQualifier	String	ATTRIBUTE	The price qualifier of the price asset. The allowed values are AVERAGE, FROM, UNKNOWN, UNSPECIFIED, UP_TO.
AssetPriceAssetType	String	ATTRIBUTE	Required. The type of the price asset. The allowed values are BRANDS, EVENTS, LOCATIONS, NEIGHBORHOODS, PRODUCT_CATEGORIES, PRODUCT_TIERS, SERVICES, SERVICE_CATEGORIES, SERVICE_TIERS, UNKNOWN, UNSPECIFIED.
AssetPromotionAssetAdScheduleTargets	String	ATTRIBUTE	List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
AssetPromotionAssetDiscountModifier	String	ATTRIBUTE	A modifier for qualification of the discount. The allowed values are UNKNOWN, UNSPECIFIED, UP_TO.
AssetPromotionAssetEndDate	Date	ATTRIBUTE	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
AssetPromotionAssetLanguageCode	String	ATTRIBUTE	The language of the promotion. Represented as BCP 47 language tag.
AssetPromotionAssetMoneyAmountOffAmountMicros	Long	ATTRIBUTE	Amount in micros. One million is equivalent to one unit.
AssetPromotionAssetMoneyAmountOffCurrencyCode	String	ATTRIBUTE	Three-character ISO 4217 currency code.
AssetPromotionAssetOccasion	String	ATTRIBUTE	The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion. The allowed values are BACK_TO_SCHOOL, BLACK_FRIDAY, BOXING_DAY, CARNIVAL, CHINESE_NEW_YEAR, CHRISTMAS, CYBER_MONDAY, DIWALI, EASTER, EID_AL_ADHA, EID_AL_FITR, END_OF_SEASON, EPIPHANY, FALL_SALE, FATHERS_DAY, HALLOWEEN, HANUKKAH, HOLI, INDEPENDENCE_DAY, LABOR_DAY, MOTHERS_DAY, NATIONAL_DAY, NAVRATRI, NEW_YEARS, PARENTS_DAY, PASSOVER, RAMADAN, ROSH_HASHANAH, SINGLES_DAY, SONGKRAN, SPRING_SALE, ST_NICHOLAS_DAY, SUMMER_SALE, UNKNOWN, UNSPECIFIED, VALENTINES_DAY, WINTER_SALE, WOMENS_DAY, YEAR_END_GIFT.
AssetPromotionAssetOrdersOverAmountAmountMicros	Long	ATTRIBUTE	Amount in micros. One million is equivalent to one unit.
AssetPromotionAssetOrdersOverAmountCurrencyCode	String	ATTRIBUTE	Three-character ISO 4217 currency code.
AssetPromotionAssetPercentOff	Long	ATTRIBUTE	Percentage off discount in the promotion. 1,000,000 = 100%. Either this or money_amount_off is required.
AssetPromotionAssetPromotionCode	String	ATTRIBUTE	A code the user should use in order to be eligible for the promotion.
AssetPromotionAssetPromotionTarget	String	ATTRIBUTE	Required. A freeform description of what the promotion is targeting.
AssetPromotionAssetRedemptionEndDate	Date	ATTRIBUTE	Last date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
AssetPromotionAssetRedemptionStartDate	Date	ATTRIBUTE	Start date of when the promotion is eligible to be redeemed, in yyyy-MM-dd format.
AssetPromotionAssetStartDate	Date	ATTRIBUTE	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
AssetResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset. Asset resource names have the form: customers/{customer_id}/assets/{asset_id}
AssetSitelinkAssetAdScheduleTargets	String	ATTRIBUTE	List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.
AssetSitelinkAssetDescription1	String	ATTRIBUTE	First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.
AssetSitelinkAssetDescription2	String	ATTRIBUTE	Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.
AssetSitelinkAssetEndDate	Date	ATTRIBUTE	Last date of when this asset is effective and still serving, in yyyy-MM-dd format.
AssetSitelinkAssetLinkText	String	ATTRIBUTE	Required. URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
AssetSitelinkAssetStartDate	Date	ATTRIBUTE	Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.
AssetSource	String	ATTRIBUTE	Output only. Source of the asset. The allowed values are ADVERTISER, AUTOMATICALLY_CREATED, UNKNOWN, UNSPECIFIED.
AssetStructuredSnippetAssetHeader	String	ATTRIBUTE	Required. The header of the snippet. This string should be one of the predefined values at https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers
AssetStructuredSnippetAssetValues	String	ATTRIBUTE	Required. The values in the snippet. The size of this collection should be between 3 and 10, inclusive. The length of each value should be between 1 and 25 characters, inclusive.
AssetTextAssetText	String	ATTRIBUTE	Text content of the text asset.
AssetTrackingUrlTemplate	String	ATTRIBUTE	URL template for constructing a tracking URL.
AssetType	String	ATTRIBUTE	Output only. Type of the asset. The allowed values are BOOK_ON_GOOGLE, CALL, CALLOUT, CALL_TO_ACTION, DISCOVERY_CAROUSEL_CARD, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, HOTEL_CALLOUT, IMAGE, LEAD_FORM, LOCATION, MEDIA_BUNDLE, MOBILE_APP, PAGE_FEED, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, TEXT, UNKNOWN, UNSPECIFIED, YOUTUBE_VIDEO.
AssetUrlCustomParameters	String	ATTRIBUTE	A list of mappings to be used for substituting URL custom parameter tags in the tracking_url_template, final_urls, and/or final_mobile_urls.
AssetYoutubeVideoAssetYoutubeVideoId	String	ATTRIBUTE	YouTube video id. This is the 11 character string value used in the YouTube video URL.
AssetYoutubeVideoAssetYoutubeVideoTitle	String	ATTRIBUTE	YouTube video title.
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
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 versus 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.
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.

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.

AssetFieldTypeView

An asset field type view. This view reports non-overcounted metrics for each asset field type when the asset is used as extension.

Columns

Name	Type	Behavior	Description
AssetFieldTypeViewFieldType	String	ATTRIBUTE	Output only. The asset field type of the asset field type view. The allowed values are AD_IMAGE, 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.
AssetFieldTypeViewResourceName	String	ATTRIBUTE	Output only. The resource name of the asset field type view. Asset field type view resource names have the form: customers/{customer_id}/assetFieldTypeViews/{field_type}
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).
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

AssetGroup

An asset group. AssetGroupAsset is used to link an asset to the asset group. AssetGroupSignal is used to associate a signal to an asset group.

Columns

Name	Type	Behavior	Description
AssetGroupAdStrength	String	ATTRIBUTE	Output only. Overall ad strength of this asset group. The allowed values are AVERAGE, EXCELLENT, GOOD, NO_ADS, PENDING, POOR, UNKNOWN, UNSPECIFIED.
AssetGroupCampaign	String	ATTRIBUTE	Immutable. The campaign with which this asset group is associated. The asset which is linked to the asset group.
AssetGroupFinalMobileUrls	String	ATTRIBUTE	A list of final mobile URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
AssetGroupFinalUrls	String	ATTRIBUTE	A list of final URLs after all cross domain redirects. In performance max, by default, the urls are eligible for expansion unless opted out.
AssetGroupId	Long	ATTRIBUTE	Output only. The ID of the asset group.
AssetGroupName	String	ATTRIBUTE	Required. Name of the asset group. Required. It must have a minimum length of 1 and maximum length of 128. It must be unique under a campaign.
AssetGroupPath1	String	ATTRIBUTE	First part of text that may appear appended to the url displayed in the ad.
AssetGroupPath6	String	ATTRIBUTE	Second part of text that may appear appended to the url displayed in the ad. This field can only be set when path1 is set.
AssetGroupResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset group. Asset group resource names have the form: customers/{customer_id}/assetGroups/{asset_group_id}
AssetGroupStatus	String	ATTRIBUTE	The status of the asset group. The allowed values are ENABLED, PAUSED, REMOVED, 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.

AssetGroupAsset

AssetGroupAsset is the link between an asset and an asset group. Adding an AssetGroupAsset links an asset with an asset group.

Columns

Name	Type	Behavior	Description
AssetGroupAssetAsset	String	ATTRIBUTE	Immutable. The asset which this asset group asset is linking.
AssetGroupAssetAssetGroup	String	ATTRIBUTE	Immutable. The asset group which this asset group asset is linking.
AssetGroupAssetFieldType	String	ATTRIBUTE	The description of the placement of the asset within the asset group. For example: HEADLINE, YOUTUBE_VIDEO etc The allowed values are AD_IMAGE, 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.
AssetGroupAssetPerformanceLabel	String	ATTRIBUTE	Output only. The performance of this asset group asset. The allowed values are BEST, GOOD, LEARNING, LOW, PENDING, UNKNOWN, UNSPECIFIED.
AssetGroupAssetPolicySummaryApprovalStatus	String	ATTRIBUTE	The overall approval status, which is 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.
AssetGroupAssetPolicySummaryPolicyTopicEntries	String	ATTRIBUTE	The list of policy findings.
AssetGroupAssetPolicySummaryReviewStatus	String	ATTRIBUTE	Where in the review process the resource is. The allowed values are ELIGIBLE_MAY_SERVE, REVIEWED, REVIEW_IN_PROGRESS, UNDER_APPEAL, UNKNOWN, UNSPECIFIED.
AssetGroupAssetResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset group asset. Asset group asset resource name have the form: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
AssetGroupAssetStatus	String	ATTRIBUTE	The status of the link between an asset and asset group. The allowed values are ENABLED, PAUSED, REMOVED, 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.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter represents a listing group filter tree node in an asset group.

Columns

Name	Type	Behavior	Description
AssetGroupListingGroupFilterAssetGroup	String	ATTRIBUTE	Immutable. The asset group which this asset group listing group filter is part of.
AssetGroupListingGroupFilterCaseValueProductBiddingCategoryId	Long	ATTRIBUTE	ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436
AssetGroupListingGroupFilterCaseValueProductBiddingCategoryLevel	String	ATTRIBUTE	Indicates the level of the category in the taxonomy. The allowed values are LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductBrandValue	String	ATTRIBUTE	String value of the product brand.
AssetGroupListingGroupFilterCaseValueProductChannelChannel	String	ATTRIBUTE	Value of the locality. The allowed values are LOCAL, ONLINE, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductConditionCondition	String	ATTRIBUTE	Value of the condition. The allowed values are NEW, REFURBISHED, UNKNOWN, UNSPECIFIED, USED.
AssetGroupListingGroupFilterCaseValueProductCustomAttributeIndex	String	ATTRIBUTE	Indicates the index of the custom attribute. The allowed values are INDEX0, INDEX1, INDEX2, INDEX3, INDEX4, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductCustomAttributeValue	String	ATTRIBUTE	String value of the product custom attribute.
AssetGroupListingGroupFilterCaseValueProductItemIdValue	String	ATTRIBUTE	Value of the id.
AssetGroupListingGroupFilterCaseValueProductTypeLevel	String	ATTRIBUTE	Level of the type. The allowed values are LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterCaseValueProductTypeValue	String	ATTRIBUTE	Value of the type.
AssetGroupListingGroupFilterId	Long	ATTRIBUTE	Output only. The ID of the ListingGroupFilter.
AssetGroupListingGroupFilterParentListingGroupFilter	String	ATTRIBUTE	Immutable. Resource name of the parent listing group subdivision. Null for the root listing group filter node.
AssetGroupListingGroupFilterResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset group listing group filter. Asset group listing group filter resource name have the form: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
AssetGroupListingGroupFilterType	String	ATTRIBUTE	Immutable. Type of a listing group filter node. The allowed values are SUBDIVISION, UNIT_EXCLUDED, UNIT_INCLUDED, UNKNOWN, UNSPECIFIED.
AssetGroupListingGroupFilterVertical	String	ATTRIBUTE	Immutable. The vertical the current node tree represents. All nodes in the same tree must belong to the same vertical. The allowed values are SHOPPING, 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.

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.

Columns

Name	Type	Behavior	Description
AssetGroupSignalAssetGroup	String	ATTRIBUTE	Immutable. The asset group which this asset group signal belongs to.
AssetGroupSignalAudienceAudience	String	ATTRIBUTE	The Audience resource name.
AssetGroupSignalResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset group signal. Asset group signal resource name have the form: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_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.

AssetSet

An asset set representing a collection of assets. Use AssetSetAsset to link an asset to the asset set.

Columns

Name	Type	Behavior	Description
AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterBusinessNameFilterBusinessName	String	ATTRIBUTE	Business name string to use for filtering.
AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterBusinessNameFilterFilterType	String	ATTRIBUTE	The type of string matching to use when filtering with business_name. The allowed values are EXACT, UNKNOWN, UNSPECIFIED.
AssetSetBusinessProfileLocationGroupDynamicBusinessProfileLocationGroupFilterLabelFilters	String	ATTRIBUTE	Used to filter Business Profile locations by label. Only locations that have any of the listed labels will be in the asset set. Label filters are OR'ed together.
AssetSetId	Long	ATTRIBUTE	Output only. The ID of the asset set.
AssetSetLocationSetBusinessProfileLocationSetBusinessNameFilter	String	ATTRIBUTE	Used to filter Google Business Profile listings by business name. If businessNameFilter is set, only listings with a matching business name are candidates to be sync'd into Assets.
AssetSetLocationSetBusinessProfileLocationSetLabelFilters	String	ATTRIBUTE	Used to filter Google Business Profile listings by labels. If entries exist in labelFilters, only listings that have any of the labels set are candidates to be synchronized into Assets. If no entries exist in labelFilters, then all listings are candidates for syncing. Label filters are OR'ed together.
AssetSetLocationSetBusinessProfileLocationSetListingIdFilters	String	ATTRIBUTE	Used to filter Google Business Profile listings by listing id. If entries exist in listingIdFilters, only listings specified by the filters are candidates to be synchronized into Assets. If no entries exist in listingIdFilters, then all listings are candidates for syncing. Listing ID filters are OR'ed together.
AssetSetLocationSetChainLocationSetRelationshipType	String	ATTRIBUTE	Required. Immutable. Relationship type the specified chains have with this advertiser. The allowed values are AUTO_DEALERS, GENERAL_RETAILERS, UNKNOWN, UNSPECIFIED.
AssetSetLocationSetLocationOwnershipType	String	ATTRIBUTE	Required. Immutable. Location Ownership Type (owned location or affiliate location). The allowed values are AFFILIATE, BUSINESS_OWNER, UNKNOWN, UNSPECIFIED.
AssetSetMerchantCenterFeedFeedLabel	String	ATTRIBUTE	Optional. Feed Label from Google Merchant Center.
AssetSetMerchantCenterFeedMerchantId	Long	ATTRIBUTE	Required. Merchant ID from Google Merchant Center
AssetSetName	String	ATTRIBUTE	Required. Name of the asset set. Required. It must have a minimum length of 1 and maximum length of 128.
AssetSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset set. Asset set resource names have the form: customers/{customer_id}/assetSets/{asset_set_id}
AssetSetStatus	String	ATTRIBUTE	Output only. The status of the asset set. Read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
AssetSetType	String	ATTRIBUTE	Required. Immutable. The type of the asset set. Required. The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, 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.

AssetSetAsset

AssetSetAsset is the link between an asset and an asset set. Adding an AssetSetAsset links an asset with an asset set.

Columns

Name	Type	Behavior	Description
AssetSetAssetAsset	String	ATTRIBUTE	Immutable. The asset which this asset set asset is linking to.
AssetSetAssetAssetSet	String	ATTRIBUTE	Immutable. The asset set which this asset set asset is linking to.
AssetSetAssetResourceName	String	ATTRIBUTE	Immutable. The resource name of the asset set asset. Asset set asset resource names have the form: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
AssetSetAssetStatus	String	ATTRIBUTE	Output only. The status of the asset set asset. Read-only. The allowed values are ENABLED, 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.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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.
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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

AssetSetTypeView

An asset set type view. This view reports non-overcounted metrics for each asset set type. Child asset set types are not included in this report. Their stats are aggregated under the parent asset set type.

Columns

Name	Type	Behavior	Description
AssetSetTypeViewAssetSetType	String	ATTRIBUTE	Output only. The asset set type of the asset set type view. The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, UNKNOWN, UNSPECIFIED.
AssetSetTypeViewResourceName	String	ATTRIBUTE	Output only. The resource name of the asset set type view. Asset set type view resource names have the form: customers/{customer_id}/assetSetTypeViews/{asset_set_type}
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

Audience

Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.

Columns

Name	Type	Behavior	Description
AudienceDescription	String	ATTRIBUTE	Description of this audience.
AudienceDimensions	String	ATTRIBUTE	Positive dimensions specifying the audience composition.
AudienceExclusionDimension	String	ATTRIBUTE	Negative dimension specifying the audience composition.
AudienceId	Long	ATTRIBUTE	Output only. ID of the audience.
AudienceName	String	ATTRIBUTE	Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255.
AudienceResourceName	String	ATTRIBUTE	Immutable. The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
AudienceStatus	String	ATTRIBUTE	Output only. Status of this audience. Indicates whether the audience is enabled or removed. The allowed values are ENABLED, REMOVED, 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.

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.

Columns

Name	Type	Behavior	Description
BatchJobId	Long	ATTRIBUTE	Output only. ID of this batch job.
BatchJobLongRunningOperation	String	ATTRIBUTE	Output only. The resource name of the long-running operation that can be used to poll for completion. Only set when the batch job status is RUNNING or DONE.
BatchJobMetadataCompletionDateTime	Date	ATTRIBUTE	Output only. The time when this batch job was completed. Formatted as yyyy-MM-dd HH:mm:ss. Example: '2018-03-05 09:16:00'
BatchJobMetadataCreationDateTime	Date	ATTRIBUTE	Output only. The time when this batch job was created. Formatted as yyyy-mm-dd hh:mm:ss. Example: '2018-03-05 09:15:00'
BatchJobMetadataEstimatedCompletionRatio	Double	ATTRIBUTE	Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. This is empty if the job hasn't started running yet.
BatchJobMetadataExecutedOperationCount	Long	ATTRIBUTE	Output only. The number of mutate operations executed by the batch job. Present only if the job has started running.
BatchJobMetadataOperationCount	Long	ATTRIBUTE	Output only. The number of mutate operations in the batch job.
BatchJobMetadataStartDateTime	Date	ATTRIBUTE	Output only. The time when this batch job started running. Formatted as yyyy-mm-dd hh:mm:ss. Example: '2018-03-05 09:15:30'
BatchJobNextAddSequenceToken	String	ATTRIBUTE	Output only. The next sequence token to use when adding operations. Only set when the batch job status is PENDING.
BatchJobResourceName	String	ATTRIBUTE	Immutable. The resource name of the batch job. Batch job resource names have the form: customers/{customer_id}/batchJobs/{batch_job_id}
BatchJobStatus	String	ATTRIBUTE	Output only. Status of this batch job. The allowed values are DONE, PENDING, RUNNING, 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.

BiddingDataExclusion

Represents a bidding data exclusion. See 'About data exclusions' at https://support.google.com/google-ads/answer/10370710.

Columns

Name	Type	Behavior	Description
BiddingDataExclusionAdvertisingChannelTypes	String	ATTRIBUTE	The data_exclusion will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this exclusion is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported. The allowed values are DISCOVERY, DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
BiddingDataExclusionCampaigns	String	ATTRIBUTE	The data exclusion will apply to the campaigns listed when the scope of this exclusion is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a data exclusion with both advertising_channel_types and campaign_ids is not supported.
BiddingDataExclusionDataExclusionId	Long	ATTRIBUTE	Output only. The ID of the data exclusion.
BiddingDataExclusionDescription	String	ATTRIBUTE	The description of the data exclusion. The description can be at most 2048 characters.
BiddingDataExclusionDevices	String	ATTRIBUTE	If not specified, all devices will be included in this exclusion. Otherwise, only the specified targeted devices will be included in this exclusion. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
BiddingDataExclusionEndDateTime	String	ATTRIBUTE	Required. The exclusive end time of the data exclusion in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days].
BiddingDataExclusionName	String	ATTRIBUTE	The name of the data exclusion. The name can be at most 255 characters.
BiddingDataExclusionResourceName	String	ATTRIBUTE	Immutable. The resource name of the data exclusion. Data exclusion resource names have the form: customers/{customer_id}/biddingDataExclusions/{data_exclusion_id}
BiddingDataExclusionScope	String	ATTRIBUTE	The scope of the data exclusion. The allowed values are CAMPAIGN, CHANNEL, CUSTOMER, UNKNOWN, UNSPECIFIED.
BiddingDataExclusionStartDateTime	String	ATTRIBUTE	Required. The inclusive start time of the data exclusion in yyyy-MM-dd HH:mm:ss format. A data exclusion is backward looking and should be used for events that start in the past and end either in the past or future.
BiddingDataExclusionStatus	String	ATTRIBUTE	Output only. The status of the data exclusion. The allowed values are ENABLED, REMOVED, 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.

BiddingSeasonalityAdjustment

Represents a bidding seasonality adjustment. See 'About seasonality adjustments' at https://support.google.com/google-ads/answer/10369906.

Columns

Name	Type	Behavior	Description
BiddingSeasonalityAdjustmentAdvertisingChannelTypes	String	ATTRIBUTE	The seasonality adjustment will apply to all the campaigns under the listed channels retroactively as well as going forward when the scope of this adjustment is CHANNEL. The supported advertising channel types are DISPLAY, SEARCH and SHOPPING. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported. The allowed values are DISCOVERY, DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
BiddingSeasonalityAdjustmentCampaigns	String	ATTRIBUTE	The seasonality adjustment will apply to the campaigns listed when the scope of this adjustment is CAMPAIGN. The maximum number of campaigns per event is 2000. Note: a seasonality adjustment with both advertising_channel_types and campaign_ids is not supported.
BiddingSeasonalityAdjustmentConversionRateModifier	Double	ATTRIBUTE	Conversion rate modifier estimated based on expected conversion rate changes. When this field is unset or set to 1.0 no adjustment will be applied to traffic. The allowed range is 0.1 to 10.0.
BiddingSeasonalityAdjustmentDescription	String	ATTRIBUTE	The description of the seasonality adjustment. The description can be at most 2048 characters.
BiddingSeasonalityAdjustmentDevices	String	ATTRIBUTE	If not specified, all devices will be included in this adjustment. Otherwise, only the specified targeted devices will be included in this adjustment. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
BiddingSeasonalityAdjustmentEndDateTime	String	ATTRIBUTE	Required. The exclusive end time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. The length of [start_date_time, end_date_time) interval must be within (0, 14 days].
BiddingSeasonalityAdjustmentName	String	ATTRIBUTE	The name of the seasonality adjustment. The name can be at most 255 characters.
BiddingSeasonalityAdjustmentResourceName	String	ATTRIBUTE	Immutable. The resource name of the seasonality adjustment. Seasonality adjustment resource names have the form: customers/{customer_id}/biddingSeasonalityAdjustments/{seasonality_adjustment_id}
BiddingSeasonalityAdjustmentScope	String	ATTRIBUTE	The scope of the seasonality adjustment. The allowed values are CAMPAIGN, CHANNEL, CUSTOMER, UNKNOWN, UNSPECIFIED.
BiddingSeasonalityAdjustmentSeasonalityAdjustmentId	Long	ATTRIBUTE	Output only. The ID of the seasonality adjustment.
BiddingSeasonalityAdjustmentStartDateTime	String	ATTRIBUTE	Required. The inclusive start time of the seasonality adjustment in yyyy-MM-dd HH:mm:ss format. A seasonality adjustment is forward looking and should be used for events that start and end in the future.
BiddingSeasonalityAdjustmentStatus	String	ATTRIBUTE	Output only. The status of the seasonality adjustment. The allowed values are ENABLED, REMOVED, 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.

BiddingStrategy

A bidding strategy.

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
BiddingStrategyAlignedCampaignBudgetId	Long	ATTRIBUTE	ID of the campaign budget that this portfolio bidding strategy is aligned with. When a portfolio and a campaign budget are aligned, that means that they are attached to the same set of campaigns. After a bidding strategy is aligned with a campaign budget, campaigns that are added to the bidding strategy must also use the aligned campaign budget.
BiddingStrategyCampaignCount	Long	ATTRIBUTE	Output only. The number of campaigns attached to this bidding strategy. This field is read-only.
BiddingStrategyCurrencyCode	String	ATTRIBUTE	Immutable. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
BiddingStrategyEffectiveCurrencyCode	String	ATTRIBUTE	Output only. The currency used by the bidding strategy (ISO 4217 three-letter code). For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currency_code. Bidding strategy metrics are reported in this currency. This field is read-only.
BiddingStrategyEnhancedCpc	String	ATTRIBUTE	A bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
BiddingStrategyId	Long	ATTRIBUTE	Output only. The ID of the bidding strategy.
BiddingStrategyMaximizeConversionValueCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
BiddingStrategyMaximizeConversionValueCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
BiddingStrategyMaximizeConversionValueTargetRoas	Double	ATTRIBUTE	Output only. 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.
BiddingStrategyMaximizeConversionsCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
BiddingStrategyMaximizeConversionsCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.
BiddingStrategyMaximizeConversionsTargetCpaMicros	Long	ATTRIBUTE	Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
BiddingStrategyName	String	ATTRIBUTE	The name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
BiddingStrategyNonRemovedCampaignCount	Long	ATTRIBUTE	Output only. The number of non-removed campaigns attached to this bidding strategy. This field is read-only.
BiddingStrategyResourceName	String	ATTRIBUTE	Immutable. The resource name of the bidding strategy. Bidding strategy resource names have the form: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
BiddingStrategyStatus	String	ATTRIBUTE	Output only. The status of the bidding strategy. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
BiddingStrategyTargetCpaCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
BiddingStrategyTargetCpaCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
BiddingStrategyTargetCpaTargetCpaMicros	Long	ATTRIBUTE	Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
BiddingStrategyTargetImpressionShareCpcBidCeilingMicros	Long	ATTRIBUTE	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.
BiddingStrategyTargetImpressionShareLocation	String	ATTRIBUTE	The targeted location on the search results page. The allowed values are ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
BiddingStrategyTargetImpressionShareLocationFractionMicros	Long	ATTRIBUTE	The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
BiddingStrategyTargetRoasCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
BiddingStrategyTargetRoasCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
BiddingStrategyTargetRoasTargetRoas	Double	ATTRIBUTE	Output only. The chosen revenue (based on conversion data) per unit of spend.
BiddingStrategyTargetSpendCpcBidCeilingMicros	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.
BiddingStrategyTargetSpendTargetSpendMicros	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.
BiddingStrategyType	String	ATTRIBUTE	Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. The allowed values are COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPA, 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.
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.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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).
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 (for example, clicking on) another ad.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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

Columns

Name	Type	Behavior	Description
BiddingStrategySimulationBiddingStrategyId	Long	ATTRIBUTE	Output only. Bidding strategy shared set id of the simulation.
BiddingStrategySimulationEndDate	Date	ATTRIBUTE	Output only. Last day on which the simulation is based, in YYYY-MM-DD format
BiddingStrategySimulationModificationMethod	String	ATTRIBUTE	Output only. How the simulation modifies the field. The allowed values are DEFAULT, SCALING, UNIFORM, UNKNOWN, UNSPECIFIED.
BiddingStrategySimulationResourceName	String	ATTRIBUTE	Output only. The resource name of the bidding strategy simulation. Bidding strategy simulation resource names have the form: customers/{customer_id}/biddingStrategySimulations/{bidding_strategy_id}~{type}~{modification_method}~{start_date}~{end_date}
BiddingStrategySimulationStartDate	Date	ATTRIBUTE	Output only. First day on which the simulation is based, in YYYY-MM-DD format.
BiddingStrategySimulationTargetCpaPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target CPA amounts.
BiddingStrategySimulationTargetRoasPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target ROAS amounts.
BiddingStrategySimulationType	String	ATTRIBUTE	Output only. The field that the simulation modifies. The allowed values are BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, 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.

BillingSetup

A billing setup, which associates a payments account and an advertiser. A billing setup is specific to one advertiser.

Columns

Name	Type	Behavior	Description
BillingSetupEndDateTime	Date	ATTRIBUTE	Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format.
BillingSetupEndTimeType	String	ATTRIBUTE	Output only. The end time as a type. The only possible value is FOREVER. The allowed values are FOREVER, NOW, UNKNOWN, UNSPECIFIED.
BillingSetupId	Long	ATTRIBUTE	Output only. The ID of the billing setup.
BillingSetupPaymentsAccount	String	ATTRIBUTE	Immutable. The resource name of the payments account associated with this billing setup. Payments resource names have the form: customers/{customer_id}/paymentsAccounts/{payments_account_id} When setting up billing, this is used to signup with an existing payments account (and then payments_account_info should not be set). When getting a billing setup, this and payments_account_info will be populated.
BillingSetupPaymentsAccountInfoPaymentsAccountId	String	ATTRIBUTE	Output only. A 16 digit id used to identify the payments account associated with the billing setup. This must be passed as a string with dashes, for example, '1234-5678-9012-3456'.
BillingSetupPaymentsAccountInfoPaymentsAccountName	String	ATTRIBUTE	Immutable. The name of the payments account associated with the billing setup. This enables the user to specify a meaningful name for a payments account to aid in reconciling monthly invoices. This name will be printed in the monthly invoices.
BillingSetupPaymentsAccountInfoPaymentsProfileId	String	ATTRIBUTE	Immutable. A 12 digit id used to identify the payments profile associated with the billing setup. This must be passed in as a string with dashes, for example, '1234-5678-9012'.
BillingSetupPaymentsAccountInfoPaymentsProfileName	String	ATTRIBUTE	Output only. The name of the payments profile associated with the billing setup.
BillingSetupPaymentsAccountInfoSecondaryPaymentsProfileId	String	ATTRIBUTE	Output only. A secondary payments profile id present in uncommon situations, for example, when a sequential liability agreement has been arranged.
BillingSetupResourceName	String	ATTRIBUTE	Immutable. The resource name of the billing setup. BillingSetup resource names have the form: customers/{customer_id}/billingSetups/{billing_setup_id}
BillingSetupStartDateTime	Date	ATTRIBUTE	Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a future time is allowed.
BillingSetupStatus	String	ATTRIBUTE	Output only. The status of the billing setup. The allowed values are APPROVED, APPROVED_HELD, CANCELLED, PENDING, 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.

CallView

A call view that includes data for call tracking of call-only ads or call extensions.

Columns

Name	Type	Behavior	Description
CallViewCallDurationSeconds	Long	ATTRIBUTE	Output only. The advertiser-provided call duration in seconds.
CallViewCallStatus	String	ATTRIBUTE	Output only. The status of the call. The allowed values are MISSED, RECEIVED, UNKNOWN, UNSPECIFIED.
CallViewCallTrackingDisplayLocation	String	ATTRIBUTE	Output only. The call tracking display location. The allowed values are AD, LANDING_PAGE, UNKNOWN, UNSPECIFIED.
CallViewCallerAreaCode	String	ATTRIBUTE	Output only. Area code of the caller. Null if the call duration is shorter than 15 seconds.
CallViewCallerCountryCode	String	ATTRIBUTE	Output only. Country code of the caller.
CallViewEndCallDateTime	Date	ATTRIBUTE	Output only. The advertiser-provided call end date time.
CallViewResourceName	String	ATTRIBUTE	Output only. The resource name of the call view. Call view resource names have the form: customers/{customer_id}/callViews/{call_detail_id}
CallViewStartCallDateTime	Date	ATTRIBUTE	Output only. The advertiser-provided call start date time.
CallViewType	String	ATTRIBUTE	Output only. The type of the call. The allowed values are HIGH_END_MOBILE_SEARCH, MANUALLY_DIALED, 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.

Campaign

A campaign.

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
CampaignAccessibleBiddingStrategy	String	ATTRIBUTE	Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.
CampaignAdServingOptimizationStatus	String	ATTRIBUTE	The ad serving optimization status of the campaign. The allowed values are CONVERSION_OPTIMIZE, OPTIMIZE, ROTATE, ROTATE_INDEFINITELY, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
CampaignAdvertisingChannelSubType	String	ATTRIBUTE	Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. The allowed values are APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, APP_CAMPAIGN_FOR_PRE_REGISTRATION, DISPLAY_EXPRESS, DISPLAY_GMAIL_AD, DISPLAY_MOBILE_APP, DISPLAY_SMART_CAMPAIGN, LOCAL_CAMPAIGN, SEARCH_EXPRESS, SEARCH_MOBILE_APP, SHOPPING_COMPARISON_LISTING_ADS, SHOPPING_SMART_ADS, SMART_CAMPAIGN, UNKNOWN, UNSPECIFIED, VIDEO_ACTION, VIDEO_NON_SKIPPABLE, VIDEO_OUTSTREAM, VIDEO_SEQUENCE.
CampaignAdvertisingChannelType	String	ATTRIBUTE	Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. The allowed values are DISCOVERY, DISPLAY, HOTEL, LOCAL, LOCAL_SERVICES, MULTI_CHANNEL, PERFORMANCE_MAX, SEARCH, SHOPPING, SMART, UNKNOWN, UNSPECIFIED, VIDEO.
CampaignAppCampaignSettingAppId	String	ATTRIBUTE	Immutable. A string that uniquely identifies a mobile application.
CampaignAppCampaignSettingAppStore	String	ATTRIBUTE	Immutable. The application store that distributes this specific app. The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
CampaignAppCampaignSettingBiddingStrategyGoalType	String	ATTRIBUTE	Represents the goal which the bidding strategy of this app campaign should optimize towards. The allowed values are OPTIMIZE_INSTALLS_TARGET_INSTALL_COST, OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST, OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST, OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME, OPTIMIZE_RETURN_ON_ADVERTISING_SPEND, UNKNOWN, UNSPECIFIED.
CampaignAudienceSettingUseAudienceGrouped	Bool	ATTRIBUTE	Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
CampaignBaseCampaign	String	ATTRIBUTE	Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only.
CampaignBiddingStrategy	String	ATTRIBUTE	Portfolio bidding strategy used by campaign.
CampaignBiddingStrategySystemStatus	String	ATTRIBUTE	Output only. The system status of the campaign's bidding strategy. The allowed values are ENABLED, LEARNING_BUDGET_CHANGE, LEARNING_COMPOSITION_CHANGE, LEARNING_CONVERSION_SETTING_CHANGE, LEARNING_CONVERSION_TYPE_CHANGE, LEARNING_NEW, LEARNING_SETTING_CHANGE, LIMITED_BY_BUDGET, LIMITED_BY_CPC_BID_CEILING, LIMITED_BY_CPC_BID_FLOOR, LIMITED_BY_DATA, LIMITED_BY_INVENTORY, LIMITED_BY_LOW_PRIORITY_SPEND, LIMITED_BY_LOW_QUALITY, MISCONFIGURED_CONVERSION_SETTINGS, MISCONFIGURED_CONVERSION_TYPES, MISCONFIGURED_SHARED_BUDGET, MISCONFIGURED_STRATEGY_TYPE, MISCONFIGURED_ZERO_ELIGIBILITY, MULTIPLE, MULTIPLE_LEARNING, MULTIPLE_LIMITED, MULTIPLE_MISCONFIGURED, PAUSED, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
CampaignBiddingStrategyType	String	ATTRIBUTE	Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. The allowed values are COMMISSION, ENHANCED_CPC, INVALID, MANUAL_CPA, 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.
CampaignCampaignBudget	String	ATTRIBUTE	The budget of the campaign.
CampaignCampaignGroup	String	ATTRIBUTE	The campaign group this campaign belongs to.
CampaignCommissionCommissionRateMicros	Long	ATTRIBUTE	Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%).
CampaignDynamicSearchAdsSettingDomainName	String	ATTRIBUTE	Required. The Internet domain name that this setting represents, for example, 'google.com' or 'www.google.com'.
CampaignDynamicSearchAdsSettingFeeds	String	ATTRIBUTE	The list of page feeds associated with the campaign.
CampaignDynamicSearchAdsSettingLanguageCode	String	ATTRIBUTE	Required. The language code specifying the language of the domain, for example, 'en'.
CampaignDynamicSearchAdsSettingUseSuppliedUrlsOnly	Bool	ATTRIBUTE	Whether the campaign uses advertiser supplied URLs exclusively.
CampaignEndDate	Date	ATTRIBUTE	The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.
CampaignExcludedParentAssetFieldTypes	String	ATTRIBUTE	The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. The allowed values are AD_IMAGE, 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.
CampaignExcludedParentAssetSetTypes	String	ATTRIBUTE	The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported. The allowed values are BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHTS, DYNAMIC_HOTELS_AND_RENTALS, DYNAMIC_JOBS, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, LOCATION_SYNC, MERCHANT_CENTER_FEED, PAGE_FEED, STATIC_LOCATION_GROUP, UNKNOWN, UNSPECIFIED.
CampaignExperimentType	String	ATTRIBUTE	Output only. The type of campaign: normal, draft, or experiment. The allowed values are BASE, DRAFT, EXPERIMENT, UNKNOWN, UNSPECIFIED.
CampaignFinalUrlSuffix	String	ATTRIBUTE	Suffix used to append query parameters to landing pages that are served with parallel tracking.
CampaignFrequencyCaps	String	ATTRIBUTE	A list that limits how often each user will see this campaign's ads.
CampaignGeoTargetTypeSettingNegativeGeoTargetType	String	ATTRIBUTE	The setting used for negative geotargeting in this particular campaign. The allowed values are PRESENCE, PRESENCE_OR_INTEREST, UNKNOWN, UNSPECIFIED.
CampaignGeoTargetTypeSettingPositiveGeoTargetType	String	ATTRIBUTE	The setting used for positive geotargeting in this particular campaign. The allowed values are PRESENCE, PRESENCE_OR_INTEREST, SEARCH_INTEREST, UNKNOWN, UNSPECIFIED.
CampaignHotelSettingHotelCenterId	Long	ATTRIBUTE	Immutable. The linked Hotel Center account.
CampaignId	Long	ATTRIBUTE	Output only. The ID of the campaign.
CampaignLabels	String	ATTRIBUTE	Output only. The resource names of labels attached to this campaign.
CampaignLocalCampaignSettingLocationSourceType	String	ATTRIBUTE	The location source type for this local campaign. The allowed values are AFFILIATE, GOOGLE_MY_BUSINESS, UNKNOWN, UNSPECIFIED.
CampaignLocalServicesCampaignSettingsCategoryBids	String	ATTRIBUTE	Categorical level bids associated with MANUAL_CPA bidding strategy.
CampaignManualCpa	String	ATTRIBUTE	Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.
CampaignManualCpcEnhancedCpcEnabled	Bool	ATTRIBUTE	Whether bids are to be enhanced based on conversion optimizer data.
CampaignManualCpm	String	ATTRIBUTE	Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
CampaignManualCpv	String	ATTRIBUTE	Output only. A bidding strategy that pays a configurable amount per video view.
CampaignMaximizeConversionValueTargetRoas	Double	ATTRIBUTE	Output only. 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.
CampaignMaximizeConversionsTargetCpaMicros	Long	ATTRIBUTE	Output only. The target cost per acquisition (CPA) option. This is the average amount that you would like to spend per acquisition.
CampaignName	String	ATTRIBUTE	The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CampaignNetworkSettingsTargetContentNetwork	Bool	ATTRIBUTE	Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
CampaignNetworkSettingsTargetGoogleSearch	Bool	ATTRIBUTE	Whether ads will be served with google.com search results.
CampaignNetworkSettingsTargetPartnerSearchNetwork	Bool	ATTRIBUTE	Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
CampaignNetworkSettingsTargetSearchNetwork	Bool	ATTRIBUTE	Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
CampaignOptimizationGoalSettingOptimizationGoalTypes	String	ATTRIBUTE	The list of optimization goal types. The allowed values are APP_PRE_REGISTRATION, CALL_CLICKS, DRIVING_DIRECTIONS, UNKNOWN, UNSPECIFIED.
CampaignOptimizationScore	Double	ATTRIBUTE	Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See 'About optimization score' at https://support.google.com/google-ads/answer/9061546. This field is read-only.
CampaignPaymentMode	String	ATTRIBUTE	Payment mode for the campaign. The allowed values are CLICKS, CONVERSIONS, CONVERSION_VALUE, GUEST_STAY, UNKNOWN, UNSPECIFIED.
CampaignPercentCpcCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.
CampaignPercentCpcEnhancedCpcEnabled	Bool	ATTRIBUTE	Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not.
CampaignPerformanceMaxUpgradePerformanceMaxCampaign	String	ATTRIBUTE	Output only. Indicates which Performance Max campaign the campaign is upgraded to.
CampaignPerformanceMaxUpgradePreUpgradeCampaign	String	ATTRIBUTE	Output only. Indicates legacy campaign upgraded to Performance Max.
CampaignPerformanceMaxUpgradeStatus	String	ATTRIBUTE	Output only. The upgrade status of a campaign requested to be upgraded to Performance Max. The allowed values are UNKNOWN, UNSPECIFIED, UPGRADE_COMPLETE, UPGRADE_ELIBIGLE, UPGRADE_FAILED, UPGRADE_IN_PROGRESS.
CampaignPrimaryStatus	String	ATTRIBUTE	Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status. The allowed values are ELIGIBLE, ENDED, LEARNING, LIMITED, MISCONFIGURED, NOT_ELIGIBLE, PAUSED, PENDING, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignPrimaryStatusReasons	String	ATTRIBUTE	Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus. The allowed values are AD_GROUPS_PAUSED, AD_GROUP_ADS_PAUSED, APP_NOT_RELEASED, APP_PARTIALLY_RELEASED, BIDDING_STRATEGY_CONSTRAINED, BIDDING_STRATEGY_LEARNING, BIDDING_STRATEGY_LIMITED, BIDDING_STRATEGY_MISCONFIGURED, BUDGET_CONSTRAINED, BUDGET_MISCONFIGURED, CALL_EXTENSION_DISAPPROVED, CALL_EXTENSION_UNDER_REVIEW, CAMPAIGN_DRAFT, CAMPAIGN_ENDED, CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED, CAMPAIGN_GROUP_PAUSED, CAMPAIGN_PAUSED, CAMPAIGN_PENDING, CAMPAIGN_REMOVED, HAS_ADS_DISAPPROVED, HAS_ADS_LIMITED_BY_POLICY, KEYWORDS_PAUSED, LEAD_FORM_EXTENSION_DISAPPROVED, LEAD_FORM_EXTENSION_UNDER_REVIEW, MISSING_CALL_EXTENSION, MISSING_LEAD_FORM_EXTENSION, MOST_ADS_UNDER_REVIEW, NO_AD_GROUPS, NO_AD_GROUP_ADS, NO_KEYWORDS, NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA, SEARCH_VOLUME_LIMITED, UNKNOWN, UNSPECIFIED.
CampaignRealTimeBiddingSettingOptIn	Bool	ATTRIBUTE	Whether the campaign is opted in to real-time bidding.
CampaignResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
CampaignSelectiveOptimizationConversionActions	String	ATTRIBUTE	The selected set of conversion actions for optimizing this campaign.
CampaignServingStatus	String	ATTRIBUTE	Output only. The ad serving status of the campaign. The allowed values are ENDED, NONE, PENDING, SERVING, SUSPENDED, UNKNOWN, UNSPECIFIED.
CampaignShoppingSettingCampaignPriority	Int	ATTRIBUTE	Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.
CampaignShoppingSettingEnableLocal	Bool	ATTRIBUTE	Whether to include local products.
CampaignShoppingSettingFeedLabel	String	ATTRIBUTE	Feed label of products to include in the campaign. Only one of feed_label or sales_country can be set. If used instead of sales_country, the feed_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center.
CampaignShoppingSettingMerchantId	Long	ATTRIBUTE	Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
CampaignShoppingSettingSalesCountry	String	ATTRIBUTE	Sales country of products to include in the campaign. Only one of feed_label or sales_country can be set. Field is immutable except for clearing. Once this field is cleared, you must use feed_label if you want to set the sales country.
CampaignShoppingSettingUseVehicleInventory	Bool	ATTRIBUTE	Immutable. Whether to target Vehicle Listing inventory.
CampaignStartDate	Date	ATTRIBUTE	The date when campaign started in serving customer's timezone in YYYY-MM-DD format.
CampaignStatus	String	ATTRIBUTE	The status of the campaign. When a new campaign is added, the status defaults to ENABLED. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignTargetCpaCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetCpaCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetCpaTargetCpaMicros	Long	ATTRIBUTE	Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
CampaignTargetCpm	String	ATTRIBUTE	A bidding strategy that automatically optimizes cost per thousand impressions.
CampaignTargetImpressionShareCpcBidCeilingMicros	Long	ATTRIBUTE	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.
CampaignTargetImpressionShareLocation	String	ATTRIBUTE	The targeted location on the search results page. The allowed values are ABSOLUTE_TOP_OF_PAGE, ANYWHERE_ON_PAGE, TOP_OF_PAGE, UNKNOWN, UNSPECIFIED.
CampaignTargetImpressionShareLocationFractionMicros	Long	ATTRIBUTE	The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.
CampaignTargetRoasCpcBidCeilingMicros	Long	ATTRIBUTE	Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetRoasCpcBidFloorMicros	Long	ATTRIBUTE	Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.
CampaignTargetRoasTargetRoas	Double	ATTRIBUTE	Output only. The chosen revenue (based on conversion data) per unit of spend.
CampaignTargetSpendCpcBidCeilingMicros	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.
CampaignTargetSpendTargetSpendMicros	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.
CampaignTargetingSettingTargetRestrictions	String	ATTRIBUTE	The per-targeting-dimension setting to restrict the reach of your campaign or ad group.
CampaignTrackingSettingTrackingUrl	String	ATTRIBUTE	Output only. The url used for dynamic tracking.
CampaignTrackingUrlTemplate	String	ATTRIBUTE	The URL template for constructing a tracking URL.
CampaignUrlCustomParameters	String	ATTRIBUTE	The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
CampaignUrlExpansionOptOut	Bool	ATTRIBUTE	Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
CampaignVanityPharmaVanityPharmaDisplayUrlMode	String	ATTRIBUTE	The display mode for vanity pharma URLs. The allowed values are MANUFACTURER_WEBSITE_URL, UNKNOWN, UNSPECIFIED, WEBSITE_DESCRIPTION.
CampaignVanityPharmaVanityPharmaText	String	ATTRIBUTE	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. The allowed values are MEDICAL_DEVICE_WEBSITE_EN, MEDICAL_DEVICE_WEBSITE_ES, PRESCRIPTION_CONTRACEPTION_WEBSITE_EN, PRESCRIPTION_CONTRACEPTION_WEBSITE_ES, PRESCRIPTION_DEVICE_WEBSITE_EN, PRESCRIPTION_DEVICE_WEBSITE_ES, PRESCRIPTION_TREATMENT_WEBSITE_EN, PRESCRIPTION_TREATMENT_WEBSITE_ES, PRESCRIPTION_VACCINE_WEBSITE_EN, PRESCRIPTION_VACCINE_WEBSITE_ES, PREVENTATIVE_TREATMENT_WEBSITE_EN, PREVENTATIVE_TREATMENT_WEBSITE_ES, UNKNOWN, UNSPECIFIED.
CampaignVideoBrandSafetySuitability	String	ATTRIBUTE	Output only. 3-Tier Brand Safety setting for the campaign. The allowed values are EXPANDED_INVENTORY, LIMITED_INVENTORY, STANDARD_INVENTORY, 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.
AllConversionsFromClickToCall	Double	METRIC	The number of times people clicked the 'Call' button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.
AllConversionsFromDirections	Double	METRIC	The number of times people clicked a 'Get directions' button to navigate to a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromInteractionsRate	Double	METRIC	All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsFromLocationAssetClickToCall	Double	METRIC	Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetDirections	Double	METRIC	Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetMenu	Double	METRIC	Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetOrder	Double	METRIC	Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetOtherEngagement	Double	METRIC	Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetStoreVisits	Double	METRIC	Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetWebsite	Double	METRIC	Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromMenu	Double	METRIC	The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
AllConversionsFromOrder	Double	METRIC	The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromOtherEngagement	Double	METRIC	The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.
AllConversionsFromStoreVisit	Double	METRIC	Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromStoreWebsite	Double	METRIC	The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
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.
ContentBudgetLostImpressionShare	Double	METRIC	The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
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.
CurrentModelAttributedConversionsFromInteractionsRate	Double	METRIC	Current model attributed 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.
CurrentModelAttributedConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of current model attributed conversions from interactions divided by the number 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.
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.
CurrentModelAttributedConversionsValuePerCost	Double	METRIC	The value of current model attributed 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.
EligibleImpressionsFromLocationAssetStoreReach	Long	METRIC	Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location.
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.
InvalidClickRate	Double	METRIC	The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
InvalidClicks	Long	METRIC	Number of clicks Google considers illegitimate and doesn't charge you for.
OptimizationScoreUplift	Double	METRIC	Total optimization score uplift of all recommendations.
OptimizationScoreUrl	String	METRIC	URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign, and can be segmented by segments.recommendation_type. For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination.
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).
PublisherOrganicClicks	Long	METRIC	Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity
PublisherPurchasedClicks	Long	METRIC	Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity
PublisherUnknownClicks	Long	METRIC	Clicks from traffic which is not identified as 'Publisher Purchased' or 'Publisher Organic'
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.
SearchBudgetLostImpressionShare	Double	METRIC	The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost 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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
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.
SkAdNetworkConversions	Long	METRIC	The number of iOS Store Kit Ad Network conversions.
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 (for example, clicking on) another ad.
ViewThroughConversionsFromLocationAssetClickToCall	Double	METRIC	Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetDirections	Double	METRIC	Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetMenu	Double	METRIC	Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetOrder	Double	METRIC	Number of order clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetOtherEngagement	Double	METRIC	Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetStoreVisits	Double	METRIC	Estimated number of visits to the store after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetWebsite	Double	METRIC	Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location.
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.
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.
AuctionInsightDomain	String	SEGMENT	Domain (visible URL) of a participant in the Auction Insights report.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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 versus 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.
ConversionAttributionEventType	String	SEGMENT	Conversion attribution event type. The allowed values are IMPRESSION, INTERACTION, UNKNOWN, UNSPECIFIED.
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.
ConversionValueRulePrimaryDimension	String	SEGMENT	Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. The allowed values are AUDIENCE, DEVICE, GEO_LOCATION, MULTIPLE, NEW_VS_RETURNING_USER, NO_RULE_APPLIED, ORIGINAL, UNKNOWN, UNSPECIFIED.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
RecommendationType	String	SEGMENT	Recommendation type. The allowed values are CALLOUT_EXTENSION, CALL_EXTENSION, CAMPAIGN_BUDGET, DISPLAY_EXPANSION_OPT_IN, ENHANCED_CPC_OPT_IN, FORECASTING_CAMPAIGN_BUDGET, FORECASTING_SET_TARGET_ROAS, KEYWORD, KEYWORD_MATCH_TYPE, MARGINAL_ROI_CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MOVE_UNUSED_BUDGET, OPTIMIZE_AD_ROTATION, RAISE_TARGET_CPA_BID_TOO_LOW, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UNKNOWN, UNSPECIFIED, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, USE_BROAD_MATCH_KEYWORD.
SkAdNetworkAdEventType	String	SEGMENT	iOS Store Kit Ad Network ad event type. The allowed values are INTERACTION, UNAVAILABLE, UNKNOWN, UNSPECIFIED, VIEW.
SkAdNetworkAttributionCredit	String	SEGMENT	iOS Store Kit Ad Network attribution credit The allowed values are CONTRIBUTED, UNAVAILABLE, UNKNOWN, UNSPECIFIED, WON.
SkAdNetworkConversionValue	Long	SEGMENT	iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign.
SkAdNetworkSourceAppSkAdNetworkSourceAppId	String	SEGMENT	App id where the ad that drove the iOS Store Kit Ad Network install was shown.
SkAdNetworkUserType	String	SEGMENT	iOS Store Kit Ad Network user type. The allowed values are NEW_INSTALLER, REINSTALLER, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
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.

CampaignAsset

A link between a Campaign and an Asset.

Columns

Name	Type	Behavior	Description
CampaignAssetAsset	String	ATTRIBUTE	Immutable. The asset which is linked to the campaign.
CampaignAssetCampaign	String	ATTRIBUTE	Immutable. The campaign to which the asset is linked.
CampaignAssetFieldType	String	ATTRIBUTE	Immutable. Role that the asset takes under the linked campaign. Required. The allowed values are AD_IMAGE, 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.
CampaignAssetResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign asset. CampaignAsset resource names have the form: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
CampaignAssetSource	String	ATTRIBUTE	Output only. Source of the campaign asset link. The allowed values are ADVERTISER, AUTOMATICALLY_CREATED, UNKNOWN, UNSPECIFIED.
CampaignAssetStatus	String	ATTRIBUTE	Status of the campaign 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

CampaignAssetSet

CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.

Columns

Name	Type	Behavior	Description
CampaignAssetSetAssetSet	String	ATTRIBUTE	Immutable. The asset set which is linked to the campaign.
CampaignAssetSetCampaign	String	ATTRIBUTE	Immutable. The campaign to which this asset set is linked.
CampaignAssetSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign asset set. Asset set asset resource names have the form: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
CampaignAssetSetStatus	String	ATTRIBUTE	Output only. The status of the campaign asset set asset. Read-only. The allowed values are ENABLED, REMOVED, 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.

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.

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
CampaignAudienceViewResourceName	String	ATTRIBUTE	Output only. The resource name of the campaign audience view. Campaign audience view resource names have the form: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

CampaignBidModifier

Represents a bid-modifiable only criterion at the campaign 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
CampaignBidModifierBidModifier	Double	ATTRIBUTE	The modifier for the bid when the criterion matches.
CampaignBidModifierCampaign	String	ATTRIBUTE	Output only. The campaign to which this criterion belongs.
CampaignBidModifierCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion to bid modify. This field is ignored for mutates.
CampaignBidModifierInteractionTypeType	String	ATTRIBUTE	The interaction type. The allowed values are CALLS, UNKNOWN, UNSPECIFIED.
CampaignBidModifierResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign bid modifier. Campaign bid modifier resource names have the form: customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
InteractionEventTypes	String	METRIC	The types of payable and free interactions. The allowed values are UNSPECIFIED, UNKNOWN, CLICK, ENGAGEMENT, VIDEO_VIEW, NONE.

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.

CampaignBudget

A campaign budget shared amongst various budget recommendation types.

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
CampaignBudgetAlignedBiddingStrategyId	Long	ATTRIBUTE	ID of the portfolio bidding strategy that this shared campaign budget is aligned with. When a bidding strategy and a campaign budget are aligned, they are attached to the same set of campaigns. After a campaign budget is aligned with a bidding strategy, campaigns that are added to the campaign budget must also use the aligned bidding strategy.
CampaignBudgetAmountMicros	Long	ATTRIBUTE	The amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
CampaignBudgetDeliveryMethod	String	ATTRIBUTE	The delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation. The allowed values are ACCELERATED, STANDARD, UNKNOWN, UNSPECIFIED.
CampaignBudgetExplicitlyShared	Bool	ATTRIBUTE	Specifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
CampaignBudgetHasRecommendedBudget	Bool	ATTRIBUTE	Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only.
CampaignBudgetId	Long	ATTRIBUTE	Output only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns; the system will then allocate the campaign budget among different campaigns to get optimum results.
CampaignBudgetName	String	ATTRIBUTE	The name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
CampaignBudgetPeriod	String	ATTRIBUTE	Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. The allowed values are CUSTOM_PERIOD, DAILY, UNKNOWN, UNSPECIFIED.
CampaignBudgetRecommendedBudgetAmountMicros	Long	ATTRIBUTE	Output only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyClicks	Long	ATTRIBUTE	Output only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyCostMicros	Long	ATTRIBUTE	Output only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyInteractions	Long	ATTRIBUTE	Output only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
CampaignBudgetRecommendedBudgetEstimatedChangeWeeklyViews	Long	ATTRIBUTE	Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
CampaignBudgetReferenceCount	Long	ATTRIBUTE	Output only. The number of campaigns actively using the budget. This field is read-only.
CampaignBudgetResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign budget. Campaign budget resource names have the form: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
CampaignBudgetStatus	String	ATTRIBUTE	Output only. The status of this campaign budget. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignBudgetTotalAmountMicros	Long	ATTRIBUTE	The lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
CampaignBudgetType	String	ATTRIBUTE	Immutable. The type of the campaign budget. The allowed values are FIXED_CPA, LOCAL_SERVICES, SMART_CAMPAIGN, STANDARD, UNKNOWN, UNSPECIFIED.
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.
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.
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.
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 (for example, clicking on) another ad.
BudgetCampaignAssociationStatusCampaign	String	SEGMENT	The campaign resource name.
BudgetCampaignAssociationStatusStatus	String	SEGMENT	Budget campaign association status. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
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, for example, 2018-04-17.
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.
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.

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.

CampaignConversionGoal

The biddability setting for the specified campaign only for all conversion actions with a matching category and origin.

Columns

Name	Type	Behavior	Description
CampaignConversionGoalBiddable	Bool	ATTRIBUTE	The biddability of the campaign conversion goal.
CampaignConversionGoalCampaign	String	ATTRIBUTE	Immutable. The campaign with which this campaign conversion goal is associated.
CampaignConversionGoalCategory	String	ATTRIBUTE	The conversion category of this campaign conversion goal. 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.
CampaignConversionGoalOrigin	String	ATTRIBUTE	The conversion origin of this campaign conversion goal. The allowed values are APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
CampaignConversionGoalResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign conversion goal. Campaign conversion goal resource names have the form: customers/{customer_id}/campaignConversionGoals/{campaign_id}~{category}~{origin}
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.

CampaignCriterion

A campaign criterion.

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
CampaignCriterionAdScheduleDayOfWeek	String	ATTRIBUTE	Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
CampaignCriterionAdScheduleEndHour	Int	ATTRIBUTE	Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
CampaignCriterionAdScheduleEndMinute	String	ATTRIBUTE	Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. The allowed values are FIFTEEN, FORTY_FIVE, THIRTY, UNKNOWN, UNSPECIFIED, ZERO.
CampaignCriterionAdScheduleStartHour	Int	ATTRIBUTE	Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.
CampaignCriterionAdScheduleStartMinute	String	ATTRIBUTE	Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. The allowed values are FIFTEEN, FORTY_FIVE, THIRTY, UNKNOWN, UNSPECIFIED, ZERO.
CampaignCriterionAgeRangeType	String	ATTRIBUTE	Type of the age range. The allowed values are AGE_RANGE_18_24, AGE_RANGE_25_34, AGE_RANGE_35_44, AGE_RANGE_45_54, AGE_RANGE_55_64, AGE_RANGE_65_UP, AGE_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionBidModifier	String	ATTRIBUTE	The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.
CampaignCriterionCampaign	String	ATTRIBUTE	Immutable. The campaign to which the criterion belongs.
CampaignCriterionCarrierCarrierConstant	String	ATTRIBUTE	The Carrier constant resource name.
CampaignCriterionCombinedAudienceCombinedAudience	String	ATTRIBUTE	The CombinedAudience resource name.
CampaignCriterionContentLabelType	String	ATTRIBUTE	Content label type, required for CREATE operations. The allowed values are BELOW_THE_FOLD, EMBEDDED_VIDEO, JUVENILE, LIVE_STREAMING_VIDEO, PARKED_DOMAIN, PROFANITY, SEXUALLY_SUGGESTIVE, SOCIAL_ISSUES, TRAGEDY, UNKNOWN, UNSPECIFIED, VIDEO, VIDEO_NOT_YET_RATED, VIDEO_RATING_DV_G, VIDEO_RATING_DV_MA, VIDEO_RATING_DV_PG, VIDEO_RATING_DV_T.
CampaignCriterionCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion. This field is ignored during mutate.
CampaignCriterionCustomAffinityCustomAffinity	String	ATTRIBUTE	The CustomInterest resource name.
CampaignCriterionCustomAudienceCustomAudience	String	ATTRIBUTE	The CustomAudience resource name.
CampaignCriterionDeviceType	String	ATTRIBUTE	Type of the device. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
CampaignCriterionDisplayName	String	ATTRIBUTE	Output only. The display name of the criterion. This field is ignored for mutates.
CampaignCriterionGenderType	String	ATTRIBUTE	Type of the gender. The allowed values are FEMALE, MALE, UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionIncomeRangeType	String	ATTRIBUTE	Type of the income range. The allowed values are INCOME_RANGE_0_50, INCOME_RANGE_50_60, INCOME_RANGE_60_70, INCOME_RANGE_70_80, INCOME_RANGE_80_90, INCOME_RANGE_90_UP, INCOME_RANGE_UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionIpBlockIpAddress	String	ATTRIBUTE	The IP address of this IP block.
CampaignCriterionKeywordMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
CampaignCriterionKeywordText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
CampaignCriterionKeywordThemeFreeFormKeywordTheme	String	ATTRIBUTE	Free-form text to be matched to a Smart Campaign keyword theme constant on a best-effort basis.
CampaignCriterionKeywordThemeKeywordThemeConstant	String	ATTRIBUTE	The resource name of a Smart Campaign keyword theme constant. keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}
CampaignCriterionLanguageLanguageConstant	String	ATTRIBUTE	The language constant resource name.
CampaignCriterionListingScopeDimensions	String	ATTRIBUTE	Scope of the campaign criterion.
CampaignCriterionLocationGeoTargetConstant	String	ATTRIBUTE	The geo target constant resource name.
CampaignCriterionLocationGroup	String	ATTRIBUTE	Immutable. Location Group
CampaignCriterionLocationGroupEnableCustomerLevelLocationAssetSet	Bool	ATTRIBUTE	Denotes that the latest customer level asset set is used for targeting. Used with radius and radius_units. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or location_group_asset_sets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.
CampaignCriterionLocationGroupFeed	String	ATTRIBUTE	Feed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.
CampaignCriterionMobileAppCategoryMobileAppCategoryConstant	String	ATTRIBUTE	The mobile app category constant resource name.
CampaignCriterionMobileApplicationAppId	String	ATTRIBUTE	A string that uniquely identifies a mobile application to Google Ads API. The format of this string is '{platform}-{platform_native_id}', where platform is '1' for iOS apps and '2' for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, '476943146' for 'Flood-It! 2' whose App Store link is 'http://itunes.apple.com/us/app/flood-it!-2/id476943146'). For Android, this native identifier is the application's package name (for example, 'com.labpixies.colordrips' for 'Color Drips' given Google Play link 'https://play.google.com/store/apps/details?id=com.labpixies.colordrips'). A well formed app id for Google Ads API would thus be '1-476943146' for iOS and '2-com.labpixies.colordrips' for Android. This field is required and must be set in CREATE operations.
CampaignCriterionMobileApplicationName	String	ATTRIBUTE	Name of this mobile application.
CampaignCriterionMobileDeviceMobileDeviceConstant	String	ATTRIBUTE	The mobile device constant resource name.
CampaignCriterionNegative	Bool	ATTRIBUTE	Immutable. Whether to target (false) or exclude (true) the criterion.
CampaignCriterionOperatingSystemVersionOperatingSystemVersionConstant	String	ATTRIBUTE	The operating system version constant resource name.
CampaignCriterionParentalStatusType	String	ATTRIBUTE	Type of the parental status. The allowed values are NOT_A_PARENT, PARENT, UNDETERMINED, UNKNOWN, UNSPECIFIED.
CampaignCriterionPlacementUrl	String	ATTRIBUTE	URL of the placement. For example, 'http://www.domain.com'.
CampaignCriterionProximityAddressCityName	String	ATTRIBUTE	Name of the city.
CampaignCriterionProximityAddressCountryCode	String	ATTRIBUTE	Country code.
CampaignCriterionProximityAddressPostalCode	String	ATTRIBUTE	Postal code.
CampaignCriterionProximityAddressProvinceCode	String	ATTRIBUTE	Province or state code.
CampaignCriterionProximityAddressProvinceName	String	ATTRIBUTE	Province or state name.
CampaignCriterionProximityAddressStreetAddress	String	ATTRIBUTE	Street address line 1.
CampaignCriterionProximityGeoPointLatitudeInMicroDegrees	Int	ATTRIBUTE	Micro degrees for the latitude.
CampaignCriterionProximityGeoPointLongitudeInMicroDegrees	Int	ATTRIBUTE	Micro degrees for the longitude.
CampaignCriterionProximityRadius	Double	ATTRIBUTE	The radius of the proximity.
CampaignCriterionProximityRadiusUnits	String	ATTRIBUTE	The unit of measurement of the radius. Default is KILOMETERS. The allowed values are KILOMETERS, MILES, UNKNOWN, UNSPECIFIED.
CampaignCriterionResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
CampaignCriterionStatus	String	ATTRIBUTE	The status of the criterion. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignCriterionTopicPath	String	ATTRIBUTE	The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, 'Pets & Animals', 'Pets', 'Dogs' represents the 'Pets & Animals/Pets/Dogs' category.
CampaignCriterionTopicTopicConstant	String	ATTRIBUTE	The Topic Constant resource name.
CampaignCriterionType	String	ATTRIBUTE	Output only. The type of the criterion. The allowed values are AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LISTING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
CampaignCriterionUserInterestUserInterestCategory	String	ATTRIBUTE	The UserInterest resource name.
CampaignCriterionUserListUserList	String	ATTRIBUTE	The User List resource name.
CampaignCriterionWebpageConditions	String	ATTRIBUTE	Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations.
CampaignCriterionWebpageCoveragePercentage	Double	ATTRIBUTE	Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
CampaignCriterionWebpageCriterionName	String	ATTRIBUTE	The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
CampaignCriterionWebpageSampleSampleUrls	String	ATTRIBUTE	Webpage sample urls
CampaignCriterionYoutubeChannelChannelId	String	ATTRIBUTE	The YouTube uploader channel id or the channel code of a YouTube channel.
CampaignCriterionYoutubeVideoVideoId	String	ATTRIBUTE	YouTube video id as it appears on the YouTube watch page.
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.

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

Columns

Name	Type	Behavior	Description
CampaignCriterionSimulationBidModifierPointListPoints	String	ATTRIBUTE	Projected metrics for a series of bid modifier amounts.
CampaignCriterionSimulationCampaignId	Long	ATTRIBUTE	Output only. Campaign ID of the simulation.
CampaignCriterionSimulationCriterionId	Long	ATTRIBUTE	Output only. Criterion ID of the simulation.
CampaignCriterionSimulationEndDate	Date	ATTRIBUTE	Output only. Last day on which the simulation is based, in YYYY-MM-DD format.
CampaignCriterionSimulationModificationMethod	String	ATTRIBUTE	Output only. How the simulation modifies the field. The allowed values are DEFAULT, SCALING, UNIFORM, UNKNOWN, UNSPECIFIED.
CampaignCriterionSimulationResourceName	String	ATTRIBUTE	Output only. The resource name of the campaign criterion simulation. Campaign criterion simulation resource names have the form: customers/{customer_id}/campaignCriterionSimulations/{campaign_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}
CampaignCriterionSimulationStartDate	Date	ATTRIBUTE	Output only. First day on which the simulation is based, in YYYY-MM-DD format.
CampaignCriterionSimulationType	String	ATTRIBUTE	Output only. The field that the simulation modifies. The allowed values are BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, 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.

CampaignCustomizer

A customizer value for the associated CustomizerAttribute at the Campaign level.

Columns

Name	Type	Behavior	Description
CampaignCustomizerCampaign	String	ATTRIBUTE	Immutable. The campaign to which the customizer attribute is linked.
CampaignCustomizerCustomizerAttribute	String	ATTRIBUTE	Required. Immutable. The customizer attribute which is linked to the campaign.
CampaignCustomizerResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign customizer. Campaign customizer resource names have the form: customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}
CampaignCustomizerStatus	String	ATTRIBUTE	Output only. The status of the campaign customizer. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignCustomizerValueStringValue	String	ATTRIBUTE	Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
CampaignCustomizerValueType	String	ATTRIBUTE	Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. The allowed values are NUMBER, PERCENT, PRICE, TEXT, 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.

CampaignDraft

A campaign draft.

Columns

Name	Type	Behavior	Description
CampaignDraftBaseCampaign	String	ATTRIBUTE	Immutable. The base campaign to which the draft belongs.
CampaignDraftDraftCampaign	String	ATTRIBUTE	Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign. This field is read-only.
CampaignDraftDraftId	Long	ATTRIBUTE	Output only. The ID of the draft. This field is read-only.
CampaignDraftHasExperimentRunning	Bool	ATTRIBUTE	Output only. Whether there is an experiment based on this draft currently serving.
CampaignDraftLongRunningOperation	String	ATTRIBUTE	Output only. The resource name of the long-running operation that can be used to poll for completion of draft promotion. This is only set if the draft promotion is in progress or finished.
CampaignDraftName	String	ATTRIBUTE	The name of the campaign draft. This field is required and should not be empty when creating new campaign drafts. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CampaignDraftResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign draft. Campaign draft resource names have the form: customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}
CampaignDraftStatus	String	ATTRIBUTE	Output only. The status of the campaign draft. This field is read-only. When a new campaign draft is added, the status defaults to PROPOSED. The allowed values are PROMOTED, PROMOTE_FAILED, PROMOTING, PROPOSED, REMOVED, 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.

CampaignExperiment

This table has been deprecated for Google Ads API v12. An A/B experiment that compares the performance of the base campaign (the control) and a variation of that campaign (the experiment).

Columns

Name	Type	Behavior	Description
CampaignExperimentCampaignDraft	String	ATTRIBUTE	Immutable. The campaign draft with staged changes to the base campaign.
CampaignExperimentDescription	String	ATTRIBUTE	The description of the experiment.
CampaignExperimentEndDate	Date	ATTRIBUTE	The last day of the campaign experiment. By default, the experiment ends on the campaign's end date. If this field is set, then the experiment ends at the end of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-04-18
CampaignExperimentExperimentCampaign	String	ATTRIBUTE	Output only. The experiment campaign, as opposed to the base campaign.
CampaignExperimentId	Long	ATTRIBUTE	Output only. The ID of the campaign experiment. This field is read-only.
CampaignExperimentLongRunningOperation	String	ATTRIBUTE	Output only. The resource name of the long-running operation that can be used to poll for completion of experiment create or promote. The most recent long running operation is returned.
CampaignExperimentName	String	ATTRIBUTE	The name of the campaign experiment. This field is required when creating new campaign experiments and must not conflict with the name of another non-removed campaign experiment or campaign. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CampaignExperimentResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign experiment. Campaign experiment resource names have the form: customers/{customer_id}/campaignExperiments/{campaign_experiment_id}
CampaignExperimentStartDate	Date	ATTRIBUTE	Date when the campaign experiment starts. By default, the experiment starts now or on the campaign's start date, whichever is later. If this field is set, then the experiment starts at the beginning of the specified date in the customer's time zone. Cannot be changed once the experiment starts. Format: YYYY-MM-DD Example: 2019-03-14
CampaignExperimentStatus	String	ATTRIBUTE	Output only. The status of the campaign experiment. This field is read-only. The allowed values are ENABLED, ENDED_MANUALLY, GRADUATED, INITIALIZATION_FAILED, INITIALIZING, PROMOTED, PROMOTING, PROMOTION_FAILED, REMOVED, UNKNOWN, UNSPECIFIED.
CampaignExperimentTrafficSplitPercent	Long	ATTRIBUTE	Immutable. Share of traffic directed to experiment as a percent (must be between 1 and 99 inclusive. Base campaign receives the remainder of the traffic (100 - traffic_split_percent). Required for create.
CampaignExperimentTrafficSplitType	String	ATTRIBUTE	Immutable. Determines the behavior of the traffic split. The allowed values are COOKIE, RANDOM_QUERY, 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.

CampaignExtensionSetting

A campaign extension setting.

Columns

Name	Type	Behavior	Description
CampaignExtensionSettingCampaign	String	ATTRIBUTE	Immutable. The resource name of the campaign. The linked extension feed items will serve under this campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
CampaignExtensionSettingDevice	String	ATTRIBUTE	The device for which the extensions will serve. Optional. The allowed values are DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
CampaignExtensionSettingExtensionFeedItems	String	ATTRIBUTE	The resource names of the extension feed items to serve under the campaign. ExtensionFeedItem resource names have the form: customers/{customer_id}/extensionFeedItems/{feed_item_id}
CampaignExtensionSettingExtensionType	String	ATTRIBUTE	Immutable. The extension type of the customer extension setting. The allowed values are AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CampaignExtensionSettingResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign extension setting. CampaignExtensionSetting resource names have the form: customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}
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.

CampaignFeed

A campaign feed.

Columns

Name	Type	Behavior	Description
CampaignFeedCampaign	String	ATTRIBUTE	Immutable. The campaign to which the CampaignFeed belongs.
CampaignFeedFeed	String	ATTRIBUTE	Immutable. The feed to which the CampaignFeed belongs.
CampaignFeedMatchingFunctionFunctionString	String	ATTRIBUTE	String representation of the Function. Examples: 1. IDENTITY(true) or IDENTITY(false). All or no feed items served. 2. EQUALS(CONTEXT.DEVICE,'Mobile') 3. IN(FEED_ITEM_ID,{1000001,1000002,1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678,0],{'Mars cruise','Venus cruise'}) 5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,'Mobile')) For more details, visit https://developers.google.com/adwords/api/docs/guides/feed-matching-functions Note that because multiple strings may represent the same underlying function (whitespace and single versus double quotation marks, for example), the value returned may not be identical to the string sent in a mutate request.
CampaignFeedMatchingFunctionLeftOperands	String	ATTRIBUTE	The operands on the left hand side of the equation. This is also the operand to be used for single operand expressions such as NOT.
CampaignFeedMatchingFunctionOperator	String	ATTRIBUTE	Operator for a function. The allowed values are AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
CampaignFeedMatchingFunctionRightOperands	String	ATTRIBUTE	The operands on the right hand side of the equation.
CampaignFeedPlaceholderTypes	String	ATTRIBUTE	Indicates which placeholder types the feed may populate under the connected campaign. Required. The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CampaignFeedResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign feed. Campaign feed resource names have the form: `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id}
CampaignFeedStatus	String	ATTRIBUTE	Output only. Status of the campaign feed. This field is read-only. The allowed values are ENABLED, REMOVED, 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.

CampaignGroup

A campaign group.

Columns

Name	Type	Behavior	Description
CampaignGroupId	Long	ATTRIBUTE	Output only. The ID of the campaign group.
CampaignGroupName	String	ATTRIBUTE	The name of the campaign group. This field is required and should not be empty when creating new campaign groups. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.
CampaignGroupResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign group. Campaign group resource names have the form: customers/{customer_id}/campaignGroups/{campaign_group_id}
CampaignGroupStatus	String	ATTRIBUTE	The status of the campaign group. When a new campaign group is added, the status defaults to ENABLED. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
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.
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.
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.
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.
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.
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.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Device	String	SEGMENT	Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
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.
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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

CampaignLabel

Represents a relationship between a campaign and a label.

Columns

Name	Type	Behavior	Description
CampaignLabelCampaign	String	ATTRIBUTE	Immutable. The campaign to which the label is attached.
CampaignLabelLabel	String	ATTRIBUTE	Immutable. The label assigned to the campaign.
CampaignLabelResourceName	String	ATTRIBUTE	Immutable. Name of the resource. Campaign label resource names have the form: customers/{customer_id}/campaignLabels/{campaign_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.

CampaignSharedSet

CampaignSharedSets are used for managing the shared sets associated with a campaign.

Columns

Name	Type	Behavior	Description
CampaignSharedSetCampaign	String	ATTRIBUTE	Immutable. The campaign to which the campaign shared set belongs.
CampaignSharedSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the campaign shared set. Campaign shared set resource names have the form: customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}
CampaignSharedSetSharedSet	String	ATTRIBUTE	Immutable. The shared set associated with the campaign. This may be a negative keyword shared set of another customer. This customer should be a manager of the other customer, otherwise the campaign shared set will exist but have no serving effect. Only negative keyword shared sets can be associated with Shopping campaigns. Only negative placement shared sets can be associated with Display mobile app campaigns.
CampaignSharedSetStatus	String	ATTRIBUTE	Output only. The status of this campaign shared set. Read only. The allowed values are ENABLED, REMOVED, 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.

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 * MULTI_CHANNEL - TARGET_CPA - UNIFORM * DISCOVERY - TARGET_CPA - DEFAULT * DISPLAY - TARGET_CPA - UNIFORM

Columns

Name	Type	Behavior	Description
CampaignSimulationBudgetPointListPoints	String	ATTRIBUTE	Projected metrics for a series of budget amounts.
CampaignSimulationCampaignId	Long	ATTRIBUTE	Output only. Campaign id of the simulation.
CampaignSimulationCpcBidPointListPoints	String	ATTRIBUTE	Projected metrics for a series of CPC bid amounts.
CampaignSimulationEndDate	Date	ATTRIBUTE	Output only. Last day on which the simulation is based, in YYYY-MM-DD format
CampaignSimulationModificationMethod	String	ATTRIBUTE	Output only. How the simulation modifies the field. The allowed values are DEFAULT, SCALING, UNIFORM, UNKNOWN, UNSPECIFIED.
CampaignSimulationResourceName	String	ATTRIBUTE	Output only. The resource name of the campaign simulation. Campaign simulation resource names have the form: customers/{customer_id}/campaignSimulations/{campaign_id}~{type}~{modification_method}~{start_date}~{end_date}
CampaignSimulationStartDate	Date	ATTRIBUTE	Output only. First day on which the simulation is based, in YYYY-MM-DD format.
CampaignSimulationTargetCpaPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target CPA amounts.
CampaignSimulationTargetImpressionSharePointListPoints	String	ATTRIBUTE	Projected metrics for a specific target impression share value.
CampaignSimulationTargetRoasPointListPoints	String	ATTRIBUTE	Projected metrics for a series of target ROAS amounts.
CampaignSimulationType	String	ATTRIBUTE	Output only. The field that the simulation modifies. The allowed values are BID_MODIFIER, BUDGET, CPC_BID, CPV_BID, PERCENT_CPC_BID, TARGET_CPA, TARGET_IMPRESSION_SHARE, TARGET_ROAS, 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.

CarrierConstant

A carrier criterion that can be used in campaign targeting.

Columns

Name	Type	Behavior	Description
CarrierConstantCountryCode	String	ATTRIBUTE	Output only. The country code of the country where the carrier is located, for example, 'AR', 'FR', etc.
CarrierConstantId	Long	ATTRIBUTE	Output only. The ID of the carrier criterion.
CarrierConstantName	String	ATTRIBUTE	Output only. The full name of the carrier in English.
CarrierConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the carrier criterion. Carrier criterion resource names have the form: carrierConstants/{criterion_id}

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.

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.

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.

The ChangeEvent table has extra limitations. You need to provide a time no older than 30 days, and a limit, for example:

  SELECT ChangeEventCampaign, CustomerId FROM ChangeEvent WHERE ChangeEventChangeDateTime DURING LAST_14_DAYS LIMIT 10

Columns

Name	Type	Behavior	Description
ChangeEventAdGroup	String	ATTRIBUTE	Output only. The AdGroup affected by this change.
ChangeEventAsset	String	ATTRIBUTE	Output only. The Asset affected by this change.
ChangeEventCampaign	String	ATTRIBUTE	Output only. The Campaign affected by this change.
ChangeEventChangeDateTime	Date	ATTRIBUTE	Output only. Time at which the change was committed on this resource.
ChangeEventChangeResourceName	String	ATTRIBUTE	Output only. The Simply resource this change occurred on.
ChangeEventChangeResourceType	String	ATTRIBUTE	Output only. The type of the changed resource. This dictates what resource will be set in old_resource and new_resource. The allowed values are AD, AD_GROUP, AD_GROUP_AD, AD_GROUP_ASSET, AD_GROUP_BID_MODIFIER, AD_GROUP_CRITERION, AD_GROUP_FEED, ASSET, ASSET_SET, ASSET_SET_ASSET, CAMPAIGN, CAMPAIGN_ASSET, CAMPAIGN_ASSET_SET, CAMPAIGN_BUDGET, CAMPAIGN_CRITERION, CAMPAIGN_FEED, CUSTOMER_ASSET, FEED, FEED_ITEM, UNKNOWN, UNSPECIFIED.
ChangeEventChangedFields	String	ATTRIBUTE	Output only. A list of fields that are changed in the returned resource.
ChangeEventClientType	String	ATTRIBUTE	Output only. Where the change was made through. The allowed values are GOOGLE_ADS_API, GOOGLE_ADS_AUTOMATED_RULE, GOOGLE_ADS_BULK_UPLOAD, GOOGLE_ADS_EDITOR, GOOGLE_ADS_MOBILE_APP, GOOGLE_ADS_RECOMMENDATIONS, GOOGLE_ADS_SCRIPTS, GOOGLE_ADS_WEB_CLIENT, INTERNAL_TOOL, OTHER, SEARCH_ADS_360_POST, SEARCH_ADS_360_SYNC, UNKNOWN, UNSPECIFIED.
ChangeEventFeed	String	ATTRIBUTE	Output only. The Feed affected by this change.
ChangeEventFeedItem	String	ATTRIBUTE	Output only. The FeedItem affected by this change.
ChangeEventNewResource	String	ATTRIBUTE	Output only. The new resource after the change. Only changed fields will be populated.
ChangeEventOldResource	String	ATTRIBUTE	Output only. The old resource before the change. Only changed fields will be populated.
ChangeEventResourceChangeOperation	String	ATTRIBUTE	Output only. The operation on the changed resource. The allowed values are CREATE, REMOVE, UNKNOWN, UNSPECIFIED, UPDATE.
ChangeEventResourceName	String	ATTRIBUTE	Output only. The resource name of the change event. Change event resource names have the form: customers/{customer_id}/changeEvents/{timestamp_micros}~{command_index}~{mutate_index}
ChangeEventUserEmail	String	ATTRIBUTE	Output only. The email of the user who made this change.
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.

ChangeStatus

Describes the status of returned resource. ChangeStatus could have up to 3 minutes delay to reflect a new change.

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.

The ChangeStatus table has extra limitations. You need to provide a time no older than 30 days, and a limit, for example:

  SELECT ChangeStatusCampaign, CustomerId FROM ChangeStatus WHERE ChangeStatusLastChangeDateTime DURING LAST_14_DAYS LIMIT 10

Columns

Name	Type	Behavior	Description
ChangeStatusAdGroup	String	ATTRIBUTE	Output only. The AdGroup affected by this change.
ChangeStatusAdGroupAd	String	ATTRIBUTE	Output only. The AdGroupAd affected by this change.
ChangeStatusAdGroupAsset	String	ATTRIBUTE	Output only. The AdGroupAsset affected by this change.
ChangeStatusAdGroupBidModifier	String	ATTRIBUTE	Output only. The AdGroupBidModifier affected by this change.
ChangeStatusAdGroupCriterion	String	ATTRIBUTE	Output only. The AdGroupCriterion affected by this change.
ChangeStatusAdGroupFeed	String	ATTRIBUTE	Output only. The AdGroupFeed affected by this change.
ChangeStatusAsset	String	ATTRIBUTE	Output only. The Asset affected by this change.
ChangeStatusCampaign	String	ATTRIBUTE	Output only. The Campaign affected by this change.
ChangeStatusCampaignAsset	String	ATTRIBUTE	Output only. The CampaignAsset affected by this change.
ChangeStatusCampaignCriterion	String	ATTRIBUTE	Output only. The CampaignCriterion affected by this change.
ChangeStatusCampaignFeed	String	ATTRIBUTE	Output only. The CampaignFeed affected by this change.
ChangeStatusCampaignSharedSet	String	ATTRIBUTE	Output only. The CampaignSharedSet affected by this change.
ChangeStatusCustomerAsset	String	ATTRIBUTE	Output only. The CustomerAsset affected by this change.
ChangeStatusFeed	String	ATTRIBUTE	Output only. The Feed affected by this change.
ChangeStatusFeedItem	String	ATTRIBUTE	Output only. The FeedItem affected by this change.
ChangeStatusLastChangeDateTime	Date	ATTRIBUTE	Output only. Time at which the most recent change has occurred on this resource.
ChangeStatusResourceName	String	ATTRIBUTE	Output only. The resource name of the change status. Change status resource names have the form: customers/{customer_id}/changeStatus/{change_status_id}
ChangeStatusResourceStatus	String	ATTRIBUTE	Output only. Represents the status of the changed resource. The allowed values are ADDED, CHANGED, REMOVED, UNKNOWN, UNSPECIFIED.
ChangeStatusResourceType	String	ATTRIBUTE	Output only. Represents the type of the changed resource. This dictates what fields will be set. For example, for AD_GROUP, campaign and ad_group fields will be set. The allowed values are AD_GROUP, AD_GROUP_AD, AD_GROUP_ASSET, AD_GROUP_BID_MODIFIER, AD_GROUP_CRITERION, AD_GROUP_FEED, ASSET, CAMPAIGN, CAMPAIGN_ASSET, CAMPAIGN_CRITERION, CAMPAIGN_FEED, CAMPAIGN_SHARED_SET, CUSTOMER_ASSET, FEED, FEED_ITEM, SHARED_SET, UNKNOWN, UNSPECIFIED.
ChangeStatusSharedSet	String	ATTRIBUTE	Output only. The SharedSet affected by this change.
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.

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.

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.

Queries to 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.

SELECT * FROM ClickView WHERE Date DURING Yesterday

Columns

Name	Type	Behavior	Description
ClickViewAdGroupAd	String	ATTRIBUTE	Output only. The associated ad.
ClickViewAreaOfInterestCity	String	ATTRIBUTE	The city location criterion associated with the impression.
ClickViewAreaOfInterestCountry	String	ATTRIBUTE	The country location criterion associated with the impression.
ClickViewAreaOfInterestMetro	String	ATTRIBUTE	The metro location criterion associated with the impression.
ClickViewAreaOfInterestMostSpecific	String	ATTRIBUTE	The most specific location criterion associated with the impression.
ClickViewAreaOfInterestRegion	String	ATTRIBUTE	The region location criterion associated with the impression.
ClickViewCampaignLocationTarget	String	ATTRIBUTE	Output only. The associated campaign location target, if one exists.
ClickViewGclid	String	ATTRIBUTE	Output only. The Google Click ID.
ClickViewKeyword	String	ATTRIBUTE	Output only. The associated keyword, if one exists and the click corresponds to the SEARCH channel.
ClickViewKeywordInfoMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
ClickViewKeywordInfoText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
ClickViewLocationOfPresenceCity	String	ATTRIBUTE	The city location criterion associated with the impression.
ClickViewLocationOfPresenceCountry	String	ATTRIBUTE	The country location criterion associated with the impression.
ClickViewLocationOfPresenceMetro	String	ATTRIBUTE	The metro location criterion associated with the impression.
ClickViewLocationOfPresenceMostSpecific	String	ATTRIBUTE	The most specific location criterion associated with the impression.
ClickViewLocationOfPresenceRegion	String	ATTRIBUTE	The region location criterion associated with the impression.
ClickViewPageNumber	Long	ATTRIBUTE	Output only. Page number in search results where the ad was shown.
ClickViewResourceName	String	ATTRIBUTE	Output only. The resource name of the click view. Click view resource names have the form: customers/{customer_id}/clickViews/{date (yyyy-MM-dd)}~{gclid}
ClickViewUserList	String	ATTRIBUTE	Output only. The associated user list, if one exists.
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
Clicks	Long	METRIC	The number of clicks.
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, CROSS_NETWORK, 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.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Device	String	SEGMENT	Device to which metrics apply. The allowed values are CONNECTED_TV, DESKTOP, MOBILE, OTHER, TABLET, UNKNOWN, UNSPECIFIED.
MonthOfYear	String	SEGMENT	Month of the year, for example, 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.
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.

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.

CombinedAudience

Describe a resource for combined audiences which includes different audiences.

Columns

Name	Type	Behavior	Description
CombinedAudienceDescription	String	ATTRIBUTE	Output only. Description of this combined audience.
CombinedAudienceId	Long	ATTRIBUTE	Output only. ID of the combined audience.
CombinedAudienceName	String	ATTRIBUTE	Output only. Name of the combined audience. It should be unique across all combined audiences.
CombinedAudienceResourceName	String	ATTRIBUTE	Immutable. The resource name of the combined audience. Combined audience names have the form: customers/{customer_id}/combinedAudience/{combined_audience_id}
CombinedAudienceStatus	String	ATTRIBUTE	Output only. Status of this combined audience. Indicates whether the combined audience is enabled or removed. The allowed values are ENABLED, REMOVED, 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.

ConversionAction

A conversion action.

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
ConversionActionAppId	String	ATTRIBUTE	App ID for an app conversion action.
ConversionActionAttributionModelSettingsAttributionModel	String	ATTRIBUTE	The attribution model type of this conversion action. The allowed values are EXTERNAL, GOOGLE_ADS_LAST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN, GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_LINEAR, GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED, GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY, UNKNOWN, UNSPECIFIED.
ConversionActionAttributionModelSettingsDataDrivenModelStatus	String	ATTRIBUTE	Output only. The status of the data-driven attribution model for the conversion action. The allowed values are AVAILABLE, EXPIRED, NEVER_GENERATED, STALE, UNKNOWN, UNSPECIFIED.
ConversionActionCategory	String	ATTRIBUTE	The category of conversions reported for this conversion action. 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.
ConversionActionClickThroughLookbackWindowDays	Long	ATTRIBUTE	The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.
ConversionActionCountingType	String	ATTRIBUTE	How to count conversion events for the conversion action. The allowed values are MANY_PER_CLICK, ONE_PER_CLICK, UNKNOWN, UNSPECIFIED.
ConversionActionFirebaseSettingsEventName	String	ATTRIBUTE	Output only. The event name of a Firebase conversion.
ConversionActionFirebaseSettingsProjectId	String	ATTRIBUTE	Output only. The Firebase project ID of the conversion.
ConversionActionFirebaseSettingsPropertyId	Long	ATTRIBUTE	Output only. The GA property ID of the conversion.
ConversionActionFirebaseSettingsPropertyName	String	ATTRIBUTE	Output only. The GA property name of the conversion.
ConversionActionId	Long	ATTRIBUTE	Output only. The ID of the conversion action.
ConversionActionIncludeInConversionsMetric	Bool	ATTRIBUTE	Whether this conversion action should be included in the 'conversions' metric.
ConversionActionMobileAppVendor	String	ATTRIBUTE	Output only. Mobile app vendor for an app conversion action. The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN, UNSPECIFIED.
ConversionActionName	String	ATTRIBUTE	The name of the conversion action. This field is required and should not be empty when creating new conversion actions.
ConversionActionOrigin	String	ATTRIBUTE	Output only. The conversion origin of this conversion action. The allowed values are APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
ConversionActionOwnerCustomer	String	ATTRIBUTE	Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.
ConversionActionPhoneCallDurationSeconds	Long	ATTRIBUTE	The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive.
ConversionActionPrimaryForGoal	Bool	ATTRIBUTE	If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional.
ConversionActionResourceName	String	ATTRIBUTE	Immutable. The resource name of the conversion action. Conversion action resource names have the form: customers/{customer_id}/conversionActions/{conversion_action_id}
ConversionActionStatus	String	ATTRIBUTE	The status of this conversion action for conversion event accrual. The allowed values are ENABLED, HIDDEN, REMOVED, UNKNOWN, UNSPECIFIED.
ConversionActionTagSnippets	String	ATTRIBUTE	Output only. The snippets used for tracking conversions.
ConversionActionThirdPartyAppAnalyticsSettingsEventName	String	ATTRIBUTE	Output only. The event name of a third-party app analytics conversion.
ConversionActionThirdPartyAppAnalyticsSettingsProviderName	String	ATTRIBUTE	Output only. Name of the third-party app analytics provider.
ConversionActionType	String	ATTRIBUTE	Immutable. The type of this conversion action. The allowed values are AD_CALL, ANDROID_APP_PRE_REGISTRATION, ANDROID_INSTALLS_ALL_OTHER_APPS, CLICK_TO_CALL, FIREBASE_ANDROID_CUSTOM, FIREBASE_ANDROID_FIRST_OPEN, FIREBASE_ANDROID_IN_APP_PURCHASE, FIREBASE_IOS_CUSTOM, FIREBASE_IOS_FIRST_OPEN, FIREBASE_IOS_IN_APP_PURCHASE, FLOODLIGHT_ACTION, FLOODLIGHT_TRANSACTION, GOOGLE_HOSTED, GOOGLE_PLAY_DOWNLOAD, GOOGLE_PLAY_IN_APP_PURCHASE, LEAD_FORM_SUBMIT, SALESFORCE, SEARCH_ADS_360, SMART_CAMPAIGN_AD_CLICKS_TO_CALL, SMART_CAMPAIGN_MAP_CLICKS_TO_CALL, SMART_CAMPAIGN_MAP_DIRECTIONS, SMART_CAMPAIGN_TRACKED_CALLS, STORE_SALES, STORE_SALES_DIRECT_UPLOAD, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM, THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE, THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM, THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE, UNKNOWN, UNSPECIFIED, UPLOAD_CALLS, UPLOAD_CLICKS, WEBPAGE, WEBSITE_CALL.
ConversionActionValueSettingsAlwaysUseDefaultValue	Bool	ATTRIBUTE	Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.
ConversionActionValueSettingsDefaultCurrencyCode	String	ATTRIBUTE	The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.
ConversionActionValueSettingsDefaultValue	Double	ATTRIBUTE	The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.
ConversionActionViewThroughLookbackWindowDays	Long	ATTRIBUTE	The maximum number of days which may elapse between an impression and a conversion without an interaction.
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.
ConversionLastConversionDate	Date	METRIC	The date of the most recent conversion for this conversion action. The date is in the customer's time zone.
ConversionLastReceivedRequestDateTime	Date	METRIC	The last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (for example, because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Week	Date	SEGMENT	Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

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.

ConversionCustomVariable

A conversion custom variable See 'About custom variables for conversions' at https://support.google.com/google-ads/answer/9964350

Columns

Name	Type	Behavior	Description
ConversionCustomVariableId	Long	ATTRIBUTE	Output only. The ID of the conversion custom variable.
ConversionCustomVariableName	String	ATTRIBUTE	Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.
ConversionCustomVariableOwnerCustomer	String	ATTRIBUTE	Output only. The resource name of the customer that owns the conversion custom variable.
ConversionCustomVariableResourceName	String	ATTRIBUTE	Immutable. The resource name of the conversion custom variable. Conversion custom variable resource names have the form: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
ConversionCustomVariableStatus	String	ATTRIBUTE	The status of the conversion custom variable for conversion event accrual. The allowed values are ACTIVATION_NEEDED, ENABLED, PAUSED, UNKNOWN, UNSPECIFIED.
ConversionCustomVariableTag	String	ATTRIBUTE	Required. Immutable. The tag of the conversion custom variable. It is used in the event snippet and sent to Google Ads along with conversion pings. For conversion uploads in Google Ads API, the resource name of the conversion custom variable is used. Tag should be unique. The maximum size of tag is 100 bytes. There should not be any extra spaces before and after. Currently only lowercase letters, numbers and underscores are allowed in the tag.
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.

ConversionGoalCampaignConfig

Conversion goal settings for a Campaign.

Columns

Name	Type	Behavior	Description
ConversionGoalCampaignConfigCampaign	String	ATTRIBUTE	Immutable. The campaign with which this conversion goal campaign config is associated.
ConversionGoalCampaignConfigCustomConversionGoal	String	ATTRIBUTE	The custom conversion goal the campaign is using for optimization.
ConversionGoalCampaignConfigGoalConfigLevel	String	ATTRIBUTE	The level of goal config the campaign is using. The allowed values are CAMPAIGN, CUSTOMER, UNKNOWN, UNSPECIFIED.
ConversionGoalCampaignConfigResourceName	String	ATTRIBUTE	Immutable. The resource name of the conversion goal campaign config. Conversion goal campaign config resource names have the form: customers/{customer_id}/conversionGoalCampaignConfigs/{campaign_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.

ConversionValueRule

A conversion value rule

Columns

Name	Type	Behavior	Description
ConversionValueRuleActionOperation	String	ATTRIBUTE	Specifies applied operation. The allowed values are ADD, MULTIPLY, SET, UNKNOWN, UNSPECIFIED.
ConversionValueRuleActionValue	Double	ATTRIBUTE	Specifies applied value.
ConversionValueRuleAudienceConditionUserInterests	String	ATTRIBUTE	User Interests.
ConversionValueRuleAudienceConditionUserLists	String	ATTRIBUTE	User Lists.
ConversionValueRuleDeviceConditionDeviceTypes	String	ATTRIBUTE	Value for device type condition. The allowed values are DESKTOP, MOBILE, TABLET, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionExcludedGeoMatchType	String	ATTRIBUTE	Excluded Geo location match type. The allowed values are ANY, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionExcludedGeoTargetConstants	String	ATTRIBUTE	Geo locations that advertisers want to exclude.
ConversionValueRuleGeoLocationConditionGeoMatchType	String	ATTRIBUTE	Included Geo location match type. The allowed values are ANY, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
ConversionValueRuleGeoLocationConditionGeoTargetConstants	String	ATTRIBUTE	Geo locations that advertisers want to include.
ConversionValueRuleId	Long	ATTRIBUTE	Output only. The ID of the conversion value rule.
ConversionValueRuleOwnerCustomer	String	ATTRIBUTE	Output only. The resource name of the conversion value rule's owner customer. When the value rule is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only **
ConversionValueRuleResourceName	String	ATTRIBUTE	Immutable. The resource name of the conversion value rule. Conversion value rule resource names have the form: customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}
ConversionValueRuleStatus	String	ATTRIBUTE	The status of the conversion value rule. The allowed values are ENABLED, PAUSED, REMOVED, 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.

ConversionValueRuleSet

A conversion value rule set

Columns

Name	Type	Behavior	Description
ConversionValueRuleSetAttachmentType	String	ATTRIBUTE	Immutable. Defines the scope where the conversion value rule set is attached. The allowed values are CAMPAIGN, CUSTOMER, UNKNOWN, UNSPECIFIED.
ConversionValueRuleSetCampaign	String	ATTRIBUTE	The resource name of the campaign when the conversion value rule set is attached to a campaign.
ConversionValueRuleSetConversionActionCategories	String	ATTRIBUTE	Immutable. The conversion action categories of the conversion value rule set. 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.
ConversionValueRuleSetConversionValueRules	String	ATTRIBUTE	Resource names of rules within the rule set.
ConversionValueRuleSetDimensions	String	ATTRIBUTE	Defines dimensions for Value Rule conditions. The condition types of value rules within this value rule set must be of these dimensions. The first entry in this list is the primary dimension of the included value rules. When using value rule primary dimension segmentation, conversion values will be segmented into the values adjusted by value rules and the original values, if some value rules apply. The allowed values are AUDIENCE, DEVICE, GEO_LOCATION, NO_CONDITION, UNKNOWN, UNSPECIFIED.
ConversionValueRuleSetId	Long	ATTRIBUTE	Output only. The ID of the conversion value rule set.
ConversionValueRuleSetOwnerCustomer	String	ATTRIBUTE	Output only. The resource name of the conversion value rule set's owner customer. When the value rule set is inherited from a manager customer, owner_customer will be the resource name of the manager whereas the customer in the resource_name will be of the requesting serving customer. ** Read-only **
ConversionValueRuleSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the conversion value rule set. Conversion value rule set resource names have the form: customers/{customer_id}/conversionValueRuleSets/{conversion_value_rule_set_id}
ConversionValueRuleSetStatus	String	ATTRIBUTE	Output only. The status of the conversion value rule set. ** Read-only ** The allowed values are ENABLED, PAUSED, REMOVED, 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.

CurrencyConstant

A currency constant.

Columns

Name	Type	Behavior	Description
CurrencyConstantBillableUnitMicros	Long	ATTRIBUTE	Output only. The billable unit for this currency. Billed amounts should be multiples of this value.
CurrencyConstantCode	String	ATTRIBUTE	Output only. ISO 4217 three-letter currency code, for example, 'USD'
CurrencyConstantName	String	ATTRIBUTE	Output only. Full English name of the currency.
CurrencyConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the currency constant. Currency constant resource names have the form: currencyConstants/{code}
CurrencyConstantSymbol	String	ATTRIBUTE	Output only. Standard symbol for describing this currency, for example, '$' for US Dollars.

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.

CustomAudience

A custom audience. This is a list of users by interest.

Columns

Name	Type	Behavior	Description
CustomAudienceDescription	String	ATTRIBUTE	Description of this custom audience.
CustomAudienceId	Long	ATTRIBUTE	Output only. ID of the custom audience.
CustomAudienceMembers	String	ATTRIBUTE	List of custom audience members that this custom audience is composed of. Members can be added during CustomAudience creation. If members are presented in UPDATE operation, existing members will be overridden.
CustomAudienceName	String	ATTRIBUTE	Name of the custom audience. It should be unique for all custom audiences created by a customer. This field is required for creating operations.
CustomAudienceResourceName	String	ATTRIBUTE	Immutable. The resource name of the custom audience. Custom audience resource names have the form: customers/{customer_id}/customAudiences/{custom_audience_id}
CustomAudienceStatus	String	ATTRIBUTE	Output only. Status of this custom audience. Indicates whether the custom audience is enabled or removed. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomAudienceType	String	ATTRIBUTE	Type of the custom audience. ('INTEREST' OR 'PURCHASE_INTENT' is not allowed for newly created custom audience but kept for existing audiences) The allowed values are AUTO, INTEREST, PURCHASE_INTENT, SEARCH, 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.

CustomConversionGoal

Custom conversion goal that can make arbitrary conversion actions biddable.

Columns

Name	Type	Behavior	Description
CustomConversionGoalConversionActions	String	ATTRIBUTE	Conversion actions that the custom conversion goal makes biddable.
CustomConversionGoalId	Long	ATTRIBUTE	Immutable. The ID for this custom conversion goal.
CustomConversionGoalName	String	ATTRIBUTE	The name for this custom conversion goal.
CustomConversionGoalResourceName	String	ATTRIBUTE	Immutable. The resource name of the custom conversion goal. Custom conversion goal resource names have the form: customers/{customer_id}/customConversionGoals/{goal_id}
CustomConversionGoalStatus	String	ATTRIBUTE	The status of the custom conversion goal. The allowed values are ENABLED, REMOVED, 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.

Customer

A customer.

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
CustomerAutoTaggingEnabled	Bool	ATTRIBUTE	Whether auto-tagging is enabled for the customer.
CustomerCallReportingSettingCallConversionAction	String	ATTRIBUTE	Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true.
CustomerCallReportingSettingCallConversionReportingEnabled	Bool	ATTRIBUTE	Whether to enable call conversion reporting.
CustomerCallReportingSettingCallReportingEnabled	Bool	ATTRIBUTE	Enable reporting of phone call events by redirecting them through Google System.
CustomerConversionTrackingSettingAcceptedCustomerDataTerms	Bool	ATTRIBUTE	Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
CustomerConversionTrackingSettingConversionTrackingId	Long	ATTRIBUTE	Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.
CustomerConversionTrackingSettingConversionTrackingStatus	String	ATTRIBUTE	Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request. The allowed values are CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER, CONVERSION_TRACKING_MANAGED_BY_SELF, CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER, NOT_CONVERSION_TRACKED, UNKNOWN, UNSPECIFIED.
CustomerConversionTrackingSettingCrossAccountConversionTrackingId	Long	ATTRIBUTE	Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.
CustomerConversionTrackingSettingEnhancedConversionsForLeadsEnabled	Bool	ATTRIBUTE	Output only. Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
CustomerConversionTrackingSettingGoogleAdsConversionCustomer	String	ATTRIBUTE	Output only. The resource name of the customer where conversions are created and managed. This field is read-only.
CustomerCurrencyCode	String	ATTRIBUTE	Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
CustomerDescriptiveName	String	ATTRIBUTE	Optional, non-unique descriptive name of the customer.
CustomerFinalUrlSuffix	String	ATTRIBUTE	The URL template for appending params to the final URL
CustomerHasPartnersBadge	Bool	ATTRIBUTE	Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerManager	Bool	ATTRIBUTE	Output only. Whether the customer is a manager.
CustomerOptimizationScore	Double	ATTRIBUTE	Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See 'About optimization score' at https://support.google.com/google-ads/answer/9061546. This field is read-only.
CustomerOptimizationScoreWeight	Double	ATTRIBUTE	Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only.
CustomerPayPerConversionEligibilityFailureReasons	String	ATTRIBUTE	Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only. The allowed values are ANALYSIS_NOT_COMPLETE, AVERAGE_DAILY_SPEND_TOO_HIGH, CONVERSION_LAG_TOO_HIGH, HAS_CAMPAIGN_WITH_SHARED_BUDGET, HAS_UPLOAD_CLICKS_CONVERSION, NOT_ENOUGH_CONVERSIONS, OTHER, UNKNOWN, UNSPECIFIED.
CustomerRemarketingSettingGoogleGlobalSiteTag	String	ATTRIBUTE	Output only. The Google tag.
CustomerResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer. Customer resource names have the form: customers/{customer_id}
CustomerStatus	String	ATTRIBUTE	Output only. The status of the customer. The allowed values are CANCELED, CLOSED, ENABLED, SUSPENDED, UNKNOWN, UNSPECIFIED.
CustomerTestAccount	Bool	ATTRIBUTE	Output only. Whether the customer is a test account.
CustomerTimeZone	String	ATTRIBUTE	Immutable. The local timezone ID of the customer.
CustomerTrackingUrlTemplate	String	ATTRIBUTE	The URL template for constructing a tracking URL out of parameters.

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.

CustomerAsset

A link between a customer and an asset.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerAssetAsset	String	ATTRIBUTE	Required. Immutable. The asset which is linked to the customer.
CustomerAssetFieldType	String	ATTRIBUTE	Required. Immutable. Role that the asset takes for the customer link. The allowed values are AD_IMAGE, 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.
CustomerAssetResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer asset. CustomerAsset resource names have the form: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
CustomerAssetSource	String	ATTRIBUTE	Output only. Source of the customer asset link. The allowed values are ADVERTISER, AUTOMATICALLY_CREATED, UNKNOWN, UNSPECIFIED.
CustomerAssetStatus	String	ATTRIBUTE	Status of the customer asset. The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED.
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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

CustomerAssetSet

CustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerAssetSetAssetSet	String	ATTRIBUTE	Immutable. The asset set which is linked to the customer.
CustomerAssetSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer asset set. Asset set asset resource names have the form: customers/{customer_id}/customerAssetSets/{asset_set_id}
CustomerAssetSetStatus	String	ATTRIBUTE	Output only. The status of the customer asset set asset. Read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerClientAppliedLabels	String	ATTRIBUTE	Output only. The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form: customers/{customer_id}/labels/{label_id}
CustomerClientClientCustomer	String	ATTRIBUTE	Output only. The resource name of the client-customer which is linked to the given customer. Read only.
CustomerClientCurrencyCode	String	ATTRIBUTE	Output only. Currency code (for example, 'USD', 'EUR') for the client. Read only.
CustomerClientDescriptiveName	String	ATTRIBUTE	Output only. Descriptive name for the client. Read only.
CustomerClientHidden	Bool	ATTRIBUTE	Output only. Specifies whether this is a hidden account. Read only.
CustomerClientId	Long	ATTRIBUTE	Output only. The ID of the client customer. Read only.
CustomerClientLevel	Long	ATTRIBUTE	Output only. Distance between given customer and client. For self link, the level value will be 0. Read only.
CustomerClientManager	Bool	ATTRIBUTE	Output only. Identifies if the client is a manager. Read only.
CustomerClientResourceName	String	ATTRIBUTE	Output only. The resource name of the customer client. CustomerClient resource names have the form: customers/{customer_id}/customerClients/{client_customer_id}
CustomerClientStatus	String	ATTRIBUTE	Output only. The status of the client customer. Read only. The allowed values are CANCELED, CLOSED, ENABLED, SUSPENDED, UNKNOWN, UNSPECIFIED.
CustomerClientTestAccount	Bool	ATTRIBUTE	Output only. Identifies if the client is a test account. Read only.
CustomerClientTimeZone	String	ATTRIBUTE	Output only. Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

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.

CustomerClientLink

The links between customer client accounts and manager accounts

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.

Query the CustomerClientLink table to get a list of the linked Customer Client Ids subaccounts, starting from the ManagerId specified in the connection property. If you wish to retreive the listing, from a different hierarchy level you can do so by filtering with the CustomerId pseudo-column, specifying the customer id of the accout for which you want to get the linked subaccounts. If you want to avoid the full hierarchy listing and only get subaccounts for a specific manager/CustomerId set RecurseChildren connection property to false. Note that ManagerId property should be specified to be able to get data from this table.

SELECT * FROM CustomerClientLink WHERE CustomerId = '2705304492'

Columns

Name	Type	Behavior	Description
ClientCustomerId	String	Attribute	Immutable. The client customer linked to this customer.
Hidden	String	Attribute	The visibility of the link. Users can choose whether or not to see hidden links in the Google Ads UI. Default value is false
ManagerLinkId	String	Attribute	Output only. This is uniquely identifies a customer client link. Read only.
ResourceName	String	Attribute	Immutable. Name of the resource.
Status	String	Attribute	This is the status of the link between client and manager.
LinkedManagerId	String	Attribute	Id of the linked manager.

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	Long	CustomerId for which to get the linked client customer ids.
ManagerId	Long	Id of the manager account on behalf of which you are requesting customer data.

CustomerConversionGoal

Biddability control for conversion actions with a matching category and origin.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerConversionGoalBiddable	Bool	ATTRIBUTE	The biddability of the customer conversion goal.
CustomerConversionGoalCategory	String	ATTRIBUTE	The conversion category of this customer conversion goal. Only conversion actions that have this category will be included in this goal. 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.
CustomerConversionGoalOrigin	String	ATTRIBUTE	The conversion origin of this customer conversion goal. Only conversion actions that have this conversion origin will be included in this goal. The allowed values are APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_HOSTED.
CustomerConversionGoalResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer conversion goal. Customer conversion goal resource names have the form: customers/{customer_id}/customerConversionGoals/{category}~{origin}

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.

CustomerCustomizer

A customizer value for the associated CustomizerAttribute at the Customer level.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerCustomizerCustomizerAttribute	String	ATTRIBUTE	Required. Immutable. The customizer attribute which is linked to the customer.
CustomerCustomizerResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer customizer. Customer customizer resource names have the form: customers/{customer_id}/customerCustomizers/{customizer_attribute_id}
CustomerCustomizerStatus	String	ATTRIBUTE	Output only. The status of the customer customizer attribute. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomerCustomizerValueStringValue	String	ATTRIBUTE	Required. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
CustomerCustomizerValueType	String	ATTRIBUTE	Required. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type. The allowed values are NUMBER, PERCENT, PRICE, TEXT, UNKNOWN, UNSPECIFIED.

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.

CustomerExtensionSetting

A customer extension setting.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerExtensionSettingDevice	String	ATTRIBUTE	The device for which the extensions will serve. Optional. The allowed values are DESKTOP, MOBILE, UNKNOWN, UNSPECIFIED.
CustomerExtensionSettingExtensionFeedItems	String	ATTRIBUTE	The resource names of the extension feed items to serve under the customer. ExtensionFeedItem resource names have the form: customers/{customer_id}/extensionFeedItems/{feed_item_id}
CustomerExtensionSettingExtensionType	String	ATTRIBUTE	Immutable. The extension type of the customer extension setting. The allowed values are AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CustomerExtensionSettingResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer extension setting. CustomerExtensionSetting resource names have the form: customers/{customer_id}/customerExtensionSettings/{extension_type}

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.

CustomerFeed

A customer feed.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerFeedFeed	String	ATTRIBUTE	Immutable. The feed being linked to the customer.
CustomerFeedMatchingFunctionFunctionString	String	ATTRIBUTE	String representation of the Function. Examples: 1. IDENTITY(true) or IDENTITY(false). All or no feed items served. 2. EQUALS(CONTEXT.DEVICE,'Mobile') 3. IN(FEED_ITEM_ID,{1000001,1000002,1000003}) 4. CONTAINS_ANY(FeedAttribute[12345678,0],{'Mars cruise','Venus cruise'}) 5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,'Mobile')) For more details, visit https://developers.google.com/adwords/api/docs/guides/feed-matching-functions Note that because multiple strings may represent the same underlying function (whitespace and single versus double quotation marks, for example), the value returned may not be identical to the string sent in a mutate request.
CustomerFeedMatchingFunctionLeftOperands	String	ATTRIBUTE	The operands on the left hand side of the equation. This is also the operand to be used for single operand expressions such as NOT.
CustomerFeedMatchingFunctionOperator	String	ATTRIBUTE	Operator for a function. The allowed values are AND, CONTAINS_ANY, EQUALS, IDENTITY, IN, UNKNOWN, UNSPECIFIED.
CustomerFeedMatchingFunctionRightOperands	String	ATTRIBUTE	The operands on the right hand side of the equation.
CustomerFeedPlaceholderTypes	String	ATTRIBUTE	Indicates which placeholder types the feed may populate under the connected customer. Required. The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
CustomerFeedResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer feed. Customer feed resource names have the form: customers/{customer_id}/customerFeeds/{feed_id}
CustomerFeedStatus	String	ATTRIBUTE	Output only. Status of the customer feed. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerLabelCustomer	String	ATTRIBUTE	Output only. The resource name of the customer to which the label is attached. Read only.
CustomerLabelLabel	String	ATTRIBUTE	Output only. The resource name of the label assigned to the customer. Note: the Customer ID portion of the label resource name is not validated when creating a new CustomerLabel.
CustomerLabelResourceName	String	ATTRIBUTE	Immutable. Name of the resource. Customer label resource names have the form: customers/{customer_id}/customerLabels/{label_id}

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.

CustomerManagerLink

Represents customer-manager link relationship.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerManagerLinkManagerCustomer	String	ATTRIBUTE	Output only. The manager customer linked to the customer.
CustomerManagerLinkManagerLinkId	Long	ATTRIBUTE	Output only. ID of the customer-manager link. This field is read only.
CustomerManagerLinkResourceName	String	ATTRIBUTE	Immutable. Name of the resource. CustomerManagerLink resource names have the form: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
CustomerManagerLinkStatus	String	ATTRIBUTE	Status of the link between the customer and the manager. The allowed values are ACTIVE, CANCELED, INACTIVE, PENDING, REFUSED, UNKNOWN, UNSPECIFIED.

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.

CustomerNegativeCriterion

A negative criterion for exclusions at the customer level.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerNegativeCriterionContentLabelType	String	ATTRIBUTE	Content label type, required for CREATE operations. The allowed values are BELOW_THE_FOLD, EMBEDDED_VIDEO, JUVENILE, LIVE_STREAMING_VIDEO, PARKED_DOMAIN, PROFANITY, SEXUALLY_SUGGESTIVE, SOCIAL_ISSUES, TRAGEDY, UNKNOWN, UNSPECIFIED, VIDEO, VIDEO_NOT_YET_RATED, VIDEO_RATING_DV_G, VIDEO_RATING_DV_MA, VIDEO_RATING_DV_PG, VIDEO_RATING_DV_T.
CustomerNegativeCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion.
CustomerNegativeCriterionMobileAppCategoryMobileAppCategoryConstant	String	ATTRIBUTE	The mobile app category constant resource name.
CustomerNegativeCriterionMobileApplicationAppId	String	ATTRIBUTE	A string that uniquely identifies a mobile application to Google Ads API. The format of this string is '{platform}-{platform_native_id}', where platform is '1' for iOS apps and '2' for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, '476943146' for 'Flood-It! 2' whose App Store link is 'http://itunes.apple.com/us/app/flood-it!-2/id476943146'). For Android, this native identifier is the application's package name (for example, 'com.labpixies.colordrips' for 'Color Drips' given Google Play link 'https://play.google.com/store/apps/details?id=com.labpixies.colordrips'). A well formed app id for Google Ads API would thus be '1-476943146' for iOS and '2-com.labpixies.colordrips' for Android. This field is required and must be set in CREATE operations.
CustomerNegativeCriterionMobileApplicationName	String	ATTRIBUTE	Name of this mobile application.
CustomerNegativeCriterionPlacementUrl	String	ATTRIBUTE	URL of the placement. For example, 'http://www.domain.com'.
CustomerNegativeCriterionResourceName	String	ATTRIBUTE	Immutable. The resource name of the customer negative criterion. Customer negative criterion resource names have the form: customers/{customer_id}/customerNegativeCriteria/{criterion_id}
CustomerNegativeCriterionType	String	ATTRIBUTE	Output only. The type of the criterion. The allowed values are AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LISTING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
CustomerNegativeCriterionYoutubeChannelChannelId	String	ATTRIBUTE	The YouTube uploader channel id or the channel code of a YouTube channel.
CustomerNegativeCriterionYoutubeVideoVideoId	String	ATTRIBUTE	YouTube video id as it appears on the YouTube watch page.

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.

CustomerUserAccess

Represents the permission of a single user onto a single customer.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerUserAccessAccessCreationDateTime	Date	ATTRIBUTE	Output only. The customer user access creation time. Read only field The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
CustomerUserAccessAccessRole	String	ATTRIBUTE	Access role of the user. The allowed values are ADMIN, EMAIL_ONLY, READ_ONLY, STANDARD, UNKNOWN, UNSPECIFIED.
CustomerUserAccessEmailAddress	String	ATTRIBUTE	Output only. Email address of the user. Read only field
CustomerUserAccessInviterUserEmailAddress	String	ATTRIBUTE	Output only. The email address of the inviter user. Read only field
CustomerUserAccessResourceName	String	ATTRIBUTE	Immutable. Name of the resource. Resource names have the form: customers/{customer_id}/customerUserAccesses/{user_id}
CustomerUserAccessUserId	Long	ATTRIBUTE	Output only. User id of the user with the customer access. Read only field

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.

CustomerUserAccessInvitation

Represent an invitation to a new user on this customer account.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomerUserAccessInvitationAccessRole	String	ATTRIBUTE	Immutable. Access role of the user. The allowed values are ADMIN, EMAIL_ONLY, READ_ONLY, STANDARD, UNKNOWN, UNSPECIFIED.
CustomerUserAccessInvitationCreationDateTime	Date	ATTRIBUTE	Output only. Time invitation was created. This field is read-only. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
CustomerUserAccessInvitationEmailAddress	String	ATTRIBUTE	Immutable. Email address the invitation was sent to. This can differ from the email address of the account that accepts the invite.
CustomerUserAccessInvitationInvitationId	Long	ATTRIBUTE	Output only. The ID of the invitation. This field is read-only.
CustomerUserAccessInvitationInvitationStatus	String	ATTRIBUTE	Output only. Invitation status of the user. The allowed values are DECLINED, EXPIRED, PENDING, UNKNOWN, UNSPECIFIED.
CustomerUserAccessInvitationResourceName	String	ATTRIBUTE	Immutable. Name of the resource. Resource names have the form: customers/{customer_id}/customerUserAccessInvitations/{invitation_id}

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.

CustomInterest

A custom interest. This is a list of users by interest.

Columns

Name	Type	Behavior	Description
CustomInterestDescription	String	ATTRIBUTE	Description of this custom interest audience.
CustomInterestId	Long	ATTRIBUTE	Output only. Id of the custom interest.
CustomInterestMembers	String	ATTRIBUTE	List of custom interest members that this custom interest is composed of. Members can be added during CustomInterest creation. If members are presented in UPDATE operation, existing members will be overridden.
CustomInterestName	String	ATTRIBUTE	Name of the custom interest. It should be unique across the same custom affinity audience. This field is required for create operations.
CustomInterestResourceName	String	ATTRIBUTE	Immutable. The resource name of the custom interest. Custom interest resource names have the form: customers/{customer_id}/customInterests/{custom_interest_id}
CustomInterestStatus	String	ATTRIBUTE	Status of this custom interest. Indicates whether the custom interest is enabled or removed. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomInterestType	String	ATTRIBUTE	Type of the custom interest, CUSTOM_AFFINITY or CUSTOM_INTENT. By default the type is set to CUSTOM_AFFINITY. The allowed values are CUSTOM_AFFINITY, CUSTOM_INTENT, 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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
CustomizerAttributeId	Long	ATTRIBUTE	Output only. The ID of the customizer attribute.
CustomizerAttributeName	String	ATTRIBUTE	Required. Immutable. Name of the customizer attribute. Required. It must have a minimum length of 1 and maximum length of 40. Name of an enabled customizer attribute must be unique (case insensitive).
CustomizerAttributeResourceName	String	ATTRIBUTE	Immutable. The resource name of the customizer attribute. Customizer Attribute resource names have the form: customers/{customer_id}/customizerAttributes/{customizer_attribute_id}
CustomizerAttributeStatus	String	ATTRIBUTE	Output only. The status of the customizer attribute. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
CustomizerAttributeType	String	ATTRIBUTE	Immutable. The type of the customizer attribute. The allowed values are NUMBER, PERCENT, PRICE, TEXT, UNKNOWN, UNSPECIFIED.

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.

DetailedDemographic

A detailed demographic: a particular interest-based vertical to be targeted to reach users based on long-term life facts.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DetailedDemographicAvailabilities	String	ATTRIBUTE	Output only. Availability information of the detailed demographic.
DetailedDemographicId	Long	ATTRIBUTE	Output only. The ID of the detailed demographic.
DetailedDemographicLaunchedToAll	Bool	ATTRIBUTE	Output only. True if the detailed demographic is launched to all channels and locales.
DetailedDemographicName	String	ATTRIBUTE	Output only. The name of the detailed demographic. For example,'Highest Level of Educational Attainment'
DetailedDemographicParent	String	ATTRIBUTE	Output only. The parent of the detailed_demographic.
DetailedDemographicResourceName	String	ATTRIBUTE	Output only. The resource name of the detailed demographic. Detailed demographic resource names have the form: customers/{customer_id}/detailedDemographics/{detailed_demographic_id}

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.

DetailPlacementView

A view with metrics aggregated by ad group and URL or YouTube video.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DetailPlacementViewDisplayName	String	ATTRIBUTE	Output only. The display name is URL name for websites, YouTube video name for YouTube videos, and translated mobile app name for mobile apps.
DetailPlacementViewGroupPlacementTargetUrl	String	ATTRIBUTE	Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.
DetailPlacementViewPlacement	String	ATTRIBUTE	Output only. The automatic placement string at detail level, e. g. website URL, mobile application ID, or a YouTube video ID.
DetailPlacementViewPlacementType	String	ATTRIBUTE	Output only. Type of the placement, for example, Website, YouTube Video, and Mobile Application. The allowed values are MOBILE_APPLICATION, MOBILE_APP_CATEGORY, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
DetailPlacementViewResourceName	String	ATTRIBUTE	Output only. The resource name of the detail placement view. Detail placement view resource names have the form: customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}
DetailPlacementViewTargetUrl	String	ATTRIBUTE	Output only. URL of the placement, for example, website, link to the mobile application in app store, or a YouTube video URL.
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.
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.
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.
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.
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 (for example, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

DisplayKeywordView

A display keyword view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DisplayKeywordViewResourceName	String	ATTRIBUTE	Output only. The resource name of the display keyword view. Display Keyword view resource names have the form: customers/{customer_id}/displayKeywordViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DistanceViewDistanceBucket	String	ATTRIBUTE	Output only. Grouping of user distance from location extensions. The allowed values are BEYOND_40MILES, BEYOND_65KM, UNKNOWN, UNSPECIFIED, WITHIN_0_7MILES, WITHIN_10KM, WITHIN_10MILES, WITHIN_15KM, WITHIN_15MILES, WITHIN_1KM, WITHIN_1MILE, WITHIN_20KM, WITHIN_20MILES, WITHIN_25KM, WITHIN_25MILES, WITHIN_30KM, WITHIN_30MILES, WITHIN_35KM, WITHIN_35MILES, WITHIN_40KM, WITHIN_40MILES, WITHIN_45KM, WITHIN_50KM, WITHIN_55KM, WITHIN_5KM, WITHIN_5MILES, WITHIN_60KM, WITHIN_65KM, WITHIN_700M.
DistanceViewMetricSystem	Bool	ATTRIBUTE	Output only. True if the DistanceBucket is using the metric system, false otherwise.
DistanceViewResourceName	String	ATTRIBUTE	Output only. The resource name of the distance view. Distance view resource names have the form: customers/{customer_id}/distanceViews/1~{distance_bucket}
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.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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).
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 (for example, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DomainCategoryCampaign	String	ATTRIBUTE	Output only. The campaign this category is recommended for.
DomainCategoryCategory	String	ATTRIBUTE	Output only. Recommended category for the website domain, for example, if you have a website about electronics, the categories could be 'cameras', 'televisions', etc.
DomainCategoryCategoryRank	Long	ATTRIBUTE	Output only. The position of this category in the set of categories. Lower numbers indicate a better match for the domain. null indicates not recommended.
DomainCategoryCoverageFraction	Double	ATTRIBUTE	Output only. Fraction of pages on your site that this category matches.
DomainCategoryDomain	String	ATTRIBUTE	Output only. The domain for the website. The domain can be specified in the DynamicSearchAdsSetting required for dynamic search ads.
DomainCategoryHasChildren	Bool	ATTRIBUTE	Output only. Indicates whether this category has sub-categories.
DomainCategoryLanguageCode	String	ATTRIBUTE	Output only. The language code specifying the language of the website, for example, 'en' for English. The language can be specified in the DynamicSearchAdsSetting required for dynamic search ads. This is the language of the pages from your website that you want Google Ads to find, create ads for, and match searches with.
DomainCategoryRecommendedCpcBidMicros	Long	ATTRIBUTE	Output only. The recommended cost per click for the category.
DomainCategoryResourceName	String	ATTRIBUTE	Output only. The resource name of the domain category. Domain category resource names have the form: customers/{customer_id}/domainCategories/{campaign_id}~{category_base64}~{language_code}

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.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
DynamicSearchAdsSearchTermViewHasMatchingKeyword	Bool	ATTRIBUTE	Output only. True if query is added to targeted keywords. This field is read-only.
DynamicSearchAdsSearchTermViewHasNegativeKeyword	Bool	ATTRIBUTE	Output only. True if query matches a negative keyword. This field is read-only.
DynamicSearchAdsSearchTermViewHasNegativeUrl	Bool	ATTRIBUTE	Output only. True if query matches a negative url. This field is read-only.
DynamicSearchAdsSearchTermViewHeadline	String	ATTRIBUTE	Output only. The dynamically generated headline of the Dynamic Search Ad. This field is read-only.
DynamicSearchAdsSearchTermViewLandingPage	String	ATTRIBUTE	Output only. The dynamically selected landing page URL of the impression. This field is read-only.
DynamicSearchAdsSearchTermViewPageUrl	String	ATTRIBUTE	Output only. The URL of page feed item served for the impression. This field is read-only.
DynamicSearchAdsSearchTermViewResourceName	String	ATTRIBUTE	Output only. The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
DynamicSearchAdsSearchTermViewSearchTerm	String	ATTRIBUTE	Output only. Search term This field is read-only.
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.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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).
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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Webpage	String	SEGMENT	Resource name of the ad group criterion that represents webpage criterion.
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.

ExpandedLandingPageView

A landing page view with metrics aggregated at the expanded final URL 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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ExpandedLandingPageViewExpandedFinalUrl	String	ATTRIBUTE	Output only. The final URL that clicks are directed to.
ExpandedLandingPageViewResourceName	String	ATTRIBUTE	Output only. The resource name of the expanded landing page view. Expanded landing page view resource names have the form: customers/{customer_id}/expandedLandingPageViews/{expanded_final_url_fingerprint}
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.
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.
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.
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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.
MobileFriendlyClicksPercentage	Double	METRIC	The percentage of mobile clicks that go to a mobile-friendly page.
SpeedScore	Long	METRIC	A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest.
ValidAcceleratedMobilePagesClicksPercentage	Double	METRIC	The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.
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.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

Experiment

A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ExperimentDescription	String	ATTRIBUTE	The description of the experiment. It must have a minimum length of 1 and maximum length of 2048.
ExperimentEndDate	String	ATTRIBUTE	Date when the experiment ends. By default, the experiment ends on the campaign's end date. If this field is set, then the experiment ends at the end of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-04-18
ExperimentExperimentId	Long	ATTRIBUTE	Output only. The ID of the experiment. Read only.
ExperimentGoals	String	ATTRIBUTE	The goals of this experiment.
ExperimentLongRunningOperation	String	ATTRIBUTE	Output only. The resource name of the long-running operation that can be used to poll for completion of experiment schedule or promote. The most recent long running operation is returned.
ExperimentName	String	ATTRIBUTE	Required. The name of the experiment. It must have a minimum length of 1 and maximum length of 1024. It must be unique under a customer.
ExperimentPromoteStatus	String	ATTRIBUTE	Output only. The status of the experiment promotion process. The allowed values are COMPLETED, COMPLETED_WITH_WARNING, FAILED, IN_PROGRESS, NOT_STARTED, UNKNOWN, UNSPECIFIED.
ExperimentResourceName	String	ATTRIBUTE	Immutable. The resource name of the experiment. Experiment resource names have the form: customers/{customer_id}/experiments/{experiment_id}
ExperimentStartDate	String	ATTRIBUTE	Date when the experiment starts. By default, the experiment starts now or on the campaign's start date, whichever is later. If this field is set, then the experiment starts at the beginning of the specified date in the customer's time zone. Format: YYYY-MM-DD Example: 2019-03-14
ExperimentStatus	String	ATTRIBUTE	The Advertiser-chosen status of this experiment. The allowed values are ENABLED, GRADUATED, HALTED, INITIATED, PROMOTED, REMOVED, SETUP, UNKNOWN, UNSPECIFIED.
ExperimentSuffix	String	ATTRIBUTE	For system managed experiments, the advertiser must provide a suffix during construction, in the setup stage before moving to initiated. The suffix will be appended to the in-design and experiment campaign names so that the name is base campaign name + suffix.
ExperimentType	String	ATTRIBUTE	Required. The product/feature that uses this experiment. The allowed values are AD_VARIATION, DISPLAY_AND_VIDEO_360, DISPLAY_AUTOMATED_BIDDING_STRATEGY, DISPLAY_CUSTOM, HOTEL_CUSTOM, SEARCH_AUTOMATED_BIDDING_STRATEGY, SEARCH_CUSTOM, SHOPPING_AUTOMATED_BIDDING_STRATEGY, SMART_MATCHING, UNKNOWN, UNSPECIFIED, YOUTUBE_CUSTOM.

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.

ExperimentArm

A Google ads experiment for users to experiment changes on multiple campaigns, compare the performance, and apply the effective changes.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ExperimentArmCampaigns	String	ATTRIBUTE	List of campaigns in the trial arm. The max length is one.
ExperimentArmControl	Bool	ATTRIBUTE	Whether this arm is a control arm. A control arm is the arm against which the other arms are compared.
ExperimentArmExperiment	String	ATTRIBUTE	Immutable. The experiment to which the ExperimentArm belongs.
ExperimentArmInDesignCampaigns	String	ATTRIBUTE	Output only. The in design campaigns in the treatment experiment arm.
ExperimentArmName	String	ATTRIBUTE	Required. The name of the experiment arm. It must have a minimum length of 1 and maximum length of 1024. It must be unique under an experiment.
ExperimentArmResourceName	String	ATTRIBUTE	Immutable. The resource name of the experiment arm. Experiment arm resource names have the form: customers/{customer_id}/experimentArms/{TrialArm.trial_id}~{TrialArm.trial_arm_id}

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.

ExtensionFeedItem

An extension feed item.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ExtensionFeedItemAdSchedules	String	ATTRIBUTE	List of non-overlapping schedules specifying all time intervals for which the feed item may serve. There can be a maximum of 6 schedules per day.
ExtensionFeedItemAffiliateLocationFeedItemAddressLine1	String	ATTRIBUTE	Line 1 of the business address.
ExtensionFeedItemAffiliateLocationFeedItemAddressLine2	String	ATTRIBUTE	Line 2 of the business address.
ExtensionFeedItemAffiliateLocationFeedItemBusinessName	String	ATTRIBUTE	The name of the business.
ExtensionFeedItemAffiliateLocationFeedItemChainId	Long	ATTRIBUTE	Id of the retail chain that is advertised as a seller of your product.
ExtensionFeedItemAffiliateLocationFeedItemChainName	String	ATTRIBUTE	Name of chain.
ExtensionFeedItemAffiliateLocationFeedItemCity	String	ATTRIBUTE	City of the business address.
ExtensionFeedItemAffiliateLocationFeedItemCountryCode	String	ATTRIBUTE	Country code of the business address.
ExtensionFeedItemAffiliateLocationFeedItemPhoneNumber	String	ATTRIBUTE	Phone number of the business.
ExtensionFeedItemAffiliateLocationFeedItemPostalCode	String	ATTRIBUTE	Postal code of the business address.
ExtensionFeedItemAffiliateLocationFeedItemProvince	String	ATTRIBUTE	Province of the business address.
ExtensionFeedItemAppFeedItemAppId	String	ATTRIBUTE	The store-specific ID for the target application. This string must not be empty.
ExtensionFeedItemAppFeedItemAppStore	String	ATTRIBUTE	The application store that the target application belongs to. This field is required. The allowed values are APPLE_ITUNES, GOOGLE_PLAY, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemAppFeedItemFinalMobileUrls	String	ATTRIBUTE	A list of possible final mobile URLs after all cross domain redirects.
ExtensionFeedItemAppFeedItemFinalUrlSuffix	String	ATTRIBUTE	URL template for appending params to landing page URLs served with parallel tracking.
ExtensionFeedItemAppFeedItemFinalUrls	String	ATTRIBUTE	A list of possible final URLs after all cross domain redirects. This list must not be empty.
ExtensionFeedItemAppFeedItemLinkText	String	ATTRIBUTE	The visible text displayed when the link is rendered in an ad. This string must not be empty, and the length of this string should be between 1 and 25, inclusive.
ExtensionFeedItemAppFeedItemTrackingUrlTemplate	String	ATTRIBUTE	URL template for constructing a tracking URL. Default value is '{lpurl}'.
ExtensionFeedItemCallFeedItemCallConversionAction	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_tracking_enabled is set to true. Otherwise this field is ignored.
ExtensionFeedItemCallFeedItemCallConversionReportingState	String	ATTRIBUTE	Enum value that indicates whether this call extension uses its own call conversion setting (or just have call conversion disabled), or following the account level setting. The allowed values are DISABLED, UNKNOWN, UNSPECIFIED, USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION, USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
ExtensionFeedItemCallFeedItemCallConversionTrackingDisabled	Bool	ATTRIBUTE	If true, disable call conversion tracking. call_conversion_action should not be set if this is true. Optional.
ExtensionFeedItemCallFeedItemCallTrackingEnabled	Bool	ATTRIBUTE	Indicates whether call tracking is enabled. By default, call tracking is not enabled.
ExtensionFeedItemCallFeedItemCountryCode	String	ATTRIBUTE	Uppercase two-letter country code of the advertiser's phone number. This string must not be empty.
ExtensionFeedItemCallFeedItemPhoneNumber	String	ATTRIBUTE	The advertiser's phone number to append to the ad. This string must not be empty.
ExtensionFeedItemCalloutFeedItemCalloutText	String	ATTRIBUTE	The callout text. The length of this string should be between 1 and 25, inclusive.
ExtensionFeedItemDevice	String	ATTRIBUTE	The targeted device. The allowed values are MOBILE, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemEndDateTime	Date	ATTRIBUTE	End time in which this feed item is no longer effective and will stop serving. The time is in the customer's time zone. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
ExtensionFeedItemExtensionType	String	ATTRIBUTE	Output only. The extension type of the extension feed item. This field is read-only. The allowed values are AFFILIATE_LOCATION, APP, CALL, CALLOUT, HOTEL_CALLOUT, IMAGE, LOCATION, MESSAGE, NONE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemHotelCalloutFeedItemLanguageCode	String	ATTRIBUTE	The language of the hotel callout text. IETF BCP 47 compliant language code.
ExtensionFeedItemHotelCalloutFeedItemText	String	ATTRIBUTE	The callout text. The length of this string should be between 1 and 25, inclusive.
ExtensionFeedItemId	Long	ATTRIBUTE	Output only. The ID of this feed item. Read-only.
ExtensionFeedItemImageFeedItemImageAsset	String	ATTRIBUTE	Required. Resource name of the image asset.
ExtensionFeedItemLocationFeedItemAddressLine1	String	ATTRIBUTE	Line 1 of the business address.
ExtensionFeedItemLocationFeedItemAddressLine2	String	ATTRIBUTE	Line 2 of the business address.
ExtensionFeedItemLocationFeedItemBusinessName	String	ATTRIBUTE	The name of the business.
ExtensionFeedItemLocationFeedItemCity	String	ATTRIBUTE	City of the business address.
ExtensionFeedItemLocationFeedItemCountryCode	String	ATTRIBUTE	Country code of the business address.
ExtensionFeedItemLocationFeedItemPhoneNumber	String	ATTRIBUTE	Phone number of the business.
ExtensionFeedItemLocationFeedItemPostalCode	String	ATTRIBUTE	Postal code of the business address.
ExtensionFeedItemLocationFeedItemProvince	String	ATTRIBUTE	Province of the business address.
ExtensionFeedItemPriceFeedItemFinalUrlSuffix	String	ATTRIBUTE	Tracking URL template for all offers of this price extension.
ExtensionFeedItemPriceFeedItemLanguageCode	String	ATTRIBUTE	The code of the language used for this price extension.
ExtensionFeedItemPriceFeedItemPriceOfferings	String	ATTRIBUTE	The price offerings in this price extension.
ExtensionFeedItemPriceFeedItemPriceQualifier	String	ATTRIBUTE	Price qualifier for all offers of this price extension. The allowed values are AVERAGE, FROM, UNKNOWN, UNSPECIFIED, UP_TO.
ExtensionFeedItemPriceFeedItemTrackingUrlTemplate	String	ATTRIBUTE	Tracking URL template for all offers of this price extension.
ExtensionFeedItemPriceFeedItemType	String	ATTRIBUTE	Price extension type of this extension. The allowed values are BRANDS, EVENTS, LOCATIONS, NEIGHBORHOODS, PRODUCT_CATEGORIES, PRODUCT_TIERS, SERVICES, SERVICE_CATEGORIES, SERVICE_TIERS, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemPromotionFeedItemDiscountModifier	String	ATTRIBUTE	Enum that modifies the qualification of the discount. The allowed values are UNKNOWN, UNSPECIFIED, UP_TO.
ExtensionFeedItemPromotionFeedItemFinalMobileUrls	String	ATTRIBUTE	A list of possible final mobile URLs after all cross domain redirects.
ExtensionFeedItemPromotionFeedItemFinalUrlSuffix	String	ATTRIBUTE	URL template for appending params to landing page URLs served with parallel tracking.
ExtensionFeedItemPromotionFeedItemFinalUrls	String	ATTRIBUTE	A list of possible final URLs after all cross domain redirects. This field is required.
ExtensionFeedItemPromotionFeedItemLanguageCode	String	ATTRIBUTE	The language of the promotion. Represented as BCP 47 language tag.
ExtensionFeedItemPromotionFeedItemMoneyAmountOffAmountMicros	Long	ATTRIBUTE	Amount in micros. One million is equivalent to one unit.
ExtensionFeedItemPromotionFeedItemMoneyAmountOffCurrencyCode	String	ATTRIBUTE	Three-character ISO 4217 currency code.
ExtensionFeedItemPromotionFeedItemOccasion	String	ATTRIBUTE	The occasion the promotion was intended for. If an occasion is set, the redemption window will need to fall within the date range associated with the occasion. The allowed values are BACK_TO_SCHOOL, BLACK_FRIDAY, BOXING_DAY, CARNIVAL, CHINESE_NEW_YEAR, CHRISTMAS, CYBER_MONDAY, DIWALI, EASTER, EID_AL_ADHA, EID_AL_FITR, END_OF_SEASON, EPIPHANY, FALL_SALE, FATHERS_DAY, HALLOWEEN, HANUKKAH, HOLI, INDEPENDENCE_DAY, LABOR_DAY, MOTHERS_DAY, NATIONAL_DAY, NAVRATRI, NEW_YEARS, PARENTS_DAY, PASSOVER, RAMADAN, ROSH_HASHANAH, SINGLES_DAY, SONGKRAN, SPRING_SALE, ST_NICHOLAS_DAY, SUMMER_SALE, UNKNOWN, UNSPECIFIED, VALENTINES_DAY, WINTER_SALE, WOMENS_DAY, YEAR_END_GIFT.
ExtensionFeedItemPromotionFeedItemOrdersOverAmountAmountMicros	Long	ATTRIBUTE	Amount in micros. One million is equivalent to one unit.
ExtensionFeedItemPromotionFeedItemOrdersOverAmountCurrencyCode	String	ATTRIBUTE	Three-character ISO 4217 currency code.
ExtensionFeedItemPromotionFeedItemPercentOff	Long	ATTRIBUTE	Percentage off discount in the promotion in micros. One million is equivalent to one percent. Either this or money_off_amount is required.
ExtensionFeedItemPromotionFeedItemPromotionCode	String	ATTRIBUTE	A code the user should use in order to be eligible for the promotion.
ExtensionFeedItemPromotionFeedItemPromotionEndDate	Date	ATTRIBUTE	Last date when the promotion is eligible to be redeemed.
ExtensionFeedItemPromotionFeedItemPromotionStartDate	Date	ATTRIBUTE	Start date of when the promotion is eligible to be redeemed.
ExtensionFeedItemPromotionFeedItemPromotionTarget	String	ATTRIBUTE	A freeform description of what the promotion is targeting. This field is required.
ExtensionFeedItemPromotionFeedItemTrackingUrlTemplate	String	ATTRIBUTE	URL template for constructing a tracking URL.
ExtensionFeedItemResourceName	String	ATTRIBUTE	Immutable. The resource name of the extension feed item. Extension feed item resource names have the form: customers/{customer_id}/extensionFeedItems/{feed_item_id}
ExtensionFeedItemSitelinkFeedItemFinalMobileUrls	String	ATTRIBUTE	A list of possible final mobile URLs after all cross domain redirects.
ExtensionFeedItemSitelinkFeedItemFinalUrlSuffix	String	ATTRIBUTE	Final URL suffix to be appended to landing page URLs served with parallel tracking.
ExtensionFeedItemSitelinkFeedItemFinalUrls	String	ATTRIBUTE	A list of possible final URLs after all cross domain redirects.
ExtensionFeedItemSitelinkFeedItemLine1	String	ATTRIBUTE	First line of the description for the sitelink. If this value is set, line2 must also be set. The length of this string should be between 0 and 35, inclusive.
ExtensionFeedItemSitelinkFeedItemLine2	String	ATTRIBUTE	Second line of the description for the sitelink. If this value is set, line1 must also be set. The length of this string should be between 0 and 35, inclusive.
ExtensionFeedItemSitelinkFeedItemLinkText	String	ATTRIBUTE	URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.
ExtensionFeedItemSitelinkFeedItemTrackingUrlTemplate	String	ATTRIBUTE	URL template for constructing a tracking URL.
ExtensionFeedItemStartDateTime	Date	ATTRIBUTE	Start time in which this feed item is effective and can begin serving. The time is in the customer's time zone. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
ExtensionFeedItemStatus	String	ATTRIBUTE	Output only. Status of the feed item. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemStructuredSnippetFeedItemHeader	String	ATTRIBUTE	The header of the snippet. This string must not be empty.
ExtensionFeedItemStructuredSnippetFeedItemValues	String	ATTRIBUTE	The values in the snippet. The maximum size of this collection is 10.
ExtensionFeedItemTargetedAdGroup	String	ATTRIBUTE	The targeted ad group.
ExtensionFeedItemTargetedCampaign	String	ATTRIBUTE	The targeted campaign.
ExtensionFeedItemTargetedGeoTargetConstant	String	ATTRIBUTE	The targeted geo target constant.
ExtensionFeedItemTargetedKeywordMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
ExtensionFeedItemTargetedKeywordText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
ExtensionFeedItemTextMessageFeedItemBusinessName	String	ATTRIBUTE	The business name to prepend to the message text. This field is required.
ExtensionFeedItemTextMessageFeedItemCountryCode	String	ATTRIBUTE	Uppercase two-letter country code of the advertiser's phone number. This field is required.
ExtensionFeedItemTextMessageFeedItemExtensionText	String	ATTRIBUTE	The message extension_text populated in the messaging app.
ExtensionFeedItemTextMessageFeedItemPhoneNumber	String	ATTRIBUTE	The advertiser's phone number the message will be sent to. Required.
ExtensionFeedItemTextMessageFeedItemText	String	ATTRIBUTE	The text to show in the ad. This field is required.
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.
AllConversionsFromClickToCall	Double	METRIC	The number of times people clicked the 'Call' button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.
AllConversionsFromDirections	Double	METRIC	The number of times people clicked a 'Get directions' button to navigate to a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromInteractionsRate	Double	METRIC	All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
AllConversionsFromMenu	Double	METRIC	The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
AllConversionsFromOrder	Double	METRIC	The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromOtherEngagement	Double	METRIC	The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.
AllConversionsFromStoreVisit	Double	METRIC	Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
AllConversionsFromStoreWebsite	Double	METRIC	The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
AllConversionsValue	Double	METRIC	The value of all conversions.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
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).
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
MessageChatRate	Double	METRIC	Number of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression.
MessageChats	Long	METRIC	Number of message chats initiated for Click To Message impressions that were message tracking eligible.
MessageImpressions	Long	METRIC	Number of Click To Message impressions that were message tracking eligible.
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.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
InteractionOnThisExtension	Bool	SEGMENT	Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.
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, for example, 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, for example, 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.

Feed

A feed.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedAffiliateLocationFeedDataChainIds	String	ATTRIBUTE	The list of chains that the affiliate location feed will sync the locations from.
FeedAffiliateLocationFeedDataRelationshipType	String	ATTRIBUTE	The relationship the chains have with the advertiser. The allowed values are GENERAL_RETAILER, UNKNOWN, UNSPECIFIED.
FeedAttributes	String	ATTRIBUTE	The Feed's attributes. Required on CREATE, unless system_feed_generation_data is provided, in which case Google Ads will update the feed with the correct attributes. Disallowed on UPDATE. Use attribute_operations to add new attributes.
FeedId	Long	ATTRIBUTE	Output only. The ID of the feed. This field is read-only.
FeedName	String	ATTRIBUTE	Immutable. Name of the feed. Required.
FeedOrigin	String	ATTRIBUTE	Immutable. Specifies who manages the FeedAttributes for the Feed. The allowed values are GOOGLE, UNKNOWN, UNSPECIFIED, USER.
FeedPlacesLocationFeedDataBusinessNameFilter	String	ATTRIBUTE	Used to filter Business Profile listings by business name. If business_name_filter is set, only listings with a matching business name are candidates to be sync'd into FeedItems.
FeedPlacesLocationFeedDataCategoryFilters	String	ATTRIBUTE	Used to filter Business Profile listings by categories. If entries exist in category_filters, only listings that belong to any of the categories are candidates to be sync'd into FeedItems. If no entries exist in category_filters, then all listings are candidates for syncing.
FeedPlacesLocationFeedDataEmailAddress	String	ATTRIBUTE	Email address of a Business Profile or email address of a manager of the Business Profile. Required.
FeedPlacesLocationFeedDataLabelFilters	String	ATTRIBUTE	Used to filter Business Profile listings by labels. If entries exist in label_filters, only listings that has any of the labels set are candidates to be synchronized into FeedItems. If no entries exist in label_filters, then all listings are candidates for syncing.
FeedResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed. Feed resource names have the form: customers/{customer_id}/feeds/{feed_id}
FeedStatus	String	ATTRIBUTE	Output only. Status of the feed. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

FeedItem

A feed item.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedItemAttributeValues	String	ATTRIBUTE	The feed item's attribute values.
FeedItemEndDateTime	Date	ATTRIBUTE	End time in which this feed item is no longer effective and will stop serving. The time is in the customer's time zone. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
FeedItemFeed	String	ATTRIBUTE	Immutable. The feed to which this feed item belongs.
FeedItemGeoTargetingRestriction	String	ATTRIBUTE	Geo targeting restriction specifies the type of location that can be used for targeting. The allowed values are LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
FeedItemId	Long	ATTRIBUTE	Output only. The ID of this feed item.
FeedItemPolicyInfos	String	ATTRIBUTE	Output only. List of info about a feed item's validation and approval state for active feed mappings. There will be an entry in the list for each type of feed mapping associated with the feed, for example, a feed with a sitelink and a call feed mapping would cause every feed item associated with that feed to have an entry in this list for both sitelink and call. This field is read-only.
FeedItemResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed item. Feed item resource names have the form: customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}
FeedItemStartDateTime	Date	ATTRIBUTE	Start time in which this feed item is effective and can begin serving. The time is in the customer's time zone. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
FeedItemStatus	String	ATTRIBUTE	Output only. Status of the feed item. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
FeedItemUrlCustomParameters	String	ATTRIBUTE	The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
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.
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.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
InteractionOnThisExtension	Bool	SEGMENT	Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.
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, for example, 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.
PlaceholderType	String	SEGMENT	Placeholder type. This is only used with feed item metrics. The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
Quarter	Date	SEGMENT	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, 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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedItemSetDisplayName	String	ATTRIBUTE	Name of the set. Must be unique within the account.
FeedItemSetDynamicAffiliateLocationSetFilterChainIds	String	ATTRIBUTE	Used to filter affiliate locations by chain ids. Only affiliate locations that belong to the specified chain(s) will be added to the FeedItemSet.
FeedItemSetDynamicLocationSetFilterBusinessNameFilterBusinessName	String	ATTRIBUTE	Business name string to use for filtering.
FeedItemSetDynamicLocationSetFilterBusinessNameFilterFilterType	String	ATTRIBUTE	The type of string matching to use when filtering with business_name. The allowed values are EXACT, UNKNOWN, UNSPECIFIED.
FeedItemSetDynamicLocationSetFilterLabels	String	ATTRIBUTE	If multiple labels are set, then only feeditems marked with all the labels will be added to the FeedItemSet.
FeedItemSetFeed	String	ATTRIBUTE	Immutable. The resource name of the feed containing the feed items in the set. Immutable. Required.
FeedItemSetFeedItemSetId	Long	ATTRIBUTE	Output only. ID of the set.
FeedItemSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed item set. Feed item set resource names have the form: customers/{customer_id}/feedItemSets/{feed_id}~{feed_item_set_id}
FeedItemSetStatus	String	ATTRIBUTE	Output only. Status of the feed item set. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

FeedItemSetLink

Represents a link between a FeedItem and a FeedItemSet.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedItemSetLinkFeedItem	String	ATTRIBUTE	Immutable. The linked FeedItem.
FeedItemSetLinkFeedItemSet	String	ATTRIBUTE	Immutable. The linked FeedItemSet.
FeedItemSetLinkResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed item set link. Feed item set link resource names have the form: customers/{customer_id}/feedItemSetLinks/{feed_id}~{feed_item_set_id}~{feed_item_id}

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.

FeedItemTarget

A feed item target.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedItemTargetAdGroup	String	ATTRIBUTE	Immutable. The targeted ad group.
FeedItemTargetAdSchedule	String	ATTRIBUTE	Immutable. The targeted schedule.
FeedItemTargetAdScheduleDayOfWeek	String	ATTRIBUTE	Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
FeedItemTargetCampaign	String	ATTRIBUTE	Immutable. The targeted campaign.
FeedItemTargetDevice	String	ATTRIBUTE	Immutable. The targeted device. The allowed values are MOBILE, UNKNOWN, UNSPECIFIED.
FeedItemTargetFeedItem	String	ATTRIBUTE	Immutable. The feed item to which this feed item target belongs.
FeedItemTargetFeedItemTargetId	Long	ATTRIBUTE	Output only. The ID of the targeted resource. This field is read-only.
FeedItemTargetFeedItemTargetType	String	ATTRIBUTE	Output only. The target type of this feed item target. This field is read-only. The allowed values are AD_GROUP, CAMPAIGN, CRITERION, UNKNOWN, UNSPECIFIED.
FeedItemTargetGeoTargetConstant	String	ATTRIBUTE	Immutable. The targeted geo target constant resource name.
FeedItemTargetKeywordMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
FeedItemTargetKeywordText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
FeedItemTargetResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed item target. Feed item target resource names have the form: customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}
FeedItemTargetStatus	String	ATTRIBUTE	Output only. Status of the feed item target. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

FeedMapping

A feed mapping.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedMappingAttributeFieldMappings	String	ATTRIBUTE	Immutable. Feed attributes to field mappings. These mappings are a one-to-many relationship meaning that 1 feed attribute can be used to populate multiple placeholder fields, but 1 placeholder field can only draw data from 1 feed attribute. Ad Customizer is an exception, 1 placeholder field can be mapped to multiple feed attributes. Required.
FeedMappingCriterionType	String	ATTRIBUTE	Immutable. The criterion type of this mapping (for example, if the mapping maps feed attributes to criterion fields). The allowed values are DSA_PAGE_FEED, LOCATION_EXTENSION_TARGETING, UNKNOWN, UNSPECIFIED.
FeedMappingFeed	String	ATTRIBUTE	Immutable. The feed of this feed mapping.
FeedMappingPlaceholderType	String	ATTRIBUTE	Immutable. The placeholder type of this mapping (for example, if the mapping maps feed attributes to placeholder fields). The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
FeedMappingResourceName	String	ATTRIBUTE	Immutable. The resource name of the feed mapping. Feed mapping resource names have the form: customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}
FeedMappingStatus	String	ATTRIBUTE	Output only. Status of the feed mapping. This field is read-only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.

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.

FeedPlaceholderView

A feed placeholder view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
FeedPlaceholderViewPlaceholderType	String	ATTRIBUTE	Output only. The placeholder type of the feed placeholder view. The allowed values are AD_CUSTOMIZER, AFFILIATE_LOCATION, APP, CALL, CALLOUT, DYNAMIC_CUSTOM, DYNAMIC_EDUCATION, DYNAMIC_FLIGHT, DYNAMIC_HOTEL, DYNAMIC_JOB, DYNAMIC_LOCAL, DYNAMIC_REAL_ESTATE, DYNAMIC_TRAVEL, IMAGE, LOCATION, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, UNKNOWN, UNSPECIFIED.
FeedPlaceholderViewResourceName	String	ATTRIBUTE	Output only. The resource name of the feed placeholder view. Feed placeholder view resource names have the form: customers/{customer_id}/feedPlaceholderViews/{placeholder_type}
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

GenderView

A gender view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
GenderViewResourceName	String	ATTRIBUTE	Output only. The resource name of the gender view. Gender view resource names have the form: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
GeographicViewCountryCriterionId	Long	ATTRIBUTE	Output only. Criterion Id for the country.
GeographicViewLocationType	String	ATTRIBUTE	Output only. Type of the geo targeting of the campaign. The allowed values are AREA_OF_INTEREST, LOCATION_OF_PRESENCE, UNKNOWN, UNSPECIFIED.
GeographicViewResourceName	String	ATTRIBUTE	Output only. The resource name of the geographic view. Geographic view resource names have the form: customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type}
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.
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).
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.
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.
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 (for example, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
GeoTargetAirport	String	SEGMENT	Resource name of the geo target constant that represents an airport.
GeoTargetCanton	String	SEGMENT	Resource name of the geo target constant that represents a canton.
GeoTargetCity	String	SEGMENT	Resource name of the geo target constant that represents a city.
GeoTargetCounty	String	SEGMENT	Resource name of the geo target constant that represents a county.
GeoTargetDistrict	String	SEGMENT	Resource name of the geo target constant that represents a district.
GeoTargetMetro	String	SEGMENT	Resource name of the geo target constant that represents a metro.
GeoTargetMostSpecificLocation	String	SEGMENT	Resource name of the geo target constant that represents the most specific location.
GeoTargetPostalCode	String	SEGMENT	Resource name of the geo target constant that represents a postal code.
GeoTargetProvince	String	SEGMENT	Resource name of the geo target constant that represents a province.
GeoTargetRegion	String	SEGMENT	Resource name of the geo target constant that represents a region.
GeoTargetState	String	SEGMENT	Resource name of the geo target constant that represents a state.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

GeoTargetConstant

A geo target constant.

Columns

Name	Type	Behavior	Description
GeoTargetConstantCanonicalName	String	ATTRIBUTE	Output only. The fully qualified English name, consisting of the target's name and that of its parent and country.
GeoTargetConstantCountryCode	String	ATTRIBUTE	Output only. The ISO-3166-1 alpha-2 country code that is associated with the target.
GeoTargetConstantId	Long	ATTRIBUTE	Output only. The ID of the geo target constant.
GeoTargetConstantName	String	ATTRIBUTE	Output only. Geo target constant English name.
GeoTargetConstantParentGeoTarget	String	ATTRIBUTE	Output only. The resource name of the parent geo target constant. Geo target constant resource names have the form: geoTargetConstants/{parent_geo_target_constant_id}
GeoTargetConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the geo target constant. Geo target constant resource names have the form: geoTargetConstants/{geo_target_constant_id}
GeoTargetConstantStatus	String	ATTRIBUTE	Output only. Geo target constant status. The allowed values are ENABLED, REMOVAL_PLANNED, UNKNOWN, UNSPECIFIED.
GeoTargetConstantTargetType	String	ATTRIBUTE	Output only. Geo target constant target type.

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.

GroupPlacementView

A group placement view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
GroupPlacementViewDisplayName	String	ATTRIBUTE	Output only. Domain name for websites and YouTube channel name for YouTube channels.
GroupPlacementViewPlacement	String	ATTRIBUTE	Output only. The automatic placement string at group level, e. g. web domain, mobile app ID, or a YouTube channel ID.
GroupPlacementViewPlacementType	String	ATTRIBUTE	Output only. Type of the placement, for example, Website, YouTube Channel, Mobile Application. The allowed values are MOBILE_APPLICATION, MOBILE_APP_CATEGORY, UNKNOWN, UNSPECIFIED, WEBSITE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
GroupPlacementViewResourceName	String	ATTRIBUTE	Output only. The resource name of the group placement view. Group placement view resource names have the form: customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}
GroupPlacementViewTargetUrl	String	ATTRIBUTE	Output only. URL of the group placement, for example, domain, link to the mobile application in app store, or a YouTube channel URL.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

HotelGroupView

A hotel group view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
HotelGroupViewResourceName	String	ATTRIBUTE	Output only. The resource name of the hotel group view. Hotel Group view resource names have the form: customers/{customer_id}/hotelGroupViews/{ad_group_id}~{criterion_id}
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.
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.
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.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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).
HotelAverageLeadValueMicros	Double	METRIC	Average lead value based on clicks.
HotelEligibleImpressions	Long	METRIC	The number of impressions that hotel partners could have had given their feed performance.
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
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.
SearchBudgetLostImpressionShare	Double	METRIC	The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost 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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click 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.
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.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, MONDAY. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
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.
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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

HotelPerformanceView

A hotel performance view.

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
HotelPerformanceViewResourceName	String	ATTRIBUTE	Output only. The resource name of the hotel performance view. Hotel performance view resource names have the form: customers/{customer_id}/hotelPerformanceView
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.
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.
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.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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).
HotelAverageLeadValueMicros	Double	METRIC	Average lead value based on clicks.
HotelEligibleImpressions	Long	METRIC	The number of impressions that hotel partners could have had given their feed performance.
HotelPriceDifferencePercentage	Double	METRIC	The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser.
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
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.
SearchBudgetLostImpressionShare	Double	METRIC	The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost 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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click 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.
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.
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, CROSS_NETWORK, 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.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
GeoTargetCountry	String	SEGMENT	Resource name of the geo target constant that represents a country.
HotelBookingWindowDays	Long	SEGMENT	Hotel booking window in days.
HotelCenterId	Long	SEGMENT	Hotel center ID.
HotelCheckInDate	Date	SEGMENT	Hotel check-in date. Formatted as yyyy-MM-dd.
HotelCheckInDayOfWeek	String	SEGMENT	Hotel check-in day of week. The allowed values are FRIDAY, MONDAY, SATURDAY, SUNDAY, THURSDAY, TUESDAY, UNKNOWN, UNSPECIFIED, WEDNESDAY.
HotelCity	String	SEGMENT	Hotel city.
HotelClass	Int	SEGMENT	Hotel class.
HotelCountry	String	SEGMENT	Hotel country.
HotelDateSelectionType	String	SEGMENT	Hotel date selection type. The allowed values are DEFAULT_SELECTION, UNKNOWN, UNSPECIFIED, USER_SELECTED.
HotelLengthOfStay	Int	SEGMENT	Hotel length of stay.
HotelPriceBucket	String	SEGMENT	Hotel price bucket. The allowed values are LOWEST_TIED, LOWEST_UNIQUE, NOT_LOWEST, ONLY_PARTNER_SHOWN, UNKNOWN, UNSPECIFIED.
HotelRateRuleId	String	SEGMENT	Hotel rate rule ID.
HotelRateType	String	SEGMENT	Hotel rate type. The allowed values are PRIVATE_RATE, PUBLIC_RATE, QUALIFIED_RATE, UNAVAILABLE, UNKNOWN, UNSPECIFIED.
HotelState	String	SEGMENT	Hotel state.
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.
PartnerHotelId	String	SEGMENT	Partner hotel ID.
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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

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 through Bulk Uploads.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
HotelReconciliationBilled	Bool	ATTRIBUTE	Output only. Whether a given booking has been billed. Once billed, a booking can't be modified.
HotelReconciliationCampaign	String	ATTRIBUTE	Output only. The resource name for the Campaign associated with the conversion.
HotelReconciliationCheckInDate	Date	ATTRIBUTE	Output only. Check-in date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD.
HotelReconciliationCheckOutDate	Date	ATTRIBUTE	Output only. Check-out date recorded when the booking is made. If the check-in date is modified at reconciliation, the revised date will then take the place of the original date in this column. Format is YYYY-MM-DD.
HotelReconciliationCommissionId	String	ATTRIBUTE	Required. Output only. The commission ID is Google's ID for this booking. Every booking event is assigned a Commission ID to help you match it to a guest stay.
HotelReconciliationHotelCenterId	Long	ATTRIBUTE	Output only. Identifier for the Hotel Center account which provides the rates for the Hotel campaign.
HotelReconciliationHotelId	String	ATTRIBUTE	Output only. Unique identifier for the booked property, as provided in the Hotel Center feed. The hotel ID comes from the 'ID' parameter of the conversion tracking tag.
HotelReconciliationOrderId	String	ATTRIBUTE	Output only. The order ID is the identifier for this booking as provided in the 'transaction_id' parameter of the conversion tracking tag.
HotelReconciliationReconciledValueMicros	Long	ATTRIBUTE	Required. Output only. Reconciled value is the final value of a booking as paid by the guest. If original booking value changes for any reason, such as itinerary changes or room upsells, the reconciled value should be the full final amount collected. If a booking is canceled, the reconciled value should include the value of any cancellation fees or non-refundable nights charged. Value is in millionths of the base unit currency. For example, $12.35 would be represented as 12350000. Currency unit is in the default customer currency.
HotelReconciliationResourceName	String	ATTRIBUTE	Immutable. The resource name of the hotel reconciliation. Hotel reconciliation resource names have the form: customers/{customer_id}/hotelReconciliations/{commission_id}
HotelReconciliationStatus	String	ATTRIBUTE	Required. Output only. Current status of a booking with regards to reconciliation and billing. Bookings should be reconciled within 45 days after the check-out date. Any booking not reconciled within 45 days will be billed at its original value. The allowed values are CANCELED, RECONCILED, RECONCILIATION_NEEDED, RESERVATION_ENABLED, UNKNOWN, UNSPECIFIED.
HotelCommissionRateMicros	Long	METRIC	Commission bid rate in micros. A 20% commission is represented as 200,000.
HotelExpectedCommissionCost	Double	METRIC	Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency.
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.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
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.

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.

IncomeRangeView

An income range view.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
IncomeRangeViewResourceName	String	ATTRIBUTE	Output only. The resource name of the income range view. Income range view resource names have the form: customers/{customer_id}/incomeRangeViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

KeywordPlan

A Keyword Planner plan. Max number of saved keyword plans: 10000. It's possible to remove plans if limit is reached.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordPlanForecastPeriod	String	ATTRIBUTE	The date period used for forecasting the plan.
KeywordPlanId	Long	ATTRIBUTE	Output only. The ID of the keyword plan.
KeywordPlanName	String	ATTRIBUTE	The name of the keyword plan. This field is required and should not be empty when creating new keyword plans.
KeywordPlanResourceName	String	ATTRIBUTE	Immutable. The resource name of the Keyword Planner plan. KeywordPlan resource names have the form: customers/{customer_id}/keywordPlans/{kp_plan_id}

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.

KeywordPlanAdGroup

A Keyword Planner ad group. Max number of keyword plan ad groups per plan: 200.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordPlanAdGroupCpcBidMicros	Long	ATTRIBUTE	A default ad group max cpc bid in micros in account currency for all biddable keywords under the keyword plan ad group. If not set, will inherit from parent campaign.
KeywordPlanAdGroupId	Long	ATTRIBUTE	Output only. The ID of the keyword plan ad group.
KeywordPlanAdGroupKeywordPlanCampaign	String	ATTRIBUTE	The keyword plan campaign to which this ad group belongs.
KeywordPlanAdGroupName	String	ATTRIBUTE	The name of the keyword plan ad group. This field is required and should not be empty when creating keyword plan ad group.
KeywordPlanAdGroupResourceName	String	ATTRIBUTE	Immutable. The resource name of the Keyword Planner ad group. KeywordPlanAdGroup resource names have the form: customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}

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.

KeywordPlanAdGroupKeyword

A Keyword Plan ad group keyword. Max number of keyword plan keywords per plan: 10000.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordPlanAdGroupKeywordCpcBidMicros	Long	ATTRIBUTE	A keyword level max cpc bid in micros (for example, $1 = 1mm). The currency is the same as the account currency code. This will override any CPC bid set at the keyword plan ad group level. Not applicable for negative keywords. (negative = true) This field is Optional.
KeywordPlanAdGroupKeywordId	Long	ATTRIBUTE	Output only. The ID of the Keyword Plan keyword.
KeywordPlanAdGroupKeywordKeywordPlanAdGroup	String	ATTRIBUTE	The Keyword Plan ad group to which this keyword belongs.
KeywordPlanAdGroupKeywordMatchType	String	ATTRIBUTE	The keyword match type. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordPlanAdGroupKeywordNegative	Bool	ATTRIBUTE	Immutable. If true, the keyword is negative.
KeywordPlanAdGroupKeywordResourceName	String	ATTRIBUTE	Immutable. The resource name of the Keyword Plan ad group keyword. KeywordPlanAdGroupKeyword resource names have the form: customers/{customer_id}/keywordPlanAdGroupKeywords/{kp_ad_group_keyword_id}
KeywordPlanAdGroupKeywordText	String	ATTRIBUTE	The keyword text.

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.

KeywordPlanCampaign

A Keyword Plan campaign. Max number of keyword plan campaigns per plan allowed: 1.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordPlanCampaignCpcBidMicros	Long	ATTRIBUTE	A default max cpc bid in micros, and in the account currency, for all ad groups under the campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
KeywordPlanCampaignGeoTargets	String	ATTRIBUTE	The geo targets. Max number allowed: 20.
KeywordPlanCampaignId	Long	ATTRIBUTE	Output only. The ID of the Keyword Plan campaign.
KeywordPlanCampaignKeywordPlan	String	ATTRIBUTE	The keyword plan this campaign belongs to.
KeywordPlanCampaignKeywordPlanNetwork	String	ATTRIBUTE	Targeting network. This field is required and should not be empty when creating Keyword Plan campaigns. The allowed values are GOOGLE_SEARCH, GOOGLE_SEARCH_AND_PARTNERS, UNKNOWN, UNSPECIFIED.
KeywordPlanCampaignLanguageConstants	String	ATTRIBUTE	The languages targeted for the Keyword Plan campaign. Max allowed: 1.
KeywordPlanCampaignName	String	ATTRIBUTE	The name of the Keyword Plan campaign. This field is required and should not be empty when creating Keyword Plan campaigns.
KeywordPlanCampaignResourceName	String	ATTRIBUTE	Immutable. The resource name of the Keyword Plan campaign. KeywordPlanCampaign resource names have the form: customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}

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.

KeywordPlanCampaignKeyword

A Keyword Plan Campaign keyword. Only negative keywords are supported for Campaign Keyword.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordPlanCampaignKeywordId	Long	ATTRIBUTE	Output only. The ID of the Keyword Plan negative keyword.
KeywordPlanCampaignKeywordKeywordPlanCampaign	String	ATTRIBUTE	The Keyword Plan campaign to which this negative keyword belongs.
KeywordPlanCampaignKeywordMatchType	String	ATTRIBUTE	The keyword match type. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
KeywordPlanCampaignKeywordNegative	Bool	ATTRIBUTE	Immutable. If true, the keyword is negative. Must be set to true. Only negative campaign keywords are supported.
KeywordPlanCampaignKeywordResourceName	String	ATTRIBUTE	Immutable. The resource name of the Keyword Plan Campaign keyword. KeywordPlanCampaignKeyword resource names have the form: customers/{customer_id}/keywordPlanCampaignKeywords/{kp_campaign_keyword_id}
KeywordPlanCampaignKeywordText	String	ATTRIBUTE	The keyword text.

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.

KeywordThemeConstant

A Smart Campaign keyword theme constant.

Columns

Name	Type	Behavior	Description
KeywordThemeConstantCountryCode	String	ATTRIBUTE	Output only. The ISO-3166 Alpha-2 country code of the constant, eg. 'US'. To display and query matching purpose, the keyword theme needs to be localized.
KeywordThemeConstantDisplayName	String	ATTRIBUTE	Output only. The display name of the keyword theme or sub keyword theme.
KeywordThemeConstantLanguageCode	String	ATTRIBUTE	Output only. The ISO-639-1 language code with 2 letters of the constant, eg. 'en'. To display and query matching purpose, the keyword theme needs to be localized.
KeywordThemeConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the keyword theme constant. Keyword theme constant resource names have the form: keywordThemeConstants/{keyword_theme_id}~{sub_keyword_theme_id}

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.

KeywordView

A keyword view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
KeywordViewResourceName	String	ATTRIBUTE	Output only. The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
HistoricalCreativeQualityScore	String	METRIC	The creative historical quality score. The allowed values are UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalLandingPageQualityScore	String	METRIC	The quality of historical landing page experience. The allowed values are UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
HistoricalQualityScore	Long	METRIC	The historical quality score.
HistoricalSearchPredictedCtr	String	METRIC	The historical search predicted click through rate (CTR). The allowed values are UNSPECIFIED, UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.
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.
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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
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 (for example, 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.
AuctionInsightDomain	String	SEGMENT	Domain (visible URL) of a participant in the Auction Insights report.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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 versus 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

Label

A label.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
LabelId	Long	ATTRIBUTE	Output only. ID of the label. Read only.
LabelName	String	ATTRIBUTE	The name of the label. This field is required and should not be empty when creating a new label. The length of this string should be between 1 and 80, inclusive.
LabelResourceName	String	ATTRIBUTE	Immutable. Name of the resource. Label resource names have the form: customers/{customer_id}/labels/{label_id}
LabelStatus	String	ATTRIBUTE	Output only. Status of the label. Read only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
LabelTextLabelBackgroundColor	String	ATTRIBUTE	Background color of the label in RGB format. This string must match the regular expression '^\\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.
LabelTextLabelDescription	String	ATTRIBUTE	A short description of the label. The length must be no more than 200 characters.

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.

LandingPageView

A landing page view with metrics aggregated at the unexpanded final URL 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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
LandingPageViewResourceName	String	ATTRIBUTE	Output only. The resource name of the landing page view. Landing page view resource names have the form: customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}
LandingPageViewUnexpandedFinalUrl	String	ATTRIBUTE	Output only. The advertiser-specified final URL.
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.
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.
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.
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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.
MobileFriendlyClicksPercentage	Double	METRIC	The percentage of mobile clicks that go to a mobile-friendly page.
SpeedScore	Long	METRIC	A measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest.
ValidAcceleratedMobilePagesClicksPercentage	Double	METRIC	The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.
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.
ClickType	String	SEGMENT	Click type. The allowed values are APP_DEEPLINK, BREADCRUMBS, BROADBAND_PLAN, CALLS, CALL_TRACKING, CLICK_ON_ENGAGEMENT_AD, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.

LanguageConstant

A language.

Columns

Name	Type	Behavior	Description
LanguageConstantCode	String	ATTRIBUTE	Output only. The language code, for example, 'en_US', 'en_AU', 'es', 'fr', etc.
LanguageConstantId	Long	ATTRIBUTE	Output only. The ID of the language constant.
LanguageConstantName	String	ATTRIBUTE	Output only. The full name of the language in English, for example, 'English (US)', 'Spanish', etc.
LanguageConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the language constant. Language constant resource names have the form: languageConstants/{criterion_id}
LanguageConstantTargetable	Bool	ATTRIBUTE	Output only. Whether the language is targetable.

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.

LeadFormSubmissionData

Data from lead form submissions.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
LeadFormSubmissionDataAdGroup	String	ATTRIBUTE	Output only. AdGroup associated with the submitted lead form.
LeadFormSubmissionDataAdGroupAd	String	ATTRIBUTE	Output only. AdGroupAd associated with the submitted lead form.
LeadFormSubmissionDataAsset	String	ATTRIBUTE	Output only. Asset associated with the submitted lead form.
LeadFormSubmissionDataCampaign	String	ATTRIBUTE	Output only. Campaign associated with the submitted lead form.
LeadFormSubmissionDataCustomLeadFormSubmissionFields	String	ATTRIBUTE	Output only. Submission data associated with a custom lead form.
LeadFormSubmissionDataGclid	String	ATTRIBUTE	Output only. Google Click Id associated with the submissed lead form.
LeadFormSubmissionDataId	String	ATTRIBUTE	Output only. ID of this lead form submission.
LeadFormSubmissionDataLeadFormSubmissionFields	String	ATTRIBUTE	Output only. Submission data associated with a lead form.
LeadFormSubmissionDataResourceName	String	ATTRIBUTE	Output only. The resource name of the lead form submission data. Lead form submission data resource names have the form: customers/{customer_id}/leadFormSubmissionData/{lead_form_submission_data_id}
LeadFormSubmissionDataSubmissionDateTime	Date	ATTRIBUTE	Output only. The date and time at which the lead form was submitted. The format is 'yyyy-mm-dd hh:mm:ss+|-hh:mm', for example, '2019-01-01 12:32:45-08:00'.

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.

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.

Columns

Name	Type	Behavior	Description
LifeEventAvailabilities	String	ATTRIBUTE	Output only. Availability information of the life event.
LifeEventId	Long	ATTRIBUTE	Output only. The ID of the life event.
LifeEventLaunchedToAll	Bool	ATTRIBUTE	Output only. True if the life event is launched to all channels and locales.
LifeEventName	String	ATTRIBUTE	Output only. The name of the life event, for example,'Recently Moved'
LifeEventParent	String	ATTRIBUTE	Output only. The parent of the life_event.
LifeEventResourceName	String	ATTRIBUTE	Output only. The resource name of the life event. Life event resource names have the form: customers/{customer_id}/lifeEvents/{life_event_id}

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.

LocationView

A location view summarizes the performance of campaigns by Location criteria.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
LocationViewResourceName	String	ATTRIBUTE	Output only. The resource name of the location view. Location view resource names have the form: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}
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.
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.
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 (for example, clicking on) another ad.
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, for example, 2018-04-17.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

ManagedPlacementView

A managed placement view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ManagedPlacementViewResourceName	String	ATTRIBUTE	Output only. The resource name of the Managed Placement view. Managed placement view resource names have the form: customers/{customer_id}/managedPlacementViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

MediaFile

A media file.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
MediaFileAudioAdDurationMillis	Long	ATTRIBUTE	Output only. The duration of the Audio in milliseconds.
MediaFileFileSize	Long	ATTRIBUTE	Output only. The size of the media file in bytes.
MediaFileId	Long	ATTRIBUTE	Output only. The ID of the media file.
MediaFileImageFullSizeImageUrl	String	ATTRIBUTE	Output only. The url to the full size version of the image.
MediaFileImagePreviewSizeImageUrl	String	ATTRIBUTE	Output only. The url to the preview size version of the image.
MediaFileMediaBundleUrl	String	ATTRIBUTE	Output only. The url to access the uploaded zipped data. For example, https://tpc.googlesyndication.com/simgad/123 This field is read-only.
MediaFileMimeType	String	ATTRIBUTE	Output only. The mime type of the media file. 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.
MediaFileName	String	ATTRIBUTE	Immutable. The name of the media file. The name can be used by clients to help identify previously uploaded media.
MediaFileResourceName	String	ATTRIBUTE	Immutable. The resource name of the media file. Media file resource names have the form: customers/{customer_id}/mediaFiles/{media_file_id}
MediaFileSourceUrl	String	ATTRIBUTE	Immutable. The URL of where the original media file was downloaded from (or a file name). Only used for media of type AUDIO and IMAGE.
MediaFileType	String	ATTRIBUTE	Immutable. Type of the media file. The allowed values are AUDIO, DYNAMIC_IMAGE, ICON, IMAGE, MEDIA_BUNDLE, UNKNOWN, UNSPECIFIED, VIDEO.
MediaFileVideoAdDurationMillis	Long	ATTRIBUTE	Output only. The duration of the Video in milliseconds.
MediaFileVideoAdvertisingIdCode	String	ATTRIBUTE	Output only. The Advertising Digital Identification code for this video, as defined by the American Association of Advertising Agencies, used mainly for television commercials.
MediaFileVideoIsciCode	String	ATTRIBUTE	Output only. The Industry Standard Commercial Identifier code for this video, used mainly for television commercials.
MediaFileVideoYoutubeVideoId	String	ATTRIBUTE	Immutable. The YouTube video ID (as seen in YouTube URLs). Adding prefix 'https://www.youtube.com/watch?v=' to this ID will get the YouTube streaming URL for this video.

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.

MobileAppCategoryConstant

A mobile application category constant.

Columns

Name	Type	Behavior	Description
MobileAppCategoryConstantId	Int	ATTRIBUTE	Output only. The ID of the mobile app category constant.
MobileAppCategoryConstantName	String	ATTRIBUTE	Output only. Mobile app category name.
MobileAppCategoryConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the mobile app category constant. Mobile app category constant resource names have the form: mobileAppCategoryConstants/{mobile_app_category_id}

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.

MobileDeviceConstant

A mobile device constant.

Columns

Name	Type	Behavior	Description
MobileDeviceConstantId	Long	ATTRIBUTE	Output only. The ID of the mobile device constant.
MobileDeviceConstantManufacturerName	String	ATTRIBUTE	Output only. The manufacturer of the mobile device.
MobileDeviceConstantName	String	ATTRIBUTE	Output only. The name of the mobile device.
MobileDeviceConstantOperatingSystemName	String	ATTRIBUTE	Output only. The operating system of the mobile device.
MobileDeviceConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the mobile device constant. Mobile device constant resource names have the form: mobileDeviceConstants/{criterion_id}
MobileDeviceConstantType	String	ATTRIBUTE	Output only. The type of mobile device. The allowed values are MOBILE, TABLET, UNKNOWN, UNSPECIFIED.

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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
OfflineUserDataJobCustomerMatchUserListMetadataUserList	String	ATTRIBUTE	The resource name of remarketing list to update data. Required for job of CUSTOMER_MATCH_USER_LIST type.
OfflineUserDataJobExternalId	Long	ATTRIBUTE	Immutable. User specified job ID.
OfflineUserDataJobFailureReason	String	ATTRIBUTE	Output only. Reason for the processing failure, if status is FAILED. The allowed values are HIGH_AVERAGE_TRANSACTION_VALUE, INSUFFICIENT_MATCHED_TRANSACTIONS, INSUFFICIENT_TRANSACTIONS, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE, UNKNOWN, UNSPECIFIED.
OfflineUserDataJobId	Long	ATTRIBUTE	Output only. ID of this offline user data job.
OfflineUserDataJobOperationMetadataMatchRateRange	String	ATTRIBUTE	Output only. Match rate of the Customer Match user list upload. Describes the estimated match rate when the status of the job is 'RUNNING' and final match rate when the final match rate is available after the status of the job is 'SUCCESS/FAILED'. The allowed values are MATCH_RANGE_20_TO_30, MATCH_RANGE_31_TO_40, MATCH_RANGE_41_TO_50, MATCH_RANGE_51_TO_60, MATCH_RANGE_61_TO_70, MATCH_RANGE_71_TO_80, MATCH_RANGE_81_TO_90, MATCH_RANGE_91_TO_100, MATCH_RANGE_LESS_THAN_20, UNKNOWN, UNSPECIFIED.
OfflineUserDataJobResourceName	String	ATTRIBUTE	Immutable. The resource name of the offline user data job. Offline user data job resource names have the form: customers/{customer_id}/offlineUserDataJobs/{offline_user_data_job_id}
OfflineUserDataJobStatus	String	ATTRIBUTE	Output only. Status of the job. The allowed values are FAILED, PENDING, RUNNING, SUCCESS, UNKNOWN, UNSPECIFIED.
OfflineUserDataJobStoreSalesMetadataLoyaltyFraction	Double	ATTRIBUTE	This is the fraction of all transactions that are identifiable (for example, associated with any form of customer information). Required. The fraction needs to be between 0 and 1 (excluding 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataAdvertiserUploadDateTime	Date	ATTRIBUTE	Time the advertiser uploaded the data to the partner. Required. The format is 'YYYY-MM-DD HH:MM:SS'. Examples: '2018-03-05 09:15:00' or '2018-02-01 14:34:30'
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataBridgeMapVersionId	String	ATTRIBUTE	Version of partner IDs to be used for uploads. Required.
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerId	Long	ATTRIBUTE	ID of the third party partner updating the transaction feed.
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerMatchFraction	Double	ATTRIBUTE	The fraction of valid transactions that are matched to a third party assigned user ID on the partner side. Required. The fraction needs to be between 0 and 1 (excluding 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataPartnerUploadFraction	Double	ATTRIBUTE	The fraction of valid transactions that are uploaded by the partner to Google. Required. The fraction needs to be between 0 and 1 (excluding 0).
OfflineUserDataJobStoreSalesMetadataThirdPartyMetadataValidTransactionFraction	Double	ATTRIBUTE	The fraction of transactions that are valid. Invalid transactions may include invalid formats or values. Required. The fraction needs to be between 0 and 1 (excluding 0).
OfflineUserDataJobStoreSalesMetadataTransactionUploadFraction	Double	ATTRIBUTE	This is the ratio of sales being uploaded compared to the overall sales that can be associated with a customer. Required. The fraction needs to be between 0 and 1 (excluding 0). For example, if you upload half the sales that you are able to associate with a customer, this would be 0.5.
OfflineUserDataJobType	String	ATTRIBUTE	Immutable. Type of the job. The allowed values are CUSTOMER_MATCH_USER_LIST, CUSTOMER_MATCH_WITH_ATTRIBUTES, STORE_SALES_UPLOAD_FIRST_PARTY, STORE_SALES_UPLOAD_THIRD_PARTY, UNKNOWN, UNSPECIFIED.

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.

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

Columns

Name	Type	Behavior	Description
OperatingSystemVersionConstantId	Long	ATTRIBUTE	Output only. The ID of the operating system version.
OperatingSystemVersionConstantName	String	ATTRIBUTE	Output only. Name of the operating system.
OperatingSystemVersionConstantOperatorType	String	ATTRIBUTE	Output only. Determines whether this constant represents a single version or a range of versions. The allowed values are EQUALS_TO, GREATER_THAN_EQUALS_TO, UNKNOWN, UNSPECIFIED.
OperatingSystemVersionConstantOsMajorVersion	Int	ATTRIBUTE	Output only. The OS Major Version number.
OperatingSystemVersionConstantOsMinorVersion	Int	ATTRIBUTE	Output only. The OS Minor Version number.
OperatingSystemVersionConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the operating system version constant. Operating system version constant resource names have the form: operatingSystemVersionConstants/{criterion_id}

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.

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.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
PaidOrganicSearchTermViewResourceName	String	ATTRIBUTE	Output only. The resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/paidOrganicSearchTermViews/{campaign_id}~ {ad_group_id}~{URL-base64 search term}
PaidOrganicSearchTermViewSearchTerm	String	ATTRIBUTE	Output only. The search term.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
Clicks	Long	METRIC	The number of clicks.
CombinedClicks	Long	METRIC	The number of times your ad or your site's listing in the unpaid results was clicked. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CombinedClicksPerQuery	Double	METRIC	The number of times your ad or your site's listing in the unpaid results was clicked (combined_clicks) divided by combined_queries. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CombinedQueries	Long	METRIC	The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
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.
OrganicClicks	Long	METRIC	The number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
OrganicClicksPerQuery	Double	METRIC	The number of times someone clicked your site's listing in the unpaid results (organic_clicks) divided by the total number of searches that returned pages from your site (organic_queries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.
OrganicImpressions	Long	METRIC	The number of listings for your site in the unpaid search results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
OrganicImpressionsPerQuery	Double	METRIC	The number of times a page from your site was listed in the unpaid search results (organic_impressions) divided by the number of searches returning your site's listing in the unpaid results (organic_queries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.
OrganicQueries	Long	METRIC	The total number of searches that returned your site's listing in the unpaid results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
SearchEngineResultsPageType	String	SEGMENT	Type of the search engine results page. The allowed values are ADS_AND_ORGANIC, ADS_ONLY, ORGANIC_ONLY, 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.

ParentalStatusView

A parental status view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ParentalStatusViewResourceName	String	ATTRIBUTE	Output only. The resource name of the parental status view. Parental Status view resource names have the form: customers/{customer_id}/parentalStatusViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

PerStoreView

An per store view. This view provides per store impression reach and local action conversion stats for advertisers.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
PerStoreViewPlaceId	String	ATTRIBUTE	Output only. The place ID of the per store view.
PerStoreViewResourceName	String	ATTRIBUTE	Output only. The resource name of the per store view. Per Store view resource names have the form: customers/{customer_id}/perStoreViews/{place_id}
AllConversionsFromLocationAssetClickToCall	Double	METRIC	Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetDirections	Double	METRIC	Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetMenu	Double	METRIC	Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetOrder	Double	METRIC	Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetOtherEngagement	Double	METRIC	Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetStoreVisits	Double	METRIC	Estimated number of visits to the store after a chargeable ad event (click or impression). This measure is coming from Asset based location.
AllConversionsFromLocationAssetWebsite	Double	METRIC	Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location.
EligibleImpressionsFromLocationAssetStoreReach	Long	METRIC	Number of impressions in which the store location was shown or the location was used for targeting. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetClickToCall	Double	METRIC	Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetDirections	Double	METRIC	Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetMenu	Double	METRIC	Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetOrder	Double	METRIC	Number of order clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetOtherEngagement	Double	METRIC	Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetStoreVisits	Double	METRIC	Estimated number of visits to the store after an impression. This measure is coming from Asset based location.
ViewThroughConversionsFromLocationAssetWebsite	Double	METRIC	Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location.
AdNetworkType	String	SEGMENT	Ad network type. The allowed values are CONTENT, MIXED, SEARCH, SEARCH_PARTNERS, UNKNOWN, UNSPECIFIED, YOUTUBE_SEARCH, YOUTUBE_WATCH.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
MonthOfYear	String	SEGMENT	Month of the year, for example, January. The allowed values are APRIL, AUGUST, DECEMBER, FEBRUARY, JANUARY, JULY, JUNE, MARCH, MAY, NOVEMBER, OCTOBER, SEPTEMBER, UNKNOWN, UNSPECIFIED.
Quarter	Date	SEGMENT	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

ProductBiddingCategoryConstant

A Product Bidding Category.

Columns

Name	Type	Behavior	Description
ProductBiddingCategoryConstantCountryCode	String	ATTRIBUTE	Output only. Two-letter upper-case country code of the product bidding category.
ProductBiddingCategoryConstantId	Long	ATTRIBUTE	Output only. ID of the product bidding category. This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436.
ProductBiddingCategoryConstantLanguageCode	String	ATTRIBUTE	Output only. Language code of the product bidding category.
ProductBiddingCategoryConstantLevel	String	ATTRIBUTE	Output only. Level of the product bidding category. The allowed values are LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5, UNKNOWN, UNSPECIFIED.
ProductBiddingCategoryConstantLocalizedName	String	ATTRIBUTE	Output only. Display value of the product bidding category localized according to language_code.
ProductBiddingCategoryConstantProductBiddingCategoryConstantParent	String	ATTRIBUTE	Output only. Resource name of the parent product bidding category.
ProductBiddingCategoryConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the product bidding category. Product bidding category resource names have the form: productBiddingCategoryConstants/{country_code}~{level}~{id}
ProductBiddingCategoryConstantStatus	String	ATTRIBUTE	Output only. Status of the product bidding category. The allowed values are ACTIVE, OBSOLETE, UNKNOWN, UNSPECIFIED.

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.

ProductGroupView

A product group view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ProductGroupViewResourceName	String	ATTRIBUTE	Output only. The resource name of the product group view. Product group view resource names have the form: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}
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.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
AverageCpm	Double	METRIC	Average cost-per-thousand impressions (CPM).
BenchmarkAverageMaxCpc	Double	METRIC	An indication of how other advertisers are bidding on similar products.
BenchmarkCtr	Double	METRIC	An indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it.
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).
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click 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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

Recommendation

A recommendation.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
RecommendationAdGroup	String	ATTRIBUTE	Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group. This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD
RecommendationCallExtensionRecommendation	String	ATTRIBUTE	Output only. The Call extension recommendation.
RecommendationCalloutExtensionRecommendation	String	ATTRIBUTE	Output only. The Callout extension recommendation.
RecommendationCampaign	String	ATTRIBUTE	Output only. The campaign targeted by this recommendation. This will be set only when the recommendation affects a single campaign. This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX , RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS
RecommendationCampaignBudget	String	ATTRIBUTE	Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET
RecommendationCampaignBudgetRecommendation	String	ATTRIBUTE	Output only. The campaign budget recommendation.
RecommendationDismissed	Bool	ATTRIBUTE	Output only. Whether the recommendation is dismissed or not.
RecommendationDisplayExpansionOptInRecommendation	String	ATTRIBUTE	Output only. The Display Expansion opt-in recommendation.
RecommendationEnhancedCpcOptInRecommendation	String	ATTRIBUTE	Output only. The Enhanced Cost-Per-Click Opt-In recommendation.
RecommendationForecastingCampaignBudgetRecommendation	String	ATTRIBUTE	Output only. The forecasting campaign budget recommendation.
RecommendationForecastingSetTargetRoasRecommendation	String	ATTRIBUTE	Output only. The forecasting set target ROAS recommendation.
RecommendationImpact	String	ATTRIBUTE	Output only. The impact on account performance as a result of applying the recommendation.
RecommendationKeywordMatchTypeRecommendation	String	ATTRIBUTE	Output only. The keyword match type recommendation.
RecommendationKeywordRecommendation	String	ATTRIBUTE	Output only. The keyword recommendation.
RecommendationMarginalRoiCampaignBudgetRecommendation	String	ATTRIBUTE	Output only. The marginal ROI campaign budget recommendation.
RecommendationMaximizeClicksOptInRecommendation	String	ATTRIBUTE	Output only. The MaximizeClicks Opt-In recommendation.
RecommendationMaximizeConversionsOptInRecommendation	String	ATTRIBUTE	Output only. The MaximizeConversions Opt-In recommendation.
RecommendationMoveUnusedBudgetRecommendation	String	ATTRIBUTE	Output only. The move unused budget recommendation.
RecommendationOptimizeAdRotationRecommendation	String	ATTRIBUTE	Output only. The Optimize Ad Rotation recommendation.
RecommendationRaiseTargetCpaBidTooLowRecommendation	String	ATTRIBUTE	Output only. The raise target CPA bid too low recommendation.
RecommendationResourceName	String	ATTRIBUTE	Immutable. The resource name of the recommendation. customers/{customer_id}/recommendations/{recommendation_id}
RecommendationResponsiveSearchAdAssetRecommendation	String	ATTRIBUTE	Output only. The responsive search ad asset recommendation.
RecommendationResponsiveSearchAdImproveAdStrengthRecommendation	String	ATTRIBUTE	Output only. The responsive search ad improve ad strength recommendation.
RecommendationResponsiveSearchAdRecommendation	String	ATTRIBUTE	Output only. The add responsive search ad recommendation.
RecommendationSearchPartnersOptInRecommendation	String	ATTRIBUTE	Output only. The Search Partners Opt-In recommendation.
RecommendationSitelinkExtensionRecommendation	String	ATTRIBUTE	Output only. The Sitelink extension recommendation.
RecommendationTargetCpaOptInRecommendation	String	ATTRIBUTE	Output only. The TargetCPA opt-in recommendation.
RecommendationTargetRoasOptInRecommendation	String	ATTRIBUTE	Output only. The Target ROAS opt-in recommendation.
RecommendationTextAdRecommendation	String	ATTRIBUTE	Output only. Add expanded text ad recommendation.
RecommendationType	String	ATTRIBUTE	Output only. The type of recommendation. The allowed values are CALLOUT_EXTENSION, CALL_EXTENSION, CAMPAIGN_BUDGET, DISPLAY_EXPANSION_OPT_IN, ENHANCED_CPC_OPT_IN, FORECASTING_CAMPAIGN_BUDGET, FORECASTING_SET_TARGET_ROAS, KEYWORD, KEYWORD_MATCH_TYPE, MARGINAL_ROI_CAMPAIGN_BUDGET, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, MOVE_UNUSED_BUDGET, OPTIMIZE_AD_ROTATION, RAISE_TARGET_CPA_BID_TOO_LOW, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UNKNOWN, UNSPECIFIED, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX, USE_BROAD_MATCH_KEYWORD.
RecommendationUpgradeLocalCampaignToPerformanceMaxRecommendation	String	ATTRIBUTE	Output only. The upgrade a Local campaign to a Performance Max campaign recommendation.
RecommendationUpgradeSmartShoppingCampaignToPerformanceMaxRecommendation	String	ATTRIBUTE	Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.
RecommendationUseBroadMatchKeywordRecommendation	String	ATTRIBUTE	Output only. The use broad match keyword recommendation.

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.

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.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
RemarketingActionId	Long	ATTRIBUTE	Output only. Id of the remarketing action.
RemarketingActionName	String	ATTRIBUTE	The name of the remarketing action. This field is required and should not be empty when creating new remarketing actions.
RemarketingActionResourceName	String	ATTRIBUTE	Immutable. The resource name of the remarketing action. Remarketing action resource names have the form: customers/{customer_id}/remarketingActions/{remarketing_action_id}
RemarketingActionTagSnippets	String	ATTRIBUTE	Output only. The snippets used for tracking remarketing actions.

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.

Resources

List of resources that can be used in order to generate new Reports or re-generate the old one.

Columns

Name	Type	Behavior	Description
ReportName	String		The name of the report generated from this resource.
ResourceName	String		The name of the resource.
AttributeResources	String		A comma separated list of the attribute resources.
SegmentingResources	String		A comma separated list of the segmenting resources.
Description	String		The description of the current 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
ManagerId	Long	Id of the manager account on behalf of which you are requesting customer data.

SearchTermView

A search term view with metrics aggregated by search term at the ad group 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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
SearchTermViewAdGroup	String	ATTRIBUTE	Output only. The ad group the search term served in.
SearchTermViewResourceName	String	ATTRIBUTE	Output only. The resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}
SearchTermViewSearchTerm	String	ATTRIBUTE	Output only. The search term.
SearchTermViewStatus	String	ATTRIBUTE	Output only. Indicates whether the search term is currently one of your targeted or excluded keywords. The allowed values are ADDED, ADDED_EXCLUDED, EXCLUDED, NONE, UNKNOWN, UNSPECIFIED.
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.
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.
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.
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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.
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.
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 (for example, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
SearchTermMatchType	String	SEGMENT	Match type of the keyword that triggered the ad, including variants. The allowed values are BROAD, EXACT, NEAR_EXACT, NEAR_PHRASE, PHRASE, 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.

SharedCriterion

A criterion belonging to a shared set.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
SharedCriterionCriterionId	Long	ATTRIBUTE	Output only. The ID of the criterion. This field is ignored for mutates.
SharedCriterionKeywordMatchType	String	ATTRIBUTE	The match type of the keyword. The allowed values are BROAD, EXACT, PHRASE, UNKNOWN, UNSPECIFIED.
SharedCriterionKeywordText	String	ATTRIBUTE	The text of the keyword (at most 80 characters and 10 words).
SharedCriterionMobileAppCategoryMobileAppCategoryConstant	String	ATTRIBUTE	The mobile app category constant resource name.
SharedCriterionMobileApplicationAppId	String	ATTRIBUTE	A string that uniquely identifies a mobile application to Google Ads API. The format of this string is '{platform}-{platform_native_id}', where platform is '1' for iOS apps and '2' for Android apps, and where platform_native_id is the mobile application identifier native to the corresponding platform. For iOS, this native identifier is the 9 digit string that appears at the end of an App Store URL (for example, '476943146' for 'Flood-It! 2' whose App Store link is 'http://itunes.apple.com/us/app/flood-it!-2/id476943146'). For Android, this native identifier is the application's package name (for example, 'com.labpixies.colordrips' for 'Color Drips' given Google Play link 'https://play.google.com/store/apps/details?id=com.labpixies.colordrips'). A well formed app id for Google Ads API would thus be '1-476943146' for iOS and '2-com.labpixies.colordrips' for Android. This field is required and must be set in CREATE operations.
SharedCriterionMobileApplicationName	String	ATTRIBUTE	Name of this mobile application.
SharedCriterionPlacementUrl	String	ATTRIBUTE	URL of the placement. For example, 'http://www.domain.com'.
SharedCriterionResourceName	String	ATTRIBUTE	Immutable. The resource name of the shared criterion. Shared set resource names have the form: customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}
SharedCriterionSharedSet	String	ATTRIBUTE	Immutable. The shared set to which the shared criterion belongs.
SharedCriterionType	String	ATTRIBUTE	Output only. The type of the criterion. The allowed values are AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, AUDIENCE, CARRIER, COMBINED_AUDIENCE, CONTENT_LABEL, CUSTOM_AFFINITY, CUSTOM_AUDIENCE, CUSTOM_INTENT, DEVICE, GENDER, INCOME_RANGE, IP_BLOCK, KEYWORD, KEYWORD_THEME, LANGUAGE, LISTING_GROUP, LISTING_SCOPE, LOCATION, LOCATION_GROUP, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, UNKNOWN, UNSPECIFIED, USER_INTEREST, USER_LIST, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO.
SharedCriterionYoutubeChannelChannelId	String	ATTRIBUTE	The YouTube uploader channel id or the channel code of a YouTube channel.
SharedCriterionYoutubeVideoVideoId	String	ATTRIBUTE	YouTube video id as it appears on the YouTube watch page.

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.

SharedSet

SharedSets are used for sharing criterion exclusions across multiple campaigns.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
SharedSetId	Long	ATTRIBUTE	Output only. The ID of this shared set. Read only.
SharedSetMemberCount	Long	ATTRIBUTE	Output only. The number of shared criteria within this shared set. Read only.
SharedSetName	String	ATTRIBUTE	The name of this shared set. Required. Shared Sets must have names that are unique among active shared sets of the same type. The length of this string should be between 1 and 255 UTF-8 bytes, inclusive.
SharedSetReferenceCount	Long	ATTRIBUTE	Output only. The number of campaigns associated with this shared set. Read only.
SharedSetResourceName	String	ATTRIBUTE	Immutable. The resource name of the shared set. Shared set resource names have the form: customers/{customer_id}/sharedSets/{shared_set_id}
SharedSetStatus	String	ATTRIBUTE	Output only. The status of this shared set. Read only. The allowed values are ENABLED, REMOVED, UNKNOWN, UNSPECIFIED.
SharedSetType	String	ATTRIBUTE	Immutable. The type of this shared set: each shared set holds only a single kind of resource. Required. Immutable. The allowed values are NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN, UNSPECIFIED.

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.

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.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ShoppingPerformanceViewResourceName	String	ATTRIBUTE	Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView
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.
AverageCpc	Double	METRIC	The total cost of all clicks divided by the total number of clicks received.
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).
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
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.
SearchClickShare	Double	METRIC	The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click 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.
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.
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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
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.
ProductAggregatorId	Long	SEGMENT	Aggregator ID of the product.
ProductBiddingCategoryLevel1	String	SEGMENT	Bidding category (level 1) of the product.
ProductBiddingCategoryLevel2	String	SEGMENT	Bidding category (level 2) of the product.
ProductBiddingCategoryLevel3	String	SEGMENT	Bidding category (level 3) of the product.
ProductBiddingCategoryLevel4	String	SEGMENT	Bidding category (level 4) of the product.
ProductBiddingCategoryLevel5	String	SEGMENT	Bidding category (level 5) of the product.
ProductBrand	String	SEGMENT	Brand of the product.
ProductChannel	String	SEGMENT	Channel of the product. The allowed values are LOCAL, ONLINE, UNKNOWN, UNSPECIFIED.
ProductChannelExclusivity	String	SEGMENT	Channel exclusivity of the product. The allowed values are MULTI_CHANNEL, SINGLE_CHANNEL, UNKNOWN, UNSPECIFIED.
ProductCondition	String	SEGMENT	Condition of the product. The allowed values are NEW, REFURBISHED, UNKNOWN, UNSPECIFIED, USED.
ProductCountry	String	SEGMENT	Resource name of the geo target constant for the country of sale of the product.
ProductCustomAttribute0	String	SEGMENT	Custom attribute 0 of the product.
ProductCustomAttribute1	String	SEGMENT	Custom attribute 1 of the product.
ProductCustomAttribute2	String	SEGMENT	Custom attribute 2 of the product.
ProductCustomAttribute3	String	SEGMENT	Custom attribute 3 of the product.
ProductCustomAttribute4	String	SEGMENT	Custom attribute 4 of the product.
ProductItemId	String	SEGMENT	Item ID of the product.
ProductLanguage	String	SEGMENT	Resource name of the language constant for the language of the product.
ProductMerchantId	Long	SEGMENT	Merchant ID of the product.
ProductStoreId	String	SEGMENT	Store ID of the product.
ProductTitle	String	SEGMENT	Title of the product.
ProductTypeL1	String	SEGMENT	Type (level 1) of the product.
ProductTypeL2	String	SEGMENT	Type (level 2) of the product.
ProductTypeL3	String	SEGMENT	Type (level 3) of the product.
ProductTypeL4	String	SEGMENT	Type (level 4) of the product.
ProductTypeL5	String	SEGMENT	Type (level 5) of the product.
Quarter	Date	SEGMENT	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

SmartCampaignSearchTermView

A Smart campaign search term view.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
SmartCampaignSearchTermViewCampaign	String	ATTRIBUTE	Output only. The Smart campaign the search term served in.
SmartCampaignSearchTermViewResourceName	String	ATTRIBUTE	Output only. The resource name of the Smart campaign search term view. Smart campaign search term view resource names have the form: customers/{customer_id}/smartCampaignSearchTermViews/{campaign_id}~{URL-base64_search_term}
SmartCampaignSearchTermViewSearchTerm	String	ATTRIBUTE	Output only. The search term.
Clicks	Long	METRIC	The number of clicks.
CostMicros	Long	METRIC	The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Impressions	Long	METRIC	Count of how often your ad has appeared on a search results page or website on the Google Network.
Date	Date	SEGMENT	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
MonthOfYear	String	SEGMENT	Month of the year, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

SmartCampaignSetting

Settings for configuring Smart campaigns.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
SmartCampaignSettingAdOptimizedBusinessProfileSettingIncludeLeadForm	Bool	ATTRIBUTE	Enabling a lead form on your business profile enables prospective customers to contact your business by filling out a simple form, and you'll receive their information through email.
SmartCampaignSettingAdvertisingLanguageCode	String	ATTRIBUTE	The ISO-639-1 language code to advertise in.
SmartCampaignSettingBusinessName	String	ATTRIBUTE	The name of the business.
SmartCampaignSettingBusinessProfileLocation	String	ATTRIBUTE	The resource name of a Business Profile location. Business Profile location resource names can be fetched through the Business Profile API and adhere to the following format: locations/{locationId}. See the Business Profile API for additional details.
SmartCampaignSettingCampaign	String	ATTRIBUTE	Output only. The campaign to which these settings apply.
SmartCampaignSettingFinalUrl	String	ATTRIBUTE	The user-provided landing page URL for this Campaign.
SmartCampaignSettingPhoneNumberCountryCode	String	ATTRIBUTE	Upper-case, two-letter country code as defined by ISO-3166.
SmartCampaignSettingPhoneNumberPhoneNumber	String	ATTRIBUTE	Phone number of the smart campaign.
SmartCampaignSettingResourceName	String	ATTRIBUTE	Immutable. The resource name of the Smart campaign setting. Smart campaign setting resource names have the form: customers/{customer_id}/smartCampaignSettings/{campaign_id}

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.

ThirdPartyAppAnalyticsLink

A data sharing connection, allowing the import of third party app analytics into a Google Ads Customer.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
ThirdPartyAppAnalyticsLinkResourceName	String	ATTRIBUTE	Immutable. The resource name of the third party app analytics link. Third party app analytics link resource names have the form: customers/{customer_id}/thirdPartyAppAnalyticsLinks/{account_link_id}
ThirdPartyAppAnalyticsLinkShareableLinkId	String	ATTRIBUTE	Output only. The shareable link ID that should be provided to the third party when setting up app analytics. This is able to be regenerated using regenerate method in the ThirdPartyAppAnalyticsLinkService.

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.

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').

Columns

Name	Type	Behavior	Description
TopicConstantId	Long	ATTRIBUTE	Output only. The ID of the topic.
TopicConstantPath	String	ATTRIBUTE	Output only. The category to target or exclude. Each subsequent element in the array describes a more specific sub-category. For example, {'Pets & Animals', 'Pets', 'Dogs'} represents the 'Pets & Animals/Pets/Dogs' category. List of available topic categories at https://developers.google.com/adwords/api/docs/appendix/verticals
TopicConstantResourceName	String	ATTRIBUTE	Output only. The resource name of the topic constant. topic constant resource names have the form: topicConstants/{topic_id}
TopicConstantTopicConstantParent	String	ATTRIBUTE	Output only. Resource name of parent of the topic constant.

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.

TopicView

A topic view.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
TopicViewResourceName	String	ATTRIBUTE	Output only. The resource name of the topic view. Topic view resource names have the form: customers/{customer_id}/topicViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

UserInterest

A user interest: a particular interest-based vertical to be targeted.

Columns

Name	Type	Behavior	Description
UserInterestAvailabilities	String	ATTRIBUTE	Output only. Availability information of the user interest.
UserInterestLaunchedToAll	Bool	ATTRIBUTE	Output only. True if the user interest is launched to all channels and locales.
UserInterestName	String	ATTRIBUTE	Output only. The name of the user interest.
UserInterestResourceName	String	ATTRIBUTE	Output only. The resource name of the user interest. User interest resource names have the form: customers/{customer_id}/userInterests/{user_interest_id}
UserInterestTaxonomyType	String	ATTRIBUTE	Output only. Taxonomy type of the user interest. The allowed values are AFFINITY, IN_MARKET, MOBILE_APP_INSTALL_USER, NEW_SMART_PHONE_USER, UNKNOWN, UNSPECIFIED, VERTICAL_GEO.
UserInterestUserInterestId	Long	ATTRIBUTE	Output only. The ID of the user interest.
UserInterestUserInterestParent	String	ATTRIBUTE	Output only. The parent of the user interest.

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.

UserList

A user list. This is a list of users a customer may target.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
UserListAccessReason	String	ATTRIBUTE	Output only. Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only. The allowed values are AFFILIATED, LICENSED, OWNED, SHARED, SUBSCRIBED, UNKNOWN, UNSPECIFIED.
UserListAccountUserListStatus	String	ATTRIBUTE	Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED. The allowed values are DISABLED, ENABLED, UNKNOWN, UNSPECIFIED.
UserListBasicUserListActions	String	ATTRIBUTE	Actions associated with this user list.
UserListClosingReason	String	ATTRIBUTE	Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open. The allowed values are UNKNOWN, UNSPECIFIED, UNUSED.
UserListCrmBasedUserListAppId	String	ATTRIBUTE	A string that uniquely identifies a mobile application from which the data was collected. For iOS, the ID string is the 9 digit string that appears at the end of an App Store URL (for example, '476943146' for 'Flood-It! 2' whose App Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). For Android, the ID string is the application's package name (for example, 'com.labpixies.colordrips' for 'Color Drips' given Google Play link https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Required when creating CrmBasedUserList for uploading mobile advertising IDs.
UserListCrmBasedUserListDataSourceType	String	ATTRIBUTE	Data source of the list. Default value is FIRST_PARTY. Only customers on the allow-list can create third-party sourced CRM lists. The allowed values are FIRST_PARTY, THIRD_PARTY_CREDIT_BUREAU, THIRD_PARTY_VOTER_FILE, UNKNOWN, UNSPECIFIED.
UserListCrmBasedUserListUploadKeyType	String	ATTRIBUTE	Matching key type of the list. Mixed data types are not allowed on the same list. This field is required for an ADD operation. The allowed values are CONTACT_INFO, CRM_ID, MOBILE_ADVERTISING_ID, UNKNOWN, UNSPECIFIED.
UserListDescription	String	ATTRIBUTE	Description of this user list.
UserListEligibleForDisplay	Bool	ATTRIBUTE	Output only. Indicates this user list is eligible for Google Display Network. This field is read-only.
UserListEligibleForSearch	Bool	ATTRIBUTE	Indicates if this user list is eligible for Google Search Network.
UserListId	Long	ATTRIBUTE	Output only. Id of the user list.
UserListIntegrationCode	String	ATTRIBUTE	An ID from external system. It is used by user list sellers to correlate IDs on their systems.
UserListLogicalUserListRules	String	ATTRIBUTE	Logical list rules that define this user list. The rules are defined as a logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are ANDed when they are evaluated. Required for creating a logical user list.
UserListMatchRatePercentage	Int	ATTRIBUTE	Output only. Indicates match rate for Customer Match lists. The range of this field is [0-100]. This will be null for other list types or when it's not possible to calculate the match rate. This field is read-only.
UserListMembershipLifeSpan	Long	ATTRIBUTE	Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list.
UserListMembershipStatus	String	ATTRIBUTE	Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to. The allowed values are CLOSED, OPEN, UNKNOWN, UNSPECIFIED.
UserListName	String	ATTRIBUTE	Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=SHARED)
UserListReadOnly	Bool	ATTRIBUTE	Output only. An option that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only.
UserListResourceName	String	ATTRIBUTE	Immutable. The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
UserListRuleBasedUserListCombinedRuleUserListLeftOperandRuleItemGroups	String	ATTRIBUTE	List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
UserListRuleBasedUserListCombinedRuleUserListLeftOperandRuleType	String	ATTRIBUTE	Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. The allowed values are AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListCombinedRuleUserListRightOperandRuleItemGroups	String	ATTRIBUTE	List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
UserListRuleBasedUserListCombinedRuleUserListRightOperandRuleType	String	ATTRIBUTE	Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. The allowed values are AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListCombinedRuleUserListRuleOperator	String	ATTRIBUTE	Operator to connect the two operands. Required for creating a combined rule user list. The allowed values are AND, AND_NOT, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListExpressionRuleUserListRuleRuleItemGroups	String	ATTRIBUTE	List of rule item groups that defines this rule. Rule item groups are grouped together based on rule_type.
UserListRuleBasedUserListExpressionRuleUserListRuleRuleType	String	ATTRIBUTE	Rule type is used to determine how to group rule items. The default is OR of ANDs (disjunctive normal form). That is, rule items will be ANDed together within rule item groups and the groups themselves will be ORed together. Currently AND of ORs (conjunctive normal form) is only supported for ExpressionRuleUserList. The allowed values are AND_OF_ORS, OR_OF_ANDS, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListFlexibleRuleUserListExclusiveOperands	String	ATTRIBUTE	Actions that are located on the exclusive side. These are joined together with OR.
UserListRuleBasedUserListFlexibleRuleUserListInclusiveOperands	String	ATTRIBUTE	Actions that are located on the inclusive side. These are joined together by either AND/OR as specified by the inclusive_rule_operator.
UserListRuleBasedUserListFlexibleRuleUserListInclusiveRuleOperator	String	ATTRIBUTE	Operator that defines how the inclusive operands are combined. The allowed values are AND, OR, UNKNOWN, UNSPECIFIED.
UserListRuleBasedUserListPrepopulationStatus	String	ATTRIBUTE	The status of pre-population. The field is default to NONE if not set which means the previous users will not be considered. If set to REQUESTED, past site visitors or app users who match the list definition will be included in the list (works on the Display Network only). This will only add past users from within the last 30 days, depending on the list's membership duration and the date when the remarketing tag is added. The status will be updated to FINISHED once request is processed, or FAILED if the request fails. The allowed values are FAILED, FINISHED, REQUESTED, UNKNOWN, UNSPECIFIED.
UserListSimilarUserListSeedUserList	String	ATTRIBUTE	Seed UserList from which this list is derived.
UserListSizeForDisplay	Long	ATTRIBUTE	Output only. Estimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only.
UserListSizeForSearch	Long	ATTRIBUTE	Output only. Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only.
UserListSizeRangeForDisplay	String	ATTRIBUTE	Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only. The allowed values are FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND, FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION, FIVE_MILLION_TO_TEN_MILLION, LESS_THAN_FIVE_HUNDRED, LESS_THAN_ONE_THOUSAND, ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND, ONE_MILLION_TO_TWO_MILLION, ONE_THOUSAND_TO_TEN_THOUSAND, OVER_FIFTY_MILLION, TEN_MILLION_TO_TWENTY_MILLION, TEN_THOUSAND_TO_FIFTY_THOUSAND, THIRTY_MILLION_TO_FIFTY_MILLION, THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND, THREE_MILLION_TO_FIVE_MILLION, TWENTY_MILLION_TO_THIRTY_MILLION, TWO_MILLION_TO_THREE_MILLION, UNKNOWN, UNSPECIFIED.
UserListSizeRangeForSearch	String	ATTRIBUTE	Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only. The allowed values are FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND, FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION, FIVE_MILLION_TO_TEN_MILLION, LESS_THAN_FIVE_HUNDRED, LESS_THAN_ONE_THOUSAND, ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND, ONE_MILLION_TO_TWO_MILLION, ONE_THOUSAND_TO_TEN_THOUSAND, OVER_FIFTY_MILLION, TEN_MILLION_TO_TWENTY_MILLION, TEN_THOUSAND_TO_FIFTY_THOUSAND, THIRTY_MILLION_TO_FIFTY_MILLION, THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND, THREE_MILLION_TO_FIVE_MILLION, TWENTY_MILLION_TO_THIRTY_MILLION, TWO_MILLION_TO_THREE_MILLION, UNKNOWN, UNSPECIFIED.
UserListType	String	ATTRIBUTE	Output only. Type of this list. This field is read-only. The allowed values are CRM_BASED, EXTERNAL_REMARKETING, LOGICAL, REMARKETING, RULE_BASED, SIMILAR, UNKNOWN, UNSPECIFIED.

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.

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.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
UserLocationViewCountryCriterionId	Long	ATTRIBUTE	Output only. Criterion Id for the country.
UserLocationViewResourceName	String	ATTRIBUTE	Output only. The resource name of the user location view. UserLocation view resource names have the form: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
UserLocationViewTargetingLocation	Bool	ATTRIBUTE	Output only. Indicates whether location was targeted or not.
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.
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).
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.
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.
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 (for example, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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.
GeoTargetAirport	String	SEGMENT	Resource name of the geo target constant that represents an airport.
GeoTargetCanton	String	SEGMENT	Resource name of the geo target constant that represents a canton.
GeoTargetCity	String	SEGMENT	Resource name of the geo target constant that represents a city.
GeoTargetCounty	String	SEGMENT	Resource name of the geo target constant that represents a county.
GeoTargetDistrict	String	SEGMENT	Resource name of the geo target constant that represents a district.
GeoTargetMetro	String	SEGMENT	Resource name of the geo target constant that represents a metro.
GeoTargetMostSpecificLocation	String	SEGMENT	Resource name of the geo target constant that represents the most specific location.
GeoTargetPostalCode	String	SEGMENT	Resource name of the geo target constant that represents a postal code.
GeoTargetProvince	String	SEGMENT	Resource name of the geo target constant that represents a province.
GeoTargetRegion	String	SEGMENT	Resource name of the geo target constant that represents a region.
GeoTargetState	String	SEGMENT	Resource name of the geo target constant that represents a state.
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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

Video

A video.

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
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
VideoChannelId	String	ATTRIBUTE	Output only. The owner channel id of the video.
VideoDurationMillis	Long	ATTRIBUTE	Output only. The duration of the video in milliseconds.
VideoId	String	ATTRIBUTE	Output only. The ID of the video.
VideoResourceName	String	ATTRIBUTE	Output only. The resource name of the video. Video resource names have the form: customers/{customer_id}/videos/{video_id}
VideoTitle	String	ATTRIBUTE	Output only. The title of the video.
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.
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.
ConversionsFromInteractionsValuePerInteraction	Double	METRIC	The value of conversions from interactions divided by the number 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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
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.

WebpageView

A webpage view.

Columns

Name	Type	Behavior	Description
CustomerId	Long	ATTRIBUTE	Output only. The ID of the customer.
WebpageViewResourceName	String	ATTRIBUTE	Output only. The resource name of the webpage view. Webpage view resource names have the form: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}
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.
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.
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.
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.
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.
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.
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 (for example, 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, CROSS_NETWORK, 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.
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, for example, 2018-04-17.
DayOfWeek	String	SEGMENT	Day of the week, for example, 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, for example, 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, for example, 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.