user_location_view

    A user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

    Attributed resources
    customer

    Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

    Segmenting resources
    ad_group
    campaign

    Fields from the above resources, when selected along with this resource in your SELECT and WHERE clauses, will segment metrics.

    Fields/Segments/Metrics

    This page shows all metrics and segments that can be put in the same SELECT clause as the fields of user_location_view . However, when you specify user_location_view in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when user_location_view is specified in the FROM clause.

    Is user_location_view specified in the FROM clause of your query?

     Resource fields
    country_criterion_id
    resource_name
    targeting_location
     Segments
    ad_network_type
    conversion_action
    conversion_action_category
    conversion_action_name
    date
    day_of_week
    device
    geo_target_city
    geo_target_metro
    geo_target_region
    month
    quarter
    week
    year
     Metrics
    all_conversions
    all_conversions_from_interactions_rate
    all_conversions_value
    average_cost
    average_cpc
    average_cpm
    clicks
    client_account_conversions
    client_account_conversions_value
    client_account_view_through_conversions
    conversions
    conversions_from_interactions_rate
    conversions_value
    cost_micros
    cost_per_all_conversions
    cost_per_conversion
    cross_device_conversions
    cross_device_conversions_value
    ctr
    impressions
    interaction_event_types
    interaction_rate
    interactions
    value_per_all_conversions
    value_per_conversion

    user_location_view.country_criterion_id

    Field description
    Criterion Id for the country.
    Category
    ATTRIBUTE
    Data Type
    INT64
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    user_location_view.resource_name

    Field description
    The resource name of the user location view. UserLocation view resource names have the form: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
    Category
    ATTRIBUTE
    Data Type
    RESOURCE_NAME
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    False
    Repeated
    False

    user_location_view.targeting_location

    Field description
    Indicates whether location was targeted or not.
    Category
    ATTRIBUTE
    Data Type
    BOOLEAN
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.ad_network_type

    Field description
    Ad network type.
    Category
    SEGMENT
    Data Type
    Type URL
    google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.conversion_action

    Field description
    Resource name of the conversion action.
    Category
    SEGMENT
    Data Type
    RESOURCE_NAME
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.conversion_action_category

    Field description
    Conversion action category.
    Category
    SEGMENT
    Data Type
    Type URL
    google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.conversion_action_name

    Field description
    Conversion action name.
    Category
    SEGMENT
    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

    segments.day_of_week

    Field description
    Day of the week, for example, MONDAY.
    Category
    SEGMENT
    Data Type
    Type URL
    google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.device

    Field description
    Device to which metrics apply.
    Category
    SEGMENT
    Data Type
    Type URL
    google.ads.searchads360.v0.enums.DeviceEnum.Device
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.geo_target_city

    Field description
    Resource name of the geo target constant that represents a city.
    Category
    SEGMENT
    Data Type
    RESOURCE_NAME
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.geo_target_metro

    Field description
    Resource name of the geo target constant that represents a metro.
    Category
    SEGMENT
    Data Type
    RESOURCE_NAME
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    segments.geo_target_region

    Field description
    Resource name of the geo target constant that represents a region.
    Category
    SEGMENT
    Data Type
    RESOURCE_NAME
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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

    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

    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

    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

    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

    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

    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

    metrics.average_cost

    Field description
    The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.average_cpc

    Field description
    The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.average_cpm

    Field description
    Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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
    Field description
    The number of client account conversions. This only includes conversion actions which include_in_client_account_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
    Field description
    The value of client account conversions. This only includes conversion actions which include_in_client_account_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
    Field description
    The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.
    Category
    METRIC
    Data Type
    INT64
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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

    metrics.conversions_from_interactions_rate

    Field description
    Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.conversions_value

    Field description
    The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.cost_micros

    Field description
    The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
    Category
    METRIC
    Data Type
    INT64
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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

    metrics.cost_per_conversion

    Field description
    Average conversion eligible cost per biddable conversion.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.cross_device_conversions

    Field description
    Conversions from when a customer clicks on an 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

    metrics.cross_device_conversions_value

    Field description
    The sum of the value of cross-device conversions.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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

    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

    metrics.interaction_event_types

    Field description
    The types of payable and free interactions.
    Category
    METRIC
    Data Type
    ENUM
    Type URL
    google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType
    Filterable
    True
    Selectable
    True
    Sortable
    False
    Repeated
    True

    metrics.interaction_rate

    Field description
    How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    metrics.interactions

    Field description
    The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.
    Category
    METRIC
    Data Type
    INT64
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False

    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

    metrics.value_per_conversion

    Field description
    The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth.
    Category
    METRIC
    Data Type
    DOUBLE
    Type URL
    N/A
    Filterable
    True
    Selectable
    True
    Sortable
    True
    Repeated
    False
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: