User Ad Distance Report (v201705)

The User Ad Distance Report provides statistics aggregated by the user's distance from your location extensions. Each DistanceBucket shows all impressions that fall within its distance. As a result, an impression will contribute to the stats for all DistanceBucket objects that include the user's distance.

For example, if an impression is recorded for a user who is 12 miles from your location extension, then that impression's stats will contribute to the stats for each of the following DistanceBucket values:

  • DISTANCE_BUCKET_WITHIN_15MILES
  • DISTANCE_BUCKET_WITHIN_20MILES
  • DISTANCE_BUCKET_WITHIN_25MILES
  • DISTANCE_BUCKET_WITHIN_30MILES
  • DISTANCE_BUCKET_WITHIN_35MILES
  • DISTANCE_BUCKET_WITHIN_40MILES
Since each impression's stats can contribute to the stats in multiple rows, you should not add together statistics across rows of this report.

info_outline  Attribute

layers  Segment

show_chart  Metric

Ctr

Download this table in CSV format

USER_AD_DISTANCE_REPORT

AccountCurrencyCode

The currency of the Customer account.

TypeString
Display NameCurrency
XML Attributecurrency
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AccountDescriptiveName

The descriptive name of the Customer account.

TypeString
Display NameAccount
XML Attributeaccount
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AccountTimeZone

Name of the timezone selected for the Customer account. For example: "(GMT-05:00) Eastern Time". This field does not reflect the current state of daylight saving time for the timezone.

TypeString
Display NameTime zone
XML AttributetimeZone
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

AdNetworkType1

First level network type.

TypeAdNetworkType1
Display NameNetwork
XML Attributenetwork
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

AdNetworkType2

Second level network type (includes search partners).

TypeAdNetworkType2
Display NameNetwork (with search partners)
XML AttributenetworkWithSearchPartners
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

AllConversionRate

AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. rate
XML AttributeallConvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

AllConversions

Best estimate of the total number of conversions that AdWords drives. Includes website, cross-device, and phone call conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv.
XML AttributeallConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

AllConversionValue

The total value of all of your conversions, including those that are estimated. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAll conv. value
XML AttributeallConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

AverageCpc

The total cost of all clicks divided by the total number of clicks received.

TypeMoney
Display NameAvg. CPC
XML AttributeavgCPC
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

AverageCpm

Average Cost-per-thousand impressions (CPM).

TypeMoney
Display NameAvg. CPM
XML AttributeavgCPM
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

AveragePosition

Your ad's position relative to those of other advertisers. To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameAvg. position
XML AttributeavgPosition
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

CampaignId

The ID of the Campaign.

TypeLong
Display NameCampaign ID
XML AttributecampaignID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignName

The name of the Campaign.

TypeString
Display NameCampaign
XML Attributecampaign
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

CampaignStatus

The status of the Campaign.

TypeCampaignStatus
Display NameCampaign state
XML AttributecampaignState
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Clicks

The number of clicks.

TypeLong
Display NameClicks
XML Attributeclicks
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

ConversionCategoryName

A category that describes the action the user will take to complete a conversion. Prevents zero-conversion rows from being returned. Values: "Download", "Lead", "Purchase/Sale", "Signup", "View of a key page", and "Other".

TypeString
Display NameConversion category
XML AttributeconversionCategory
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionRate

The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConv. rate
XML AttributeconvRate
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

Conversions

The number of conversions for all conversion actions that you have opted into optimization. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameConversions
XML Attributeconversions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

ConversionTrackerId

ID of the conversion tracker.

TypeLong
Display NameConversion Tracker Id
XML AttributeconversionTrackerId
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionTypeName

The name of the conversion type. Prevents zero-conversion rows from being returned.

TypeString
Display NameConversion name
XML AttributeconversionName
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ConversionValue

The sum of conversion values for all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameTotal conv. value
XML AttributetotalConvValue
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

Cost

The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.

TypeMoney
Display NameCost
XML Attributecost
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

CostPerAllConversion

Total cost divided by all conversions.

TypeMoney
Display NameCost / all conv.
XML AttributecostAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

CostPerConversion

The Cost attributable to conversion-tracked clicks divided by the number of conversions

TypeMoney
Display NameCost / conv.
XML AttributecostConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

CrossDeviceConversions

Conversions from when a customer clicks on an AdWords ad on one device, then converts on a different device or browser. Cross-device conversions are already included in your AllConversions column. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCross-device conv.
XML AttributecrossDeviceConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

Ctr

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as "x.xx%". To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameCTR
XML Attributectr
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

CustomerDescriptiveName

The descriptive name of the Customer.

TypeString
Display NameClient name
XML AttributeclientName
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Date

The date formatted as yyyy-MM-dd.

TypeDate
Display NameDay
XML Attributeday
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

DayOfWeek

The name of the day of the week, e.g., "Monday".

TypeDayOfWeek
Display NameDay of week
XML AttributedayOfWeek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

Device

Device type where the impression was shown.

TypeDeviceType
Display NameDevice
XML Attributedevice
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

DistanceBucket

Grouping of user distance from location extensions.

TypeDistanceBucket
Display NameDistance from location extensions
XML AttributedistanceFromLocationExtensions
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

ExternalConversionSource

The source of conversion such as website, import from calls.

TypeExternalConversionSource
Display NameConversion source
XML AttributeconversionSource
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ExternalCustomerId

The Customer ID.

TypeLong
Display NameCustomer ID
XML AttributecustomerID
BehaviorAttribute
FilterableTrue
Supports Zero ImpressionsFalse

Impressions

Count of how often your ad has appeared on a search results page or website on the Google Network.

TypeLong
Display NameImpressions
XML Attributeimpressions
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

Month

The first day of the month, formatted as yyyy-MM-dd.

TypeString
Display NameMonth
XML Attributemonth
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

MonthOfYear

The name of the month of the year, e.g., "December".

TypeMonthOfYear
Display NameMonth of Year
XML AttributemonthOfYear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

Quarter

The first day of the quarter, formatted as yyyy-MM-dd. Uses the calendar year for quarters, e.g., the second quarter of 2014 starts on 2014-04-01.

TypeString
Display NameQuarter
XML Attributequarter
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

ValuePerAllConversion

The value, on average, of all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / all conv.
XML AttributevalueAllConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

ValuePerConversion

The total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00). To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN. This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.

TypeDouble
Display NameValue / conv.
XML AttributevalueConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

ViewThroughConversions

The total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.

TypeLong
Display NameView-through conv.
XML AttributeviewThroughConv
BehaviorMetric
FilterableTrue
Supports Zero ImpressionsFalse

Week

The date for the Monday of the week, formatted as yyyy-MM-dd.

TypeString
Display NameWeek
XML Attributeweek
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

Year

The year, formatted as yyyy.

TypeInteger
Display NameYear
XML Attributeyear
BehaviorSegment
FilterableTrue
Supports Zero ImpressionsFalse

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.