UrlGoal 數據物件 - 行銷活動管理

定義 URL 轉換目標。 使用這種類型的目標，將每次有人造訪網頁時計算為轉換。 例如，如果有人造訪購買確認頁面，您可以計算轉換。

提示

如需實作概觀，請參閱 通用事件追蹤 技術指南。

重要事項

每次您透過 Microsoft Advertising Web 應用程式或行銷活動管理 API 新增或更新 DurationGoal、EventGoal、OfflineConversionGoal、PagesViewedPerVisitGoal 或 UrlGoal 時，對應 AccountProperty 的 MSCLKIDAutoTaggingEnabled 值都會自動設定為 True。 如果目標的範圍設定為 [客戶 層級]，則會設定 [客戶] 下所有帳戶的 AccountProperty 。

XML

<xs:complexType name="UrlGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="UrlExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlOperator" nillable="true" type="tns:ExpressionOperator" />
      </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": "Url",
  "ViewThroughConversionWindowInMinutes": IntValueHere,
  "UrlExpression": "ValueHere",
  "UrlOperator": "ValueHere"
}

元素

UrlGoal 物件具有下列元素：UrlExpression、UrlOperator。

元素	描述	資料類型
UrlExpression	表達式，用來判斷用戶必須造訪的頁面或頁面，才能計算為轉換。 加： 必填 更新： 自選	string
UrlOperator	可套用至 Url 元素值的 運算 子。 加： 自選;如果未指定，則預設 運算符為 Equals。 更新： 自選;如果在更新期間未指定 ，則會保留先前的設定。	ExpressionOperator

UrlGoal 物件具有 Inherited Elements。

繼承的專案

從 ConversionGoal 繼承的專案

UrlGoal 物件衍生自 ConversionGoal 物件，並繼承下列元素：AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBidding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、ViewThroughConversionWindowInMinutes。 下列描述是 UrlGoal 特有的，而且可能不適用於從 ConversionGoal 物件繼承相同元素的其他物件。

