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

定义脱机转换目标。 如果将潜在客户生成作为目标，请使用此类目标。 潜在客户生成是当潜在客户填写表单或兴趣报价时，然后当面或通过电话 (完成销售，例如汽车购买、保险报价、抵押贷款等 ) 。

若要设置脱机转换跟踪，请创建 OfflineConversionGoal，等待两个小时，然后通过 ApplyOfflineConversions 操作发送Microsoft Advertising the OfflineConversion 数据。

重要

必须通过市场活动管理 API 创建 OfflineConversionGoal 才能设置 IsExternallyAttributed 属性。

提示

有关详细信息，请参阅 跟踪脱机转换。

重要

每次通过 Microsoft Advertising Web 应用程序或市场活动管理 API 添加或更新新的 DurationGoal、EventGoal、OfflineConversionGoal、PagesViewedPerVisitGoal 或 UrlGoal 时，相应 AccountProperty 的 MSCLKIDAutoTaggingEnabled 值会自动设置为 True。 如果目标的范围设置为 “客户 级别”，则将设置“客户”下所有帐户的 AccountProperty 。

语法

XML

<xs:complexType name="OfflineConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExternallyAttributed" 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:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

JSON

{
  "AttributionModelType": "ValueHere",
  "ConversionWindowInMinutes": IntValueHere,
  "CountType": "ValueHere",
  "ExcludeFromBidding": "ValueHere",
  "GoalCategory": "ValueHere",
  "Id": "LongValueHere",
  "IsEnhancedConversionsEnabled": "ValueHere",
  "Name": "ValueHere",
  "Revenue": {
    "CurrencyCode": "ValueHere",
    "Type": "ValueHere",
    "Value": DecimalValueHere
  },
  "Scope": "ValueHere",
  "Status": "ValueHere",
  "TagId": "LongValueHere",
  "TrackingStatus": "ValueHere",
  "Type": "OfflineConversion",
  "ViewThroughConversionWindowInMinutes": IntValueHere,
  "IsExternallyAttributed": "ValueHere"
}

元素

OfflineConversionGoal 对象具有以下元素：IsExternallyAttributed。

元素	说明	数据类型
IsExternallyAttributed	这将确定脱机转换目标是否使用你自己的归因模型，并允许你为每个 MSCLKID 导入小数额度。 默认情况下不返回此元素。 若要获取此元素，请在调用 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 服务操作时，在 ReturnAdditionalFields 元素中包含 IsExternallyAttributed 值。 注意：只能通过市场活动管理 API 设置 IsExternallyAttributed 。 加： 自选 更新： 自选	boolean

OfflineConversionGoal 对象具有 Inherited Elements。

继承的元素

从 ConversionGoal 继承的元素

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

