Matillion ETL Data Model for Google Adwords
Version - 20.0.7654.0

Note: Data models are true for the latest version of Matillion ETL. If you are on an older version or using a component from an old job, your experience may differ.



Connection String OptionsBack To Top

  1. Auth Scheme
  2. Auto Cache
  3. Batch Size
  4. Cache Connection
  5. Cache Driver
  6. Cache Location
  7. Cache Metadata
  8. Cache Tolerance
  9. Client Customer Id
  10. Connection Life Time
  11. Connect On Open
  12. Developer Token
  13. Firewall Password
  14. Firewall Port
  15. Firewall Server
  16. Firewall Type
  17. Firewall User
  18. Include Zero Impressions
  19. Initiate OAuth
  20. Location
  21. Logfile
  22. Log Modules
  23. Manager Id
  24. Max Log File Count
  25. Max Log File Size
  26. Max Rows
  27. OAuth Access Token
  28. OAuth Client Id
  29. OAuth Client Secret
  30. OAuth Expires In
  31. OAuth JWT Cert
  32. OAuth JWT Cert Password
  33. OAuth JWT Cert Subject
  34. OAuth JWT Cert Type
  35. OAuth JWT Issuer
  36. OAuth JWT Subject
  37. OAuth Refresh Token
  38. OAuth Settings Location
  39. OAuth Token Timestamp
  40. OAuth Verifier
  41. Offline
  42. Other
  43. Pool Idle Timeout
  44. Pool Max Size
  45. Pool Min Size
  46. Pool Wait Time
  47. Proxy Auth Scheme
  48. Proxy Auto Detect
  49. Proxy Exceptions
  50. Proxy Password
  51. Proxy Port
  52. Proxy Server
  53. Proxy SSL Type
  54. Proxy User
  55. Pseudo Columns
  56. Recurse Children
  57. RTK
  58. Schema
  59. SSL Server Cert
  60. Support Enhanced SQL
  61. Tables
  62. Timeout
  63. Use Connection Pooling
  64. Verbosity
  65. Views

Auth Scheme

Data Type

string

Default Value

"Auto"

Remarks



Auto Cache

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:

See Also



Batch Size

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.



Cache Connection

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

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:

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:
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:
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:



Cache Driver

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 based on the CacheDriver and CacheConnection properties. The CacheDriver is the name of the JDBC driver class that you want to use to cache data.

Note that you must also add the CacheDriver JAR file to the classpath.

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;

  
The CData JDBC Driver for MySQL is located in the lib subfolder of the CData JDBC Driver for Google Ads installation directory.
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=org.postgresql.Driver;CacheConnection='jdbc:postgresql://localhost:5433/postgres?user=postgres&password=admin';InitiateOAuth=GETANDREFRESH;DeveloperToken=myDeveloperToken;ClientCustomerId=myClientCustomerId;



Cache Location

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



Cache Metadata

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



Cache Tolerance

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.



Client Customer Id

Data Type

string

Default Value

""

Remarks

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

You can find this value in your AdWords account. This value is not the same as the Id of the MCC account. You need to provide the lowest-level Ids to retrieve data.



Connection Life Time

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.



Connect On Open

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



Developer Token

Data Type

string

Default Value

""

Remarks

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

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



Firewall Password

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.



Firewall Port

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.



Firewall Server

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.



Firewall Type

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.



Firewall User

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.



Include Zero Impressions

Data Type

bool

Default Value

false

Remarks

Whether or not to include or exclude zero impressions in the reports.



Initiate OAuth

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.



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.

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



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 Modules

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.



Manager Id

Data Type

string

Default Value

""

Remarks

The Id of the MCC 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.



Max Log File Count

Data Type

int

Default Value

-1

Remarks

A string specifying the maximum file count of log files. 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.



Max Log File Size

Data Type

string

Default Value

"100MB"

Remarks

A string specifying the maximum size in bytes for a log file (for example, 10 MB). 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.



Max Rows

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.



OAuth Access Token

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.



OAuth Client Id

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.



OAuth Client Secret

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.



OAuth Expires In

Data Type

string

Default Value

""

Remarks

Pair with OAuthTokenTimestamp to determine when the AccessToken will expire.



OAuth JWT Cert

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:

MYA certificate store holding personal certificates with their associated private keys.
CACertifying authority certificates.
ROOTRoot certificates.
SPCSoftware 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).



OAuth JWT Cert Password

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.



OAuth JWT Cert Subject

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.

FieldMeaning
CNCommon Name. This is commonly a host name like www.server.com.
OOrganization
OUOrganizational Unit
LLocality
SState
CCountry
EEmail Address

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



OAuth JWT Cert Type

Data Type

string

Default Value

"USER"

Remarks

This property can take one of the following values:

USER - defaultFor 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.
MACHINEFor Windows, this specifies that the certificate store is a machine store. Note: this store type is not available in Java.
PFXFILEThe certificate store is the name of a PFX (PKCS12) file containing certificates.
PFXBLOBThe certificate store is a string (base-64-encoded) representing a certificate store in PFX (PKCS12) format.
JKSFILEThe certificate store is the name of a Java key store (JKS) file containing certificates. Note: this store type is only available in Java.
JKSBLOBThe 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_FILEThe certificate store is the name of a PEM-encoded file that contains a private key and an optional certificate.
PEMKEY_BLOBThe certificate store is a string (base64-encoded) that contains a private key and an optional certificate.
PUBLIC_KEY_FILEThe certificate store is the name of a file that contains a PEM- or DER-encoded public key certificate.
PUBLIC_KEY_BLOBThe certificate store is a string (base-64-encoded) that contains a PEM- or DER-encoded public key certificate.
SSHPUBLIC_KEY_FILEThe certificate store is the name of a file that contains an SSH-style public key.
SSHPUBLIC_KEY_BLOBThe certificate store is a string (base-64-encoded) that contains an SSH-style public key.
P7BFILEThe certificate store is the name of a PKCS7 file containing certificates.
PPKFILEThe certificate store is the name of a file that contains a PPK (PuTTY Private Key).
XMLFILEThe certificate store is the name of a file that contains a certificate in XML format.
XMLBLOBThe certificate store is a string that contains a certificate in XML format.
GOOGLEJSONThe certificate store is the name of a JSON file containing the service account information. Only valid when connecting to a Google service.



OAuth JWT Issuer

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.



OAuth JWT Subject

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.



OAuth Refresh Token

Data Type

string

Default Value

""

Remarks

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



OAuth Settings Location

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



OAuth Token Timestamp

Data Type

string

Default Value

""

Remarks

Pair with OAuthExpiresIn to determine when the AccessToken will expire.



OAuth Verifier

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 Getting Started 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.



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.



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=TrueCaches only a subset of columns, which you can specify in your query.
QueryPassthrough=TruePasses the specified query to the cache database instead of using the SQL parser of the driver.

Integration and Formatting

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



Pool Idle Timeout

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.



Pool Max Size

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.



Pool Min Size

Data Type

int

Default Value

1

Remarks

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



Pool Wait Time

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.



Proxy Auth Scheme

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:

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



Proxy Auto Detect

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:

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



Proxy Exceptions

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.



Proxy Password

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.



Proxy Port

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.



Proxy Server

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.



Proxy SSL Type

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:

AUTODefault 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.
ALWAYSThe connection is always SSL enabled.
NEVERThe connection is not SSL enabled.
TUNNELThe 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.



Proxy User

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



Pseudo Columns

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, "*=*".



Recurse Children

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 in googleadsv2 schema.



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.



Schema

Data Type

string

Default Value

"v201809"

Remarks



SSL Server Cert

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.



Support Enhanced SQL

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.



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.



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.



Use Connection Pooling

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.



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 described in the following list:

1Setting Verbosity to 1 will log the query, the number of rows returned by it, the start of execution and the time taken, and any errors.
2Setting Verbosity to 2 will log everything included in Verbosity 1, cache queries, and additional information about the request, if applicable, such as HTTP headers.
3Setting Verbosity to 3 will additionally log the body of the request and the response.
4Setting Verbosity to 4 will additionally log transport-level communication with the data source. This includes SSL negotiation.
5Setting Verbosity to 5 will additionally log communication with the data source and additional details that may be helpful in troubleshooting problems. This includes interface commands.

The Verbosity should not be set to greater than 1 for normal operation. Substantial amounts of data can be logged at higher verbosities, which can delay execution times.



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.





ViewsBack To Top

  1. AccountPerformance
  2. AdCustomizersFeedItem
  3. AdGroupBidLandscape
  4. AdgroupPerformance
  5. AdGroups
  6. AdPerformance
  7. AgeRangePerformance
  8. AudiencePerformance
  9. AutomaticPlacementsPerformance
  10. BidGoalPerformance
  11. BudgetPerformance
  12. CallMetricsCallDetails
  13. CampaignAdScheduleTarget
  14. CampaignCriteria
  15. CampaignCriterionBidLandscape
  16. CampaignGroupPerformance
  17. CampaignLocationTarget
  18. CampaignNegativeKeywordsPerformance
  19. CampaignNegativeLocations
  20. CampaignNegativePlacementsPerformance
  21. CampaignPerformance
  22. Campaigns
  23. CampaignSharedSet
  24. ClickPerformance
  25. ConversionTrackers
  26. CreativeConversion
  27. CriteriaPerformance
  28. CriterionBidLandscape
  29. Customers
  30. DisplayKeywordPerformance
  31. DisplayTopicsPerformance
  32. FinalUrl
  33. GenderPerformance
  34. GeoPerformance
  35. KeywordlessCategory
  36. KeywordlessQuery
  37. KeywordsPerformance
  38. Label
  39. LandingPage
  40. LocationCriterion
  41. ManagedCustomers
  42. ManagedCustomersLinks
  43. MarketplacePerformance
  44. PaidOrganicQuery
  45. ParentalStatusPerformance
  46. Placeholder
  47. PlaceholderFeedItem
  48. PlacementPerformance
  49. ProductPartition
  50. SearchQueryPerformance
  51. SharedSet
  52. SharedSetCriteria
  53. ShoppingPerformance
  54. TopContentPerformance
  55. UrlPerformance
  56. UserAdDistance
  57. VideoPerformance
  58. AccountPerformance
  59. AdCustomizersFeedItem
  60. AdGroupBidLandscape
  61. AdgroupPerformance
  62. AdGroups
  63. AdPerformance
  64. AgeRangePerformance
  65. AudiencePerformance
  66. AutomaticPlacementsPerformance
  67. BidGoalPerformance
  68. BudgetPerformance
  69. CallMetricsCallDetails
  70. CampaignAdScheduleTarget
  71. CampaignCriteria
  72. CampaignCriterionBidLandscape
  73. CampaignGroupPerformance
  74. CampaignLocationTarget
  75. CampaignNegativeKeywordsPerformance
  76. CampaignNegativeLocations
  77. CampaignNegativePlacementsPerformance
  78. CampaignPerformance
  79. Campaigns
  80. CampaignSharedSet
  81. ClickPerformance
  82. ConversionTrackers
  83. CreativeConversion
  84. CriteriaPerformance
  85. CriterionBidLandscape
  86. Customers
  87. DisplayKeywordPerformance
  88. DisplayTopicsPerformance
  89. FinalUrl
  90. GenderPerformance
  91. GeoPerformance
  92. KeywordlessCategory
  93. KeywordlessQuery
  94. KeywordsPerformance
  95. Label
  96. LandingPage
  97. LocationCriterion
  98. ManagedCustomers
  99. ManagedCustomersLinks
  100. MarketplacePerformance
  101. PaidOrganicQuery
  102. ParentalStatusPerformance
  103. Placeholder
  104. PlaceholderFeedItem
  105. PlacementPerformance
  106. ProductPartition
  107. SearchQueryPerformance
  108. SharedSet
  109. SharedSetCriteria
  110. ShoppingPerformance
  111. TopContentPerformance
  112. UrlPerformance
  113. UserAdDistance
  114. VideoPerformance

AccountPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AccountPerformance report.
AccountDescriptiveName String Attribute Account Account for the AccountPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AccountPerformance report.
CanManageClients String Attribute Can Manage Clients Can Manage Clients for the AccountPerformance report.

The allowed values are TRUE, FALSE.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the AccountPerformance report.

The allowed values are TRUE, FALSE.

CustomerDescriptiveName String Attribute Client Name Client Name for the AccountPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AccountPerformance report.
IsAutoTaggingEnabled String Attribute Auto Tagging Enabled Auto Tagging Enabled for the AccountPerformance report.

The allowed values are TRUE, FALSE.

IsTestAccount String Attribute Test Account Test Account for the AccountPerformance report.

The allowed values are TRUE, FALSE.

AdNetworkType1 String Segment Network Network for the AccountPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AccountPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the AccountPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AccountPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AccountPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AccountPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AccountPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AccountPerformance report.
Date Date Segment Day Day for the AccountPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AccountPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AccountPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AccountPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

HourOfDay Integer Segment Hour Of Day Hour Of Day for the AccountPerformance report.
Month String Segment Month Month for the AccountPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AccountPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AccountPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AccountPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the AccountPerformance report.
Year Integer Segment Year Year for the AccountPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AccountPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AccountPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AccountPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AccountPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AccountPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AccountPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AccountPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AccountPerformance report.
AllConversions Double Metric All Conv All Conv for the AccountPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AccountPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AccountPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AccountPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AccountPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AccountPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AccountPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AccountPerformance report.
Clicks Long Metric Clicks Clicks for the AccountPerformance report.
ContentBudgetLostImpressionShare Double Metric Content Lost IS (budget) Content Lost IS (budget) for the AccountPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the AccountPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the AccountPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AccountPerformance report.
Conversions Double Metric Conversions Conversions for the AccountPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AccountPerformance report.
Cost Decimal Metric Cost Cost for the AccountPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AccountPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AccountPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AccountPerformance report.
Ctr Double Metric CTR CTR for the AccountPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AccountPerformance report.
Engagements Long Metric Engagements Engagements for the AccountPerformance report.
Impressions Long Metric Impressions Impressions for the AccountPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AccountPerformance report.
Interactions Long Metric Interactions Interactions for the AccountPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AccountPerformance report.
InvalidClickRate Double Metric Invalid Click Rate Invalid Click Rate for the AccountPerformance report.
InvalidClicks Long Metric Invalid Clicks Invalid Clicks for the AccountPerformance report.
SearchBudgetLostImpressionShare Double Metric Search Lost IS (budget) Search Lost IS (budget) for the AccountPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the AccountPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the AccountPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the AccountPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AccountPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AccountPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AccountPerformance report.
VideoViews Long Metric Views Views for the AccountPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AccountPerformance report.

Pseudo-Columns

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

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



AdCustomizersFeedItem

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the AdCustomizersFeedItem report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdCustomizersFeedItem report.
AdGroupName String Attribute Ad Group Ad Group for the AdCustomizersFeedItem report.
AdId Long Attribute Ad ID Ad ID for the AdCustomizersFeedItem report.
CampaignId Long Attribute Campaign ID Campaign ID for the AdCustomizersFeedItem report.
CampaignName String Attribute Campaign Campaign for the AdCustomizersFeedItem report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AdCustomizersFeedItem report.
FeedId Long Attribute Feed ID Feed ID for the AdCustomizersFeedItem report.
FeedItemAttributes String Attribute Attribute Values Attribute Values for the AdCustomizersFeedItem report.
FeedItemEndTime Long Attribute End Date End Date for the AdCustomizersFeedItem report.
FeedItemId Long Attribute Item ID Item ID for the AdCustomizersFeedItem report.
FeedItemStartTime Long Attribute Start Date Start Date for the AdCustomizersFeedItem report.
FeedItemStatus String Attribute Item State Item State for the AdCustomizersFeedItem report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

GeoTargetingCriterionId Long Attribute Target Location Target Location for the AdCustomizersFeedItem report.
KeywordTargetingId Long Attribute Keyword ID Keyword ID for the AdCustomizersFeedItem report.
KeywordTargetingMatchType String Attribute Target Keyword Match Type Target Keyword Match Type for the AdCustomizersFeedItem report.
KeywordTargetingText String Attribute Target Keyword Text Target Keyword Text for the AdCustomizersFeedItem report.
TargetingAdGroupId Long Attribute Target Ad Group ID Target Ad Group ID for the AdCustomizersFeedItem report.
TargetingCampaignId Long Attribute Target Campaign ID Target Campaign ID for the AdCustomizersFeedItem report.
AdNetworkType1 String Segment Network Network for the AdCustomizersFeedItem report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdCustomizersFeedItem report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AdCustomizersFeedItem report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AdCustomizersFeedItem report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdCustomizersFeedItem report.
Date Date Segment Day Day for the AdCustomizersFeedItem report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdCustomizersFeedItem report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AdCustomizersFeedItem report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AdCustomizersFeedItem report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the AdCustomizersFeedItem report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdCustomizersFeedItem report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AdCustomizersFeedItem report.
Slot String Segment Top Vs Other Top Vs Other for the AdCustomizersFeedItem report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the AdCustomizersFeedItem report.
Year Integer Segment Year Year for the AdCustomizersFeedItem report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdCustomizersFeedItem report.
AllConversions Double Metric All Conv All Conv for the AdCustomizersFeedItem report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdCustomizersFeedItem report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdCustomizersFeedItem report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdCustomizersFeedItem report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdCustomizersFeedItem report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdCustomizersFeedItem report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdCustomizersFeedItem report.
AveragePosition Double Metric Avg Position Avg Position for the AdCustomizersFeedItem report.
Clicks Long Metric Clicks Clicks for the AdCustomizersFeedItem report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdCustomizersFeedItem report.
Conversions Double Metric Conversions Conversions for the AdCustomizersFeedItem report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdCustomizersFeedItem report.
Cost Decimal Metric Cost Cost for the AdCustomizersFeedItem report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdCustomizersFeedItem report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdCustomizersFeedItem report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdCustomizersFeedItem report.
Ctr Double Metric CTR CTR for the AdCustomizersFeedItem report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdCustomizersFeedItem report.
Engagements Long Metric Engagements Engagements for the AdCustomizersFeedItem report.
Impressions Long Metric Impressions Impressions for the AdCustomizersFeedItem report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdCustomizersFeedItem report.
Interactions Long Metric Interactions Interactions for the AdCustomizersFeedItem report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdCustomizersFeedItem report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdCustomizersFeedItem report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdCustomizersFeedItem report.
VideoViewRate Double Metric View Rate View Rate for the AdCustomizersFeedItem report.
VideoViews Long Metric Views Views for the AdCustomizersFeedItem report.

Pseudo-Columns

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

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



AdGroupBidLandscape

Represents data about a bidlandscape for an adgroup.

Columns

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



AdgroupPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AdgroupPerformance report.
AccountDescriptiveName String Attribute Account Account for the AdgroupPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AdgroupPerformance report.
AdGroupDesktopBidModifier Double Attribute Desktop Bid Adj Desktop Bid Adj for the AdgroupPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdgroupPerformance report.
AdGroupMobileBidModifier Double Attribute Mobile Bid Adj Mobile Bid Adj for the AdgroupPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AdgroupPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AdgroupPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdGroupTabletBidModifier Double Attribute Tablet Bid Adj Tablet Bid Adj for the AdgroupPerformance report.
AdGroupType String Attribute Ad Group Type Ad Group Type for the AdgroupPerformance report.

The allowed values are UNKNOWN, SEARCH_STANDARD, SEARCH_DYNAMIC_ADS, DISPLAY_STANDARD, DISPLAY_ENGAGEMENT, SHOPPING_PRODUCT_ADS, SHOPPING_SHOWCASE_ADS, SHOPPING_GOAL_OPTIMIZED_ADS, VIDEO_TRUE_VIEW_IN_STREAM, VIDEO_TRUE_VIEW_IN_DISPLAY, VIDEO_BUMPER, VIDEO_NON_SKIPPABLE_IN_STREAM, HOTEL_ADS.

AdRotationMode String Attribute Ad Rotation Mode Ad Rotation Mode for the AdgroupPerformance report.

The allowed values are UNKNOWN, OPTIMIZE, ROTATE_FOREVER.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AdgroupPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AdgroupPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AdgroupPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AdgroupPerformance report.
BiddingStrategySource String Attribute Bidding Strategy Source Bidding Strategy Source for the AdgroupPerformance report.

The allowed values are CAMPAIGN, ADGROUP, CRITERION.

BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AdgroupPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

CampaignId Long Attribute Campaign ID Campaign ID for the AdgroupPerformance report.
CampaignName String Attribute Campaign Campaign for the AdgroupPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AdgroupPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ContentBidCriterionTypeGroup String Attribute Content Network Bid Dimension Content Network Bid Dimension for the AdgroupPerformance report.

The allowed values are KEYWORD, USER_INTEREST_AND_LIST, VERTICAL, GENDER, AGE_RANGE, PLACEMENT, PARENT, INCOME_RANGE, NONE, UNKNOWN.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the AdgroupPerformance report.

The allowed values are TRUE, FALSE.

CpcBid Decimal Attribute Default Max CPC Default Max CPC for the AdgroupPerformance report.
CpmBid Decimal Attribute Max CPM Max CPM for the AdgroupPerformance report.
CpvBid Decimal Attribute Max CPV Max CPV for the AdgroupPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AdgroupPerformance report.
EffectiveTargetRoas Double Attribute Target ROAS Target ROAS for the AdgroupPerformance report.
EffectiveTargetRoasSource String Attribute Target ROAS Source Target ROAS Source for the AdgroupPerformance report.

The allowed values are UNKNOWN, ADGROUP, ADGROUP_CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

