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 。 加： 自選 更新： 自選	布爾

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	這會決定如何在您選擇的轉換視窗中記錄轉換。 有兩個選擇，如果您未設定值，預設值為 All： - 全部：將會計算在單擊廣告後發生不同離線轉換時間的所有轉換。 這是銷售的常見選擇。 - 唯一：只會計算按兩下廣告後發生的第一個轉換。 這是潛在客戶的常見選擇。 例如：您追蹤兩個轉換：潛在客戶和銷售。 您會針對潛在客戶選擇 [ 唯 一]，並針對銷售選擇 [全部 ]。 當單擊一次廣告會變成兩個潛在客戶和兩個銷售，則會計算為三個轉換：一個用於唯一的潛在客戶，兩個用於所有銷售。 將會忽略具有相同 MicrosoftClickId 和 ConversionTime 的重複離機轉換。 換句話說，只會計算給定 MicrosoftClickId 和 ConversionTime 的第一個離線轉換。 加： 自選 更新： 自選	ConversionGoalCountType
ExcludeFromBidding	判斷是否要從效能報表數據行的子集排除與此轉換目標相關的數據。 此元素僅適用於已啟用 [包含在轉換中] 功能的客戶 (GetCustomerPilotFeatures 會傳回 574) 。 如果這個項目設定為 true，則與此轉換目標相關的數據將會從 Conversions、 ConversionRate、 CostPerConversion、 ReturnOnAdSpend、 RevenuePerConversion和 Revenue 報表數據行中排除。 此外，如果您使用自動化的申請策略，將此屬性設定為 true 會導致目標的轉換不再納入自動化計算。 設定此屬性 「true」 實際上與取消核取 Microsoft Advertising Web 應用程式中的 [包含在轉換中] 相同。 不論這個元素值為何，AllConversions、AllConversionRateAllCostPerConversionAllReturnOnAdSpend、 AllRevenuePerConversion和 AllRevenue 報表數據行都會包含所有轉換目標的數據。 根據預設，此元素為 false，而且與此轉換目標相關的數據會包含在所有報表數據行中。 如需詳細資訊，請 參閱報表屬性和效能統計數據 和說明文章 轉換目標：「轉換」與「所有轉換」。 加： 自選 更新： 自選	布爾
GoalCategory	用來分割轉換目標的類別。 不過，將轉換目標分類對您的業務而言是合理的。 目標類別不會影響效能 - 這些類別可協助您分割目標及其效能計量。 支援的類別值會因轉換目標類型而有所不同。 脫機轉換目標支援 AddToCart、 BeginCheckout、 BookAppointment、 Contact、 GetDirections、 Other、 OutboundClick、 PageView、 Purchase、 RequestQuote、 Signup、 SubmitLeadForm 和 Subscribe 類別。 加： 自 2021 年 6 月起為必要專案。 先前，如果您將此元素保留為 nil 或空白，預設類別會設定為 [無]。 更新： 如果轉換目標已經有非 None 的類別集，則為選擇性。 如果未設定更新的值，則此設定不會變更。	ConversionGoalCategory
標識碼	轉換目標的唯Microsoft Advertising標識符。 加： 唯讀 更新： 必要和 Read-Only	長
IsEnhancedConversionsEnabled	判斷是否啟用轉換目標的增強轉換。 注意：若要建立增強的轉換目標並設定 isEnhancedConversionsEnabled=true，您必須透過Microsoft Advertising UI 建立帳戶的轉換目標，並選取增強的轉換設定，並核取相關聯的複選框。	布爾
名稱	轉換目標名稱。 名稱的最大長度為 100，且名稱在屬於相同客戶的所有轉換目標中必須是唯一的。 加： 必填 更新： 自選	string
收入	決定每個轉換對您企業的價值。 如果您未指定任何收益追蹤喜好設定，則新增轉換目標時，每個 ConversionGoalRevenue 都會設定為其各自的預設值。 更新轉換目標時，如果 Revenue 元素為 nil 或空白，則不會更新任何巢狀屬性。 不過，如果這個專案不是 nil 或空白，則您實際上會取代任何現有的收益屬性。 如果收益類型為 FixedValue 或 VariableValue，則所套用 OfflineConversion 數據的 ConversionCurrencyCode 和 ConversionValue 元素會優先於 ConversionGoalRevenue 貨幣代碼和值。 加： 自選 更新： 自選	ConversionGoalRevenue
範圍	判斷目標是否適用於所有帳戶，或僅適用於必要 CustomerAccountId 標頭元素中指定的帳戶。 如果您有多個Microsoft Advertising 帳戶，您可以追蹤所有這些帳戶的轉換。 如果您將目標與一個帳戶建立關聯，則只會針對該帳戶追蹤轉換。 可能的值為 Account 和 Customer。 設定範圍之後，就無法加以變更。 如果您想要變更範圍，您必須建立新的轉換目標，並暫停舊的轉換目標。 加： 自選。 如果未指定，則範圍預設會設定為 [帳戶 ]。 更新： 唯讀。 您無法更新離線轉換目標範圍。	EntityScope
地位	定義轉換目標的可能使用者決定狀態值。 這些是使用者可以決定設定的狀態值，例如，如果您不想再追蹤該目標的轉換，可以將目標設定為 [ 暫停 ]。 如需系統可設定的狀態值，請參閱 TrackingStatus 元素。 加： 自選 更新： 自選	ConversionGoalStatus
TagId	不適用於離線轉換目標。	長
TrackingStatus	不適用於離線轉換目標。	ConversionGoalTrackingStatus
類型	轉換目標的類型。 當您擷取離線轉換目標時，此值為 OfflineConversion 。 如需轉換目標類型的詳細資訊，請參閱 ConversionGoal Data Object Remarks。 加： 唯讀 更新： 唯讀	ConversionGoalType
ViewThroughConversionWindowInMinutes	不適用於離線轉換目標。	int

需求

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