Matillion ETL Data Model for Google Adwords
|
string
"Auto"
bool
false
When AutoCache = true, the driver automatically maintains a cache of your table's data in the database of your choice.
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:
int
0
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.
string
""
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.
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
To cache to SQLite, you can use the SQLite JDBC driver. The following is the syntax of the JDBC URL:
jdbc:sqlite:dataSource
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:
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:
To use integrated security, you will also need to add sqljdbc_auth.dll to a folder on the Windows system path. This file is located in the auth subfolder of the Microsoft JDBC Driver for SQL Server installation. The bitness of the assembly must match the bitness of your JVM.
The following is the conventional JDBC URL syntax for the Oracle JDBC Thin driver:
jdbc:oracle:thin:[userId/password]@[//]host[[:port][:sid]]
For example:
jdbc:oracle:thin:scott/tiger@myhost:1521:orcl
The following are typical connection properties:
Data Source: The connect descriptor that identifies the Oracle database. This can be a TNS connect descriptor, an Oracle Net Services name that resolves to a connect descriptor, or, after version 11g, an Easy Connect naming (the host name of the Oracle server with an optional port and service name).
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:
string
""
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.
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;
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;
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.
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;
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 .
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;
string
"%APPDATA%\\CData\\GoogleAds Data Provider"
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 |
bool
false
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.
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.
int
600
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.
string
""
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.
int
0
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.
bool
false
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).
string
""
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.
string
""
This property is passed to the proxy specified by FirewallServer and FirewallPort, following the authentication method specified by FirewallType.
int
0
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.
string
""
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.
string
"NONE"
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.
string
""
The FirewallUser and FirewallPassword properties are used to authenticate against the proxy specified in FirewallServer and FirewallPort, following the authentication method specified in FirewallType.
bool
false
Whether or not to include or exclude zero impressions in the reports.
string
"OFF"
The following options are available:
string
"%APPDATA%\\CData\\GoogleAds Data Provider\\Schema"
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 |
string
""
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.
string
""
Only the modules specified (separated by ';') will be included in the log file. By default all modules are included.
string
""
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.
int
-1
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.
string
"100MB"
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.
int
-1
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.
string
""
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.
string
""
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.
string
""
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.
string
""
Pair with OAuthTokenTimestamp to determine when the AccessToken will expire.
string
""
The name of the certificate store for the client certificate.
The OAuthJWTCertType field specifies the type of the certificate store specified by OAuthJWTCert. If the store is password protected, specify the password in OAuthJWTCertPassword.
OAuthJWTCert is used in conjunction with the OAuthJWTCertSubject field in order to specify client certificates. If OAuthJWTCert has a value, and OAuthJWTCertSubject is set, a search for a certificate is initiated. Please refer to the OAuthJWTCertSubject field for details.
Designations of certificate stores are platform-dependent.
The following are designations of the most common User and Machine certificate stores in Windows:
MY | A certificate store holding personal certificates with their associated private keys. |
CA | Certifying authority certificates. |
ROOT | Root certificates. |
SPC | Software publisher certificates. |
In Java, the certificate store normally is a file containing certificates and optional private keys.
When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e. PKCS12 certificate store).
string
""
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.
string
"*"
When loading a certificate the subject is used to locate the certificate in the store.
If an exact match is not found, the store is searched for subjects containing the value of the property.
If a match is still not found, the property is set to an empty string, and no certificate is selected.
The special value "*" picks the first certificate in the certificate store.
The certificate subject is a comma separated list of distinguished name fields and values. For instance "CN=www.server.com, OU=test, C=US, E=support@cdata.com". Common fields and their meanings are displayed below.
Field | Meaning |
CN | Common Name. This is commonly a host name like www.server.com. |
O | Organization |
OU | Organizational Unit |
L | Locality |
S | State |
C | Country |
E | Email Address |
If a field value contains a comma it must be quoted.
string
"USER"
This property can take one of the following values:
USER - default | For Windows, this specifies that the certificate store is a certificate store owned by the current user. Note: This store type is not available in Java. |
MACHINE | For Windows, this specifies that the certificate store is a machine store. Note: this store type is not available in Java. |
PFXFILE | The certificate store is the name of a PFX (PKCS12) file containing certificates. |
PFXBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in PFX (PKCS12) format. |
JKSFILE | The certificate store is the name of a Java key store (JKS) file containing certificates. Note: this store type is only available in Java. |
JKSBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in Java key store (JKS) format. Note: this store type is only available in Java. |
PEMKEY_FILE | The certificate store is the name of a PEM-encoded file that contains a private key and an optional certificate. |
PEMKEY_BLOB | The certificate store is a string (base64-encoded) that contains a private key and an optional certificate. |
PUBLIC_KEY_FILE | The certificate store is the name of a file that contains a PEM- or DER-encoded public key certificate. |
PUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains a PEM- or DER-encoded public key certificate. |
SSHPUBLIC_KEY_FILE | The certificate store is the name of a file that contains an SSH-style public key. |
SSHPUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains an SSH-style public key. |
P7BFILE | The certificate store is the name of a PKCS7 file containing certificates. |
PPKFILE | The certificate store is the name of a file that contains a PPK (PuTTY Private Key). |
XMLFILE | The certificate store is the name of a file that contains a certificate in XML format. |
XMLBLOB | The certificate store is a string that contains a certificate in XML format. |
GOOGLEJSON | The certificate store is the name of a JSON file containing the service account information. Only valid when connecting to a Google service. |
string
""
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.
string
""
The user subject for which the application is requesting delegated access. Typically, the user account name or email address.
string
""
The OAuthRefreshToken property is used to refresh the OAuthAccessToken when using OAuth authentication.
string
"%APPDATA%\\CData\\GoogleAds Data Provider\\OAuthSettings.txt"
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 |
string
""
Pair with OAuthExpiresIn to determine when the AccessToken will expire.
string
""
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.
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.
bool
false
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.
string
""
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.
CachePartial=True | Caches only a subset of columns, which you can specify in your query. |
QueryPassthrough=True | Passes the specified query to the cache database instead of using the SQL parser of the driver. |
DefaultColumnSize | Sets the default length of string fields when the data source does not provide column length in the metadata. The default value is 2000. |
ConvertDateTimeToGMT | Determines whether to convert date-time values to GMT, instead of the local time of the machine. |
RecordToFile=filename | Records the underlying socket data transfer to the specified file. |
int
60
The allowed idle time a connection can remain in the pool until the connection is closed. The default is 60 seconds.
int
100
The maximum connections in the pool. The default is 100. To disable this property, set the property value to 0 or less.
int
1
The minimum number of connections in the pool. The default is 1.
int
60
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.
string
"BASIC"
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.
bool
false
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.
string
""
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.
string
""
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.
int
80
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.
string
""
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.
string
"AUTO"
This property determines when to use SSL for the connection to an HTTP proxy specified by ProxyServer. This value can be AUTO, ALWAYS, NEVER, or TUNNEL. The applicable values are the following:
AUTO | Default setting. If the URL is an HTTPS URL, the driver will use the TUNNEL option. If the URL is an HTTP URL, the component will use the NEVER option. |
ALWAYS | The connection is always SSL enabled. |
NEVER | The connection is not SSL enabled. |
TUNNEL | The connection is through a tunneling proxy. The proxy server opens a connection to the remote host and traffic flows back and forth through the proxy. |
string
""
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
string
""
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, "*=*".
bool
true
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.
string
""
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.
string
"v201809"
string
""
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.
bool
false
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.
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.
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.
The driver retrieves all rows necessary to process the aggregation in memory.
string
""
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.
int
60
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.
bool
false
This property enables connection pooling. The default is false. See Connection Pooling for information on using connection pools.
string
"1"
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:
1 | Setting 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. |
2 | Setting Verbosity to 2 will log everything included in Verbosity 1, cache queries, and additional information about the request, if applicable, such as HTTP headers. |
3 | Setting Verbosity to 3 will additionally log the body of the request and the response. |
4 | Setting Verbosity to 4 will additionally log transport-level communication with the data source. This includes SSL negotiation. |
5 | Setting 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.
string
""
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.
The Account Performance report includes all statistics aggregated by default at the account level, one row per account.
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 column fields are used in the 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. |
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.
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 column fields are used in the 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. |
Represents data about a bidlandscape for an adgroup.
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. |
The Ad Group Performance report includes all statistics aggregated by default at the ad group level, one row per ad group.
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 column fields are used in the 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. |
Service to access details about any ad groups.
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. |
The Ad Performance report includes all statistics aggregated at the ad level, one row per ad.
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 column fields are used in the 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. |
The Age Range Performance report includes all display network statistics aggregated by age range. It also includes automatic audience performance.
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 column fields are used in the 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. |
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.
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 column fields are used in the 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. |
The Automatic Placements Performance report includes all statistics aggregated at the placement level, one row per placement.
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 column fields are used in the 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. |
The Bid Goal Performance report includes statistics for your bid strategies.
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 column fields are used in the 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. |
The Budget Performance report includes all statistics aggregated by default at the budget level, one row per budget.
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 column fields are used in the 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. |
The Call Metrics Call Details report includes call details for your call extension including call duration and the caller's area code.
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 column fields are used in the 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. |
The Campaign Ad Schedule Target report summarizes the performance of campaigns by AdSchedule criteria.
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 column fields are used in the 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. |
The Campaign Criteria report is a structure report that allows you to efficiently retrieve campaign-level criteria.
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 column fields are used in the 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. |
The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.
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. |
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.
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 column fields are used in the 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. |
The Campaign Location Target Report summarizes the performance of campaigns by location-based CampaignCriterion.
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 column fields are used in the 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. |
Although negative keywords do not hold statistics, you can use this structured report to efficiently retrieve attributes of keyword-based NegativeCampaignCriterion objects.
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 column fields are used in the 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. |
Although negative locations do not hold statistics, you can use this structured report to efficiently retrieve attributes of location-based NegativeCampaignCriterion objects.
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 column fields are used in the 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. |
Although negative placements do not hold statistics, you can use this structured report to efficiently retrieve attributes of placement-based NegativeCampaignCriterion objects.
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 column fields are used in the 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. |
The Campaigns Performance report includes all statistics aggregated by default at the campaign level, one row per campaign.
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. |
Service to access details about any campaign.
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. |
The Campaign Shared Set report includes all relationships between SharedSets and campaigns.
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 column fields are used in the 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. |
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.
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 column fields are used in the 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. |
Service to access details about any conversion tracker.
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. |
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.
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 column fields are used in the 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. |
The Criteria Performance report includes statistics aggregated at the ad group criteria level, one row per ad group and criteria combination.
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 column fields are used in the 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. |
The bid landscape for a criterion. A bid landscape estimates how a a criterion will perform based on different bid amounts.
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. |
Service to access basic details about any customer.
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. |
The Display Keyword Performance report includes all display network statistics aggregated at the keyword level, one row per keyword.
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 column fields are used in the 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. |
The Display Topics Performance report includes all display network statistics aggregated at the topic level, one row per topic.
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 column fields are used in the 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. |
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.
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 column fields are used in the 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. |
The Gender Performance report includes all statistics aggregated by gender. It also includes automatic audience performance.
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 column fields are used in the 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. |
The Geo Performance report includes all statistics aggregated at the country/territory level, one row per country/territory.
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 column fields are used in the 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. |
The Keywordless Category Performance report includes keywordless ads (dynamic search ads) statistics aggregated by category.
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 column fields are used in the 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. |
The Keywordless Query report includes keywordless ads (dynamic search ads) statistics based on search terms.
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 column fields are used in the 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. |
The Keywords Performance report includes all statistics aggregated at the keyword level, one row per keyword.
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 column fields are used in the 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. |
The Label report is a structure report that lists all labels for your account.
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 column fields are used in the 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. |
The Landing Page report includes all statistics aggregated by default by the UnexpandedFinalUrlString, one row per the URL string.
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 column fields are used in the 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. |
Represents data that encapsulates a location criterion.
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 column fields are used in the 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. |
Service to access basic details about any customer.
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 column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
ExcludeHiddenAccounts | Boolean | Name of the place. |
Service to access basic details about any customer links.
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 column fields are used in the 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 |
The Marketplace Performance report includes all statistics of ads displayed on the Marketplace, aggregated by default at the account level.
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 column fields are used in the 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. |
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.
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 column fields are used in the 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. |
The Parental Status Performance report includes statistics aggregated at the parental status level, one row per parental status
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 column fields are used in the 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. |
The Placeholder Report provides statistics for feed-based ad extensions, one row per placeholder type.
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 column fields are used in the 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. |
The Placeholder Feed Item report includes all statistics at the feed-item level (e.g., a single sitelink).
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 column fields are used in the 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. |
The Placements Performance report includes all statistics aggregated at the placement level, one row per placement.
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 column fields are used in the 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. |
The Product Partition report provides shopping campaign statistics aggregated at the product partition (Id field) level.
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 column fields are used in the 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. |
The Search Terms report includes all statistics aggregated at the search terms level, one row per combination of search terms.
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 column fields are used in the 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. |
The Shared Set report includes all SharedSets that can be shareable across campaigns.
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 column fields are used in the 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. |
The Shared Set Criteria report includes criteria for each SharedSet.
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 column fields are used in the 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. |
The Shopping Performance report provides shopping campaign statistics aggregated at the product (OfferId field) level.
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 column fields are used in the 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. |
Retrieves TopContentPerformance report data.
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 column fields are used in the 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. |
The URL Performance report includes all statistics aggregated at the URL and criterion level.
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 column fields are used in the 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. |
The User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions.
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 column fields are used in the 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. |
The Video Performance report includes statistics for your account's upgraded AdWords for Video campaigns.
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 column fields are used in the 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. |