EnhancedCpcEnabled String Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the AdgroupPerformance report.

The allowed values are TRUE, FALSE.

ExternalCustomerId Long Attribute Customer ID Customer ID for the AdgroupPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the AdgroupPerformance report.
LabelIds String Attribute Label IDs Label IDs for the AdgroupPerformance report.
Labels String Attribute Labels Labels for the AdgroupPerformance report.
TargetCpa Decimal Attribute Target CPA Target CPA for the AdgroupPerformance report.
TargetCpaBidSource String Attribute Target CPA Source Target CPA Source for the AdgroupPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AdgroupPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AdgroupPerformance report.
AdNetworkType1 String Segment Network Network for the AdgroupPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdgroupPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the AdgroupPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AdgroupPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AdgroupPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AdgroupPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AdgroupPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdgroupPerformance report.
Date Date Segment Day Day for the AdgroupPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdgroupPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AdgroupPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AdgroupPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

HourOfDay Integer Segment Hour Of Day Hour Of Day for the AdgroupPerformance report.
Month String Segment Month Month for the AdgroupPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdgroupPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AdgroupPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AdgroupPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the AdgroupPerformance report.
Year Integer Segment Year Year for the AdgroupPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AdgroupPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AdgroupPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AdgroupPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AdgroupPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AdgroupPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AdgroupPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AdgroupPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdgroupPerformance report.
AllConversions Double Metric All Conv All Conv for the AdgroupPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdgroupPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdgroupPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdgroupPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdgroupPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdgroupPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdgroupPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the AdgroupPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AdgroupPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the AdgroupPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the AdgroupPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the AdgroupPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the AdgroupPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the AdgroupPerformance report.
Clicks Long Metric Clicks Clicks for the AdgroupPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the AdgroupPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the AdgroupPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdgroupPerformance report.
Conversions Double Metric Conversions Conversions for the AdgroupPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdgroupPerformance report.
Cost Decimal Metric Cost Cost for the AdgroupPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdgroupPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdgroupPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the AdgroupPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdgroupPerformance report.
Ctr Double Metric CTR CTR for the AdgroupPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the AdgroupPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the AdgroupPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdgroupPerformance report.
Engagements Long Metric Engagements Engagements for the AdgroupPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AdgroupPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AdgroupPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AdgroupPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the AdgroupPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the AdgroupPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the AdgroupPerformance report.
Impressions Long Metric Impressions Impressions for the AdgroupPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdgroupPerformance report.
Interactions Long Metric Interactions Interactions for the AdgroupPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdgroupPerformance report.
NumOfflineImpressions Long Metric Phone Impressions Phone Impressions for the AdgroupPerformance report.
NumOfflineInteractions Long Metric Phone Calls Phone Calls for the AdgroupPerformance report.
OfflineInteractionRate Double Metric PTR PTR for the AdgroupPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the AdgroupPerformance report.
RelativeCtr Double Metric Relative CTR Relative CTR for the AdgroupPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the AdgroupPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the AdgroupPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the AdgroupPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the AdgroupPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdgroupPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdgroupPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the AdgroupPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AdgroupPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AdgroupPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AdgroupPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AdgroupPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AdgroupPerformance report.
VideoViews Long Metric Views Views for the AdgroupPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AdgroupPerformance report.

Pseudo-Columns

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

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



AdGroups

Service to access details about any ad groups.

Columns

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



AdPerformance

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

Columns

Name Type Behavior DisplayName Description
AccentColor String Attribute Accent Color (responsive) Accent Color (responsive) for the AdPerformance report.
AccountCurrencyCode String Attribute Currency Currency for the AdPerformance report.
AccountDescriptiveName String Attribute Account Account for the AdPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AdPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AdPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AdPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AdPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdStrengthInfo String Attribute Ad Strength Ad Strength for the AdPerformance report.
AdType String Attribute Ad Type Ad Type for the AdPerformance report.

The allowed values are DEPRECATED_AD, IMAGE_AD, PRODUCT_AD, TEMPLATE_AD, TEXT_AD, THIRD_PARTY_REDIRECT_AD, DYNAMIC_SEARCH_AD, CALL_ONLY_AD, EXPANDED_TEXT_AD, RESPONSIVE_DISPLAY_AD, SHOWCASE_AD, GOAL_OPTIMIZED_SHOPPING_AD, EXPANDED_DYNAMIC_SEARCH_AD, GMAIL_AD, RESPONSIVE_SEARCH_AD, MULTI_ASSET_RESPONSIVE_DISPLAY_AD, UNKNOWN.

AllowFlexibleColor String Attribute Allow Flexible Color (responsive) Allow Flexible Color (responsive) for the AdPerformance report.

The allowed values are TRUE, FALSE.

Automated String Attribute Auto-applied Ad Suggestion Auto-applied Ad Suggestion for the AdPerformance report.

The allowed values are TRUE, FALSE.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AdPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AdPerformance report.
BusinessName String Attribute Business Name Business Name for the AdPerformance report.
CallOnlyPhoneNumber String Attribute Call-only Ad Phone Number Call-only Ad Phone Number for the AdPerformance report.
CallToActionText String Attribute Call To Action Text (responsive) Call To Action Text (responsive) for the AdPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AdPerformance report.
CampaignName String Attribute Campaign Campaign for the AdPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AdPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CombinedApprovalStatus String Attribute Approval Status Approval Status for the AdPerformance report.

The allowed values are UNKNOWN, APPROVED, APPROVED_LIMITED, ELIGIBLE, UNDER_REVIEW, DISAPPROVED, SITE_SUSPENDED.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the AdPerformance report.

The allowed values are TRUE, FALSE.

CreativeDestinationUrl String Attribute Destination URL Destination URL for the AdPerformance report.
CreativeFinalAppUrls String Attribute App Final URL App Final URL for the AdPerformance report.
CreativeFinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AdPerformance report.
CreativeFinalUrls String Attribute Final URL Final URL for the AdPerformance report.
CreativeFinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the AdPerformance report.
CreativeTrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AdPerformance report.
CreativeUrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AdPerformance report.
CriterionType String Attribute Criteria Type Criteria Type for the AdPerformance report.

The allowed values are UNKNOWN, AD_SCHEDULE, AGE_RANGE, APP_PAYMENT_MODEL, CARRIER, CONTENT_LABEL, CUSTOM_AFFINITY, GENDER, LOCATION_GROUPS, IP_BLOCK, KEYWORD, LANGUAGE, LOCATION, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, MOBILE_DEVICE, OPERATING_SYSTEM_VERSION, PARENT, PLACEMENT, PLATFORM, PREFERRED_CONTENT, PRODUCT_PARTITION, PRODUCT_SCOPE, PROXIMITY, USER_INTEREST, USER_LIST, VERTICAL, WEBPAGE, YOUTUBE_CHANNEL, YOUTUBE_VIDEO, CUSTOM_IN_MARKET.

CustomerDescriptiveName String Attribute Client Name Client Name for the AdPerformance report.
Description String Attribute Description Description for the AdPerformance report.
Description1 String Attribute Description Line 1 Description Line 1 for the AdPerformance report.
Description2 String Attribute Description Line 2 Description Line 2 for the AdPerformance report.
DevicePreference Long Attribute Device Preference Device Preference for the AdPerformance report.
DisplayUrl String Attribute Display URL Display URL for the AdPerformance report.
EnhancedDisplayCreativeLandscapeLogoImageMediaId Long Attribute Landscape Logo ID (responsive) Landscape Logo ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeLogoImageMediaId Long Attribute Logo ID (responsive) Logo ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeMarketingImageMediaId Long Attribute Image ID (responsive) Image ID (responsive) for the AdPerformance report.
EnhancedDisplayCreativeMarketingImageSquareMediaId Long Attribute Square Image ID (responsive) Square Image ID (responsive) for the AdPerformance report.
ExpandedDynamicSearchCreativeDescription2 String Attribute Expanded Dynamic Search Ad Description 2 Expanded Dynamic Search Ad Description 2 for the AdPerformance report.
ExpandedTextAdDescription2 String Attribute Expanded Text Ad Description 2 Expanded Text Ad Description 2 for the AdPerformance report.
ExpandedTextAdHeadlinePart3 String Attribute Expanded Text Ad Headline 3 Expanded Text Ad Headline 3 for the AdPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AdPerformance report.
FormatSetting String Attribute Ad Format Preference (responsive) Ad Format Preference (responsive) for the AdPerformance report.

The allowed values are UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.

GmailCreativeHeaderImageMediaId Long Attribute Gmail Ad Header Image Media Id Gmail Ad Header Image Media Id for the AdPerformance report.
GmailCreativeLogoImageMediaId Long Attribute Gmail Ad Logo Image Media Id Gmail Ad Logo Image Media Id for the AdPerformance report.
GmailCreativeMarketingImageMediaId Long Attribute Gmail Ad Marketing Image Media Id Gmail Ad Marketing Image Media Id for the AdPerformance report.
GmailTeaserBusinessName String Attribute Gmail Ad Business Name Gmail Ad Business Name for the AdPerformance report.
GmailTeaserDescription String Attribute Gmail Ad Description Gmail Ad Description for the AdPerformance report.
GmailTeaserHeadline String Attribute Gmail Ad Headline Gmail Ad Headline for the AdPerformance report.
Headline String Attribute Ad Ad for the AdPerformance report.
HeadlinePart1 String Attribute Headline 1 Headline 1 for the AdPerformance report.
HeadlinePart2 String Attribute Headline 2 Headline 2 for the AdPerformance report.
Id Long Attribute Ad ID Ad ID for the AdPerformance report.
ImageAdUrl String Attribute Image Ad URL Image Ad URL for the AdPerformance report.
ImageCreativeImageHeight Integer Attribute Image Height Image Height for the AdPerformance report.
ImageCreativeImageWidth Integer Attribute Image Width Image Width for the AdPerformance report.
ImageCreativeMimeType String Attribute Image Mime Type Image Mime Type for the AdPerformance report.
ImageCreativeName String Attribute Image Ad Name Image Ad Name for the AdPerformance report.
IsNegative String Attribute Is Negative Is Negative for the AdPerformance report.

The allowed values are TRUE, FALSE.