元素	描述	資料類型
AttributionModelType	決定哪一個屬性模型 LastTouch 或 LastClick 與轉換目標搭配使用。	AttributionModelType
ConversionWindowInMinutes	轉換視窗是您想要追蹤轉換的按兩下之後，以分鐘為單位的時間長度。 如果您將此值設定為 43200 分鐘， (30 天) ，則會追蹤在按兩下後的 30 天內發生的轉換。 過去的轉換不會受到影響。 支援的最小值為1分鐘，但請記住，較短的轉換時間範圍將會減少帳戶記錄的轉換數目。 支援的最大值為 129600 分鐘 (90 天) 。 加： 自選 更新： 自選	int
CountType	這會決定如何在您選擇的轉換視窗中記錄轉換。 有兩個選擇，如果您未設定值，預設值為 All： - 全部：在單擊廣告之後發生的所有轉換都會計算在內。 這是銷售的常見選擇。 - 唯一：只會計算按兩下廣告之後發生的一個轉換。 這是潛在客戶的常見選擇。 例如：您追蹤兩個轉換：潛在客戶和銷售。 您會針對潛在客戶選擇 [ 唯 一]，並針對銷售選擇 [全部 ]。 當單擊一次廣告會變成兩個潛在客戶和兩個銷售，則會計算為三個轉換：一個用於唯一的潛在客戶，兩個用於所有銷售。 加： 自選 更新： 自選	ConversionGoalCountType
ExcludeFromBidding	判斷是否要從效能報表數據行的子集排除與此轉換目標相關的數據。 此元素僅適用於已啟用 [包含在轉換中] 功能的客戶 (GetCustomerPilotFeatures 會傳回 574) 。 如果這個項目設定為 true，則與此轉換目標相關的數據將會從 Conversions、 ConversionRate、 CostPerConversion、 ReturnOnAdSpend、 RevenuePerConversion和 Revenue 報表數據行中排除。 此外，如果您使用自動化的申請策略，將此屬性設定為 true 會導致目標的轉換不再納入自動化計算。 設定此屬性 「true」 實際上與取消核取 Microsoft Advertising Web 應用程式中的 [包含在轉換中] 相同。 不論這個元素值為何，AllConversions、AllConversionRateAllCostPerConversionAllReturnOnAdSpend、 AllRevenuePerConversion和 AllRevenue 報表數據行都會包含所有轉換目標的數據。 根據預設，此元素為 false，而且與此轉換目標相關的數據會包含在所有報表數據行中。 如需詳細資訊，請 參閱報表屬性和效能統計數據 和說明文章 轉換目標：「轉換」與「所有轉換」。 加： 自選 更新： 自選	布爾
GoalCategory	用來分割轉換目標的類別。 不過，將轉換目標分類對您的業務而言是合理的。 目標類別不會影響效能 - 這些類別可協助您分割目標及其效能計量。 支援的類別值會因轉換目標類型而有所不同。 URL 目標支援 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 或空白，則您實際上會取代任何現有的收益屬性。 加： 自選 更新： 自選	ConversionGoalRevenue
範圍	判斷目標是否適用於所有帳戶，或僅適用於必要 CustomerAccountId 標頭元素中指定的帳戶。 如果您有多個Microsoft Advertising 帳戶，您可以追蹤所有這些帳戶的轉換。 如果您將目標與一個帳戶建立關聯，則只會針對該帳戶追蹤轉換。 可能的值為 Account 和 Customer。 如果未指定，則範圍預設會設定為 Customer 。 設定範圍之後，就無法加以變更。 如果您想要變更範圍，您必須建立新的轉換目標，並暫停舊的轉換目標。 加： 自選 更新： 自選	EntityScope
地位	定義轉換目標的可能使用者決定狀態值。 這些是使用者可以決定設定的狀態值，例如，如果您不想再追蹤該目標的轉換，可以將目標設定為 [ 暫停 ]。 如需系統可以設定的狀態值，例如是否驗證 UET 標籤，請參閱 TrackingStatus 元素。 加： 自選 更新： 自選	ConversionGoalStatus
TagId	您新增至網站之 UET 標籤的唯一Microsoft Advertising 識別碼，可讓Microsoft Advertising 收集使用者在您的網站上採取的動作。 在您對標記標識碼進行相依性之前，請注意 UET 標籤可以與其他客戶共用或與另一個客戶共用。 共用的 UET 標籤和物件僅適用於試驗客戶。 如需在客戶階層中共享物件和UET標籤的概觀，請參閱 共用物件和UET標籤 指南。 加： 必填 更新： 自選	長
TrackingStatus	定義轉換目標可能由系統決定的狀態值。 這些是系統可以設定的狀態值，例如，如果 UET 標籤尚未驗證，系統會將狀態設定為 TagUnverified 。 如需使用者可以決定設定的狀態值，例如 ，如果您不想 再追蹤該目標的轉換，請參閱 Status 元素， 加： 唯讀 更新： 唯讀	ConversionGoalTrackingStatus
類型	轉換目標的類型。 當您擷取 URL 目標時，此值為 URL。 如需轉換目標類型的詳細資訊，請參閱 ConversionGoal Data Object Remarks。 加： 唯讀 更新： 唯讀	ConversionGoalType
ViewThroughConversionWindowInMinutes	檢視轉換視窗是您想要追蹤檢視轉換的點選後幾分鐘內的時間長度。 如果您將此值設定為 43200 分鐘 (30 天) ，則會追蹤按兩下後 30 天內發生的檢視轉換。 過去的轉換不會受到影響。 支援的最小值為1分鐘，但請記住，較短的轉換時間範圍將會減少帳戶記錄的轉換數目。 支援的最大值為 43200 分鐘， (30 天) 。 IncludeViewThroughConversions 帳戶屬性也必須設定為 true，才能追蹤檢視轉換。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 服務作業時，在 ReturnAdditionalFields 元素中包含 ViewThroughConversionWindowInMinutes 值。 加： 自選 更新： 自選	int

需求

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