ConversionGoalRevenue Data Object - Campaign Management

Defines properties for revenue that can be tracked by a conversion goal.

Syntax

<xs:complexType name="ConversionGoalRevenue" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalRevenueType" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
  </xs:sequence>
</xs:complexType>

Elements

The ConversionGoalRevenue object has the following elements: CurrencyCode, Type, Value.

Element Description Data Type
CurrencyCode The currency type that you want the conversion goal revenue to be reported.

For a list of possible string values see Microsoft Advertising Currencies.

For the EventGoal, InStoreTransactionGoal, OfflineConversionGoal, and UrlGoal objects, if their Scope element is set to Customer and if the Type is FixedValue or VariableValue, this property is required.

For the OfflineConversionGoal, the ConversionCurrencyCode element of the applied OfflineConversion data takes precedence over this currency code. For the other supported conversion goals if you modify your UET tag tracking code to pass back both a revenue value and a currency, then the UET tag currency value takes precedence over this currency code. For more information on modifying your UET tag tracking code for variable revenue reporting, see How to report variable revenue with UET.

If the Scope element of any ConversionGoal is set to Account and you do not specify the CurrencyCode, then by default the account level billing currency will be used to report conversion goal revenue.

This element is not available for the AppInstallGoal, DurationGoal, or PagesViewedPerVisitGoal. You cannot set this property for those goal types.

Add: Optional unless otherwise noted above.
Update: Optional unless otherwise noted above.
string
Type Determines how revenue is tracked. The possible types are FixedValue, NoValue (the default type), and VariableValue.

If the type is FixedValue then you must specify the Value element.

If the type is NoValue then you must not specify the Value element.

If the type is VariableValue then you can optionally specify a default value with the Value element.

Add: Optional. If not specified, the default type is NoValue.
Update: Optional. If not specified, the default type is NoValue.
ConversionGoalRevenueType
Value The revenue value or amount. If you assign values to your conversions, you'll be able to see the total value driven by your advertising across different conversions, rather than simply the number of conversions that have happened.

The default value is effectively 0, and possible values range from 0 to 999,9999. Accepted values depend on the revenue type, so please see the Type element for details.

For the OfflineConversionGoal, the ConversionValue element of the applied OfflineConversion data takes precedence over this currency value.

Add: Optional. If not specified, the default type is effectively 0.
Update: Optional. If not specified, the default type is effectively 0.
decimal

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Used By

ConversionGoal