LabelIds String Attribute Label IDs Label IDs for the AdPerformance report.
Labels String Attribute Labels Labels for the AdPerformance report.
LongHeadline String Attribute Long Headline Long Headline for the AdPerformance report.
MainColor String Attribute Main Color (responsive) Main Color (responsive) for the AdPerformance report.
MarketingImageCallToActionText String Attribute Gmail Ad Marketing Image Call To Action Text Gmail Ad Marketing Image Call To Action Text for the AdPerformance report.
MarketingImageCallToActionTextColor String Attribute Gmail Ad Marketing Image Call To Action Text Color Gmail Ad Marketing Image Call To Action Text Color for the AdPerformance report.
MarketingImageDescription String Attribute Gmail Ad Marketing Image Description Gmail Ad Marketing Image Description for the AdPerformance report.
MarketingImageHeadline String Attribute Gmail Ad Marketing Image Headline Gmail Ad Marketing Image Headline for the AdPerformance report.
MultiAssetResponsiveDisplayAdAccentColor String Attribute Accent Color (multi Asset Responsive Display) Accent Color (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdAllowFlexibleColor String Attribute Allow Flexible Color (multi Asset Responsive Display) Allow Flexible Color (multi Asset Responsive Display) for the AdPerformance report.

The allowed values are TRUE, FALSE.

MultiAssetResponsiveDisplayAdBusinessName String Attribute Business Name (multi Asset Responsive Display) Business Name (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdCallToActionText String Attribute Call To Action Text (multi Asset Responsive Display) Call To Action Text (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDescriptions String Attribute Descriptions (multi Asset Responsive Display) Descriptions (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix String Attribute Price Prefix (multi Asset Responsive Display) Price Prefix (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdDynamicSettingsPromoText String Attribute Promotion Text (multi Asset Responsive Display) Promotion Text (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdFormatSetting String Attribute Ad Format Preference (multi Asset Responsive Display) Ad Format Preference (multi Asset Responsive Display) for the AdPerformance report.

The allowed values are UNKNOWN, ALL_FORMATS, NON_NATIVE, NATIVE.

MultiAssetResponsiveDisplayAdHeadlines String Attribute Headlines (multi Asset Responsive Display) Headlines (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLandscapeLogoImages String Attribute Landscape Logos (multi Asset Responsive Display) Landscape Logos (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLogoImages String Attribute Logos (multi Asset Responsive Display) Logos (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdLongHeadline String Attribute Long Headline (multi Asset Responsive Display) Long Headline (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdMainColor String Attribute Main Color (multi Asset Responsive Display) Main Color (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdMarketingImages String Attribute Images (multi Asset Responsive Display) Images (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdSquareMarketingImages String Attribute Square Images (multi Asset Responsive Display) Square Images (multi Asset Responsive Display) for the AdPerformance report.
MultiAssetResponsiveDisplayAdYouTubeVideos String Attribute Youtube Videos (multi Asset Responsive Display) Youtube Videos (multi Asset Responsive Display) for the AdPerformance report.
Path1 String Attribute Path 1 Path 1 for the AdPerformance report.
Path6 String Attribute Path 2 Path 2 for the AdPerformance report.
PolicySummary String Attribute Policy Policy for the AdPerformance report.
PricePrefix String Attribute Price Prefix (responsive) Price Prefix (responsive) for the AdPerformance report.
PromoText String Attribute Promotion Text (responsive) Promotion Text (responsive) for the AdPerformance report.
ResponsiveSearchAdDescriptions String Attribute Responsive Search Ad Descriptions Responsive Search Ad Descriptions for the AdPerformance report.
ResponsiveSearchAdHeadlines String Attribute Responsive Search Ad Headlines Responsive Search Ad Headlines for the AdPerformance report.
ResponsiveSearchAdPath1 String Attribute Responsive Search Ad Path 1 Responsive Search Ad Path 1 for the AdPerformance report.
ResponsiveSearchAdPath6 String Attribute Responsive Search Ad Path 2 Responsive Search Ad Path 2 for the AdPerformance report.
ShortHeadline String Attribute Short Headline Short Headline for the AdPerformance report.
Status String Attribute Ad State Ad State for the AdPerformance report.

The allowed values are ENABLED, PAUSED, DISABLED.

SystemManagedEntitySource String Attribute System Managed Entity Source System Managed Entity Source for the AdPerformance report.

The allowed values are UNKNOWN, AD_VARIATIONS.

AdNetworkType1 String Segment Network Network for the AdPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AdPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the AdPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the AdPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AdPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the AdPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AdPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AdPerformance report.
CriterionId Long Segment Keyword ID Keyword ID for the AdPerformance report.
Date Date Segment Day Day for the AdPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AdPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AdPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AdPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the AdPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AdPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AdPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AdPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the AdPerformance report.
Year Integer Segment Year Year for the AdPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AdPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AdPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AdPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AdPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AdPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AdPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AdPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AdPerformance report.
AllConversions Double Metric All Conv All Conv for the AdPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AdPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AdPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AdPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AdPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AdPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AdPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the AdPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AdPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the AdPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the AdPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the AdPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the AdPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the AdPerformance report.
Clicks Long Metric Clicks Clicks for the AdPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AdPerformance report.
Conversions Double Metric Conversions Conversions for the AdPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AdPerformance report.
Cost Decimal Metric Cost Cost for the AdPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AdPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AdPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the AdPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AdPerformance report.
Ctr Double Metric CTR CTR for the AdPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the AdPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the AdPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AdPerformance report.
Engagements Long Metric Engagements Engagements for the AdPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AdPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AdPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AdPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the AdPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the AdPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the AdPerformance report.
Impressions Long Metric Impressions Impressions for the AdPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AdPerformance report.
Interactions Long Metric Interactions Interactions for the AdPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AdPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the AdPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AdPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AdPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the AdPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AdPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AdPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AdPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AdPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AdPerformance report.
VideoViews Long Metric Views Views for the AdPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AdPerformance report.

Pseudo-Columns

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

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



AgeRangePerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AgeRangePerformance report.
AccountDescriptiveName String Attribute Account Account for the AgeRangePerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AgeRangePerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AgeRangePerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AgeRangePerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AgeRangePerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AgeRangePerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AgeRangePerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AgeRangePerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AgeRangePerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AgeRangePerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the AgeRangePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AgeRangePerformance report.
CampaignName String Attribute Campaign Campaign for the AgeRangePerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AgeRangePerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the AgeRangePerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the AgeRangePerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the AgeRangePerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the AgeRangePerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Age Range Age Range for the AgeRangePerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the AgeRangePerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AgeRangePerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AgeRangePerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the AgeRangePerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AgeRangePerformance report.
FinalUrls String Attribute Final URL Final URL for the AgeRangePerformance report.
Id Long Attribute Criterion ID Criterion ID for the AgeRangePerformance report.
IsNegative String Attribute Is Negative Is Negative for the AgeRangePerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the AgeRangePerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Age Range State Age Range State for the AgeRangePerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AgeRangePerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AgeRangePerformance report.
AdNetworkType1 String Segment Network Network for the AgeRangePerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AgeRangePerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the AgeRangePerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AgeRangePerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AgeRangePerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AgeRangePerformance report.
Date Date Segment Day Day for the AgeRangePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AgeRangePerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AgeRangePerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AgeRangePerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the AgeRangePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AgeRangePerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AgeRangePerformance report.
Week String Segment Week Week for the AgeRangePerformance report.
Year Integer Segment Year Year for the AgeRangePerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AgeRangePerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AgeRangePerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AgeRangePerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AgeRangePerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AgeRangePerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AgeRangePerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AgeRangePerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AgeRangePerformance report.
AllConversions Double Metric All Conv All Conv for the AgeRangePerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AgeRangePerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AgeRangePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AgeRangePerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AgeRangePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AgeRangePerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AgeRangePerformance report.
Clicks Long Metric Clicks Clicks for the AgeRangePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AgeRangePerformance report.
Conversions Double Metric Conversions Conversions for the AgeRangePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AgeRangePerformance report.
Cost Decimal Metric Cost Cost for the AgeRangePerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AgeRangePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AgeRangePerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AgeRangePerformance report.
Ctr Double Metric CTR CTR for the AgeRangePerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AgeRangePerformance report.
Engagements Long Metric Engagements Engagements for the AgeRangePerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AgeRangePerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AgeRangePerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AgeRangePerformance report.
Impressions Long Metric Impressions Impressions for the AgeRangePerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AgeRangePerformance report.
Interactions Long Metric Interactions Interactions for the AgeRangePerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AgeRangePerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AgeRangePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AgeRangePerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AgeRangePerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AgeRangePerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AgeRangePerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AgeRangePerformance report.
VideoViewRate Double Metric View Rate View Rate for the AgeRangePerformance report.
VideoViews Long Metric Views Views for the AgeRangePerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AgeRangePerformance report.

Pseudo-Columns

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

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



AudiencePerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AudiencePerformance report.
AccountDescriptiveName String Attribute Account Account for the AudiencePerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AudiencePerformance report.
BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the AudiencePerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the AudiencePerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the AudiencePerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the AudiencePerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the AudiencePerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the AudiencePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the AudiencePerformance report.
CampaignName String Attribute Campaign Campaign for the AudiencePerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AudiencePerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the AudiencePerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the AudiencePerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the AudiencePerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the AudiencePerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Audience Audience for the AudiencePerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the AudiencePerformance report.
CriterionAttachmentLevel String Attribute Level Level for the AudiencePerformance report.

The allowed values are UNKNOWN, ADGROUP, CAMPAIGN, CUSTOMER.

CustomerDescriptiveName String Attribute Client Name Client Name for the AudiencePerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AudiencePerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the AudiencePerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the AudiencePerformance report.
FinalUrls String Attribute Final URL Final URL for the AudiencePerformance report.
Id Long Attribute Criterion ID Criterion ID for the AudiencePerformance report.
IsRestrict String Attribute Is Restricting Is Restricting for the AudiencePerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Audience State Audience State for the AudiencePerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the AudiencePerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the AudiencePerformance report.
UserListName String Attribute User List Name User List Name for the AudiencePerformance report.
AdGroupId Long Segment Ad Group ID Ad Group ID for the AudiencePerformance report.
AdGroupName String Segment Ad Group Ad Group for the AudiencePerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the AudiencePerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdNetworkType1 String Segment Network Network for the AudiencePerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AudiencePerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the AudiencePerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AudiencePerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AudiencePerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AudiencePerformance report.
Date Date Segment Day Day for the AudiencePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AudiencePerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the AudiencePerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AudiencePerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the AudiencePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AudiencePerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AudiencePerformance report.
Slot String Segment Top Vs Other Top Vs Other for the AudiencePerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the AudiencePerformance report.
Year Integer Segment Year Year for the AudiencePerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AudiencePerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AudiencePerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AudiencePerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AudiencePerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AudiencePerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AudiencePerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AudiencePerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AudiencePerformance report.
AllConversions Double Metric All Conv All Conv for the AudiencePerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AudiencePerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AudiencePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AudiencePerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AudiencePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AudiencePerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AudiencePerformance report.
AveragePosition Double Metric Avg Position Avg Position for the AudiencePerformance report.
Clicks Long Metric Clicks Clicks for the AudiencePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AudiencePerformance report.
Conversions Double Metric Conversions Conversions for the AudiencePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AudiencePerformance report.
Cost Decimal Metric Cost Cost for the AudiencePerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AudiencePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AudiencePerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AudiencePerformance report.
Ctr Double Metric CTR CTR for the AudiencePerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AudiencePerformance report.
Engagements Long Metric Engagements Engagements for the AudiencePerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the AudiencePerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the AudiencePerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the AudiencePerformance report.
Impressions Long Metric Impressions Impressions for the AudiencePerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AudiencePerformance report.
Interactions Long Metric Interactions Interactions for the AudiencePerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AudiencePerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AudiencePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AudiencePerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the AudiencePerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the AudiencePerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the AudiencePerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the AudiencePerformance report.
VideoViewRate Double Metric View Rate View Rate for the AudiencePerformance report.
VideoViews Long Metric Views Views for the AudiencePerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AudiencePerformance report.

Pseudo-Columns

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

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



AutomaticPlacementsPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the AutomaticPlacementsPerformance report.
AccountDescriptiveName String Attribute Account Account for the AutomaticPlacementsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the AutomaticPlacementsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the AutomaticPlacementsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the AutomaticPlacementsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the AutomaticPlacementsPerformance report.
CampaignName String Attribute Campaign Campaign for the AutomaticPlacementsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CriteriaParameters String Attribute URL URL for the AutomaticPlacementsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the AutomaticPlacementsPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the AutomaticPlacementsPerformance report.
Domain String Attribute Domain Domain for the AutomaticPlacementsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the AutomaticPlacementsPerformance report.
IsBidOnPath String Attribute Added Added for the AutomaticPlacementsPerformance report.
IsPathExcluded String Attribute Excluded Excluded for the AutomaticPlacementsPerformance report.
AdFormat String Segment Ad Type Ad Type for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.

AdNetworkType1 String Segment Network Network for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the AutomaticPlacementsPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the AutomaticPlacementsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the AutomaticPlacementsPerformance report.
Date Date Segment Day Day for the AutomaticPlacementsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the AutomaticPlacementsPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

ExternalConversionSource String Segment Conversion Source Conversion Source for the AutomaticPlacementsPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

IsAutoOptimized String Segment Targeting Mode Targeting Mode for the AutomaticPlacementsPerformance report.

The allowed values are TRUE, FALSE.

Month String Segment Month Month for the AutomaticPlacementsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the AutomaticPlacementsPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the AutomaticPlacementsPerformance report.
Week String Segment Week Week for the AutomaticPlacementsPerformance report.
Year Integer Segment Year Year for the AutomaticPlacementsPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the AutomaticPlacementsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the AutomaticPlacementsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the AutomaticPlacementsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the AutomaticPlacementsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the AutomaticPlacementsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the AutomaticPlacementsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the AutomaticPlacementsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the AutomaticPlacementsPerformance report.
AllConversions Double Metric All Conv All Conv for the AutomaticPlacementsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the AutomaticPlacementsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the AutomaticPlacementsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the AutomaticPlacementsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the AutomaticPlacementsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the AutomaticPlacementsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the AutomaticPlacementsPerformance report.
Clicks Long Metric Clicks Clicks for the AutomaticPlacementsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the AutomaticPlacementsPerformance report.
Conversions Double Metric Conversions Conversions for the AutomaticPlacementsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the AutomaticPlacementsPerformance report.
Cost Decimal Metric Cost Cost for the AutomaticPlacementsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the AutomaticPlacementsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the AutomaticPlacementsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the AutomaticPlacementsPerformance report.
Ctr Double Metric CTR CTR for the AutomaticPlacementsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the AutomaticPlacementsPerformance report.
Engagements Long Metric Engagements Engagements for the AutomaticPlacementsPerformance report.
Impressions Long Metric Impressions Impressions for the AutomaticPlacementsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the AutomaticPlacementsPerformance report.
Interactions Long Metric Interactions Interactions for the AutomaticPlacementsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the AutomaticPlacementsPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the AutomaticPlacementsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the AutomaticPlacementsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the AutomaticPlacementsPerformance report.
VideoViews Long Metric Views Views for the AutomaticPlacementsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the AutomaticPlacementsPerformance report.

Pseudo-Columns

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

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



BidGoalPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the BidGoalPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the BidGoalPerformance report.
Id Long Attribute Bid Strategy ID Bid Strategy ID for the BidGoalPerformance report.
Name String Attribute Bid Strategy Name Bid Strategy Name for the BidGoalPerformance report.
PageOnePromotedBidCeiling Decimal Attribute Bid Limit (Target Search Page Location) Bid Limit (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedBidChangesForRaisesOnly String Attribute Bid Automation (Target Search Page Location) Bid Automation (Target Search Page Location) for the BidGoalPerformance report.

The allowed values are TRUE, FALSE.

PageOnePromotedBidModifier Double Attribute Bid Adjustment (Target Search Page Location) Bid Adjustment (Target Search Page Location) for the BidGoalPerformance report.
PageOnePromotedRaiseBidWhenBudgetConstrained String Attribute Limited Budgets (Target Search Page Location) Limited Budgets (Target Search Page Location) for the BidGoalPerformance report.

The allowed values are TRUE, FALSE.

PageOnePromotedRaiseBidWhenLowQualityScore String Attribute Low Quality Keywords (Target Search Page Location) Low Quality Keywords (Target Search Page Location) for the BidGoalPerformance report.

The allowed values are TRUE, FALSE.

PageOnePromotedStrategyGoal String Attribute Location (Target Search Page Location) Location (Target Search Page Location) for the BidGoalPerformance report.
Status String Attribute State State for the BidGoalPerformance report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

TargetCpa Decimal Attribute Target CPA Target CPA for the BidGoalPerformance report.
TargetCpaMaxCpcBidCeiling Decimal Attribute Upper Bid Limit (Target CPA) Upper Bid Limit (Target CPA) for the BidGoalPerformance report.
TargetCpaMaxCpcBidFloor Decimal Attribute Lower Bid Limit (Target CPA) Lower Bid Limit (Target CPA) for the BidGoalPerformance report.
TargetOutrankShare Double Attribute Target Outranking Share Target Outranking Share for the BidGoalPerformance report.
TargetOutrankShareBidChangesForRaisesOnly String Attribute Bid Automation (Target Outranking Share) Bid Automation (Target Outranking Share) for the BidGoalPerformance report.

The allowed values are TRUE, FALSE.

TargetOutrankShareCompetitorDomain String Attribute Competitor Domain (Target Outranking Share) Competitor Domain (Target Outranking Share) for the BidGoalPerformance report.
TargetOutrankShareMaxCpcBidCeiling Decimal Attribute Upper Max Cpc Bid Limit (Target Outranking Share) Upper Max Cpc Bid Limit (Target Outranking Share) for the BidGoalPerformance report.
TargetOutrankShareRaiseBidWhenLowQualityScore String Attribute Low Quality Keywords (Target Outranking Share) Low Quality Keywords (Target Outranking Share) for the BidGoalPerformance report.

The allowed values are TRUE, FALSE.

TargetRoas Double Attribute Target ROAS Target ROAS for the BidGoalPerformance report.
TargetRoasBidCeiling Decimal Attribute Upper Bid Limit (Target ROAS) Upper Bid Limit (Target ROAS) for the BidGoalPerformance report.
TargetRoasBidFloor Decimal Attribute Lower Bid Limit (Target ROAS) Lower Bid Limit (Target ROAS) for the BidGoalPerformance report.
TargetSpendBidCeiling Decimal Attribute Bid Limit (Maximize Clicks) Bid Limit (Maximize Clicks) for the BidGoalPerformance report.
TargetSpendSpendTarget Decimal Attribute Target Spend (Maximize Clicks) Target Spend (Maximize Clicks) for the BidGoalPerformance report.
Type String Attribute Bid Strategy Type Bid Strategy Type for the BidGoalPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the BidGoalPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the BidGoalPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the BidGoalPerformance report.
Date Date Segment Day Day for the BidGoalPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the BidGoalPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the BidGoalPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the BidGoalPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

HourOfDay Integer Segment Hour Of Day Hour Of Day for the BidGoalPerformance report.
Month String Segment Month Month for the BidGoalPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the BidGoalPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the BidGoalPerformance report.
Week String Segment Week Week for the BidGoalPerformance report.
Year Integer Segment Year Year for the BidGoalPerformance report.
AdGroupCount Integer Metric Ad Groups Ad Groups for the BidGoalPerformance report.
AdGroupCriteriaCount Integer Metric Keywords Keywords for the BidGoalPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the BidGoalPerformance report.
AllConversions Double Metric All Conv All Conv for the BidGoalPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the BidGoalPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the BidGoalPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the BidGoalPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the BidGoalPerformance report.
CampaignCount Integer Metric Campaigns Campaigns for the BidGoalPerformance report.
Clicks Long Metric Clicks Clicks for the BidGoalPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the BidGoalPerformance report.
Conversions Double Metric Conversions Conversions for the BidGoalPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the BidGoalPerformance report.
Cost Decimal Metric Cost Cost for the BidGoalPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the BidGoalPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the BidGoalPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the BidGoalPerformance report.
Ctr Double Metric CTR CTR for the BidGoalPerformance report.
Impressions Long Metric Impressions Impressions for the BidGoalPerformance report.
NonRemovedAdGroupCount Long Metric Non-Removed Ad Groups Non-Removed Ad Groups for the BidGoalPerformance report.
NonRemovedAdGroupCriteriaCount Long Metric Non-Removed Keywords Non-Removed Keywords for the BidGoalPerformance report.
NonRemovedCampaignCount Long Metric Non-Removed Campaigns Non-Removed Campaigns for the BidGoalPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the BidGoalPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the BidGoalPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the BidGoalPerformance report.

Pseudo-Columns

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

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



BudgetPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the BudgetPerformance report.
Amount Decimal Attribute Budget Budget for the BudgetPerformance report.
BudgetId Long Attribute Budget ID Budget ID for the BudgetPerformance report.
BudgetName String Attribute Budget Name Budget Name for the BudgetPerformance report.
BudgetReferenceCount Integer Attribute # Campaigns # Campaigns for the BudgetPerformance report.
BudgetStatus String Attribute Budget State Budget State for the BudgetPerformance report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

DeliveryMethod String Attribute Delivery Method Delivery Method for the BudgetPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the BudgetPerformance report.
HasRecommendedBudget String Attribute Has Recommended Budget Has Recommended Budget for the BudgetPerformance report.

The allowed values are TRUE, FALSE.

IsBudgetExplicitlyShared String Attribute Explicitly Shared Explicitly Shared for the BudgetPerformance report.

The allowed values are TRUE, FALSE.

Period String Attribute Budget Period Budget Period for the BudgetPerformance report.
RecommendedBudgetAmount Decimal Attribute Recommended Budget Amount Recommended Budget Amount for the BudgetPerformance report.
TotalAmount Decimal Attribute Total Budget Amount Total Budget Amount for the BudgetPerformance report.
AssociatedCampaignId Long Segment Campaign ID Campaign ID for the BudgetPerformance report.
AssociatedCampaignName String Segment Campaign Campaign for the BudgetPerformance report.
AssociatedCampaignStatus String Segment Campaign State Campaign State for the BudgetPerformance report.

The allowed values are ENABLED, PAUSED, REMOVED, UNKNOWN.

BudgetCampaignAssociationStatus String Segment Budget Usage Budget Usage for the BudgetPerformance report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the BudgetPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the BudgetPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the BudgetPerformance report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the BudgetPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

AllConversionRate Double Metric All Conv Rate All Conv Rate for the BudgetPerformance report.
AllConversions Double Metric All Conv All Conv for the BudgetPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the BudgetPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the BudgetPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the BudgetPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the BudgetPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the BudgetPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the BudgetPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the BudgetPerformance report.
Clicks Long Metric Clicks Clicks for the BudgetPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the BudgetPerformance report.
Conversions Double Metric Conversions Conversions for the BudgetPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the BudgetPerformance report.
Cost Decimal Metric Cost Cost for the BudgetPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the BudgetPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the BudgetPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the BudgetPerformance report.
Ctr Double Metric CTR CTR for the BudgetPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the BudgetPerformance report.
Engagements Long Metric Engagements Engagements for the BudgetPerformance report.
Impressions Long Metric Impressions Impressions for the BudgetPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the BudgetPerformance report.
Interactions Long Metric Interactions Interactions for the BudgetPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyClicks Long Metric Estimated Change In Weekly Clicks At Recommended Budget Estimated Change In Weekly Clicks At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyCost Decimal Metric Estimated Change In Weekly Cost At Recommended Budget Estimated Change In Weekly Cost At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyInteractions Long Metric Estimated Change In Weekly Interactions At Recommended Budget Estimated Change In Weekly Interactions At Recommended Budget for the BudgetPerformance report.
RecommendedBudgetEstimatedChangeInWeeklyViews Long Metric Estimated Change In Weekly Views At Recommended Budget Estimated Change In Weekly Views At Recommended Budget for the BudgetPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the BudgetPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the BudgetPerformance report.
VideoViewRate Double Metric View Rate View Rate for the BudgetPerformance report.
VideoViews Long Metric Views Views for the BudgetPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the BudgetPerformance report.

Pseudo-Columns

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

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



CallMetricsCallDetails

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CallMetricsCallDetails report.
AccountDescriptiveName String Attribute Account Account for the CallMetricsCallDetails report.
AccountTimeZone String Attribute Time Zone Time Zone for the CallMetricsCallDetails report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CallMetricsCallDetails report.
AdGroupName String Attribute Ad Group Ad Group for the CallMetricsCallDetails report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CallMetricsCallDetails report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CallDuration Long Attribute Duration (seconds) Duration (seconds) for the CallMetricsCallDetails report.
CallEndTime Long Attribute End Time End Time for the CallMetricsCallDetails report.
CallerCountryCallingCode String Attribute Caller Country Code Caller Country Code for the CallMetricsCallDetails report.
CallerNationalDesignatedCode String Attribute Caller Area Code Caller Area Code for the CallMetricsCallDetails report.
CallStartTime Long Attribute Start Time Start Time for the CallMetricsCallDetails report.
CallStatus String Attribute Status Status for the CallMetricsCallDetails report.

The allowed values are RECEIVED, MISSED, UNKNOWN.

CallTrackingDisplayLocation String Attribute Call Source Call Source for the CallMetricsCallDetails report.

The allowed values are UNKNOWN, AD, LANDING_PAGE.

CallType String Attribute Call Type Call Type for the CallMetricsCallDetails report.

The allowed values are GOOGLE_SEARCH, HIGH_END_MOBILE_SEARCH, UNKNOWN.

CampaignId Long Attribute Campaign ID Campaign ID for the CallMetricsCallDetails report.
CampaignName String Attribute Campaign Campaign for the CallMetricsCallDetails report.
CampaignStatus String Attribute Campaign State Campaign State for the CallMetricsCallDetails report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the CallMetricsCallDetails report.
Date Date Attribute Day Day for the CallMetricsCallDetails report.
DayOfWeek String Attribute Day Of Week Day Of Week for the CallMetricsCallDetails report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

ExternalCustomerId Long Attribute Customer ID Customer ID for the CallMetricsCallDetails report.
HourOfDay Integer Attribute Hour Of Day Hour Of Day for the CallMetricsCallDetails report.
Month String Attribute Month Month for the CallMetricsCallDetails report.
MonthOfYear String Attribute Month Of Year Month Of Year for the CallMetricsCallDetails report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Attribute Quarter Quarter for the CallMetricsCallDetails report.
Week String Attribute Week Week for the CallMetricsCallDetails report.
Year Integer Attribute Year Year for the CallMetricsCallDetails report.

Pseudo-Columns

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

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



CampaignAdScheduleTarget

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignAdScheduleTarget report.
AccountDescriptiveName String Attribute Account Account for the CampaignAdScheduleTarget report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignAdScheduleTarget report.
BidModifier Double Attribute Bid Adj Bid Adj for the CampaignAdScheduleTarget report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignAdScheduleTarget report.
CampaignName String Attribute Campaign Campaign for the CampaignAdScheduleTarget report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignAdScheduleTarget report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignAdScheduleTarget report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignAdScheduleTarget report.
Id Long Attribute Ad Schedule Ad Schedule for the CampaignAdScheduleTarget report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignAdScheduleTarget report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the CampaignAdScheduleTarget report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignAdScheduleTarget report.
Date Date Segment Day Day for the CampaignAdScheduleTarget report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignAdScheduleTarget report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the CampaignAdScheduleTarget report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignAdScheduleTarget report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the CampaignAdScheduleTarget report.
Week String Segment Week Week for the CampaignAdScheduleTarget report.
Year Integer Segment Year Year for the CampaignAdScheduleTarget report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignAdScheduleTarget report.
AllConversions Double Metric All Conv All Conv for the CampaignAdScheduleTarget report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignAdScheduleTarget report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignAdScheduleTarget report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignAdScheduleTarget report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignAdScheduleTarget report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignAdScheduleTarget report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignAdScheduleTarget report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignAdScheduleTarget report.
Clicks Long Metric Clicks Clicks for the CampaignAdScheduleTarget report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignAdScheduleTarget report.
Conversions Double Metric Conversions Conversions for the CampaignAdScheduleTarget report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignAdScheduleTarget report.
Cost Decimal Metric Cost Cost for the CampaignAdScheduleTarget report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignAdScheduleTarget report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignAdScheduleTarget report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignAdScheduleTarget report.
Ctr Double Metric CTR CTR for the CampaignAdScheduleTarget report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignAdScheduleTarget report.
Engagements Long Metric Engagements Engagements for the CampaignAdScheduleTarget report.
Impressions Long Metric Impressions Impressions for the CampaignAdScheduleTarget report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignAdScheduleTarget report.
Interactions Long Metric Interactions Interactions for the CampaignAdScheduleTarget report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignAdScheduleTarget report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignAdScheduleTarget report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignAdScheduleTarget report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CampaignAdScheduleTarget report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CampaignAdScheduleTarget report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CampaignAdScheduleTarget report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CampaignAdScheduleTarget report.
VideoViewRate Double Metric View Rate View Rate for the CampaignAdScheduleTarget report.
VideoViews Long Metric Views Views for the CampaignAdScheduleTarget report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignAdScheduleTarget report.

Pseudo-Columns

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

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



CampaignCriteria

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignCriteria report.
AccountDescriptiveName String Attribute Account Account for the CampaignCriteria report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignCriteria report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignCriteria report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignCriteria report.
CampaignName String Attribute Campaign Campaign for the CampaignCriteria report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignCriteria report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Criteria String Attribute Criterion Criterion for the CampaignCriteria report.
CriteriaType String Attribute Criteria Type Criteria Type for the CampaignCriteria report.

The allowed values are CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATFORM, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.

CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignCriteria report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignCriteria report.
Id Long Attribute Criterion ID Criterion ID for the CampaignCriteria report.
IsNegative String Attribute Is Negative Is Negative for the CampaignCriteria report.

The allowed values are TRUE, FALSE.

Pseudo-Columns

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

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



CampaignCriterionBidLandscape

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

Columns

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



CampaignGroupPerformance

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

Columns

Name Type Behavior DisplayName Description
Id Long Attribute Campaign Group ID Campaign Group ID for the CampaignGroupPerformance report.
Name String Attribute Campaign Group Name Campaign Group Name for the CampaignGroupPerformance report.
Status String Attribute Campaign Group Status Campaign Group Status for the CampaignGroupPerformance report.

The allowed values are UNKNOWN, ENABLED, REMOVED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignGroupPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the CampaignGroupPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignGroupPerformance report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignGroupPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CampaignGroupPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CampaignGroupPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CampaignGroupPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CampaignGroupPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CampaignGroupPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CampaignGroupPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CampaignGroupPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignGroupPerformance report.
AllConversions Double Metric All Conv All Conv for the CampaignGroupPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignGroupPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignGroupPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignGroupPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignGroupPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignGroupPerformance report.
Conversions Double Metric Conversions Conversions for the CampaignGroupPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignGroupPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignGroupPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignGroupPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CampaignGroupPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignGroupPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CampaignGroupPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CampaignGroupPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignGroupPerformance report.
Engagements Long Metric Engagements Engagements for the CampaignGroupPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignGroupPerformance report.
Interactions Long Metric Interactions Interactions for the CampaignGroupPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignGroupPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignGroupPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CampaignGroupPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CampaignGroupPerformance report.
VideoViews Long Metric Views Views for the CampaignGroupPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignGroupPerformance report.

Pseudo-Columns

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

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



CampaignLocationTarget

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignLocationTarget report.
AccountDescriptiveName String Attribute Account Account for the CampaignLocationTarget report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignLocationTarget report.
BidModifier Double Attribute Bid Adj Bid Adj for the CampaignLocationTarget report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignLocationTarget report.
CampaignName String Attribute Campaign Campaign for the CampaignLocationTarget report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignLocationTarget report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignLocationTarget report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignLocationTarget report.
Id Long Attribute Location Location for the CampaignLocationTarget report.
IsNegative String Attribute Is Negative Is Negative for the CampaignLocationTarget report.

The allowed values are TRUE, FALSE.

ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignLocationTarget report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the CampaignLocationTarget report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignLocationTarget report.
Date Date Segment Day Day for the CampaignLocationTarget report.
ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignLocationTarget report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the CampaignLocationTarget report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignLocationTarget report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the CampaignLocationTarget report.
Week String Segment Week Week for the CampaignLocationTarget report.
Year Integer Segment Year Year for the CampaignLocationTarget report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignLocationTarget report.
AllConversions Double Metric All Conv All Conv for the CampaignLocationTarget report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignLocationTarget report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignLocationTarget report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignLocationTarget report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignLocationTarget report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignLocationTarget report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignLocationTarget report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignLocationTarget report.
Clicks Long Metric Clicks Clicks for the CampaignLocationTarget report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignLocationTarget report.
Conversions Double Metric Conversions Conversions for the CampaignLocationTarget report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignLocationTarget report.
Cost Decimal Metric Cost Cost for the CampaignLocationTarget report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignLocationTarget report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignLocationTarget report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignLocationTarget report.
Ctr Double Metric CTR CTR for the CampaignLocationTarget report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignLocationTarget report.
Engagements Long Metric Engagements Engagements for the CampaignLocationTarget report.
Impressions Long Metric Impressions Impressions for the CampaignLocationTarget report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignLocationTarget report.
Interactions Long Metric Interactions Interactions for the CampaignLocationTarget report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignLocationTarget report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignLocationTarget report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignLocationTarget report.
VideoViewRate Double Metric View Rate View Rate for the CampaignLocationTarget report.
VideoViews Long Metric Views Views for the CampaignLocationTarget report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignLocationTarget report.

Pseudo-Columns

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

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



CampaignNegativeKeywordsPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativeKeywordsPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativeKeywordsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativeKeywordsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativeKeywordsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativeKeywordsPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativeKeywordsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativeKeywordsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Criteria String Attribute Negative Keyword Negative Keyword for the CampaignNegativeKeywordsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativeKeywordsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativeKeywordsPerformance report.
Id Long Attribute Keyword ID Keyword ID for the CampaignNegativeKeywordsPerformance report.
IsNegative String Attribute Is Negative Is Negative for the CampaignNegativeKeywordsPerformance report.

The allowed values are TRUE, FALSE.

KeywordMatchType String Attribute Match Type Match Type for the CampaignNegativeKeywordsPerformance report.

The allowed values are EXACT, PHRASE, BROAD.

Pseudo-Columns

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

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



CampaignNegativeLocations

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativeLocations report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativeLocations report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativeLocations report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativeLocations report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativeLocations report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativeLocations report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativeLocations report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativeLocations report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativeLocations report.
Id Long Attribute Location Location for the CampaignNegativeLocations report.
IsNegative String Attribute Is Negative Is Negative for the CampaignNegativeLocations report.

The allowed values are TRUE, FALSE.

Pseudo-Columns

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

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



CampaignNegativePlacementsPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignNegativePlacementsPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignNegativePlacementsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignNegativePlacementsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignNegativePlacementsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignNegativePlacementsPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignNegativePlacementsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignNegativePlacementsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Criteria String Attribute Exclusion Exclusion for the CampaignNegativePlacementsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignNegativePlacementsPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the CampaignNegativePlacementsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignNegativePlacementsPerformance report.
Id Long Attribute Keyword ID Keyword ID for the CampaignNegativePlacementsPerformance report.
IsNegative String Attribute Is Negative Is Negative for the CampaignNegativePlacementsPerformance report.

The allowed values are TRUE, FALSE.

KeywordMatchType String Attribute Match Type Match Type for the CampaignNegativePlacementsPerformance report.

The allowed values are EXACT, PHRASE, BROAD.

VerticalId Long Attribute Vertical ID Vertical ID for the CampaignNegativePlacementsPerformance report.

Pseudo-Columns

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

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



CampaignPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CampaignPerformance report.
AccountDescriptiveName String Attribute Account Account for the CampaignPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CampaignPerformance report.
AdvertisingChannelSubType String Attribute Advertising Sub Channel Advertising Sub Channel for the CampaignPerformance report.

The allowed values are UNKNOWN, SEARCH_MOBILE_APP, DISPLAY_MOBILE_APP, SEARCH_EXPRESS, DISPLAY_EXPRESS, UNIVERSAL_APP_CAMPAIGN, DISPLAY_SMART_CAMPAIGN, SHOPPING_GOAL_OPTIMIZED_ADS, DISPLAY_GMAIL_AD.

AdvertisingChannelType String Attribute Advertising Channel Advertising Channel for the CampaignPerformance report.

The allowed values are UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.

Amount Decimal Attribute Budget Budget for the CampaignPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CampaignPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the CampaignPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the CampaignPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the CampaignPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BudgetId Long Attribute Budget ID Budget ID for the CampaignPerformance report.
CampaignDesktopBidModifier Double Attribute Desktop Bid Adj Desktop Bid Adj for the CampaignPerformance report.
CampaignGroupId Long Attribute Campaign Group ID Campaign Group ID for the CampaignPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignPerformance report.
CampaignMobileBidModifier Double Attribute Mobile Bid Adj Mobile Bid Adj for the CampaignPerformance report.
CampaignName String Attribute Campaign Campaign for the CampaignPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignTabletBidModifier Double Attribute Tablet Bid Adj Tablet Bid Adj for the CampaignPerformance report.
CampaignTrialType String Attribute Campaign Trial Type Campaign Trial Type for the CampaignPerformance report.

The allowed values are UNKNOWN, BASE, DRAFT, TRIAL.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the CampaignPerformance report.

The allowed values are TRUE, FALSE.

CustomerDescriptiveName String Attribute Client Name Client Name for the CampaignPerformance report.
EndDate Date Attribute End Date End Date for the CampaignPerformance report.
EnhancedCpcEnabled String Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the CampaignPerformance report.

The allowed values are TRUE, FALSE.

ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the CampaignPerformance report.
HasRecommendedBudget String Attribute Has Recommended Budget Has Recommended Budget for the CampaignPerformance report.

The allowed values are TRUE, FALSE.

IsBudgetExplicitlyShared String Attribute Budget Explicitly Shared Budget Explicitly Shared for the CampaignPerformance report.

The allowed values are TRUE, FALSE.

LabelIds String Attribute Label IDs Label IDs for the CampaignPerformance report.
Labels String Attribute Labels Labels for the CampaignPerformance report.
MaximizeConversionValueTargetRoas Double Attribute Target ROAS (Maximize Conversion Value) Target ROAS (Maximize Conversion Value) for the CampaignPerformance report.
Period String Attribute Budget Period Budget Period for the CampaignPerformance report.
RecommendedBudgetAmount Decimal Attribute Recommended Budget Amount Recommended Budget Amount for the CampaignPerformance report.
ServingStatus String Attribute Campaign Serving Status Campaign Serving Status for the CampaignPerformance report.

The allowed values are SERVING, NONE, ENDED, PENDING, SUSPENDED.

StartDate Date Attribute Start Date Start Date for the CampaignPerformance report.
TotalAmount Decimal Attribute Total Budget Amount Total Budget Amount for the CampaignPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the CampaignPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the CampaignPerformance report.
AdNetworkType1 String Segment Network Network for the CampaignPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CampaignPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the CampaignPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the CampaignPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionAttributionEventType String Segment Ad Event Type Ad Event Type for the CampaignPerformance report.

The allowed values are UNKNOWN, IMPRESSION, INTERACTION.

ConversionCategoryName String Segment Conversion Category Conversion Category for the CampaignPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the CampaignPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the CampaignPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CampaignPerformance report.
Date Date Segment Day Day for the CampaignPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the CampaignPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the CampaignPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the CampaignPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

HourOfDay Integer Segment Hour Of Day Hour Of Day for the CampaignPerformance report.
Month String Segment Month Month for the CampaignPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the CampaignPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the CampaignPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the CampaignPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the CampaignPerformance report.
Year Integer Segment Year Year for the CampaignPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CampaignPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CampaignPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CampaignPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CampaignPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CampaignPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CampaignPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CampaignPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CampaignPerformance report.
AllConversions Double Metric All Conv All Conv for the CampaignPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CampaignPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CampaignPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CampaignPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CampaignPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CampaignPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CampaignPerformance report.
AverageFrequency Double Metric Avg Impr Freq Per Cookie Avg Impr Freq Per Cookie for the CampaignPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the CampaignPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the CampaignPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the CampaignPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the CampaignPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the CampaignPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the CampaignPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the CampaignPerformance report.
Clicks Long Metric Clicks Clicks for the CampaignPerformance report.
ContentBudgetLostImpressionShare Double Metric Content Lost IS (budget) Content Lost IS (budget) for the CampaignPerformance report.
ContentImpressionShare Double Metric Content Impr Share Content Impr Share for the CampaignPerformance report.
ContentRankLostImpressionShare Double Metric Content Lost IS (rank) Content Lost IS (rank) for the CampaignPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CampaignPerformance report.
Conversions Double Metric Conversions Conversions for the CampaignPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CampaignPerformance report.
Cost Decimal Metric Cost Cost for the CampaignPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CampaignPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CampaignPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CampaignPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CampaignPerformance report.
Ctr Double Metric CTR CTR for the CampaignPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CampaignPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CampaignPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CampaignPerformance report.
Engagements Long Metric Engagements Engagements for the CampaignPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the CampaignPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the CampaignPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the CampaignPerformance report.
ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the CampaignPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the CampaignPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the CampaignPerformance report.
ImpressionReach Long Metric Unique Cookies Unique Cookies for the CampaignPerformance report.
Impressions Long Metric Impressions Impressions for the CampaignPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CampaignPerformance report.
Interactions Long Metric Interactions Interactions for the CampaignPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CampaignPerformance report.
InvalidClickRate Double Metric Invalid Click Rate Invalid Click Rate for the CampaignPerformance report.
InvalidClicks Long Metric Invalid Clicks Invalid Clicks for the CampaignPerformance report.
NumOfflineImpressions Long Metric Phone Impressions Phone Impressions for the CampaignPerformance report.
NumOfflineInteractions Long Metric Phone Calls Phone Calls for the CampaignPerformance report.
OfflineInteractionRate Double Metric PTR PTR for the CampaignPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the CampaignPerformance report.
RelativeCtr Double Metric Relative CTR Relative CTR for the CampaignPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the CampaignPerformance report.
SearchBudgetLostImpressionShare Double Metric Search Lost IS (budget) Search Lost IS (budget) for the CampaignPerformance report.
SearchClickShare Double Metric Click Share Click Share for the CampaignPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the CampaignPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the CampaignPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the CampaignPerformance report.
SearchTopImpressionShare Double Metric Search top IS Search Top IS for the CampaignPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CampaignPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CampaignPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CampaignPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CampaignPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CampaignPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CampaignPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CampaignPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CampaignPerformance report.
VideoViews Long Metric Views Views for the CampaignPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CampaignPerformance report.



Campaigns

Service to access details about any campaign.

Columns

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



CampaignSharedSet

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the CampaignSharedSet report.
CampaignId Long Attribute Campaign ID Campaign ID for the CampaignSharedSet report.
CampaignName String Attribute Campaign Campaign for the CampaignSharedSet report.
CampaignStatus String Attribute Campaign State Campaign State for the CampaignSharedSet report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ExternalCustomerId Long Attribute Customer ID Customer ID for the CampaignSharedSet report.
SharedSetId Long Attribute Shared Set ID Shared Set ID for the CampaignSharedSet report.
SharedSetName String Attribute Shared Set Name Shared Set Name for the CampaignSharedSet report.
SharedSetType String Attribute Shared Set Type Shared Set Type for the CampaignSharedSet report.

The allowed values are NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.

Status String Attribute State State for the CampaignSharedSet report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

Pseudo-Columns

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

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



ClickPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ClickPerformance report.
AdFormat String Attribute Ad Type Ad Type for the ClickPerformance report.

The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.

AdGroupId Long Attribute Ad Group ID Ad Group ID for the ClickPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ClickPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ClickPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdNetworkType1 String Attribute Network Network for the ClickPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Attribute Network (with Search Partners) Network (with Search Partners) for the ClickPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdVariationControlTrialArmId Long Attribute Ad Variation Control Trial Arm ID Ad Variation Control Trial Arm ID for the ClickPerformance report.
AdVariationTreatmentTrialArmId Long Attribute Ad Variation Treatment Trial Arm ID Ad Variation Treatment Trial Arm ID for the ClickPerformance report.
AdVariationTrialId Long Attribute Ad Variation Trial ID Ad Variation Trial ID for the ClickPerformance report.
AoiCityCriteriaId Integer Attribute City (Location Of Interest) City (Location Of Interest) for the ClickPerformance report.
AoiCountryCriteriaId Integer Attribute Country Per Territory (Location Of Interest) Country Per Territory (Location Of Interest) for the ClickPerformance report.
AoiMetroCriteriaId Integer Attribute Metro Area (Location Of Interest) Metro Area (Location Of Interest) for the ClickPerformance report.
AoiMostSpecificTargetId Long Attribute Most Specific Location Target (Location Of Interest) Most Specific Location Target (Location Of Interest) for the ClickPerformance report.
AoiRegionCriteriaId Integer Attribute Region (Location Of Interest) Region (Location Of Interest) for the ClickPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ClickPerformance report.
CampaignLocationTargetId Long Attribute Campaign Location Target Campaign Location Target for the ClickPerformance report.
CampaignName String Attribute Campaign Campaign for the ClickPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the ClickPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Clicks Long Attribute Clicks Clicks for the ClickPerformance report.
ClickType String Attribute Click Type Click Type for the ClickPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

CreativeId Long Attribute Ad ID Ad ID for the ClickPerformance report.
CriteriaId Long Attribute Keyword ID Keyword ID for the ClickPerformance report.
CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the ClickPerformance report.
Date Date Attribute Day Day for the ClickPerformance report.
Device String Attribute Device Device for the ClickPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalCustomerId Long Attribute Customer ID Customer ID for the ClickPerformance report.
GclId String Attribute Google Click ID Google Click ID for the ClickPerformance report.
KeywordMatchType String Attribute Match Type Match Type for the ClickPerformance report.

The allowed values are UNKNOWN, EXACT, PHRASE, BROAD.

LopCityCriteriaId Integer Attribute City (Physical Location) City (Physical Location) for the ClickPerformance report.
LopCountryCriteriaId Integer Attribute Country Per Territory (Physical Location) Country Per Territory (Physical Location) for the ClickPerformance report.
LopMetroCriteriaId Integer Attribute Metro Area (Physical Location) Metro Area (Physical Location) for the ClickPerformance report.
LopMostSpecificTargetId Long Attribute Most Specific Location Target (Physical Location) Most Specific Location Target (Physical Location) for the ClickPerformance report.
LopRegionCriteriaId Integer Attribute Region (Physical Location) Region (Physical Location) for the ClickPerformance report.
MonthOfYear String Attribute Month Of Year Month Of Year for the ClickPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Page Integer Attribute Page Page for the ClickPerformance report.
Slot String Attribute Top Vs Other Top Vs Other for the ClickPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

UserListId Long Attribute User List ID User List ID for the ClickPerformance report.

Pseudo-Columns

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

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



ConversionTrackers

Service to access details about any conversion tracker.

Columns

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



CreativeConversion

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CreativeConversion report.
AccountDescriptiveName String Attribute Account Account for the CreativeConversion report.
AccountTimeZone String Attribute Time Zone Time Zone for the CreativeConversion report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CreativeConversion report.
AdGroupName String Attribute Ad Group Ad Group for the CreativeConversion report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CreativeConversion report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the CreativeConversion report.
CampaignName String Attribute Campaign Campaign for the CreativeConversion report.
CampaignStatus String Attribute Campaign State Campaign State for the CreativeConversion report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CreativeId Long Attribute Ad ID Ad ID for the CreativeConversion report.
CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the CreativeConversion report.
CriteriaTypeName String Attribute Match Type Match Type for the CreativeConversion report.
CriterionId Long Attribute Keyword ID Keyword ID for the CreativeConversion report.
CustomerDescriptiveName String Attribute Client Name Client Name for the CreativeConversion report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CreativeConversion report.
AdNetworkType1 String Segment Network Network for the CreativeConversion report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CreativeConversion report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionTrackerId Long Segment Free Click Type Free Click Type for the CreativeConversion report.
Date Date Segment Day Day for the CreativeConversion report.
DayOfWeek String Segment Day Of Week Day Of Week for the CreativeConversion report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Month String Segment Month Month for the CreativeConversion report.
Quarter String Segment Quarter Quarter for the CreativeConversion report.
Week String Segment Week Week for the CreativeConversion report.
Year Integer Segment Year Year for the CreativeConversion report.
CreativeConversionRate Double Metric Free Click Rate Free Click Rate for the CreativeConversion report.
CreativeConversions Long Metric Free Clicks Free Clicks for the CreativeConversion report.
Impressions Long Metric Impressions Impressions for the CreativeConversion report.

Pseudo-Columns

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

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



CriteriaPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the CriteriaPerformance report.
AccountDescriptiveName String Attribute Account Account for the CriteriaPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the CriteriaPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the CriteriaPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the CriteriaPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the CriteriaPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ApprovalStatus String Attribute Approval Status Approval Status for the CriteriaPerformance report.

The allowed values are APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the CriteriaPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the CriteriaPerformance report.
BidModifier Double Attribute Bid Adj Bid Adj for the CriteriaPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the CriteriaPerformance report.
CampaignName String Attribute Campaign Campaign for the CriteriaPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the CriteriaPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the CriteriaPerformance report.

The allowed values are TRUE, FALSE.

CpcBid Decimal Attribute Max CPC Max CPC for the CriteriaPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the CriteriaPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the CriteriaPerformance report.
CpvBid Decimal Attribute Max CPV Max CPV for the CriteriaPerformance report.
CpvBidSource String Attribute Max CPV Source Max CPV Source for the CriteriaPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CreativeQualityScore String Attribute Ad Relevance Ad Relevance for the CriteriaPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

Criteria String Attribute Keyword Per Placement Keyword Per Placement for the CriteriaPerformance report.
CriteriaDestinationUrl String Attribute Keyword Per Placement Destination URL Keyword Per Placement Destination URL for the CriteriaPerformance report.
CriteriaType String Attribute Criteria Type Criteria Type for the CriteriaPerformance report.

The allowed values are CONTENT_LABEL, KEYWORD, PLACEMENT, VERTICAL, USER_LIST, USER_INTEREST, MOBILE_APPLICATION, MOBILE_APP_CATEGORY, PRODUCT_PARTITION, IP_BLOCK, WEBPAGE, LANGUAGE, LOCATION, AGE_RANGE, CARRIER, OPERATING_SYSTEM_VERSION, MOBILE_DEVICE, GENDER, PARENT, PROXIMITY, PLATFORM, PREFERRED_CONTENT, AD_SCHEDULE, LOCATION_GROUPS, PRODUCT_SCOPE, RUN_OF_NETWORK, CUSTOM_AFFINITY, CUSTOM_INTENT, YOUTUBE_VIDEO, YOUTUBE_CHANNEL, APP_PAYMENT_MODEL, INCOME_RANGE, INTERACTION_TYPE, UNKNOWN.

CustomerDescriptiveName String Attribute Client Name Client Name for the CriteriaPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the CriteriaPerformance report.
EnhancedCpcEnabled String Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the CriteriaPerformance report.

The allowed values are TRUE, FALSE.

EstimatedAddClicksAtFirstPositionCpc Long Attribute Est Add Clicks Per wk (first Position Bid) Est Add Clicks Per wk (first Position Bid) for the CriteriaPerformance report.
EstimatedAddCostAtFirstPositionCpc Decimal Attribute Est Add Cost Per wk (first Position Bid) Est Add Cost Per wk (first Position Bid) for the CriteriaPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the CriteriaPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the CriteriaPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the CriteriaPerformance report.
FinalUrls String Attribute Final URL Final URL for the CriteriaPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the CriteriaPerformance report.
FirstPageCpc String Attribute First Page CPC First Page CPC for the CriteriaPerformance report.
FirstPositionCpc String Attribute First Position CPC First Position CPC for the CriteriaPerformance report.
HasQualityScore String Attribute Has Quality Score Has Quality Score for the CriteriaPerformance report.

The allowed values are TRUE, FALSE.

Id Long Attribute Keyword ID Keyword ID for the CriteriaPerformance report.
IsNegative String Attribute Is Negative Is Negative for the CriteriaPerformance report.

The allowed values are TRUE, FALSE.

LabelIds String Attribute Label IDs Label IDs for the CriteriaPerformance report.
Labels String Attribute Labels Labels for the CriteriaPerformance report.
Parameter String Attribute Dynamic Ad Target Dynamic Ad Target for the CriteriaPerformance report.
PostClickQualityScore String Attribute Landing Page Experience Landing Page Experience for the CriteriaPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

QualityScore Integer Attribute Quality Score Quality Score for the CriteriaPerformance report.
SearchPredictedCtr String Attribute Expected Clickthrough Rate Expected Clickthrough Rate for the CriteriaPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

Status String Attribute Keyword Per Placement State Keyword Per Placement State for the CriteriaPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

SystemServingStatus String Attribute Criterion Serving Status Criterion Serving Status for the CriteriaPerformance report.

The allowed values are ELIGIBLE, RARELY_SERVED.

TopOfPageCpc String Attribute Top Of Page CPC Top Of Page CPC for the CriteriaPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the CriteriaPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the CriteriaPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the CriteriaPerformance report.
AdNetworkType1 String Segment Network Network for the CriteriaPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the CriteriaPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the CriteriaPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the CriteriaPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the CriteriaPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the CriteriaPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the CriteriaPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the CriteriaPerformance report.
Date Date Segment Day Day for the CriteriaPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the CriteriaPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the CriteriaPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the CriteriaPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the CriteriaPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the CriteriaPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the CriteriaPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the CriteriaPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the CriteriaPerformance report.
Year Integer Segment Year Year for the CriteriaPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the CriteriaPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the CriteriaPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the CriteriaPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the CriteriaPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the CriteriaPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the CriteriaPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the CriteriaPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the CriteriaPerformance report.
AllConversions Double Metric All Conv All Conv for the CriteriaPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the CriteriaPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the CriteriaPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the CriteriaPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the CriteriaPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the CriteriaPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the CriteriaPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the CriteriaPerformance report.
Clicks Long Metric Clicks Clicks for the CriteriaPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the CriteriaPerformance report.
Conversions Double Metric Conversions Conversions for the CriteriaPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the CriteriaPerformance report.
Cost Decimal Metric Cost Cost for the CriteriaPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the CriteriaPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the CriteriaPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the CriteriaPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the CriteriaPerformance report.
Ctr Double Metric CTR CTR for the CriteriaPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the CriteriaPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the CriteriaPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the CriteriaPerformance report.
Engagements Long Metric Engagements Engagements for the CriteriaPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the CriteriaPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the CriteriaPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the CriteriaPerformance report.
Impressions Long Metric Impressions Impressions for the CriteriaPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the CriteriaPerformance report.
Interactions Long Metric Interactions Interactions for the CriteriaPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the CriteriaPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the CriteriaPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the CriteriaPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the CriteriaPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the CriteriaPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the CriteriaPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the CriteriaPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the CriteriaPerformance report.
VideoViewRate Double Metric View Rate View Rate for the CriteriaPerformance report.
VideoViews Long Metric Views Views for the CriteriaPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the CriteriaPerformance report.

Pseudo-Columns

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

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



CriterionBidLandscape

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

Columns

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



Customers

Service to access basic details about any customer.

Columns

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



DisplayKeywordPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the DisplayKeywordPerformance report.
AccountDescriptiveName String Attribute Account Account for the DisplayKeywordPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the DisplayKeywordPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the DisplayKeywordPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the DisplayKeywordPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the DisplayKeywordPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the DisplayKeywordPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the DisplayKeywordPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the DisplayKeywordPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the DisplayKeywordPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

CampaignId Long Attribute Campaign ID Campaign ID for the DisplayKeywordPerformance report.
CampaignName String Attribute Campaign Campaign for the DisplayKeywordPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the DisplayKeywordPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the DisplayKeywordPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpvBid Decimal Attribute Max CPV Max CPV for the DisplayKeywordPerformance report.
CpvBidSource String Attribute Max CPV Source Max CPV Source for the DisplayKeywordPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Keyword Keyword for the DisplayKeywordPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the DisplayKeywordPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the DisplayKeywordPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the DisplayKeywordPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the DisplayKeywordPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the DisplayKeywordPerformance report.
FinalUrls String Attribute Final URL Final URL for the DisplayKeywordPerformance report.
Id Long Attribute Keyword ID Keyword ID for the DisplayKeywordPerformance report.
IsNegative String Attribute Is Negative Is Negative for the DisplayKeywordPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the DisplayKeywordPerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Keyword State Keyword State for the DisplayKeywordPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the DisplayKeywordPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the DisplayKeywordPerformance report.
AdNetworkType1 String Segment Network Network for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the DisplayKeywordPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the DisplayKeywordPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the DisplayKeywordPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the DisplayKeywordPerformance report.
Date Date Segment Day Day for the DisplayKeywordPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the DisplayKeywordPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the DisplayKeywordPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the DisplayKeywordPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the DisplayKeywordPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the DisplayKeywordPerformance report.
Week String Segment Week Week for the DisplayKeywordPerformance report.
Year Integer Segment Year Year for the DisplayKeywordPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the DisplayKeywordPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the DisplayKeywordPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the DisplayKeywordPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the DisplayKeywordPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the DisplayKeywordPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the DisplayKeywordPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the DisplayKeywordPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the DisplayKeywordPerformance report.
AllConversions Double Metric All Conv All Conv for the DisplayKeywordPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the DisplayKeywordPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the DisplayKeywordPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the DisplayKeywordPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the DisplayKeywordPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the DisplayKeywordPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the DisplayKeywordPerformance report.
Clicks Long Metric Clicks Clicks for the DisplayKeywordPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the DisplayKeywordPerformance report.
Conversions Double Metric Conversions Conversions for the DisplayKeywordPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the DisplayKeywordPerformance report.
Cost Decimal Metric Cost Cost for the DisplayKeywordPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the DisplayKeywordPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the DisplayKeywordPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the DisplayKeywordPerformance report.
Ctr Double Metric CTR CTR for the DisplayKeywordPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the DisplayKeywordPerformance report.
Engagements Long Metric Engagements Engagements for the DisplayKeywordPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the DisplayKeywordPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the DisplayKeywordPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the DisplayKeywordPerformance report.
Impressions Long Metric Impressions Impressions for the DisplayKeywordPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the DisplayKeywordPerformance report.
Interactions Long Metric Interactions Interactions for the DisplayKeywordPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the DisplayKeywordPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the DisplayKeywordPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the DisplayKeywordPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the DisplayKeywordPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the DisplayKeywordPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the DisplayKeywordPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the DisplayKeywordPerformance report.
VideoViewRate Double Metric View Rate View Rate for the DisplayKeywordPerformance report.
VideoViews Long Metric Views Views for the DisplayKeywordPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the DisplayKeywordPerformance report.

Pseudo-Columns

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

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



DisplayTopicsPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the DisplayTopicsPerformance report.
AccountDescriptiveName String Attribute Account Account for the DisplayTopicsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the DisplayTopicsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the DisplayTopicsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the DisplayTopicsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the DisplayTopicsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the DisplayTopicsPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the DisplayTopicsPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the DisplayTopicsPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the DisplayTopicsPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the DisplayTopicsPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the DisplayTopicsPerformance report.
CampaignName String Attribute Campaign Campaign for the DisplayTopicsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the DisplayTopicsPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the DisplayTopicsPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the DisplayTopicsPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the DisplayTopicsPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Topic Topic for the DisplayTopicsPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the DisplayTopicsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the DisplayTopicsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the DisplayTopicsPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the DisplayTopicsPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the DisplayTopicsPerformance report.
FinalUrls String Attribute Final URL Final URL for the DisplayTopicsPerformance report.
Id Long Attribute Criterion ID Criterion ID for the DisplayTopicsPerformance report.
IsNegative String Attribute Is Negative Is Negative for the DisplayTopicsPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the DisplayTopicsPerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Topic State Topic State for the DisplayTopicsPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the DisplayTopicsPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the DisplayTopicsPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the DisplayTopicsPerformance report.
AdNetworkType1 String Segment Network Network for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the DisplayTopicsPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the DisplayTopicsPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the DisplayTopicsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the DisplayTopicsPerformance report.
Date Date Segment Day Day for the DisplayTopicsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the DisplayTopicsPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the DisplayTopicsPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the DisplayTopicsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the DisplayTopicsPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the DisplayTopicsPerformance report.
Week String Segment Week Week for the DisplayTopicsPerformance report.
Year Integer Segment Year Year for the DisplayTopicsPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the DisplayTopicsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the DisplayTopicsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the DisplayTopicsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the DisplayTopicsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the DisplayTopicsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the DisplayTopicsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the DisplayTopicsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the DisplayTopicsPerformance report.
AllConversions Double Metric All Conv All Conv for the DisplayTopicsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the DisplayTopicsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the DisplayTopicsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the DisplayTopicsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the DisplayTopicsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the DisplayTopicsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the DisplayTopicsPerformance report.
Clicks Long Metric Clicks Clicks for the DisplayTopicsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the DisplayTopicsPerformance report.
Conversions Double Metric Conversions Conversions for the DisplayTopicsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the DisplayTopicsPerformance report.
Cost Decimal Metric Cost Cost for the DisplayTopicsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the DisplayTopicsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the DisplayTopicsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the DisplayTopicsPerformance report.
Ctr Double Metric CTR CTR for the DisplayTopicsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the DisplayTopicsPerformance report.
Engagements Long Metric Engagements Engagements for the DisplayTopicsPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the DisplayTopicsPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the DisplayTopicsPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the DisplayTopicsPerformance report.
Impressions Long Metric Impressions Impressions for the DisplayTopicsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the DisplayTopicsPerformance report.
Interactions Long Metric Interactions Interactions for the DisplayTopicsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the DisplayTopicsPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the DisplayTopicsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the DisplayTopicsPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the DisplayTopicsPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the DisplayTopicsPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the DisplayTopicsPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the DisplayTopicsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the DisplayTopicsPerformance report.
VideoViews Long Metric Views Views for the DisplayTopicsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the DisplayTopicsPerformance report.

Pseudo-Columns

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

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



FinalUrl

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the FinalUrl report.
AccountDescriptiveName String Attribute Account Account for the FinalUrl report.
AccountTimeZone String Attribute Time Zone Time Zone for the FinalUrl report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the FinalUrl report.
AdGroupName String Attribute Ad Group Ad Group for the FinalUrl report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the FinalUrl report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdvertisingChannelType String Attribute Advertising Channel Advertising Channel for the FinalUrl report.

The allowed values are UNKNOWN, SEARCH, DISPLAY, SHOPPING, VIDEO, MULTI_CHANNEL, EXPRESS.

CampaignId Long Attribute Campaign ID Campaign ID for the FinalUrl report.
CampaignName String Attribute Campaign Campaign for the FinalUrl report.
CampaignStatus String Attribute Campaign State Campaign State for the FinalUrl report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CriteriaTypeName String Attribute Match Type Match Type for the FinalUrl report.
CustomerDescriptiveName String Attribute Client Name Client Name for the FinalUrl report.
EffectiveFinalUrl String Attribute Final URL Final URL for the FinalUrl report.
EffectiveTrackingUrlTemplate String Attribute Tracking Template Tracking Template for the FinalUrl report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the FinalUrl report.
AdNetworkType1 String Segment Network Network for the FinalUrl report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the FinalUrl report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the FinalUrl report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the FinalUrl report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the FinalUrl report.
ConversionTypeName String Segment Conversion Name Conversion Name for the FinalUrl report.
CriteriaParameters String Segment Keyword Per Placement Keyword Per Placement for the FinalUrl report.
Date Date Segment Day Day for the FinalUrl report.
DayOfWeek String Segment Day Of Week Day Of Week for the FinalUrl report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the FinalUrl report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the FinalUrl report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the FinalUrl report.
MonthOfYear String Segment Month Of Year Month Of Year for the FinalUrl report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the FinalUrl report.
Slot String Segment Top Vs Other Top Vs Other for the FinalUrl report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the FinalUrl report.
Year Integer Segment Year Year for the FinalUrl report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the FinalUrl report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the FinalUrl report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the FinalUrl report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the FinalUrl report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the FinalUrl report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the FinalUrl report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the FinalUrl report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the FinalUrl report.
AllConversions Double Metric All Conv All Conv for the FinalUrl report.
AllConversionValue Double Metric All Conv Value All Conv Value for the FinalUrl report.
AverageCost Decimal Metric Avg Cost Avg Cost for the FinalUrl report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the FinalUrl report.
AverageCpe Double Metric Avg CPE Avg CPE for the FinalUrl report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the FinalUrl report.
AverageCpv Double Metric Avg CPV Avg CPV for the FinalUrl report.
AveragePosition Double Metric Avg Position Avg Position for the FinalUrl report.
Clicks Long Metric Clicks Clicks for the FinalUrl report.
ConversionRate Double Metric Conv Rate Conv Rate for the FinalUrl report.
Conversions Double Metric Conversions Conversions for the FinalUrl report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the FinalUrl report.
Cost Decimal Metric Cost Cost for the FinalUrl report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the FinalUrl report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the FinalUrl report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the FinalUrl report.
Ctr Double Metric CTR CTR for the FinalUrl report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the FinalUrl report.
Engagements Long Metric Engagements Engagements for the FinalUrl report.
Impressions Long Metric Impressions Impressions for the FinalUrl report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the FinalUrl report.
Interactions Long Metric Interactions Interactions for the FinalUrl report.
InteractionTypes String Metric Interaction Types Interaction Types for the FinalUrl report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the FinalUrl report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the FinalUrl report.
VideoViewRate Double Metric View Rate View Rate for the FinalUrl report.
VideoViews Long Metric Views Views for the FinalUrl report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the FinalUrl report.

Pseudo-Columns

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

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



GenderPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the GenderPerformance report.
AccountDescriptiveName String Attribute Account Account for the GenderPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the GenderPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the GenderPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the GenderPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the GenderPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the GenderPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the GenderPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the GenderPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the GenderPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the GenderPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the GenderPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the GenderPerformance report.
CampaignName String Attribute Campaign Campaign for the GenderPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the GenderPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the GenderPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the GenderPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the GenderPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the GenderPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Gender Gender for the GenderPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the GenderPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the GenderPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the GenderPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the GenderPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the GenderPerformance report.
FinalUrls String Attribute Final URL Final URL for the GenderPerformance report.
Id Long Attribute Criterion ID Criterion ID for the GenderPerformance report.
IsNegative String Attribute Is Negative Is Negative for the GenderPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the GenderPerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Gender State Gender State for the GenderPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the GenderPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the GenderPerformance report.
AdNetworkType1 String Segment Network Network for the GenderPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the GenderPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the GenderPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the GenderPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the GenderPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the GenderPerformance report.
Date Date Segment Day Day for the GenderPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the GenderPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the GenderPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the GenderPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the GenderPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the GenderPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the GenderPerformance report.
Week String Segment Week Week for the GenderPerformance report.
Year Integer Segment Year Year for the GenderPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the GenderPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the GenderPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the GenderPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the GenderPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the GenderPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the GenderPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the GenderPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the GenderPerformance report.
AllConversions Double Metric All Conv All Conv for the GenderPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the GenderPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the GenderPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the GenderPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the GenderPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the GenderPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the GenderPerformance report.
Clicks Long Metric Clicks Clicks for the GenderPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the GenderPerformance report.
Conversions Double Metric Conversions Conversions for the GenderPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the GenderPerformance report.
Cost Decimal Metric Cost Cost for the GenderPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the GenderPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the GenderPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the GenderPerformance report.
Ctr Double Metric CTR CTR for the GenderPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the GenderPerformance report.
Engagements Long Metric Engagements Engagements for the GenderPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the GenderPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the GenderPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the GenderPerformance report.
Impressions Long Metric Impressions Impressions for the GenderPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the GenderPerformance report.
Interactions Long Metric Interactions Interactions for the GenderPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the GenderPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the GenderPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the GenderPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the GenderPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the GenderPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the GenderPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the GenderPerformance report.
VideoViewRate Double Metric View Rate View Rate for the GenderPerformance report.
VideoViews Long Metric Views Views for the GenderPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the GenderPerformance report.

Pseudo-Columns

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

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



GeoPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the GeoPerformance report.
AccountDescriptiveName String Attribute Account Account for the GeoPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the GeoPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the GeoPerformance report.
CampaignName String Attribute Campaign Campaign for the GeoPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the GeoPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CityCriteriaId Integer Attribute City City for the GeoPerformance report.
CountryCriteriaId Integer Attribute Country Per Territory Country Per Territory for the GeoPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the GeoPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the GeoPerformance report.
IsTargetingLocation String Attribute Is Targetable Is Targetable for the GeoPerformance report.

The allowed values are TRUE, FALSE.

MetroCriteriaId Integer Attribute Metro Area Metro Area for the GeoPerformance report.
MostSpecificCriteriaId Long Attribute Most Specific Location Most Specific Location for the GeoPerformance report.
RegionCriteriaId Integer Attribute Region Region for the GeoPerformance report.
AdFormat String Segment Ad Type Ad Type for the GeoPerformance report.

The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.

AdGroupId Long Segment Ad Group ID Ad Group ID for the GeoPerformance report.
AdGroupName String Segment Ad Group Ad Group for the GeoPerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the GeoPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdNetworkType1 String Segment Network Network for the GeoPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the GeoPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the GeoPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the GeoPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the GeoPerformance report.
Date Date Segment Day Day for the GeoPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the GeoPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the GeoPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the GeoPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

LocationType String Segment Location Type Location Type for the GeoPerformance report.

The allowed values are AREA_OF_INTEREST, LOCATION_OF_PRESENCE, UNKNOWN.

Month String Segment Month Month for the GeoPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the GeoPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the GeoPerformance report.
Week String Segment Week Week for the GeoPerformance report.
Year Integer Segment Year Year for the GeoPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the GeoPerformance report.
AllConversions Double Metric All Conv All Conv for the GeoPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the GeoPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the GeoPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the GeoPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the GeoPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the GeoPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the GeoPerformance report.
Clicks Long Metric Clicks Clicks for the GeoPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the GeoPerformance report.
Conversions Double Metric Conversions Conversions for the GeoPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the GeoPerformance report.
Cost Decimal Metric Cost Cost for the GeoPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the GeoPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the GeoPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the GeoPerformance report.
Ctr Double Metric CTR CTR for the GeoPerformance report.
Impressions Long Metric Impressions Impressions for the GeoPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the GeoPerformance report.
Interactions Long Metric Interactions Interactions for the GeoPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the GeoPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the GeoPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the GeoPerformance report.
VideoViewRate Double Metric View Rate View Rate for the GeoPerformance report.
VideoViews Long Metric Views Views for the GeoPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the GeoPerformance report.

Pseudo-Columns

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

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



KeywordlessCategory

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordlessCategory report.
AccountDescriptiveName String Attribute Account Account for the KeywordlessCategory report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordlessCategory report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordlessCategory report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordlessCategory report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordlessCategory report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the KeywordlessCategory report.
CampaignName String Attribute Campaign Campaign for the KeywordlessCategory report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordlessCategory report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Category0 String Attribute Top Level Categories Top Level Categories for the KeywordlessCategory report.
Category1 String Attribute First Level Sub-categories First Level Sub-categories for the KeywordlessCategory report.
Category2 String Attribute Second Level Sub-categories Second Level Sub-categories for the KeywordlessCategory report.
CriterionId Long Attribute Keyword ID Keyword ID for the KeywordlessCategory report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordlessCategory report.
Domain String Attribute Domain Domain for the KeywordlessCategory report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordlessCategory report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordlessCategory report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the KeywordlessCategory report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordlessCategory report.
Date Date Segment Day Day for the KeywordlessCategory report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordlessCategory report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordlessCategory report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the KeywordlessCategory report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordlessCategory report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the KeywordlessCategory report.
Week String Segment Week Week for the KeywordlessCategory report.
Year Integer Segment Year Year for the KeywordlessCategory report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordlessCategory report.
AllConversions Double Metric All Conv All Conv for the KeywordlessCategory report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordlessCategory report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordlessCategory report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordlessCategory report.
Clicks Long Metric Clicks Clicks for the KeywordlessCategory report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordlessCategory report.
Conversions Double Metric Conversions Conversions for the KeywordlessCategory report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordlessCategory report.
Cost Decimal Metric Cost Cost for the KeywordlessCategory report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordlessCategory report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordlessCategory report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordlessCategory report.
Ctr Double Metric CTR CTR for the KeywordlessCategory report.
Impressions Long Metric Impressions Impressions for the KeywordlessCategory report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordlessCategory report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordlessCategory report.

Pseudo-Columns

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

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



KeywordlessQuery

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordlessQuery report.
AccountDescriptiveName String Attribute Account Account for the KeywordlessQuery report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordlessQuery report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordlessQuery report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordlessQuery report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordlessQuery report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the KeywordlessQuery report.
CampaignName String Attribute Campaign Campaign for the KeywordlessQuery report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordlessQuery report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CategoryPaths String Attribute Categories Categories for the KeywordlessQuery report.
CriterionId Long Attribute Keyword ID Keyword ID for the KeywordlessQuery report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordlessQuery report.
Domain String Attribute Domain Domain for the KeywordlessQuery report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordlessQuery report.
Line1 String Attribute Dynamically Generated Headline Dynamically Generated Headline for the KeywordlessQuery report.
Query String Attribute Search Term Search Term for the KeywordlessQuery report.
QueryTargetingStatus String Attribute Added Per Excluded Added Per Excluded for the KeywordlessQuery report.

The allowed values are ADDED, EXCLUDED, BOTH, NONE.

Title String Attribute Landing Page Title Landing Page Title for the KeywordlessQuery report.
Url String Attribute URL URL for the KeywordlessQuery report.
ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordlessQuery report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the KeywordlessQuery report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordlessQuery report.
Date Date Segment Day Day for the KeywordlessQuery report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordlessQuery report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordlessQuery report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the KeywordlessQuery report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordlessQuery report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the KeywordlessQuery report.
Week String Segment Week Week for the KeywordlessQuery report.
Year Integer Segment Year Year for the KeywordlessQuery report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordlessQuery report.
AllConversions Double Metric All Conv All Conv for the KeywordlessQuery report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordlessQuery report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordlessQuery report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordlessQuery report.
Clicks Long Metric Clicks Clicks for the KeywordlessQuery report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordlessQuery report.
Conversions Double Metric Conversions Conversions for the KeywordlessQuery report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordlessQuery report.
Cost Decimal Metric Cost Cost for the KeywordlessQuery report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordlessQuery report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordlessQuery report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordlessQuery report.
Ctr Double Metric CTR CTR for the KeywordlessQuery report.
Impressions Long Metric Impressions Impressions for the KeywordlessQuery report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordlessQuery report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordlessQuery report.

Pseudo-Columns

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

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



KeywordsPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the KeywordsPerformance report.
AccountDescriptiveName String Attribute Account Account for the KeywordsPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the KeywordsPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the KeywordsPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the KeywordsPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the KeywordsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ApprovalStatus String Attribute Approval Status Approval Status for the KeywordsPerformance report.

The allowed values are APPROVED, PENDING_REVIEW, UNDER_REVIEW, DISAPPROVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the KeywordsPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the KeywordsPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the KeywordsPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the KeywordsPerformance report.
BiddingStrategySource String Attribute Bidding Strategy Source Bidding Strategy Source for the KeywordsPerformance report.

The allowed values are CAMPAIGN, ADGROUP, CRITERION.

BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the KeywordsPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

CampaignId Long Attribute Campaign ID Campaign ID for the KeywordsPerformance report.
CampaignName String Attribute Campaign Campaign for the KeywordsPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the KeywordsPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ConversionAdjustment String Attribute Conversion Adjustment Conversion Adjustment for the KeywordsPerformance report.

The allowed values are TRUE, FALSE.

CpcBid Decimal Attribute Max CPC Max CPC for the KeywordsPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the KeywordsPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the KeywordsPerformance report.
CreativeQualityScore String Attribute Ad Relevance Ad Relevance for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

Criteria String Attribute Keyword Keyword for the KeywordsPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the KeywordsPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the KeywordsPerformance report.
EnhancedCpcEnabled String Attribute Enhanced CPC Enabled Enhanced CPC Enabled for the KeywordsPerformance report.

The allowed values are TRUE, FALSE.

EstimatedAddClicksAtFirstPositionCpc Long Attribute Est Add Clicks Per wk (first Position Bid) Est Add Clicks Per wk (first Position Bid) for the KeywordsPerformance report.
EstimatedAddCostAtFirstPositionCpc Decimal Attribute Est Add Cost Per wk (first Position Bid) Est Add Cost Per wk (first Position Bid) for the KeywordsPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the KeywordsPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the KeywordsPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the KeywordsPerformance report.
FinalUrls String Attribute Final URL Final URL for the KeywordsPerformance report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the KeywordsPerformance report.
FirstPageCpc String Attribute First Page CPC First Page CPC for the KeywordsPerformance report.
FirstPositionCpc String Attribute First Position CPC First Position CPC for the KeywordsPerformance report.
HasQualityScore String Attribute Has Quality Score Has Quality Score for the KeywordsPerformance report.

The allowed values are TRUE, FALSE.

Id Long Attribute Keyword ID Keyword ID for the KeywordsPerformance report.
IsNegative String Attribute Is Negative Is Negative for the KeywordsPerformance report.

The allowed values are TRUE, FALSE.

KeywordMatchType String Attribute Match Type Match Type for the KeywordsPerformance report.

The allowed values are EXACT, PHRASE, BROAD.

LabelIds String Attribute Label IDs Label IDs for the KeywordsPerformance report.
Labels String Attribute Labels Labels for the KeywordsPerformance report.
PostClickQualityScore String Attribute Landing Page Experience Landing Page Experience for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

QualityScore Integer Attribute Quality Score Quality Score for the KeywordsPerformance report.
SearchPredictedCtr String Attribute Expected Clickthrough Rate Expected Clickthrough Rate for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

Status String Attribute Keyword State Keyword State for the KeywordsPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

SystemServingStatus String Attribute Criterion Serving Status Criterion Serving Status for the KeywordsPerformance report.

The allowed values are ELIGIBLE, RARELY_SERVED.

TopOfPageCpc String Attribute Top Of Page CPC Top Of Page CPC for the KeywordsPerformance report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the KeywordsPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the KeywordsPerformance report.
VerticalId Long Attribute Vertical ID Vertical ID for the KeywordsPerformance report.
AdNetworkType1 String Segment Network Network for the KeywordsPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the KeywordsPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the KeywordsPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionAdjustmentLagBucket String Segment Days To Conversion Or Adjustment Days To Conversion Or Adjustment for the KeywordsPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS, ADJUSTMENT_0_TO_1_DAY, ADJUSTMENT_1_TO_2_DAYS, ADJUSTMENT_2_TO_3_DAYS, ADJUSTMENT_3_TO_4_DAYS, ADJUSTMENT_4_TO_5_DAYS, ADJUSTMENT_5_TO_6_DAYS, ADJUSTMENT_6_TO_7_DAYS, ADJUSTMENT_7_TO_8_DAYS, ADJUSTMENT_8_TO_9_DAYS, ADJUSTMENT_9_TO_10_DAYS, ADJUSTMENT_10_TO_11_DAYS, ADJUSTMENT_11_TO_12_DAYS, ADJUSTMENT_12_TO_13_DAYS, ADJUSTMENT_13_TO_14_DAYS, ADJUSTMENT_14_TO_21_DAYS, ADJUSTMENT_21_TO_30_DAYS, ADJUSTMENT_30_TO_45_DAYS, ADJUSTMENT_45_TO_60_DAYS, ADJUSTMENT_60_TO_90_DAYS, ADJUSTMENT_90_TO_145_DAY, CONVERSION_UNKNOWN, ADJUSTMENT_UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the KeywordsPerformance report.
ConversionLagBucket String Segment Days To Conversion Days To Conversion for the KeywordsPerformance report.

The allowed values are UNKNOWN, CONVERSION_0_TO_1_DAY, CONVERSION_1_TO_2_DAYS, CONVERSION_2_TO_3_DAYS, CONVERSION_3_TO_4_DAYS, CONVERSION_4_TO_5_DAYS, CONVERSION_5_TO_6_DAYS, CONVERSION_6_TO_7_DAYS, CONVERSION_7_TO_8_DAYS, CONVERSION_8_TO_9_DAYS, CONVERSION_9_TO_10_DAYS, CONVERSION_10_TO_11_DAYS, CONVERSION_11_TO_12_DAYS, CONVERSION_12_TO_13_DAYS, CONVERSION_13_TO_14_DAYS, CONVERSION_14_TO_21_DAYS, CONVERSION_21_TO_30_DAYS, CONVERSION_30_TO_45_DAYS, CONVERSION_45_TO_60_DAYS, CONVERSION_60_TO_90_DAYS.

ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the KeywordsPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the KeywordsPerformance report.
Date Date Segment Day Day for the KeywordsPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the KeywordsPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the KeywordsPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the KeywordsPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the KeywordsPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the KeywordsPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the KeywordsPerformance report.
Slot String Segment Top Vs Other Top Vs Other for the KeywordsPerformance report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the KeywordsPerformance report.
Year Integer Segment Year Year for the KeywordsPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the KeywordsPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the KeywordsPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the KeywordsPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the KeywordsPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the KeywordsPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the KeywordsPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the KeywordsPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the KeywordsPerformance report.
AllConversions Double Metric All Conv All Conv for the KeywordsPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the KeywordsPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the KeywordsPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the KeywordsPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the KeywordsPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the KeywordsPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the KeywordsPerformance report.
AveragePageviews Double Metric Pages Per Session Pages Per Session for the KeywordsPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the KeywordsPerformance report.
AverageTimeOnSite Double Metric Avg Session Duration (seconds) Avg Session Duration (seconds) for the KeywordsPerformance report.
BounceRate Double Metric Bounce Rate Bounce Rate for the KeywordsPerformance report.
ClickAssistedConversions Long Metric Click Assisted Conv Click Assisted Conv for the KeywordsPerformance report.
ClickAssistedConversionsOverLastClickConversions Double Metric Click Assisted Conv Per Last Click Conv Click Assisted Conv Per Last Click Conv for the KeywordsPerformance report.
ClickAssistedConversionValue Double Metric Click Assisted Conv Value Click Assisted Conv Value for the KeywordsPerformance report.
Clicks Long Metric Clicks Clicks for the KeywordsPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the KeywordsPerformance report.
Conversions Double Metric Conversions Conversions for the KeywordsPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the KeywordsPerformance report.
Cost Decimal Metric Cost Cost for the KeywordsPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the KeywordsPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the KeywordsPerformance report.
CostPerCurrentModelAttributedConversion Double Metric Cost Per Conv (current Model) Cost Per Conv (current Model) for the KeywordsPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the KeywordsPerformance report.
Ctr Double Metric CTR CTR for the KeywordsPerformance report.
CurrentModelAttributedConversions Double Metric Conversions (current Model) Conversions (current Model) for the KeywordsPerformance report.
CurrentModelAttributedConversionValue Double Metric Conv Value (current Model) Conv Value (current Model) for the KeywordsPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the KeywordsPerformance report.
Engagements Long Metric Engagements Engagements for the KeywordsPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the KeywordsPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the KeywordsPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the KeywordsPerformance report.
HistoricalCreativeQualityScore String Metric Ad Relevance (hist) Ad Relevance (hist) for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

HistoricalLandingPageQualityScore String Metric Landing Page Experience (hist) Landing Page Experience (hist) for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

HistoricalQualityScore Integer Metric Qual Score (hist) Qual Score (hist) for the KeywordsPerformance report.
HistoricalSearchPredictedCtr String Metric Expected Clickthrough Rate (hist) Expected Clickthrough Rate (hist) for the KeywordsPerformance report.

The allowed values are UNKNOWN, BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE.

ImpressionAssistedConversions Long Metric Impr Assisted Conv Impr Assisted Conv for the KeywordsPerformance report.
ImpressionAssistedConversionsOverLastClickConversions Double Metric Impr Assisted Conv Per Last Click Conv Impr Assisted Conv Per Last Click Conv for the KeywordsPerformance report.
ImpressionAssistedConversionValue Double Metric Impr Assisted Conv Value Impr Assisted Conv Value for the KeywordsPerformance report.
Impressions Long Metric Impressions Impressions for the KeywordsPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the KeywordsPerformance report.
Interactions Long Metric Interactions Interactions for the KeywordsPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the KeywordsPerformance report.
PercentNewVisitors Double Metric Percent New Sessions Percent New Sessions for the KeywordsPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the KeywordsPerformance report.
SearchExactMatchImpressionShare Double Metric Search Exact Match IS Search Exact Match IS for the KeywordsPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the KeywordsPerformance report.
SearchRankLostImpressionShare Double Metric Search Lost IS (rank) Search Lost IS (rank) for the KeywordsPerformance report.
SearchTopImpressionShare Double Metric Search top IS Search Top IS for the KeywordsPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the KeywordsPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the KeywordsPerformance report.
ValuePerCurrentModelAttributedConversion Double Metric Value Per Conv (current Model) Value Per Conv (current Model) for the KeywordsPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the KeywordsPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the KeywordsPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the KeywordsPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the KeywordsPerformance report.
VideoViewRate Double Metric View Rate View Rate for the KeywordsPerformance report.
VideoViews Long Metric Views Views for the KeywordsPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the KeywordsPerformance report.

Pseudo-Columns

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

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



Label

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

Columns

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

Pseudo-Columns

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

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



LandingPage

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

Columns

Name Type Behavior DisplayName Description
AdGroupId Long Attribute Ad Group ID Ad Group ID for the LandingPage report.
AdGroupName String Attribute Ad Group Ad Group for the LandingPage report.
CampaignId Long Attribute Campaign ID Campaign ID for the LandingPage report.
CampaignName String Attribute Campaign Campaign for the LandingPage report.
ExpandedFinalUrlString String Attribute Expanded Landing Page Expanded Landing Page for the LandingPage report.
UnexpandedFinalUrlString String Attribute Landing Page Landing Page for the LandingPage report.
AdNetworkType1 String Segment Network Network for the LandingPage report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the LandingPage report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

Date Date Segment Day Day for the LandingPage report.
DayOfWeek String Segment Day Of Week Day Of Week for the LandingPage report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the LandingPage report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

Month String Segment Month Month for the LandingPage report.
MonthOfYear String Segment Month Of Year Month Of Year for the LandingPage report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the LandingPage report.
Slot String Segment Top Vs Other Top Vs Other for the LandingPage report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the LandingPage report.
Year Integer Segment Year Year for the LandingPage report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the LandingPage report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the LandingPage report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the LandingPage report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the LandingPage report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the LandingPage report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the LandingPage report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the LandingPage report.
AverageCost Decimal Metric Avg Cost Avg Cost for the LandingPage report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the LandingPage report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the LandingPage report.
AveragePosition Double Metric Avg Position Avg Position for the LandingPage report.
Clicks Long Metric Clicks Clicks for the LandingPage report.
ConversionRate Double Metric Conv Rate Conv Rate for the LandingPage report.
Conversions Double Metric Conversions Conversions for the LandingPage report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the LandingPage report.
Cost Decimal Metric Cost Cost for the LandingPage report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the LandingPage report.
Ctr Double Metric CTR CTR for the LandingPage report.
Impressions Long Metric Impressions Impressions for the LandingPage report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the LandingPage report.
Interactions Long Metric Interactions Interactions for the LandingPage report.
InteractionTypes String Metric Interaction Types Interaction Types for the LandingPage report.
PercentageMobileFriendlyClicks Double Metric Mobile-friendly Click Rate Mobile-friendly Click Rate for the LandingPage report.
PercentageValidAcceleratedMobilePagesClicks Double Metric Valid AMP Click Rate Valid AMP Click Rate for the LandingPage report.
SpeedScore Long Metric Mobile Speed Score Mobile Speed Score for the LandingPage report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the LandingPage report.

Pseudo-Columns

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

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



LocationCriterion

Represents data that encapsulates a location criterion.

Columns

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

Pseudo-Columns

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

Name Type Description
LocationName String Name of the location criterion.



ManagedCustomers

Service to access basic details about any customer.

Columns

Name Type Behavior DisplayName Description
ParentCustomerId [KEY] String Management Customer Id.
CustomerId String Client Customer Id.
Name String Name of the Customer.
CanManageClients String Boolean showing if Customer can manage clients.
CurrencyCode String CurrencyCode of the customer.
DateTimeZone String DateTimeZone
TestAccount Boolean Boolean showing if the account is a test account.

Pseudo-Columns

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

Name Type Description
ExcludeHiddenAccounts Boolean Name of the place.



ManagedCustomersLinks

Service to access basic details about any customer links.

Columns

Name Type Behavior DisplayName Description
ParentCustomerId [KEY] String Management Customer Id.
ManagerCustomerId String linked ManagerCustomer Id.
ClientCustomerId String linked Client Customer Id.
IsHidden Boolean Boolean showing if is hidden.

Pseudo-Columns

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

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



MarketplacePerformance

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

Columns

Name Type Behavior DisplayName Description
AdGroupId Long Attribute Ad Group ID Ad Group ID for the MarketplacePerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the MarketplacePerformance report.
Date Date Segment Day Day for the MarketplacePerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the MarketplacePerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Month String Segment Month Month for the MarketplacePerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the MarketplacePerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the MarketplacePerformance report.
Week String Segment Week Week for the MarketplacePerformance report.
Year Integer Segment Year Year for the MarketplacePerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the MarketplacePerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the MarketplacePerformance report.
Clicks Long Metric Clicks Clicks for the MarketplacePerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the MarketplacePerformance report.
Conversions Double Metric Conversions Conversions for the MarketplacePerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the MarketplacePerformance report.
Cost Decimal Metric Cost Cost for the MarketplacePerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the MarketplacePerformance report.
Ctr Double Metric CTR CTR for the MarketplacePerformance report.
Impressions Long Metric Impressions Impressions for the MarketplacePerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the MarketplacePerformance report.

Pseudo-Columns

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

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



PaidOrganicQuery

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PaidOrganicQuery report.
AccountDescriptiveName String Attribute Account Account for the PaidOrganicQuery report.
AccountTimeZone String Attribute Time Zone Time Zone for the PaidOrganicQuery report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the PaidOrganicQuery report.
AdGroupName String Attribute Ad Group Ad Group for the PaidOrganicQuery report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the PaidOrganicQuery report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the PaidOrganicQuery report.
CampaignName String Attribute Campaign Campaign for the PaidOrganicQuery report.
CampaignStatus String Attribute Campaign State Campaign State for the PaidOrganicQuery report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the PaidOrganicQuery report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PaidOrganicQuery report.
KeywordId Long Attribute Keyword ID Keyword ID for the PaidOrganicQuery report.
KeywordTextMatchingQuery String Attribute Keyword Keyword for the PaidOrganicQuery report.
SearchQuery String Attribute Query Query for the PaidOrganicQuery report.
Date Date Segment Day Day for the PaidOrganicQuery report.
DayOfWeek String Segment Day Of Week Day Of Week for the PaidOrganicQuery report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Month String Segment Month Month for the PaidOrganicQuery report.
MonthOfYear String Segment Month Of Year Month Of Year for the PaidOrganicQuery report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the PaidOrganicQuery report.
QueryMatchType String Segment Match Type Match Type for the PaidOrganicQuery report.

The allowed values are AUTO, BROAD, EXACT, EXPANDED, PHRASE.

SerpType String Segment Search Result Type Search Result Type for the PaidOrganicQuery report.

The allowed values are UNKNOWN, ADS_ONLY, ORGANIC_ONLY, ADS_AND_ORGANIC.

Week String Segment Week Week for the PaidOrganicQuery report.
Year Integer Segment Year Year for the PaidOrganicQuery report.
AverageCpc Decimal Metric Ad Avg CPC Ad Avg CPC for the PaidOrganicQuery report.
AveragePosition Double Metric Ad Avg Position Ad Avg Position for the PaidOrganicQuery report.
Clicks Long Metric Ad Clicks Ad Clicks for the PaidOrganicQuery report.
CombinedAdsOrganicClicks Long Metric Combined Clicks Combined Clicks for the PaidOrganicQuery report.
CombinedAdsOrganicClicksPerQuery Double Metric Combined Clicks Per Query Combined Clicks Per Query for the PaidOrganicQuery report.
CombinedAdsOrganicQueries Long Metric Combined Queries Combined Queries for the PaidOrganicQuery report.
Ctr Double Metric Ad CTR Ad CTR for the PaidOrganicQuery report.
Impressions Long Metric Ad Impressions Ad Impressions for the PaidOrganicQuery report.
OrganicAveragePosition Double Metric Organic Average Position Organic Average Position for the PaidOrganicQuery report.
OrganicClicks Long Metric Organic Clicks Organic Clicks for the PaidOrganicQuery report.
OrganicClicksPerQuery Double Metric Organic Clicks Per Query Organic Clicks Per Query for the PaidOrganicQuery report.
OrganicImpressions Long Metric Organic Listings Organic Listings for the PaidOrganicQuery report.
OrganicImpressionsPerQuery Double Metric Organic Listings Per Query Organic Listings Per Query for the PaidOrganicQuery report.
OrganicQueries Long Metric Organic Queries Organic Queries for the PaidOrganicQuery report.

Pseudo-Columns

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

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



ParentalStatusPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the ParentalStatusPerformance report.
AccountDescriptiveName String Attribute Account Account for the ParentalStatusPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the ParentalStatusPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ParentalStatusPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ParentalStatusPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the ParentalStatusPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the ParentalStatusPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the ParentalStatusPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the ParentalStatusPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the ParentalStatusPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the ParentalStatusPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ParentalStatusPerformance report.
CampaignName String Attribute Campaign Campaign for the ParentalStatusPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the ParentalStatusPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the ParentalStatusPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the ParentalStatusPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the ParentalStatusPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Parental Status Parental Status for the ParentalStatusPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the ParentalStatusPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the ParentalStatusPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ParentalStatusPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the ParentalStatusPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the ParentalStatusPerformance report.
FinalUrls String Attribute Final URL Final URL for the ParentalStatusPerformance report.
Id Long Attribute Criterion ID Criterion ID for the ParentalStatusPerformance report.
IsNegative String Attribute Is Negative Is Negative for the ParentalStatusPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the ParentalStatusPerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Parental Status State Parental Status State for the ParentalStatusPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the ParentalStatusPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the ParentalStatusPerformance report.
AdNetworkType1 String Segment Network Network for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the ParentalStatusPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the ParentalStatusPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the ParentalStatusPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ParentalStatusPerformance report.
Date Date Segment Day Day for the ParentalStatusPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the ParentalStatusPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the ParentalStatusPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the ParentalStatusPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the ParentalStatusPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the ParentalStatusPerformance report.
Week String Segment Week Week for the ParentalStatusPerformance report.
Year Integer Segment Year Year for the ParentalStatusPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the ParentalStatusPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the ParentalStatusPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the ParentalStatusPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the ParentalStatusPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the ParentalStatusPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the ParentalStatusPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the ParentalStatusPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ParentalStatusPerformance report.
AllConversions Double Metric All Conv All Conv for the ParentalStatusPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ParentalStatusPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the ParentalStatusPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ParentalStatusPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the ParentalStatusPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the ParentalStatusPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the ParentalStatusPerformance report.
Clicks Long Metric Clicks Clicks for the ParentalStatusPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the ParentalStatusPerformance report.
Conversions Double Metric Conversions Conversions for the ParentalStatusPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ParentalStatusPerformance report.
Cost Decimal Metric Cost Cost for the ParentalStatusPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ParentalStatusPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ParentalStatusPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ParentalStatusPerformance report.
Ctr Double Metric CTR CTR for the ParentalStatusPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the ParentalStatusPerformance report.
Engagements Long Metric Engagements Engagements for the ParentalStatusPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the ParentalStatusPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the ParentalStatusPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the ParentalStatusPerformance report.
Impressions Long Metric Impressions Impressions for the ParentalStatusPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the ParentalStatusPerformance report.
Interactions Long Metric Interactions Interactions for the ParentalStatusPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the ParentalStatusPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ParentalStatusPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ParentalStatusPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the ParentalStatusPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the ParentalStatusPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the ParentalStatusPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the ParentalStatusPerformance report.
VideoViewRate Double Metric View Rate View Rate for the ParentalStatusPerformance report.
VideoViews Long Metric Views Views for the ParentalStatusPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the ParentalStatusPerformance report.

Pseudo-Columns

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

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



Placeholder

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the Placeholder report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the Placeholder report.
AdGroupName String Attribute Ad Group Ad Group for the Placeholder report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the Placeholder report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the Placeholder report.
CampaignName String Attribute Campaign Campaign for the Placeholder report.
CampaignStatus String Attribute Campaign State Campaign State for the Placeholder report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ExtensionPlaceholderCreativeId Long Attribute Ad ID Ad ID for the Placeholder report.
ExtensionPlaceholderType String Attribute Feed Placeholder Type Feed Placeholder Type for the Placeholder report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the Placeholder report.
AdNetworkType1 String Segment Network Network for the Placeholder report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the Placeholder report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the Placeholder report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the Placeholder report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the Placeholder report.
ConversionTypeName String Segment Conversion Name Conversion Name for the Placeholder report.
Date Date Segment Day Day for the Placeholder report.
DayOfWeek String Segment Day Of Week Day Of Week for the Placeholder report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the Placeholder report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the Placeholder report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the Placeholder report.
MonthOfYear String Segment Month Of Year Month Of Year for the Placeholder report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the Placeholder report.
Slot String Segment Top Vs Other Top Vs Other for the Placeholder report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the Placeholder report.
Year Integer Segment Year Year for the Placeholder report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the Placeholder report.
AllConversions Double Metric All Conv All Conv for the Placeholder report.
AllConversionValue Double Metric All Conv Value All Conv Value for the Placeholder report.
AverageCost Decimal Metric Avg Cost Avg Cost for the Placeholder report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the Placeholder report.
AverageCpe Double Metric Avg CPE Avg CPE for the Placeholder report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the Placeholder report.
AverageCpv Double Metric Avg CPV Avg CPV for the Placeholder report.
AveragePosition Double Metric Avg Position Avg Position for the Placeholder report.
Clicks Long Metric Clicks Clicks for the Placeholder report.
ConversionRate Double Metric Conv Rate Conv Rate for the Placeholder report.
Conversions Double Metric Conversions Conversions for the Placeholder report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the Placeholder report.
Cost Decimal Metric Cost Cost for the Placeholder report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the Placeholder report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the Placeholder report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the Placeholder report.
Ctr Double Metric CTR CTR for the Placeholder report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the Placeholder report.
Engagements Long Metric Engagements Engagements for the Placeholder report.
Impressions Long Metric Impressions Impressions for the Placeholder report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the Placeholder report.
Interactions Long Metric Interactions Interactions for the Placeholder report.
InteractionTypes String Metric Interaction Types Interaction Types for the Placeholder report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the Placeholder report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the Placeholder report.
VideoViewRate Double Metric View Rate View Rate for the Placeholder report.
VideoViews Long Metric Views Views for the Placeholder report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the Placeholder report.

Pseudo-Columns

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

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



PlaceholderFeedItem

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PlaceholderFeedItem report.
AccountDescriptiveName String Attribute Account Account for the PlaceholderFeedItem report.
AccountTimeZone String Attribute Time Zone Time Zone for the PlaceholderFeedItem report.
AdId Long Attribute Ad ID Ad ID for the PlaceholderFeedItem report.
AttributeValues String Attribute Attribute Values Attribute Values for the PlaceholderFeedItem report.
Criteria String Attribute Target Keyword Text Target Keyword Text for the PlaceholderFeedItem report.
CustomerDescriptiveName String Attribute Client Name Client Name for the PlaceholderFeedItem report.
DevicePreference String Attribute Device Preference Device Preference for the PlaceholderFeedItem report.
DisapprovalShortNames String Attribute Disapproval Reasons Disapproval Reasons for the PlaceholderFeedItem report.
EndTime String Attribute End Date End Date for the PlaceholderFeedItem report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PlaceholderFeedItem report.
FeedId Long Attribute Feed ID Feed ID for the PlaceholderFeedItem report.
FeedItemId Long Attribute Item ID Item ID for the PlaceholderFeedItem report.
GeoTargetingCriterionId Long Attribute Target Location Target Location for the PlaceholderFeedItem report.
GeoTargetingRestriction String Attribute Target Location Restriction Target Location Restriction for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, LOCATION_OF_PRESENCE.

IsSelfAction String Attribute This Extension Vs Other This Extension Vs Other for the PlaceholderFeedItem report.

The allowed values are TRUE, FALSE.

KeywordMatchType String Attribute Target Keyword Match Type Target Keyword Match Type for the PlaceholderFeedItem report.

The allowed values are EXACT, PHRASE, BROAD.

KeywordTargetingId Long Attribute Keyword ID Keyword ID for the PlaceholderFeedItem report.
PlaceholderType Integer Attribute Feed Placeholder Type Feed Placeholder Type for the PlaceholderFeedItem report.
Scheduling String Attribute Scheduling Scheduling for the PlaceholderFeedItem report.
StartTime String Attribute Start Date Start Date for the PlaceholderFeedItem report.
Status String Attribute Item State Item State for the PlaceholderFeedItem report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

TargetingAdGroupId Long Attribute Target Ad Group ID Target Ad Group ID for the PlaceholderFeedItem report.
TargetingCampaignId Long Attribute Target Campaign ID Target Campaign ID for the PlaceholderFeedItem report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the PlaceholderFeedItem report.
ValidationDetails String Attribute Approval Status Approval Status for the PlaceholderFeedItem report.
AdGroupId Long Segment Ad Group ID Ad Group ID for the PlaceholderFeedItem report.
AdGroupName String Segment Ad Group Ad Group for the PlaceholderFeedItem report.
AdGroupStatus String Segment Ad Group State Ad Group State for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdNetworkType1 String Segment Network Network for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

CampaignId Long Segment Campaign ID Campaign ID for the PlaceholderFeedItem report.
CampaignName String Segment Campaign Campaign for the PlaceholderFeedItem report.
CampaignStatus String Segment Campaign State Campaign State for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

ClickType String Segment Click Type Click Type for the PlaceholderFeedItem report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the PlaceholderFeedItem report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the PlaceholderFeedItem report.
ConversionTypeName String Segment Conversion Name Conversion Name for the PlaceholderFeedItem report.
Date Date Segment Day Day for the PlaceholderFeedItem report.
DayOfWeek String Segment Day Of Week Day Of Week for the PlaceholderFeedItem report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the PlaceholderFeedItem report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the PlaceholderFeedItem report.
MonthOfYear String Segment Month Of Year Month Of Year for the PlaceholderFeedItem report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the PlaceholderFeedItem report.
Slot String Segment Top Vs Other Top Vs Other for the PlaceholderFeedItem report.

The allowed values are SEARCHRHS, SEARCHTOP, SEARCHOTHER, CONTENT, AFSTOP, AFSOTHER, MIXED, UNKNOWN.

Week String Segment Week Week for the PlaceholderFeedItem report.
Year Integer Segment Year Year for the PlaceholderFeedItem report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the PlaceholderFeedItem report.
AllConversions Double Metric All Conv All Conv for the PlaceholderFeedItem report.
AllConversionValue Double Metric All Conv Value All Conv Value for the PlaceholderFeedItem report.
AverageCost Decimal Metric Avg Cost Avg Cost for the PlaceholderFeedItem report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the PlaceholderFeedItem report.
AverageCpe Double Metric Avg CPE Avg CPE for the PlaceholderFeedItem report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the PlaceholderFeedItem report.
AverageCpv Double Metric Avg CPV Avg CPV for the PlaceholderFeedItem report.
AveragePosition Double Metric Avg Position Avg Position for the PlaceholderFeedItem report.
Clicks Long Metric Clicks Clicks for the PlaceholderFeedItem report.
ConversionRate Double Metric Conv Rate Conv Rate for the PlaceholderFeedItem report.
Conversions Double Metric Conversions Conversions for the PlaceholderFeedItem report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the PlaceholderFeedItem report.
Cost Decimal Metric Cost Cost for the PlaceholderFeedItem report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the PlaceholderFeedItem report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the PlaceholderFeedItem report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the PlaceholderFeedItem report.
Ctr Double Metric CTR CTR for the PlaceholderFeedItem report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the PlaceholderFeedItem report.
Engagements Long Metric Engagements Engagements for the PlaceholderFeedItem report.
Impressions Long Metric Impressions Impressions for the PlaceholderFeedItem report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the PlaceholderFeedItem report.
Interactions Long Metric Interactions Interactions for the PlaceholderFeedItem report.
InteractionTypes String Metric Interaction Types Interaction Types for the PlaceholderFeedItem report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the PlaceholderFeedItem report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the PlaceholderFeedItem report.
VideoViewRate Double Metric View Rate View Rate for the PlaceholderFeedItem report.
VideoViews Long Metric Views Views for the PlaceholderFeedItem report.

Pseudo-Columns

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

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



PlacementPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the PlacementPerformance report.
AccountDescriptiveName String Attribute Account Account for the PlacementPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the PlacementPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the PlacementPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the PlacementPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the PlacementPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BaseAdGroupId Long Attribute Base Ad Group ID Base Ad Group ID for the PlacementPerformance report.
BaseCampaignId Long Attribute Base Campaign ID Base Campaign ID for the PlacementPerformance report.
BiddingStrategyId Long Attribute Bid Strategy ID Bid Strategy ID for the PlacementPerformance report.
BiddingStrategyName String Attribute Bid Strategy Name Bid Strategy Name for the PlacementPerformance report.
BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the PlacementPerformance report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

BidModifier Double Attribute Bid Adj Bid Adj for the PlacementPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the PlacementPerformance report.
CampaignName String Attribute Campaign Campaign for the PlacementPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the PlacementPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the PlacementPerformance report.
CpcBidSource String Attribute Max CPC Source Max CPC Source for the PlacementPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

CpmBid Decimal Attribute Max CPM Max CPM for the PlacementPerformance report.
CpmBidSource String Attribute Max CPM Source Max CPM Source for the PlacementPerformance report.

The allowed values are ADGROUP, CRITERION, ADGROUP_BIDDING_STRATEGY, CAMPAIGN_BIDDING_STRATEGY.

Criteria String Attribute Placement Placement for the PlacementPerformance report.
CriteriaDestinationUrl String Attribute Destination URL Destination URL for the PlacementPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the PlacementPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the PlacementPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the PlacementPerformance report.
FinalAppUrls String Attribute App Final URL App Final URL for the PlacementPerformance report.
FinalMobileUrls String Attribute Mobile Final URL Mobile Final URL for the PlacementPerformance report.
FinalUrls String Attribute Final URL Final URL for the PlacementPerformance report.
Id Long Attribute Criterion ID Criterion ID for the PlacementPerformance report.
IsNegative String Attribute Is Negative Is Negative for the PlacementPerformance report.

The allowed values are TRUE, FALSE.

IsRestrict String Attribute Is Restricting Is Restricting for the PlacementPerformance report.

The allowed values are TRUE, FALSE.

Status String Attribute Placement State Placement State for the PlacementPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the PlacementPerformance report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the PlacementPerformance report.
AdNetworkType1 String Segment Network Network for the PlacementPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the PlacementPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the PlacementPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the PlacementPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the PlacementPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the PlacementPerformance report.
Date Date Segment Day Day for the PlacementPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the PlacementPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the PlacementPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the PlacementPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the PlacementPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the PlacementPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the PlacementPerformance report.
Week String Segment Week Week for the PlacementPerformance report.
Year Integer Segment Year Year for the PlacementPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the PlacementPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the PlacementPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the PlacementPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the PlacementPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the PlacementPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the PlacementPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the PlacementPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the PlacementPerformance report.
AllConversions Double Metric All Conv All Conv for the PlacementPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the PlacementPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the PlacementPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the PlacementPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the PlacementPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the PlacementPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the PlacementPerformance report.
Clicks Long Metric Clicks Clicks for the PlacementPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the PlacementPerformance report.
Conversions Double Metric Conversions Conversions for the PlacementPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the PlacementPerformance report.
Cost Decimal Metric Cost Cost for the PlacementPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the PlacementPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the PlacementPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the PlacementPerformance report.
Ctr Double Metric CTR CTR for the PlacementPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the PlacementPerformance report.
Engagements Long Metric Engagements Engagements for the PlacementPerformance report.
GmailForwards Long Metric Gmail Forwards Gmail Forwards for the PlacementPerformance report.
GmailSaves Long Metric Gmail Saves Gmail Saves for the PlacementPerformance report.
GmailSecondaryClicks Long Metric Gmail Clicks To Website Gmail Clicks To Website for the PlacementPerformance report.
Impressions Long Metric Impressions Impressions for the PlacementPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the PlacementPerformance report.
Interactions Long Metric Interactions Interactions for the PlacementPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the PlacementPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the PlacementPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the PlacementPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the PlacementPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the PlacementPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the PlacementPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the PlacementPerformance report.
VideoViewRate Double Metric View Rate View Rate for the PlacementPerformance report.
VideoViews Long Metric Views Views for the PlacementPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the PlacementPerformance report.

Pseudo-Columns

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

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



ProductPartition

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ProductPartition report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ProductPartition report.
AdGroupName String Attribute Ad Group Ad Group for the ProductPartition report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the ProductPartition report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

BiddingStrategyType String Attribute Bid Strategy Type Bid Strategy Type for the ProductPartition report.

The allowed values are MANUAL_CPC, MANUAL_CPV, MANUAL_CPM, PAGE_ONE_PROMOTED, TARGET_SPEND, TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE, TARGET_OUTRANK_SHARE, NONE, UNKNOWN.

CampaignId Long Attribute Campaign ID Campaign ID for the ProductPartition report.
CampaignName String Attribute Campaign Campaign for the ProductPartition report.
CampaignStatus String Attribute Campaign State Campaign State for the ProductPartition report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CpcBid Decimal Attribute Max CPC Max CPC for the ProductPartition report.
CriteriaDestinationUrl String Attribute Keyword Per Placement Destination URL Keyword Per Placement Destination URL for the ProductPartition report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ProductPartition report.
FinalUrlSuffix String Attribute Final URL Suffix Final URL Suffix for the ProductPartition report.
Id Long Attribute Criterion ID Criterion ID for the ProductPartition report.
IsNegative String Attribute Is Negative Is Negative for the ProductPartition report.

The allowed values are TRUE, FALSE.

ParentCriterionId Long Attribute Parent Criterion ID Parent Criterion ID for the ProductPartition report.
ProductGroup String Attribute Product Group Product Group for the ProductPartition report.
TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the ProductPartition report.
UrlCustomParameters String Attribute Custom Parameter Custom Parameter for the ProductPartition report.
AdNetworkType1 String Segment Network Network for the ProductPartition report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ProductPartition report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the ProductPartition report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the ProductPartition report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the ProductPartition report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ProductPartition report.
Date Date Segment Day Day for the ProductPartition report.
DayOfWeek String Segment Day Of Week Day Of Week for the ProductPartition report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the ProductPartition report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the ProductPartition report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the ProductPartition report.
MonthOfYear String Segment Month Of Year Month Of Year for the ProductPartition report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

PartitionType String Segment Partition Type Partition Type for the ProductPartition report.

The allowed values are UNKNOWN, SUBDIVISION, UNIT.

Quarter String Segment Quarter Quarter for the ProductPartition report.
Week String Segment Week Week for the ProductPartition report.
Year Integer Segment Year Year for the ProductPartition report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ProductPartition report.
AllConversions Double Metric All Conv All Conv for the ProductPartition report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ProductPartition report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ProductPartition report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the ProductPartition report.
BenchmarkAverageMaxCpc Decimal Metric Benchmark Max CPC Benchmark Max CPC for the ProductPartition report.
BenchmarkCtr Double Metric Benchmark CTR Benchmark CTR for the ProductPartition report.
Clicks Long Metric Clicks Clicks for the ProductPartition report.
ConversionRate Double Metric Conv Rate Conv Rate for the ProductPartition report.
Conversions Double Metric Conversions Conversions for the ProductPartition report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ProductPartition report.
Cost Decimal Metric Cost Cost for the ProductPartition report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ProductPartition report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ProductPartition report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ProductPartition report.
Ctr Double Metric CTR CTR for the ProductPartition report.
Impressions Long Metric Impressions Impressions for the ProductPartition report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the ProductPartition report.
SearchClickShare Double Metric Click Share Click Share for the ProductPartition report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the ProductPartition report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ProductPartition report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ProductPartition report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the ProductPartition report.

Pseudo-Columns

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

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



SearchQueryPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the SearchQueryPerformance report.
AccountDescriptiveName String Attribute Account Account for the SearchQueryPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the SearchQueryPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the SearchQueryPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the SearchQueryPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the SearchQueryPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the SearchQueryPerformance report.
CampaignName String Attribute Campaign Campaign for the SearchQueryPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the SearchQueryPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CreativeId Long Attribute Ad ID Ad ID for the SearchQueryPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the SearchQueryPerformance report.
DestinationUrl String Attribute Destination URL Destination URL for the SearchQueryPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SearchQueryPerformance report.
FinalUrl String Attribute Final URL Final URL for the SearchQueryPerformance report.
KeywordId Long Attribute Keyword ID Keyword ID for the SearchQueryPerformance report.
KeywordTextMatchingQuery String Attribute Keyword Keyword for the SearchQueryPerformance report.
Query String Attribute Search Term Search Term for the SearchQueryPerformance report.
QueryTargetingStatus String Attribute Added Per Excluded Added Per Excluded for the SearchQueryPerformance report.

The allowed values are ADDED, EXCLUDED, BOTH, NONE.

TrackingUrlTemplate String Attribute Tracking Template Tracking Template for the SearchQueryPerformance report.
AdFormat String Segment Ad Type Ad Type for the SearchQueryPerformance report.

The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.

AdNetworkType1 String Segment Network Network for the SearchQueryPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the SearchQueryPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the SearchQueryPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the SearchQueryPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the SearchQueryPerformance report.
Date Date Segment Day Day for the SearchQueryPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the SearchQueryPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the SearchQueryPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the SearchQueryPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the SearchQueryPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the SearchQueryPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the SearchQueryPerformance report.
QueryMatchTypeWithVariant String Segment Match Type Match Type for the SearchQueryPerformance report.

The allowed values are AUTO, BROAD, EXACT, EXPANDED, PHRASE, NEAR_EXACT, NEAR_PHRASE.

Week String Segment Week Week for the SearchQueryPerformance report.
Year Integer Segment Year Year for the SearchQueryPerformance report.
AbsoluteTopImpressionPercentage Double Metric Impr Abs Top The percent of add impressions shown as the very first ad.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the SearchQueryPerformance report.
AllConversions Double Metric All Conv All Conv for the SearchQueryPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the SearchQueryPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the SearchQueryPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the SearchQueryPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the SearchQueryPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the SearchQueryPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the SearchQueryPerformance report.
AveragePosition Double Metric Avg Position Avg Position for the SearchQueryPerformance report.
Clicks Long Metric Clicks Clicks for the SearchQueryPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the SearchQueryPerformance report.
Conversions Double Metric Conversions Conversions for the SearchQueryPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the SearchQueryPerformance report.
Cost Decimal Metric Cost Cost for the SearchQueryPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the SearchQueryPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the SearchQueryPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the SearchQueryPerformance report.
Ctr Double Metric CTR CTR for the SearchQueryPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the SearchQueryPerformance report.
Engagements Long Metric Engagements Engagements for the SearchQueryPerformance report.
Impressions Long Metric Impressions Impressions for the SearchQueryPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the SearchQueryPerformance report.
Interactions Long Metric Interactions Interactions for the SearchQueryPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the SearchQueryPerformance report.
TopImpressionPercentage Double Metric Impr Top The percent of add impressions that are shown anywhere above the organic search results.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the SearchQueryPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the SearchQueryPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the SearchQueryPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the SearchQueryPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the SearchQueryPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the SearchQueryPerformance report.
VideoViewRate Double Metric View Rate View Rate for the SearchQueryPerformance report.
VideoViews Long Metric Views Views for the SearchQueryPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the SearchQueryPerformance report.

Pseudo-Columns

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

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



SharedSet

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the SharedSet report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SharedSet report.
Name String Attribute Shared Set Name Shared Set Name for the SharedSet report.
SharedSetId Long Attribute Shared Set ID Shared Set ID for the SharedSet report.
Status String Attribute State State for the SharedSet report.

The allowed values are ENABLED, REMOVED, UNKNOWN.

Type String Attribute Shared Set Type Shared Set Type for the SharedSet report.

The allowed values are NEGATIVE_KEYWORDS, NEGATIVE_PLACEMENTS, UNKNOWN.

MemberCount String Metric Member Count Member Count for the SharedSet report.
ReferenceCount String Metric Reference Count Reference Count for the SharedSet report.

Pseudo-Columns

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

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



SharedSetCriteria

The Shared Set Criteria report includes criteria for each SharedSet.

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the SharedSetCriteria report.
Criteria String Attribute Negative Keyword Negative Keyword for the SharedSetCriteria report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the SharedSetCriteria report.
Id Long Attribute Keyword ID Keyword ID for the SharedSetCriteria report.
KeywordMatchType String Attribute Match Type Match Type for the SharedSetCriteria report.

The allowed values are EXACT, PHRASE, BROAD.

SharedSetId Long Attribute Shared Set ID Shared Set ID for the SharedSetCriteria report.

Pseudo-Columns

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

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



ShoppingPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountDescriptiveName String Attribute Account Account for the ShoppingPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the ShoppingPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the ShoppingPerformance report.
AggregatorId Long Attribute MCA Id MCA Id for the ShoppingPerformance report.
Brand String Attribute Brand Brand for the ShoppingPerformance report.
CampaignId Long Attribute Campaign ID Campaign ID for the ShoppingPerformance report.
CampaignName String Attribute Campaign Campaign for the ShoppingPerformance report.
CategoryL1 String Attribute Category (1st Level) Category (1st Level) for the ShoppingPerformance report.
CategoryL2 String Attribute Category (2nd Level) Category (2nd Level) for the ShoppingPerformance report.
CategoryL3 String Attribute Category (3rd Level) Category (3rd Level) for the ShoppingPerformance report.
CategoryL4 String Attribute Category (4th Level) Category (4th Level) for the ShoppingPerformance report.
CategoryL5 String Attribute Category (5th Level) Category (5th Level) for the ShoppingPerformance report.
CountryCriteriaId Integer Attribute Country Per Territory Country Per Territory for the ShoppingPerformance report.
CustomAttribute0 String Attribute Custom Label 0 Custom Label 0 for the ShoppingPerformance report.
CustomAttribute1 String Attribute Custom Label 1 Custom Label 1 for the ShoppingPerformance report.
CustomAttribute2 String Attribute Custom Label 2 Custom Label 2 for the ShoppingPerformance report.
CustomAttribute3 String Attribute Custom Label 3 Custom Label 3 for the ShoppingPerformance report.
CustomAttribute4 String Attribute Custom Label 4 Custom Label 4 for the ShoppingPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the ShoppingPerformance report.
LanguageCriteriaId Integer Attribute Language Language for the ShoppingPerformance report.
MerchantId Long Attribute MC Id MC Id for the ShoppingPerformance report.
OfferId String Attribute Item Id Item Id for the ShoppingPerformance report.
ProductTitle String Attribute Product Title Product Title for the ShoppingPerformance report.
ProductTypeL1 String Attribute Product Type (1st Level) Product Type (1st Level) for the ShoppingPerformance report.
ProductTypeL2 String Attribute Product Type (2nd Level) Product Type (2nd Level) for the ShoppingPerformance report.
ProductTypeL3 String Attribute Product Type (3rd Level) Product Type (3rd Level) for the ShoppingPerformance report.
ProductTypeL4 String Attribute Product Type (4th Level) Product Type (4th Level) for the ShoppingPerformance report.
ProductTypeL5 String Attribute Product Type (5th Level) Product Type (5th Level) for the ShoppingPerformance report.
StoreId String Attribute Store Id Store Id for the ShoppingPerformance report.
AdGroupStatus String Segment Ad Group State Ad Group State for the ShoppingPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

AdNetworkType1 String Segment Network Network for the ShoppingPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the ShoppingPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

CampaignStatus String Segment Campaign State Campaign State for the ShoppingPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

Channel String Segment Channel Channel for the ShoppingPerformance report.

The allowed values are UNKNOWN, ONLINE, LOCAL.

ChannelExclusivity String Segment Channel Exclusivity Channel Exclusivity for the ShoppingPerformance report.

The allowed values are UNKNOWN, SINGLE_CHANNEL, MULTI_CHANNEL.

ClickType String Segment Click Type Click Type for the ShoppingPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the ShoppingPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the ShoppingPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the ShoppingPerformance report.
Date Date Segment Day Day for the ShoppingPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the ShoppingPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the ShoppingPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the ShoppingPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the ShoppingPerformance report.
ProductCondition String Segment Condition Condition for the ShoppingPerformance report.

The allowed values are UNKNOWN, NEW, REFURBISHED, USED.

Quarter String Segment Quarter Quarter for the ShoppingPerformance report.
Week String Segment Week Week for the ShoppingPerformance report.
Year Integer Segment Year Year for the ShoppingPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the ShoppingPerformance report.
AllConversions Double Metric All Conv All Conv for the ShoppingPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the ShoppingPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the ShoppingPerformance report.
Clicks Long Metric Clicks Clicks for the ShoppingPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the ShoppingPerformance report.
Conversions Double Metric Conversions Conversions for the ShoppingPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the ShoppingPerformance report.
Cost Decimal Metric Cost Cost for the ShoppingPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the ShoppingPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the ShoppingPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the ShoppingPerformance report.
Ctr Double Metric CTR CTR for the ShoppingPerformance report.
Impressions Long Metric Impressions Impressions for the ShoppingPerformance report.
SearchAbsoluteTopImpressionShare Double Metric Search Abs Top IS Search Abs Top IS for the ShoppingPerformance report.
SearchClickShare Double Metric Click Share Click Share for the ShoppingPerformance report.
SearchImpressionShare Double Metric Search Impr Share Search Impr Share for the ShoppingPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the ShoppingPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the ShoppingPerformance report.

Pseudo-Columns

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

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



TopContentPerformance

Retrieves TopContentPerformance report data.

Columns

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

Pseudo-Columns

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

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



UrlPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the UrlPerformance report.
AccountDescriptiveName String Attribute Account Account for the UrlPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the UrlPerformance report.
AdGroupCriterionStatus String Attribute Keyword Per Placement State Keyword Per Placement State for the UrlPerformance report.

The allowed values are ENABLED, REMOVED, PAUSED.

AdGroupId Long Attribute Ad Group ID Ad Group ID for the UrlPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the UrlPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the UrlPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the UrlPerformance report.
CampaignName String Attribute Campaign Campaign for the UrlPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the UrlPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CriteriaParameters String Attribute Keyword Per Placement Keyword Per Placement for the UrlPerformance report.
CustomerDescriptiveName String Attribute Client Name Client Name for the UrlPerformance report.
DisplayName String Attribute Criteria Display Name Criteria Display Name for the UrlPerformance report.
Domain String Attribute Domain Domain for the UrlPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the UrlPerformance report.
IsBidOnPath String Attribute Added Added for the UrlPerformance report.
IsPathExcluded String Attribute Excluded Excluded for the UrlPerformance report.
Url String Attribute URL URL for the UrlPerformance report.
AdFormat String Segment Ad Type Ad Type for the UrlPerformance report.

The allowed values are UNKNOWN, TEXT, IMAGE, DYNAMIC_IMAGE, FLASH, VIDEO, HTML, AUDIO, COMPOSITE, PRINT.

AdNetworkType1 String Segment Network Network for the UrlPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the UrlPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the UrlPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the UrlPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the UrlPerformance report.
Date Date Segment Day Day for the UrlPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the UrlPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the UrlPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the UrlPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

IsAutoOptimized String Segment Targeting Mode Targeting Mode for the UrlPerformance report.

The allowed values are TRUE, FALSE.

Month String Segment Month Month for the UrlPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the UrlPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the UrlPerformance report.
Week String Segment Week Week for the UrlPerformance report.
Year Integer Segment Year Year for the UrlPerformance report.
ActiveViewCpm Decimal Metric Active View Avg CPM Active View Avg CPM for the UrlPerformance report.
ActiveViewCtr Double Metric Active View Viewable CTR Active View Viewable CTR for the UrlPerformance report.
ActiveViewImpressions Long Metric Active View Viewable Impressions Active View Viewable Impressions for the UrlPerformance report.
ActiveViewMeasurability Double Metric Active View Measurable Impr Per Impr Active View Measurable Impr Per Impr for the UrlPerformance report.
ActiveViewMeasurableCost Decimal Metric Active View Measurable Cost Active View Measurable Cost for the UrlPerformance report.
ActiveViewMeasurableImpressions Long Metric Active View Measurable Impr Active View Measurable Impr for the UrlPerformance report.
ActiveViewViewability Double Metric Active View Viewable Impr Per Measurable Impr Active View Viewable Impr Per Measurable Impr for the UrlPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the UrlPerformance report.
AllConversions Double Metric All Conv All Conv for the UrlPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the UrlPerformance report.
AverageCost Decimal Metric Avg Cost Avg Cost for the UrlPerformance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the UrlPerformance report.
AverageCpe Double Metric Avg CPE Avg CPE for the UrlPerformance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the UrlPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the UrlPerformance report.
Clicks Long Metric Clicks Clicks for the UrlPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the UrlPerformance report.
Conversions Double Metric Conversions Conversions for the UrlPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the UrlPerformance report.
Cost Decimal Metric Cost Cost for the UrlPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the UrlPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the UrlPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the UrlPerformance report.
Ctr Double Metric CTR CTR for the UrlPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the UrlPerformance report.
Engagements Long Metric Engagements Engagements for the UrlPerformance report.
Impressions Long Metric Impressions Impressions for the UrlPerformance report.
InteractionRate Double Metric Interaction Rate Interaction Rate for the UrlPerformance report.
Interactions Long Metric Interactions Interactions for the UrlPerformance report.
InteractionTypes String Metric Interaction Types Interaction Types for the UrlPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the UrlPerformance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the UrlPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the UrlPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the UrlPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the UrlPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the UrlPerformance report.
VideoViewRate Double Metric View Rate View Rate for the UrlPerformance report.
VideoViews Long Metric Views Views for the UrlPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the UrlPerformance report.

Pseudo-Columns

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

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



UserAdDistance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the UserAdDistance report.
AccountDescriptiveName String Attribute Account Account for the UserAdDistance report.
AccountTimeZone String Attribute Time Zone Time Zone for the UserAdDistance report.
CampaignId Long Attribute Campaign ID Campaign ID for the UserAdDistance report.
CampaignName String Attribute Campaign Campaign for the UserAdDistance report.
CampaignStatus String Attribute Campaign State Campaign State for the UserAdDistance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CustomerDescriptiveName String Attribute Client Name Client Name for the UserAdDistance report.
DistanceBucket String Attribute Distance From Location Extensions Distance From Location Extensions for the UserAdDistance report.

The allowed values are DISTANCE_BUCKET_WITHIN_200M, DISTANCE_BUCKET_WITHIN_500M, DISTANCE_BUCKET_WITHIN_700M, DISTANCE_BUCKET_WITHIN_1KM, DISTANCE_BUCKET_WITHIN_5KM, DISTANCE_BUCKET_WITHIN_10KM, DISTANCE_BUCKET_WITHIN_15KM, DISTANCE_BUCKET_WITHIN_20KM, DISTANCE_BUCKET_WITHIN_25KM, DISTANCE_BUCKET_WITHIN_30KM, DISTANCE_BUCKET_WITHIN_35KM, DISTANCE_BUCKET_WITHIN_40KM, DISTANCE_BUCKET_WITHIN_45KM, DISTANCE_BUCKET_WITHIN_50KM, DISTANCE_BUCKET_WITHIN_55KM, DISTANCE_BUCKET_WITHIN_60KM, DISTANCE_BUCKET_WITHIN_65KM, DISTANCE_BUCKET_BEYOND_65KM, DISTANCE_BUCKET_WITHIN_0_2MILES, DISTANCE_BUCKET_WITHIN_0_5MILES, DISTANCE_BUCKET_WITHIN_0_7MILES, DISTANCE_BUCKET_WITHIN_1MILE, DISTANCE_BUCKET_WITHIN_5MILES, DISTANCE_BUCKET_WITHIN_10MILES, DISTANCE_BUCKET_WITHIN_15MILES, DISTANCE_BUCKET_WITHIN_20MILES, DISTANCE_BUCKET_WITHIN_25MILES, DISTANCE_BUCKET_WITHIN_30MILES, DISTANCE_BUCKET_WITHIN_35MILES, DISTANCE_BUCKET_WITHIN_40MILES, DISTANCE_BUCKET_BEYOND_40MILES, UNKNOWN.

ExternalCustomerId Long Attribute Customer ID Customer ID for the UserAdDistance report.
AdNetworkType1 String Segment Network Network for the UserAdDistance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the UserAdDistance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ConversionCategoryName String Segment Conversion Category Conversion Category for the UserAdDistance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the UserAdDistance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the UserAdDistance report.
Date Date Segment Day Day for the UserAdDistance report.
DayOfWeek String Segment Day Of Week Day Of Week for the UserAdDistance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the UserAdDistance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the UserAdDistance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the UserAdDistance report.
MonthOfYear String Segment Month Of Year Month Of Year for the UserAdDistance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the UserAdDistance report.
Week String Segment Week Week for the UserAdDistance report.
Year Integer Segment Year Year for the UserAdDistance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the UserAdDistance report.
AllConversions Double Metric All Conv All Conv for the UserAdDistance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the UserAdDistance report.
AverageCpc Decimal Metric Avg CPC Avg CPC for the UserAdDistance report.
AverageCpm Decimal Metric Avg CPM Avg CPM for the UserAdDistance report.
AveragePosition Double Metric Avg Position Avg Position for the UserAdDistance report.
Clicks Long Metric Clicks Clicks for the UserAdDistance report.
ConversionRate Double Metric Conv Rate Conv Rate for the UserAdDistance report.
Conversions Double Metric Conversions Conversions for the UserAdDistance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the UserAdDistance report.
Cost Decimal Metric Cost Cost for the UserAdDistance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the UserAdDistance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the UserAdDistance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the UserAdDistance report.
Ctr Double Metric CTR CTR for the UserAdDistance report.
Impressions Long Metric Impressions Impressions for the UserAdDistance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the UserAdDistance report.
ValuePerConversion Double Metric Value Per Conv Value Per Conv for the UserAdDistance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the UserAdDistance report.

Pseudo-Columns

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

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



VideoPerformance

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

Columns

Name Type Behavior DisplayName Description
AccountCurrencyCode String Attribute Currency Currency for the VideoPerformance report.
AccountDescriptiveName String Attribute Account Account for the VideoPerformance report.
AccountTimeZone String Attribute Time Zone Time Zone for the VideoPerformance report.
AdGroupId Long Attribute Ad Group ID Ad Group ID for the VideoPerformance report.
AdGroupName String Attribute Ad Group Ad Group for the VideoPerformance report.
AdGroupStatus String Attribute Ad Group State Ad Group State for the VideoPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CampaignId Long Attribute Campaign ID Campaign ID for the VideoPerformance report.
CampaignName String Attribute Campaign Campaign for the VideoPerformance report.
CampaignStatus String Attribute Campaign State Campaign State for the VideoPerformance report.

The allowed values are UNKNOWN, ENABLED, PAUSED, REMOVED.

CreativeId Long Attribute Ad ID Ad ID for the VideoPerformance report.
CreativeStatus String Attribute Ad State Ad State for the VideoPerformance report.

The allowed values are ENABLED, PAUSED, DISABLED.

CustomerDescriptiveName String Attribute Client Name Client Name for the VideoPerformance report.
ExternalCustomerId Long Attribute Customer ID Customer ID for the VideoPerformance report.
VideoChannelId String Attribute Video Channel Id Video Channel Id for the VideoPerformance report.
VideoDuration Long Attribute Video Duration Video Duration for the VideoPerformance report.
VideoId String Attribute Video Id Video Id for the VideoPerformance report.
VideoTitle String Attribute Video Title Video Title for the VideoPerformance report.
AdNetworkType1 String Segment Network Network for the VideoPerformance report.

The allowed values are UNKNOWN, SEARCH, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

AdNetworkType2 String Segment Network (with Search Partners) Network (with Search Partners) for the VideoPerformance report.

The allowed values are UNKNOWN, SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, YOUTUBE_WATCH, MIXED.

ClickType String Segment Click Type Click Type for the VideoPerformance report.

The allowed values are URL_CLICKS, CALLS, OTHER, PRODUCT_EXTENSION_CLICKS, SITELINKS, PRODUCT_LISTING_AD_CLICKS, GET_DIRECTIONS, OFFER_PRINTS, BREADCRUMBS, CALL_TRACKING, MOBILE_CALL_TRACKING, LOCATION_EXPANSION, STORE_LOCATOR, PRODUCT_LISTING_AD_LOCAL, APP_DEEPLINK, PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL, PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE, PRODUCT_LISTING_ADS_COUPON, PRODUCT_LISTING_AD_TRANSACTABLE, PRODUCT_AD_APP_DEEPLINK, SHOWCASE_AD_CATEGORY_LINK, SHOWCASE_AD_LOCAL_STOREFRONT_LINK, SHOWCASE_AD_ONLINE_PRODUCT_LINK, SHOWCASE_AD_LOCAL_PRODUCT_LINK, PRICE_EXTENSION, VIDEO_WEBSITE_CLICKS, VIDEO_CALL_TO_ACTION_CLICKS, VIDEO_APP_STORE_CLICKS, VIDEO_CARD_ACTION_HEADLINE_CLICKS, VIDEO_END_CAP_CLICKS, CLICK_ON_ENGAGEMENT_AD, LOCATION_FORMAT_MAP, LOCATION_FORMAT_LANDING_PAGE, LOCATION_FORMAT_STORE_INFO, LOCATION_FORMAT_DIRECTIONS, LOCATION_FORMAT_CALL, LOCATION_FORMAT_TEXT, LOCATION_FORMAT_IMAGE, BROADBAND_PLAN, WIRELESS_PLAN, VISUAL_SITELINKS, PROMOTION_EXTENSION, SWIPEABLE_GALLERY_AD_HEADLINE, SWIPEABLE_GALLERY_AD_SWIPES, SWIPEABLE_GALLERY_AD_SEE_MORE, SWIPEABLE_GALLERY_AD_SITELINK_ONE, SWIPEABLE_GALLERY_AD_SITELINK_TWO, SWIPEABLE_GALLERY_AD_SITELINK_THREE, SWIPEABLE_GALLERY_AD_SITELINK_FOUR, SWIPEABLE_GALLERY_AD_SITELINK_FIVE, UNKNOWN.

ConversionCategoryName String Segment Conversion Category Conversion Category for the VideoPerformance report.
ConversionTrackerId Long Segment Conversion Tracker Id Conversion Tracker Id for the VideoPerformance report.
ConversionTypeName String Segment Conversion Name Conversion Name for the VideoPerformance report.
Date Date Segment Day Day for the VideoPerformance report.
DayOfWeek String Segment Day Of Week Day Of Week for the VideoPerformance report.

The allowed values are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.

Device String Segment Device Device for the VideoPerformance report.

The allowed values are UNKNOWN, DESKTOP, HIGH_END_MOBILE, TABLET.

ExternalConversionSource String Segment Conversion Source Conversion Source for the VideoPerformance report.

The allowed values are UNKNOWN, WEBPAGE, ANALYTICS, UPLOAD, AD_CALL_METRICS, OFFERS, ENGAGEMENT, WEBSITE_CALL_METRICS, STORE_VISITS, ANDROID_IN_APP, ANDROID_DOWNLOAD, IOS_IN_APP, IOS_FIRST_OPEN, APP_UNSPECIFIED, ANDROID_FIRST_OPEN, UPLOAD_CALLS, FIREBASE, CLICK_TO_CALL, SALESFORCE, STORE_SALES_CRM, STORE_SALES_PAYMENT_NETWORK, GOOGLE_PLAY, THIRD_PARTY_APP_ANALYTICS, GOOGLE_ATTRIBUTION, STORE_SALES_DIRECT.

Month String Segment Month Month for the VideoPerformance report.
MonthOfYear String Segment Month Of Year Month Of Year for the VideoPerformance report.

The allowed values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER.

Quarter String Segment Quarter Quarter for the VideoPerformance report.
Week String Segment Week Week for the VideoPerformance report.
Year Integer Segment Year Year for the VideoPerformance report.
AllConversionRate Double Metric All Conv Rate All Conv Rate for the VideoPerformance report.
AllConversions Double Metric All Conv All Conv for the VideoPerformance report.
AllConversionValue Double Metric All Conv Value All Conv Value for the VideoPerformance report.
AverageCpm Double Metric Avg CPM Avg CPM for the VideoPerformance report.
AverageCpv Double Metric Avg CPV Avg CPV for the VideoPerformance report.
Clicks Long Metric Clicks Clicks for the VideoPerformance report.
ConversionRate Double Metric Conv Rate Conv Rate for the VideoPerformance report.
Conversions Double Metric Conversions Conversions for the VideoPerformance report.
ConversionValue Double Metric Total Conv Value Total Conv Value for the VideoPerformance report.
Cost Decimal Metric Cost Cost for the VideoPerformance report.
CostPerAllConversion Decimal Metric Cost Per All Conv Cost Per All Conv for the VideoPerformance report.
CostPerConversion Decimal Metric Cost Per Conv Cost Per Conv for the VideoPerformance report.
CrossDeviceConversions Double Metric Cross-device Conv Cross-device Conv for the VideoPerformance report.
Ctr Double Metric CTR CTR for the VideoPerformance report.
EngagementRate Double Metric Engagement Rate Engagement Rate for the VideoPerformance report.
Engagements Long Metric Engagements Engagements for the VideoPerformance report.
Impressions Long Metric Impressions Impressions for the VideoPerformance report.
ValuePerAllConversion Double Metric Value Per All Conv Value Per All Conv for the VideoPerformance report.
VideoQuartile100Rate Double Metric Video Played To 100Percent Video Played To 100Percent for the VideoPerformance report.
VideoQuartile25Rate Double Metric Video Played To 25Percent Video Played To 25Percent for the VideoPerformance report.
VideoQuartile50Rate Double Metric Video Played To 50Percent Video Played To 50Percent for the VideoPerformance report.
VideoQuartile75Rate Double Metric Video Played To 75Percent Video Played To 75Percent for the VideoPerformance report.
VideoViewRate Double Metric View Rate View Rate for the VideoPerformance report.
VideoViews Long Metric Views Views for the VideoPerformance report.
ViewThroughConversions Long Metric View-through Conv View-through Conv for the VideoPerformance report.

Pseudo-Columns

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

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