UserLocationView

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

Table Specific Information

Select

Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.

To use the nondefault fields, explicitly select them in your query.

Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.

Columns

Name

Type

Behavior

Description

UserLocationViewCountryCriterionId

Long

Attribute

CountryCriterionId column for table UserLocationView

UserLocationViewResourceName

String

Attribute

ResourceName column for table UserLocationView

UserLocationViewTargetingLocation

Bool

Attribute

TargetingLocation column for table UserLocationView

CustomerId

Long

Attribute

ClientCustomerId column for table UserLocationView

AllConversions

Double

Metric

AllConversions column for table Metrics

AllConversionsFromInteractionsRate

Double

Metric

AllConversionsFromInteractionsRate column for table Metrics

AllConversionsValue

Double

Metric

AllConversionsValue column for table Metrics

AverageCost

Double

Metric

AverageCost column for table Metrics

AverageCpc

Double

Metric

AverageCpc column for table Metrics

AverageCpm

Double

Metric

AverageCpm column for table Metrics

AverageCpv

Double

Metric

AverageCpv column for table Metrics

Clicks

Long

Metric

Clicks column for table Metrics

Conversions

Double

Metric

Conversions column for table Metrics

ConversionsFromInteractionsRate

Double

Metric

ConversionsFromInteractionsRate column for table Metrics

ConversionsValue

Double

Metric

ConversionsValue column for table Metrics

CostMicros

Long

Metric

CostMicros column for table Metrics

CostPerAllConversions

Double

Metric

CostPerAllConversions column for table Metrics

CostPerConversion

Double

Metric

CostPerConversion column for table Metrics

CrossDeviceConversions

Double

Metric

CrossDeviceConversions column for table Metrics

Ctr

Double

Metric

Ctr column for table Metrics

Impressions

Long

Metric

Impressions column for table Metrics

InteractionEventTypes

String

Metric

InteractionEventTypes column for table Metrics

InteractionRate

Double

Metric

InteractionRate column for table Metrics

Interactions

Long

Metric

Interactions column for table Metrics

ValuePerAllConversions

Double

Metric

ValuePerAllConversions column for table Metrics

ValuePerConversion

Double

Metric

ValuePerConversion column for table Metrics

VideoViewRate

Double

Metric

VideoViewRate column for table Metrics

VideoViews

Long

Metric

VideoViews column for table Metrics

ViewThroughConversions

Long

Metric

ViewThroughConversions column for table Metrics

AdNetworkType

String

Segment

AdNetworkType column for table Segments

ConversionAction

String

Segment

ConversionAction column for table Segments

ConversionActionCategory

String

Segment

ConversionActionCategory column for table Segments

ConversionActionName

String

Segment

ConversionActionName column for table Segments

Date

Date

Segment

Date column for table Segments

DayOfWeek

String

Segment

DayOfWeek column for table Segments

Device

String

Segment

Device column for table Segments

ExternalConversionSource

String

Segment

ExternalConversionSource column for table Segments

GeoTargetAirport

String

Segment

GeoTargetAirport column for table Segments

GeoTargetCanton

String

Segment

GeoTargetCanton column for table Segments

GeoTargetCity

String

Segment

GeoTargetCity column for table Segments

GeoTargetCounty

String

Segment

GeoTargetCounty column for table Segments

GeoTargetDistrict

String

Segment

GeoTargetDistrict column for table Segments

GeoTargetMetro

String

Segment

GeoTargetMetro column for table Segments

GeoTargetMostSpecificLocation

String

Segment

GeoTargetMostSpecificLocation column for table Segments

GeoTargetPostalCode

String

Segment

GeoTargetPostalCode column for table Segments

GeoTargetProvince

String

Segment

GeoTargetProvince column for table Segments

GeoTargetRegion

String

Segment

GeoTargetRegion column for table Segments

GeoTargetState

String

Segment

GeoTargetState column for table Segments

Month

Date

Segment

Month column for table Segments

MonthOfYear

String

Segment

MonthOfYear column for table Segments

Quarter

Date

Segment

Quarter column for table Segments

Week

Date

Segment

Week column for table Segments

Year

Int

Segment

Year column for table Segments

Pseudo-Columns

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

Name

Type

Description

ManagerId

Long

Id of the manager account on behalf of which you are requesting customer data.

Last updated