元素	说明	数据类型
AttributionModelType	不适用于脱机转换目标。	AttributionModelType
ConversionWindowInMinutes	转换窗口是单击后要跟踪转换的时间长度（以分钟为单位）。 如果将此值设置为 43200 分钟 (30 天) ，则跟踪单击后 30 天内发生的转换。 过去的转换不受影响。 默认值为 43200。 支持的最小值为 1 分钟，但请记住，较短的转换窗口将减少帐户记录的转换次数。 支持的最大值为 129600 分钟 (90 天) 。 加： 自选 更新： 自选	int
CountType	这决定了如何在所选转换窗口中记录转换。 有两个选项，如果未设置值，则默认值为 “全部”： - 全部：将统计广告点击后发生的不同脱机转换时间的所有转换。 这是销售的常见选择。 - 唯一：仅对广告点击后发生的第一次转换进行计数。 这是潜在顾客的常见选择。 例如：跟踪两个转换：潜在顾客和销售额。 对于潜在顾客，选择 “唯一 ”，选择 “全部 ”用于销售。 当一个广告点击变成两个潜在顾客和两个销售时，将计为三个转换：一个用于唯一的潜在顾客，两个用于所有销售。 将忽略具有相同 MicrosoftClickId 和 ConversionTime 的重复脱机转换。 换句话说，仅计算给定 MicrosoftClickId 和 ConversionTime 的第一次脱机转换。 加： 自选 更新： 自选	ConversionGoalCountType
ExcludeFromBidding	确定是否从性能报告列的子集中排除与此转换目标相关的数据。 此元素仅适用于启用了“转换中包括”功能的客户， (GetCustomerPilotFeatures 返回 574) 。 如果此元素设置为 true，则从 、、、ConversionRateReturnOnAdSpendCostPerConversion、 RevenuePerConversion和 Revenue 报表列中排除Conversions与此转换目标相关的其他数据。 此外，如果使用自动出价出价策略，将此属性设置为 true 将导致目标转换不再考虑自动出价计算。 将此属性设置为“true”实际上与取消选中Microsoft广告 Web 应用程序中的“包含在转换中”相同。 无论此元素值如何，AllConversions、AllConversionRate、、AllCostPerConversionAllReturnOnAdSpend、 AllRevenuePerConversion和 AllRevenue 报表列都将包括所有转换目标的数据。 默认情况下，此元素为 false，并且与此转换目标相关的数据包含在所有报表列中。 有关详细信息，请参阅报表属性和性能统计信息和帮助文章转换目标：“转换”与“所有转换”。 加： 自选 更新： 自选	boolean
GoalCategory	用于对转换目标进行分段的类别。 但是，对转换目标进行分类对业务有意义。 目标类别不会影响性能 - 它们可帮助你对目标及其性能指标进行细分。 支持的类别值因转换目标类型而异。 脱机转换目标支持 AddToCart、 BeginCheckout、 BookAppointment、 Contact、 GetDirections、 Other、 OutboundClick、 PageView、 Purchase、 RequestQuote、 Signup、 SubmitLeadForm 和 Subscribe 类别。 加： 自 2021 年 6 月起是必需的。 以前，如果将此元素保留为 nil 或空，则默认类别设置为 None。 更新： 如果转换目标已设置了非 “无”类别，则为可选。 如果未为更新设置任何值，则不会更改此设置。	ConversionGoalCategory
ID	转换目标的唯一Microsoft广告标识符。 加： 只读 更新： 必需和 Read-Only	long
IsEnhancedConversionsEnabled	确定是否为转换目标启用增强转换。 注意：若要创建增强的转换目标并设置 isEnhancedConversionsEnabled=true，必须通过Microsoft广告 UI 为帐户创建转换目标，并且选中了增强转换设置并选中了关联的复选框。	boolean
名称	转换目标名称。 名称的最大长度为 100，并且名称在属于同一客户的所有转换目标中必须是唯一的。 加： 必填 更新： 自选	string
收入	确定每个转换对业务的价值。 添加转换目标时，如果未指定任何收入跟踪首选项，则每个 ConversionGoalRevenue 将设置为各自的默认值。 更新转换目标时，如果 Revenue 元素为零或为空，则不会更新任何嵌套属性。 但是，如果此元素不为零或为空，则实际上将替换任何现有的收入属性。 如果收入类型为 FixedValue 或 VariableValue，则应用的 OfflineConversion 数据的 ConversionCurrencyCode 和 ConversionValue 元素优先于 ConversionGoalRevenue 货币代码和值。 加： 自选 更新： 自选	ConversionGoalRevenue
范围	确定目标是应用于所有帐户，还是仅适用于在所需的 CustomerAccountId 标头元素中指定的帐户。 如果你有多个Microsoft广告帐户，则可以跟踪所有这些帐户的转换。 如果将一个目标与一个帐户相关联，将仅跟踪该帐户的转换。 可能的值为 Account 和 Customer。 设置范围后，便无法更改范围。 如果要更改范围，需要创建新的转换目标并暂停旧目标。 加： 自选。 如果未指定，则默认情况下，范围将设置为 “帐户 ”。 更新： 只读。 无法更新脱机转换目标范围。	EntityScope
状态	定义转换目标的可能由用户确定的状态值。 这些是用户可以决定设置的状态值，例如，如果不再希望跟踪该目标的转换，可以将目标设置为 Paused 。 有关可由系统设置的状态值，请参阅 TrackingStatus 元素。 加： 自选 更新： 自选	ConversionGoalStatus
TagId	不适用于脱机转换目标。	long
TrackingStatus	不适用于脱机转换目标。	ConversionGoalTrackingStatus
类型	转换目标的类型。 检索脱机转换目标时，此值为 OfflineConversion 。 有关转换目标类型的详细信息，请参阅 ConversionGoal 数据对象备注。 加： 只读 更新： 只读	ConversionGoalType
ViewThroughConversionWindowInMinutes	不适用于脱机转换目标。	int

要求

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