AppInstallGoal Data Object - Campaign Management
Defines an app install conversion goal. Use this type of goal to track every time someone installs your app as a conversion.
For other conversion goal types you create a Universal Event Tracking (UET) tag, add it to your website, and then create a conversion goal. But for app install conversion goals, all you have to do is use the app-specific URL that is provided by the Microsoft Advertising-certified partner. For more information, please see How to track mobile app installs as conversions.
For an implementation overview, see the Universal Event Tracking technical guide.
<xs:complexType name="AppInstallGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:complexContent mixed="false"> <xs:extension base="tns:ConversionGoal"> <xs:sequence> <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" /> <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" /> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType>
Inherited Elements from ConversionGoal
The AppInstallGoal object derives from the ConversionGoal object, and inherits the following elements. The descriptions below are specific to AppInstallGoal, and might not apply to other objects that inherit the same elements from the ConversionGoal object.
|ConversionWindowInMinutes||The conversion window is the length of time in minutes after a click that you want to track conversions. If you set this value to 43200 minutes (30 days), then conversions that happen within 30 days after a click are tracked. Past conversions aren't affected. The minimum value supported is 1 minute, although keep in mind that a shorter conversion window will reduce the number of conversions your account records. The maximum value supported is 129600 minutes (90 days).
|CountType||Not applicable for app install goals.||ConversionGoalCountType|
|ExcludeFromBidding||Determines whether or not to exclude data otherwise related to this conversion goal from a subset of performance report columns.
This element is only available for customers who are enabled for the Include in Conversions feature (GetCustomerPilotFeatures returns 574).
If this element is set to true, data otherwise related to this conversion goal will be excluded from the
For more information, see Report Attributes and Performance Statistics and the help article Conversion goals: "Conversions" versus "All conversions".
|Id||The unique Microsoft Advertising identifier for the conversion goal.
Update: Required and Read-Only
|Name||The conversion goal name.
The maximum length of the name is 100, and the name must be unique among all conversion goals belonging to the same customer.
|Revenue||Determines how much each conversion is worth to your business.
When adding a conversion goal if you do not specify any revenue tracking preferences, then each ConversionGoalRevenue will be set to their respective default values.
When updating a conversion goal, if the Revenue element is nil or empty then none of the nested properties will be updated. However, if this element is not nil or empty then you are effectively replacing any existing revenue properties.
The VariableValue option is not available for app install conversion goals.
|Scope||Determines if the goal applies to all accounts or only the account specified in the required CustomerAccountId header element. If you have multiple Microsoft Advertising accounts, you can track conversions across all of those accounts. If you associate a goal with one account, conversions will be tracked for that account only.
For app install goals the Account level scope is not supported. You can set this element to Customer or leave it nil. If not specified, the scope will be set to Customer by default.
|Status||Defines the possible user-determined status values of a conversion goal. These are the status values that a user can decide to set, for example a goal can be set to Paused if you no longer wish to track conversions for that goal.
For status values that can be set by the system, see the TrackingStatus element.
|TagId||Not applicable for app install goals.||long|
|TrackingStatus||Defines the possible system-determined status values of a conversion goal. These are the status values that can be set by the system, for example the system sets the status to RecordingConversions if we have recorded conversions within the last 7 days.
Only the NoRecentConversions and RecordingConversions statuses are applicable for app install conversion goals.
For status values that a user can decide to set, for example setting the status to Paused if you no longer wish to track conversions for that goal, see the Status element.
|Type||The type of the conversion goal. This value is AppInstall when you retrieve an app install goal. For more information about conversion goal types, see the ConversionGoal Data Object Remarks.
|ViewThroughConversionWindowInMinutes||Not applicable for app install goals.||int|
Service: CampaignManagementService.svc v13