Hide

type UploadConversion (v201506)

A conversion type that receives conversions by having them uploaded through the OfflineConversionFeedService. After successfully creating a new UploadConversion, send the name of this conversion type along with your conversion details to the OfflineConversionFeedService to attribute those conversions to this conversion type.


Namespace
https://adwords.google.com/api/adwords/cm/v201506
Fields
Field Type Description
ConversionTracker (inherited)
id
Filterable
ReadOnly
Selectable
xsd:long ID of this conversion tracker, null when creating a new one.

There are some system-defined conversion trackers that are available for all customers to use. See ConversionTrackerService.mutate for more information about how to modify these types.

  • 179 - Calls from Ads
  • 214 - Android Downloads
  • 239 - Store Visits
This field can be selected using the value "Id". This field can be filtered on. This field is read only and will be ignored when sent to the API for the following Operators: ADD.
originalConversionTypeId
Filterable
ReadOnly
Selectable
xsd:long The ID of the original conversion type on which this ConversionType is based. This is used to facilitate a connection between an existing shared conversion type (e.g. Calls from ads) and an advertiser-specific conversion type. This may only be specified for ADD operations, and can never be modified once a ConversionType is created. This field can be selected using the value "OriginalConversionTypeId". This field can be filtered on. This field is read only and will be ignored when sent to the API for the following Operators: SET.
name
Filterable
Required
Selectable
xsd:string Name of this conversion tracker. This field can be selected using the value "Name". This field can be filtered on. This field is required and should not be null when it is contained within Operators : ADD.
status
Filterable
Selectable
ConversionTracker.Status Status of this conversion tracker. This field can be selected using the value "Status". This field can be filtered on.
Enumerations
ENABLED
Visits to the conversion page will be recorded.
DISABLED
Visits to the conversion page will not be recorded.
HIDDEN
Conversions will be recorded, but the conversion tracker will not appear in the UI.
category
Filterable
Selectable
ConversionTracker.Category The category of conversion that is being tracked. This field can be selected using the value "Category". This field can be filtered on.
Enumerations
DEFAULT
PAGE_VIEW
PURCHASE
SIGNUP
LEAD
REMARKETING
DOWNLOAD
Download is applicable only to AppConversion types, and is an error to use in conjunction with other types. AppConversions must use download only if they also specify AppConversion.appConversionType as DOWNLOAD or FIRST_OPEN. If any other appConversionType is used, then some other category besides DOWNLOAD must be used.
conversionTypeOwnerCustomerId
Filterable
ReadOnly
Selectable
xsd:long The external customer ID of the conversion type owner, or 0 if this is a system-defined conversion type. Only the conversion type owner may edit properties of the conversion type. This field can be selected using the value "ConversionTypeOwnerCustomerId". This field can be filtered on. This field is read only and will be ignored when sent to the API.
viewthroughLookbackWindow
Filterable
InRange
Selectable
xsd:int Lookback window for view-through conversions in days. This is the length of time in which a conversion without a click can be attributed to an impression. This field can be selected using the value "ViewthroughLookbackWindow". This field can be filtered on. This field must be between 1 and 30, inclusive.
isProductAdsChargeable
Filterable
Selectable
xsd:boolean Indicates whether to turn on charging for product ads. This field can be selected using the value "IsProductAdsChargeable". This field can be filtered on.
productAdsChargeableConversionWindow
Filterable
Selectable
xsd:int Lookback window, in days, for whether product ads can be charged or not. This field can be selected using the value "ProductAdsChargeableConversionWindow". This field can be filtered on.
ctcLookbackWindow
Filterable
Selectable
xsd: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.

Conversion events that occur more than this many days after the click are ignored.

This field is only editable for Adwords Conversions and Upload Conversions, but has a system defined default for other types of conversions. The allowed range of values for this window depends on the type of conversion and may expand, but 7-90 days is the currently-allowed range. This field can be selected using the value "CtcLookbackWindow". This field can be filtered on.

countingType
Filterable
Selectable
ConversionDeduplicationMode How to count events for this conversion tracker. If countingType is MANY_PER_CLICK, then all conversion events are counted. If countingType is ONE_PER_CLICK, then only the first conversion event of this type following a given click will be counted. More information is available at https://support.google.com/adwords/answer/3438531 This field can be selected using the value "CountingType". This field can be filtered on.
Enumerations
ONE_PER_CLICK
Number of clicks that get at least one conversion.
MANY_PER_CLICK
Total number of conversions per click.
defaultRevenueValue
Filterable
InRange
Selectable
xsd:double The value to use when the tag for this conversion tracker sends conversion events without values. This value is applied on the server side, and is applicable to all ConversionTracker subclasses.

See also the corresponding ConversionTracker.defaultRevenueCurrencyCode, and see ConversionTracker.alwaysUseDefaultRevenueValue for details about when this value is used. This field can be selected using the value "DefaultRevenueValue". This field can be filtered on. This field must be between 0 and 1000000000000, inclusive.

defaultRevenueCurrencyCode
Filterable
Selectable
xsd:string The currency code to use when the tag for this conversion tracker sends conversion events without currency codes. This code is applied on the server side, and is applicable to all ConversionTracker subclasses. It must be a valid ISO4217 3-character code, such as USD.

This code is used if the code in the tag is not supplied or is unsupported, or if ConversionTracker.alwaysUseDefaultRevenueValue is set to true. If this default code is not set the currency code of the account is used as the default code.

Set the default code to XXX in order to specify that this conversion type does not have units of a currency (that is, it is unitless). In this case no currency conversion will occur even if a currency code is set in the tag. This field can be selected using the value "DefaultRevenueCurrencyCode". This field can be filtered on.

alwaysUseDefaultRevenueValue
Filterable
Selectable
xsd:boolean Controls whether conversion event values and currency codes are taken from the tag snippet or from ConversionTracker.defaultRevenueValue and ConversionTracker.defaultRevenueCurrencyCode. If alwaysUseDefaultRevenueValue is true, then conversion events will always use defaultRevenueValue and defaultRevenueCurrencyCode, even if the tag has supplied a value and/or code when reporting the conversion event. If alwaysUseDefaultRevenueValue is false, then defaultRevenueValue and defaultRevenueCurrencyCode are only used if the tag does not supply a value, or the tag's value is unparseable. This field can be selected using the value "AlwaysUseDefaultRevenueValue". This field can be filtered on.
excludeFromBidding
Filterable
Selectable
xsd:boolean Whether this conversion tracker should be excluded from the "Conv (opt.)" columns in reports.

If true, the conversion tracker will not be counted towards Conv (opt.). If false, it will be counted in Conv (opt.). This is the default.

Either way, conversions will still be counted in the "Conversions" columns in reports. This field can be selected using the value "ExcludeFromBidding". This field can be filtered on.
mostRecentConversionDate
ReadOnly
Selectable
xsd:string The date of the most recent ad click that led to a conversion of this conversion type.

This date is in the advertiser's defined time zone.

This field can be selected using the value "MostRecentConversionDate". This field is read only and will be ignored when sent to the API.
lastReceivedRequestTime
ReadOnly
Selectable
xsd:string The last time a conversion tag for this conversion type successfully fired and was seen by AdWords. This firing event may not have been the result of an attributable conversion (ex: because the tag was fired from a browser that did not previously click an ad from the appropriate advertiser).

This datetime is in UTC, not the advertiser's time zone.

This field can be selected using the value "LastReceivedRequestTime". This field is read only and will be ignored when sent to the API.
ConversionTracker.Type xsd:string Indicates that this instance is a subtype of ConversionTracker. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.
UploadConversion

Send feedback about...

AdWords API