|
| Field description | Output only. An ad group of a campaign that includes the product. This field is selectable only in the ad group scope, which requires an equality filter on campaign and ad_group. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
|
|
| Field description | Output only. The brand of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. A campaign that includes the product. This field is selectable only in the campaign scope, which requires an equality filter on campaign. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The category level 1 of the product. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The category level 2 of the product. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The category level 3 of the product. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The category level 4 of the product. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The category level 5 of the product. |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
|
|
|
|
|
|
| Field description | Output only. The currency code as provided by the merchant, in ISO 4217 format. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The custom attribute 0 of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The custom attribute 1 of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The custom attribute 2 of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The custom attribute 3 of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The custom attribute 4 of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The effective maximum cost-per-click (effective max. CPC) of the product. This field is available only if the query specifies the campaign or ad group scope, and if the campaign uses manual bidding. The value is the highest bid set for the product in product groups across all enabled ad groups. It represents the most you're willing to pay for a click on the product. This field can take up to 24 hours to update. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product feed label as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The list of issues affecting whether the product can show in ads. The value of this field is restricted to the scope specified in the query, see the documentation of the resource. This field can take up to 24 hours to update. This field is not supported for App campaigns. |
| Category | ATTRIBUTE |
| Data Type | MESSAGE |
| Type URL | google.ads.googleads.v24.resources.ShoppingProduct.ProductIssue |
| Filterable | False |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | Output only. The item id of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The language code as provided by the merchant, in BCP 47 format. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The id of the merchant that owns the product. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The id of the Multi Client Account of the merchant, if present. |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The price of the product in micros as provided by the merchant, in the currency specified in currency_code (e.g. $2.97 is reported as 2970000). |
| Category | ATTRIBUTE |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The URI of the product image as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product type level 1 as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product type level 2 as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product type level 3 as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product type level 4 as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The product type level 5 as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. The resource name of the shopping product. Shopping product resource names have the form: customers/{customer_id}/shoppingProducts/{merchant_center_id}~{channel}~{language_code}~{feed_label}~{item_id} |
| Category | ATTRIBUTE |
| Data Type | RESOURCE_NAME |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | False |
|
|
| Field description | Output only. The status that indicates whether the product can show in ads. The value of this field is restricted to the scope specified in the query, see the documentation of the resource. This field can take up to 24 hours to update. This field is not supported for App campaigns. |
| Category | ATTRIBUTE |
| Data Type |
ENUM
ELIGIBLE ELIGIBLE_LIMITED NOT_ELIGIBLE UNKNOWN UNSPECIFIED
|
| Type URL | google.ads.googleads.v24.enums.ProductStatusEnum.ProductStatus |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
|
| Field description | Output only. Upper-case two-letter ISO 3166-1 code of the regions where the product is intended to be shown in ads. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | False |
| Repeated | True |
|
|
| Field description | Output only. The title of the product as provided by the merchant. |
| Category | ATTRIBUTE |
| Data Type | STRING |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
|
segments.date |
| Field description | Date to which metrics apply.
yyyy-MM-dd format, for example, 2018-04-17. |
| Category | SEGMENT |
| Data Type | DATE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
segments.month |
| Field description | Month as represented by the date of the first day of a month. Formatted as
yyyy-MM-dd. |
| Category | SEGMENT |
| Data Type | DATE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
segments.quarter |
| Field description | Quarter as represented by the date of the first day of a quarter.
Uses the calendar year for quarters, for example, the second quarter of
2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
| Category | SEGMENT |
| Data Type | DATE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
segments.week |
| Field description | Week as defined as Monday through Sunday, and represented by the date of
Monday. Formatted as yyyy-MM-dd. |
| Category | SEGMENT |
| Data Type | DATE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
segments.year |
| Field description | Year, formatted as yyyy. |
| Category | SEGMENT |
| Data Type | INT32 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_average_cart_size |
| Field description | All average cart size is the average number of products in each order
attributed to your ads. Includes the amount from the average_cart_size
metric, plus avg. cart size from all your conversion actions, even if your
campaigns are not actively optimizing towards them. It's calculated using
product info from cart data to give more detail than conversion value
alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_average_order_value_micros |
| Field description | All average order value is the average revenue you made per order
attributed to your ads. Includes the amount from the average_order_value
metric, plus avg. order value from all your conversion actions, even
if your campaigns are not actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_conversions |
| Field description | The total number of conversions. This includes all conversions regardless
of the value of include_in_conversions_metric. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_conversions_from_interactions_rate |
| Field description | All conversions from interactions (as oppose to view through conversions)
divided by the number of ad interactions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_conversions_from_interactions_value_per_interaction |
| Field description | The value of all conversions from interactions divided by the total number
of interactions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_conversions_value |
| Field description | The value of all conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_conversions_value_per_cost |
| Field description | The value of all conversions divided by the total cost of ad interactions
(such as clicks for text ads or views for video ads). |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_cost_of_goods_sold_micros |
| Field description | All cost of goods sold is the total cost of the products you sold in orders
attributed to your ads. Includes the amount from the
cost_of_goods_sold_micros metric, plus cost of goods sold from all
conversion actions, even if your campaigns are not actively optimizing
towards them. It's calculated using product info from cart data to give
more detail than conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_cross_sell_cost_of_goods_sold_micros |
| Field description | All cross-sell cost of goods sold is the total cost of products sold as a
result of advertising a different product. Includes the amount from the
cross_sell_cost_of_goods_sold_micros metric, plus cross-sell cost of goods
sold from all your conversion actions, even if your campaigns are not
actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_cross_sell_gross_profit_micros |
| Field description | All cross-sell gross profit is the profit you made from products sold as a
result of advertising a different product, minus cost of goods sold (COGS).
Includes the amount from the cross_sell_gross_profit_micros metric, plus
cross-sell gross profit from all your conversion actions, even if your
campaigns are not actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_cross_sell_revenue_micros |
| Field description | All cross-sell revenue is the total amount you made from products sold as
a result of advertising a different product. Includes the amount from the
cross_sell_revenue_micros metric, plus cross-sell revenue from all your
conversion actions, even if your campaigns are not actively optimizing
towards them. It's calculated using product info from cart data to give
more detail than conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_cross_sell_units_sold |
| Field description | All cross-sell units sold is the total number of products sold as a result
of advertising a different product. Includes the amount shown in the
cross_sell_units_sold metric, plus cross-sell units sold from all your
conversion actions, even if your campaigns are not actively optimizing
towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_gross_profit_margin |
| Field description | All gross profit margin is the percentage gross profit you made from
orders attributed to your ads, after taking out the cost of goods sold
(COGS). This value is between 0.0 and 1.0, where 1.0 means 100%. Includes
the amount from the gross_profit_margin metric, plus gross profit margin
across all conversion actions, even if your campaigns are not actively
optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_gross_profit_micros |
| Field description | All gross profit is the total profit made from orders attributed to your
ads minus the cost of goods sold (COGS). Includes the amount from the
gross_profit_micros metric, plus gross profit from all your conversion
actions, even if your campaigns are not actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_lead_cost_of_goods_sold_micros |
| Field description | All lead cost of goods sold is the total cost of products sold as a result
of advertising the same product. Includes the amount shown in the
lead_cost_of_goods_sold_micros metric, plus lead cost of goods sold from
all your conversion actions, even if your campaigns are not actively
optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_lead_gross_profit_micros |
| Field description | All lead gross profit is the profit you made from products sold as a result
of advertising the same product, minus cost of goods sold (COGS). Includes
the amount from the lead_gross_profit_micros metric, plus lead gross profit
from all your conversion actions, even if your campaigns are not actively
optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_lead_revenue_micros |
| Field description | All lead revenue is the total amount you made from products sold as a
result of advertising the same product. Includes the amount shown in the
lead_revenue_micros metric, plus lead revenue from all your conversion
actions, even if your campaigns are not actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_lead_units_sold |
| Field description | All lead units sold is the total number of products sold as a result of
advertising the same product. Includes the amount shown in the
lead_units_sold metric, plus lead units sold from all your conversion
actions, even if your campaigns are not actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_orders |
| Field description | All orders is total number of purchase conversions attributed to your ads.
Includes the amount from the orders metric, plus orders from all your
conversion actions, even if your campaigns are not actively optimizing
towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_revenue_micros |
| Field description | All revenue is the total you made from orders attributed to your ads.
Includes the amount from the revenue_micros metric, plus revenue from all
your conversion actions, even if your campaigns are not actively optimizing
towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.all_units_sold |
| Field description | All units sold is the total number of products sold from orders attributed
to your ads. Includes the amount from the units_sold metric, plus
units sold from all your conversion actions, even if your campaigns are not
actively optimizing towards them.
It's calculated using product info from cart data to give more detail than
conversion value alone. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.average_cart_size |
| Field description | Average cart size is the average number of products in each order
attributed to your ads.
How it works: You report conversions with cart data for completed purchases
on your website. Average cart size is the total number of products sold
divided by the total number of orders you received.
Example: You received 2 orders, the first included 3 products and the
second included 2. The average cart size is 2.5 products = (3+2)/2.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.average_cpc |
| Field description | The total cost of all clicks divided by the total number of clicks
received. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.average_order_value_micros |
| Field description | Average order value is the average revenue you made per order attributed to
your ads.
How it works: You report conversions with cart data for completed purchases
on your website. Average order value is the total revenue from your orders
divided by the total number of orders.
Example: You received 3 orders which made $10, $15 and $20 worth of
revenue. The average order value is $15 = ($10 + $15 + $20)/3.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.clicks |
| Field description | The number of clicks. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.conversions |
| Field description | The number of conversions. This only includes conversion actions which
include_in_conversions_metric attribute is set to true. If you use
conversion-based bidding, your bid strategies will optimize for these
conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.conversions_from_interactions_rate |
| Field description | Conversions from interactions divided by the number of ad interactions
(such as clicks for text ads or views for video ads). This only includes
conversion actions which include_in_conversions_metric attribute is set to
true. If you use conversion-based bidding, your bid strategies will
optimize for these conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.conversions_from_interactions_value_per_interaction |
| Field description | The value of conversions from interactions divided by the number of ad
interactions. This only includes conversion actions which
include_in_conversions_metric attribute is set to true. If you use
conversion-based bidding, your bid strategies will optimize for these
conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.conversions_value |
| Field description | The value of conversions. This only includes conversion actions which
include_in_conversions_metric attribute is set to true. If you use
conversion-based bidding, your bid strategies will optimize for these
conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cost_micros |
| Field description | The sum of your cost-per-click (CPC) and cost-per-thousand impressions
(CPM) costs during this period. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cost_of_goods_sold_micros |
| Field description | Cost of goods sold (COGS) is the total cost of the products you sold in
orders attributed to your ads.
How it works: You can add a cost of goods sold value to every product in
Merchant Center. If you report conversions with cart data, the products you
sold are matched with their cost of goods sold value and this can be used
to calculate the gross profit you made on each order.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
has a cost of goods sold value of $5. The cost of goods sold for this order
is $8 = $3 + $5.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cost_per_all_conversions |
| Field description | The cost of ad interactions divided by all conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cost_per_conversion |
| Field description | The cost of ad interactions divided by conversions. This only includes
conversion actions which include_in_conversions_metric attribute is set to
true. If you use conversion-based bidding, your bid strategies will
optimize for these conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_device_conversions |
| Field description | Conversions from when a customer clicks on a Google Ads ad on one device,
then converts on a different device or browser.
Cross-device conversions are already included in all_conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_device_conversions_value_micros |
| Field description | The sum of the value of cross-device conversions, in micros. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_sell_cost_of_goods_sold_micros |
| Field description | Cross-sell cost of goods sold (COGS) is the total cost of products sold as
a result of advertising a different product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If these products don't match then this is
considered cross-sell. Cross-sell cost of goods sold is the total cost of
the products sold that weren't advertised.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
has a cost of goods sold value of $5. The cross-sell cost of goods sold for
this order is $5.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_sell_gross_profit_micros |
| Field description | Cross-sell gross profit is the profit you made from products sold as a
result of advertising a different product, minus cost of goods sold (COGS).
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the purchase is a sold
product. If these products don't match then this is considered cross-sell.
Cross-sell gross profit is the revenue you made from cross-sell attributed
to your ads minus the cost of the goods sold.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The shirt is priced $20 and has a cost of goods sold value
of $5. The cross-sell gross profit of this order is $15 = $20 - $5.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_sell_revenue_micros |
| Field description | Cross-sell revenue is the total amount you made from products sold as a
result of advertising a different product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If these products don't match then this is
considered cross-sell. Cross-sell revenue is the total value you made from
cross-sell attributed to your ads.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat is priced $10 and the shirt is priced $20. The
cross-sell revenue of this order is $20.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.cross_sell_units_sold |
| Field description | Cross-sell units sold is the total number of products sold as a result of
advertising a different product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If these products don't match then this is
considered cross-sell. Cross-sell units sold is the total number of
cross-sold products from all orders attributed to your ads.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat, a shirt and a jacket. The cross-sell units sold in this order is 2.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.ctr |
| Field description | The number of clicks your ad receives (Clicks) divided by the number
of times your ad is shown (Impressions). |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.gross_profit_margin |
| Field description | Gross profit margin is the percentage gross profit you made from orders
attributed to your ads, after taking out the cost of goods sold (COGS).
How it works: You report conversions with cart data for completed purchases
on your website. Gross profit margin is the gross profit you made divided
by your total revenue and multiplied by 100%. Gross profit margin
calculations only include products that have a cost of goods sold value in
Merchant Center.
Example: Someone bought a hat and a shirt in an order on your website. The
hat is priced $10 and has a cost of goods sold value of $3. The shirt is
priced $20 but has no cost of goods sold value. Gross profit margin for
this order will only take into account the hat because it has a cost of
goods sold value, so it's 70% = ($10 - $3)/$10 x 100%.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.gross_profit_micros |
| Field description | Gross profit is the profit you made from orders attributed to your ads
minus the cost of goods sold (COGS).
How it works: Gross profit is the revenue you made from sales attributed to
your ads minus cost of goods sold. Gross profit calculations only include
products that have a cost of goods sold value in Merchant Center.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt in an order from your website. The hat is priced $10 and
the shirt is priced $20. The hat has a cost of goods sold value of $3, but
the shirt has no cost of goods sold value. Gross profit for this order will
only take into account the hat, so it's $7 = $10 - $3.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.impressions |
| Field description | Count of how often your ad has appeared on a search results page or
website on the Google Network. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.lead_cost_of_goods_sold_micros |
| Field description | Lead cost of goods sold (COGS) is the total cost of products sold as a
result of advertising the same product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with has an associated
product (see Shopping Ads) then this product is considered the advertised
product. Any product included in the order the customer places is a sold
product. If the advertised and sold products match, then the cost of these
goods is counted under lead cost of goods sold.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat has a cost of goods sold value of $3, the shirt
has a cost of goods sold value of $5. The lead cost of goods sold for this
order is $3.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.lead_gross_profit_micros |
| Field description | Lead gross profit is the profit you made from products sold as a result of
advertising the same product, minus cost of goods sold (COGS).
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If the advertised and sold products match, then
the revenue you made from these sales minus the cost of goods sold is your
lead gross profit.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat is priced $10 and has a cost of goods sold value
of $3. The lead gross profit of this order is $7 = $10 - $3.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.lead_revenue_micros |
| Field description | Lead revenue is the total amount you made from products sold as a result of
advertising the same product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If the advertised and sold products match, then
the total value you made from the sales of these products is shown under
lead revenue.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt. The hat is priced $10 and the shirt is priced $20. The
lead revenue of this order is $10.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.lead_units_sold |
| Field description | Lead units sold is the total number of products sold as a result of
advertising the same product.
How it works: You report conversions with cart data for completed purchases
on your website. If the ad that was interacted with before the purchase has
an associated product (see Shopping Ads) then this product is considered
the advertised product. Any product included in the order the customer
places is a sold product. If the advertised and sold products match, then
the total number of these products sold is shown under lead units sold.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat, a shirt and a jacket. The lead units sold in this order is 1.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.orders |
| Field description | Orders is the total number of purchase conversions you received attributed
to your ads.
How it works: You report conversions with cart data for
completed purchases on your website. If a conversion is attributed to
previous interactions with your ads (clicks for text or Shopping ads, views
for video ads etc.) it's counted as an order.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt in an order on your website. Even though they bought 2
products, this would count as 1 order.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.revenue_micros |
| Field description | Revenue is the total amount you made from orders attributed to your ads.
How it works: You report conversions with cart data for completed purchases
on your website. Revenue is the total value of all the orders you received
attributed to your ads, minus any discount.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat and a shirt in an order from your website. The hat is priced $10 and
the shirt is priced $20. The entire order has a $5 discount. The revenue
from this order is $25 = ($10 + $20) - $5.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | INT64 |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.search_absolute_top_impression_share |
| Field description | The percentage of the customer's Shopping or Search ad impressions that are
shown in the most prominent Shopping position. See
https://support.google.com/google-ads/answer/7501826
for details. Any value below 0.1 is reported as 0.0999. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.units_sold |
| Field description | Units sold is the total number of products sold from orders attributed to
your ads.
How it works: You report conversions with cart data for completed purchases
on your website. Units sold is the total number of products sold from all
orders attributed to your ads.
Example: Someone clicked on a Shopping ad for a hat then bought the same
hat, a shirt and a jacket. The units sold in this order is 3.
This metric is only available if you report conversions with cart data. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.value_per_all_conversions |
| Field description | The value of all conversions divided by the number of all conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|
metrics.value_per_conversion |
| Field description | The value of conversions divided by the number of conversions. This only
includes conversion actions which include_in_conversions_metric attribute
is set to true. If you use conversion-based bidding, your bid strategies
will optimize for these conversions. |
| Category | METRIC |
| Data Type | DOUBLE |
| Type URL | N/A |
| Filterable | True |
| Selectable | True |
| Sortable | True |
| Repeated | False |
| Selectable with |
The following fields/resources can be selected with this field:
|
|