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

项目
11/13/2024

定义转换目标的基本对象。

不要尝试实例化 ConversionGoal。可以创建派生自它的一个或多个以下对象。

语法

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

元素

ConversionGoal 对象具有以下元素：AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBiding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、ViewThroughConversionWindowInMinutes。

元素	说明	数据类型
AttributionModelType	确定将哪个归因模型 LastTouch 或 LastClick 用于转换目标。默认情况下不返回此元素。若要获取此元素，请在调用 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 服务操作时，在 ReturnAdditionalFields 元素中包含 AttributionModelType 值。此元素不适用于 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。	AttributionModelType
ConversionWindowInMinutes	转换窗口是单击后要跟踪转换的时间长度（以分钟为单位）。如果将此值设置为 43200 分钟 (30 天) ，则跟踪单击后 30 天内发生的转换。过去的转换不受影响。支持的最小值为 1 分钟，但请记住，较短的转换窗口将减少帐户记录的转换次数。支持的最大值为 129600 分钟 (90 天) 。	int
CountType	这决定了如何在所选转换窗口中记录转换。有两个选项，如果未设置值，则默认值为 “全部”： - 全部：将统计广告点击后发生的所有转换。这是销售的常见选择。 - 唯一：仅对广告点击后发生的一次转换进行计数。这是潜在顾客的常见选择。例如：跟踪两个转换：潜在顾客和销售额。对于潜在顾客，选择 “唯一 ”，选择 “全部 ”用于销售。当一个广告点击变成两个潜在顾客和两个销售时，将计为三个转换：一个用于唯一的潜在顾客，两个用于所有销售。此元素不适用于 AppInstallGoal。	ConversionGoalCountType
ExcludeFromBidding	确定是否从性能报告列的子集中排除与此转换目标相关的数据。此元素仅适用于启用了“转换中包括”功能的客户， (GetCustomerPilotFeatures 返回 574) 。如果此元素设置为 true，则从、、、`ConversionRateReturnOnAdSpendCostPerConversion`、 `RevenuePerConversion`和 `Revenue` 报表列中排除`Conversions`与此转换目标相关的其他数据。此外，如果使用自动出价出价策略，将此属性设置为 true 将导致目标转换不再考虑自动出价计算。将此属性设置为“true”实际上与在 Microsoft Advertising Web 应用程序中取消选中“包含在转换中”相同。无论此元素值如何，`AllConversions`、`AllConversionRate`、、`AllCostPerConversionAllReturnOnAdSpend`、 `AllRevenuePerConversion`和 `AllRevenue` 报表列都将包括所有转换目标的数据。默认情况下，此元素为 false，并且与此转换目标相关的数据包含在所有报表列中。有关详细信息，请参阅报表属性和性能统计信息和帮助文章转换目标：“转换”与“所有转换”。	boolean
GoalCategory	用于对转换目标进行分段的类别。但是，对转换目标进行分类对业务有意义。目标类别不会影响性能 - 它们可帮助你对目标及其性能指标进行细分。支持的类别值因转换目标类型而异，因此有关详细要求，请参阅相应的参考页。	ConversionGoalCategory
Id	转换目标的唯一 Microsoft Advertising 标识符。	long
IsEnhancedConversionsEnabled	确定是否为转换目标启用增强转换。注意：若要创建增强的转换目标并设置 `isEnhancedConversionsEnabled=true`，必须通过 Microsoft Advertising UI 为帐户创建转换目标，并且选中了增强转换设置并选中了关联的复选框。	boolean
名称	转换目标名称。名称的最大长度为 100，并且名称在属于同一客户的所有转换目标中必须是唯一的。	string
收入	确定每个转换对业务的价值。添加转换目标时，如果未指定任何收入跟踪首选项，则每个 ConversionGoalRevenue 将设置为各自的默认值。更新转换目标时，如果 Revenue 元素为零或为空，则不会更新任何嵌套属性。但是，如果此元素不为零或为空，则实际上将替换任何现有的收入属性。 VariableValue 选项不适用于 AppInstallGoal、DurationGoal 或 PagesViewedPerVisitGoal。	ConversionGoalRevenue
范围	确定目标是应用于所有帐户，还是仅适用于在所需的 CustomerAccountId 标头元素中指定的帐户。如果你有多个 Microsoft Advertising 帐户，则可以跟踪所有这些帐户的转换。如果将一个目标与一个帐户相关联，将仅跟踪该帐户的转换。可能的值为 Account 和 Customer。设置范围后，便无法更改范围。如果要更改范围，需要创建新的转换目标并暂停旧目标。 AppInstallGoal 仅支持客户范围。	EntityScope
状态	定义转换目标的可能由用户确定的状态值。这些是用户可以决定设置的状态值，例如，如果不再希望跟踪该目标的转换，可以将目标设置为 Paused 。有关可由系统设置的状态值（例如是否验证 UET 标记），请参阅 TrackingStatus 元素。	ConversionGoalStatus
TagId	添加到网站的 UET 标记的唯一 Microsoft Advertising 标识符，允许 Microsoft Advertising 收集用户对您的网站执行的操作。在依赖标记 ID 之前，请注意，UET 标记可以与其他客户共享或从其他客户共享。共享 UET 标记和访问群体仅适用于试点客户。有关在客户层次结构中共享访问群体和 UET 标记的概述，请参阅共享受众和 UET 标记技术指南。此元素不适用于 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。	long
TrackingStatus	定义转换目标的可能系统确定的状态值。这些是系统可以设置的状态值，例如，如果 UET 标记尚未验证，系统会将状态设置为 TagUnverified 。对于用户可以决定设置的状态值，例如，如果不想再跟踪该目标的转换，请将状态设置为 “已暂停 ”，请参阅 Status 元素。只有 NoRecentConversions 和 RecordingConversions 状态适用于 AppInstallGoal 和 OfflineConversionGoal。	ConversionGoalTrackingStatus
类型	转换目标的类型。有关转换目标类型的详细信息，请参阅备注。	ConversionGoalType
ViewThroughConversionWindowInMinutes	查看转换窗口是单击后要跟踪浏览转换的时间长度（以分钟为单位）。如果将此值设置为 43200 分钟 (30 天) ，则跟踪单击后 30 天内发生的查看转换。过去的转换不受影响。支持的最小值为 1 分钟，但请记住，较短的转换窗口将减少帐户记录的转换次数。支持的最大值为 43200 分钟 (30 天) 。还必须将 IncludeViewThroughConversions 帐户属性设置为 true 才能跟踪查看转换。默认情况下不返回此元素。若要获取此元素，请在调用 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 服务操作时，在 ReturnAdditionalFields 元素中包含 ViewThroughConversionWindowInMinutes 值。此元素不适用于 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。	int

备注

对于 Java 和 .NET 语言，请勿设置 Type 元素，因为该值由实例化的转换目标类型决定。

如果手动生成 SOAP，请使用节点的 <ConversionGoal>type 属性，如以下示例所示，指定转换目标的类型。

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

要求

服务： CampaignManagementService.svc v13
命名空间： https://bingads.microsoft.com/CampaignManagement/v13

使用者

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

通过

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

语法

元素

备注

要求

使用者

反馈

其他资源