通过

AppInstallGoal 数据对象 - 市场活动管理

  • 项目

定义应用安装转换目标。 每次有人将你的应用安装为转换时，使用此类型的目标进行跟踪。

对于其他转换目标类型，请创建通用事件跟踪 (UET) 标记，将其添加到网站，然后创建转换目标。 但对于应用安装转换目标，只需使用Microsoft广告认证合作伙伴提供的特定于应用的 URL。 有关详细信息，请参阅 如何将移动应用安装跟踪为转换。

提示

有关实现概述，请参阅 通用事件跟踪 技术指南。

语法

<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>

元素

AppInstallGoal 对象具有以下元素：AppPlatform、AppStoreId。

元素 说明 数据类型
AppPlatform 应用程序平台。

可能的值包括 Android、 iOS、 Windows 和 WindowsPhone。

加： 必填
更新： 自选		 string
AppStoreId 应用商店提供的应用程序标识符。

加： 必填
更新： 自选		 string

AppInstallGoal 对象具有继承元素。

继承的元素

从 ConversionGoal 继承的元素

AppInstallGoal 对象派生自 ConversionGoal 对象，并继承以下元素：AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBidding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、 ViewThroughConversionWindowInMinutes。 下面的说明特定于 AppInstallGoal，可能不适用于从 ConversionGoal 对象继承相同元素的其他对象。

元素 说明 数据类型
AttributionModelType 不适用于应用安装目标。 AttributionModelType
ConversionWindowInMinutes 转换窗口是单击后要跟踪转换的时间长度（以分钟为单位）。 如果将此值设置为 43200 分钟 (30 天) ，则跟踪单击后 30 天内发生的转换。 过去的转换不受影响。 支持的最小值为 1 分钟，但请记住，较短的转换窗口将减少帐户记录的转换次数。 支持的最大值为 129600 分钟 (90 天) 。

加： 自选
更新： 自选		 int
CountType 不适用于应用安装目标。 ConversionGoalCountType
ExcludeFromBidding 确定是否从性能报告列的子集中排除与此转换目标相关的数据。

此元素仅适用于启用了“转换中包括”功能的客户， (GetCustomerPilotFeatures 返回 574) 。

如果此元素设置为 true，则从 、、、ConversionRateReturnOnAdSpendCostPerConversion、 RevenuePerConversion和 Revenue 报表列中排除Conversions与此转换目标相关的其他数据。 此外，如果使用自动出价出价策略，将此属性设置为 true 将导致目标转换不再考虑自动出价计算。 将此属性设置为“true”实际上与取消选中Microsoft广告 Web 应用程序中的“包含在转换中”相同。

无论此元素值如何，AllConversions、AllConversionRate、、AllCostPerConversionAllReturnOnAdSpend、 AllRevenuePerConversion和 AllRevenue 报表列都将包括所有转换目标的数据。 默认情况下，此元素为 false，并且与此转换目标相关的数据包含在所有报表列中。

有关详细信息，请参阅报表属性和性能统计信息和帮助文章转换目标：“转换”与“所有转换”。

加： 自选
更新： 自选		 boolean
GoalCategory 用于对转换目标进行分段的类别。

但是，对转换目标进行分类对业务有意义。 目标类别不会影响性能 - 它们可帮助你对目标及其性能指标进行细分。

支持的类别值因转换目标类型而异。 应用安装目标仅支持 “下载” 类别。

加： 自选。 如果将此元素保留为 nil 或空，则默认类别将设置为 “下载”。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 ConversionGoalCategory
ID 转换目标的唯一Microsoft广告标识符。

加： 只读
更新： 必需和 Read-Only		 long
IsEnhancedConversionsEnabled 确定是否为转换目标启用增强转换。

注意：若要创建增强的转换目标并设置 isEnhancedConversionsEnabled=true，必须通过Microsoft广告 UI 为帐户创建转换目标，并且选中了增强转换设置并选中了关联的复选框。		 boolean
名称 转换目标名称。

名称的最大长度为 100，并且名称在属于同一客户的所有转换目标中必须是唯一的。

加： 必填
更新： 自选		 string
收入 确定每个转换对业务的价值。

添加转换目标时，如果未指定任何收入跟踪首选项，则每个 ConversionGoalRevenue 将设置为各自的默认值。

更新转换目标时，如果 Revenue 元素为零或为空，则不会更新任何嵌套属性。 但是，如果此元素不为零或为空，则实际上将替换任何现有的收入属性。

VariableValue 选项不适用于应用安装转换目标。

加： 自选
更新： 自选		 ConversionGoalRevenue
范围 确定目标是应用于所有帐户，还是仅适用于在所需的 CustomerAccountId 标头元素中指定的帐户。 如果你有多个Microsoft广告帐户，则可以跟踪所有这些帐户的转换。 如果将一个目标与一个帐户相关联，将仅跟踪该帐户的转换。

对于应用安装目标，不支持帐户级别范围。 可以将此元素设置为 Customer 或将其保留为零。 如果未指定，则默认情况下，范围将设置为 Customer。

加： 自选
更新： 自选		 EntityScope
状态 定义转换目标的可能由用户确定的状态值。 这些是用户可以决定设置的状态值，例如，如果不再希望跟踪该目标的转换，可以将目标设置为 Paused 。

有关可由系统设置的状态值，请参阅 TrackingStatus 元素。

加： 自选
更新： 自选		 ConversionGoalStatus
TagId 不适用于应用安装目标。 long
TrackingStatus 定义转换目标的可能系统确定的状态值。 这些是系统可以设置的状态值，例如，如果我们在过去 7 天内记录了转换，系统会将状态设置为 RecordConversions 。

只有 NoRecentConversions 和 RecordingConversions 状态适用于应用安装转换目标。

对于用户可以决定设置的状态值，例如，如果不想再跟踪该目标的转换，请将状态设置为 “已暂停 ”，请参阅 Status 元素。

加： 只读
更新： 只读		 ConversionGoalTrackingStatus
类型 转换目标的类型。 检索应用安装目标时，此值为 AppInstall 。 有关转换目标类型的详细信息，请参阅 ConversionGoal 数据对象备注。

加： 只读
更新： 只读		 ConversionGoalType
ViewThroughConversionWindowInMinutes 不适用于应用安装目标。 int

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13