共用方式為

EventGoal 資料物件 - 行銷活動管理

  • 發行項

定義自訂事件轉換目標。

每次有人完成特定動作，例如訂閱電子報或下載檔案做為轉換時，請使用這種類型的目標來計算。

根據預設，UET 標籤會記錄使用者造訪您網站上的頁面，讓 Microsoft Advertising 支援目標型別，例如 UrlGoal、 DurationGoal 和 PagesViewedPerVisitGoal。 不過，您可能想要追蹤其他類型的事件，例如訂閱電子報或下載檔案。 Microsoft Advertising 會使用 EventGoal來啟用此案例。 除了建立 EventGoal之外，您還必須自訂 UET 標記追蹤程式碼，以報告一或多個自訂事件參數的值。 若要深入瞭解，請 參閱如何使用 UET 報告自訂事件。

提示

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

重要事項

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

語法

<xs:complexType name="EventGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="CategoryExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="LabelExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" nillable="true" type="tns:ValueOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

EventGoal物件具有下列元素：ActionExpression、ActionOperator、CategoryExpression、CategoryOperator、LabelExpression、LabelOperator、Value、ValueOperator。

元素 說明 資料類型
ActionExpression 您想要追蹤的使用者互動類型。例如'play' 或 'pause'。

如果在新增或更新作業期間指定這個專案，則也需要 ActionOperator 元素。

字串不能超過最大長度 100。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 ActionOperator 和 ActionExpression ，將會刪除任何現有的 ActionOperator 和 ActionExpression 設定。		 string
ActionOperator 可套用至 ActionExpression 元素值的運算子。

如果在新增或更新作業期間指定這個專案，則也需要 ActionExpression 元素。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 ActionOperator 和 ActionExpression ，將會刪除任何現有的 ActionOperator 和 ActionExpression 設定。		 ExpressionOperator
CategoryExpression 您想要追蹤的事件類別。例如，'video'。

如果在新增或更新作業期間指定這個專案，則也需要 CategoryOperator 元素。

字串不能超過最大長度 100。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 CategoryOperator 和 CategoryExpression ，將會刪除任何現有的 CategoryOperator 和 CategoryExpression 設定。		 string
CategoryOperator 可套用至 CategoryExpression 元素值的運算子。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 CategoryOperator 和 CategoryExpression ，將會刪除任何現有的 CategoryOperator 和 CategoryExpression 設定。		 ExpressionOperator
LabelExpression 造成動作的專案名稱。 例如'trailer' 或 'behindthescenes'。

如果在新增或更新作業期間指定這個專案，則也需要 LabelOperator 元素。

字串不能超過最大長度 100。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 LabelOperator 和 LabelExpression ，將會刪除任何現有的 LabelOperator 和 LabelExpression 設定。		 string
LabelOperator 可套用至 LabelExpression 元素值的運算子。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 LabelOperator 和 LabelExpression ，將會刪除任何現有的 LabelOperator 和 LabelExpression 設定。		 ExpressionOperator
值 與該事件相關聯的數值。 例如，值可能是影片播放的持續時間。

如果在新增或更新作業期間指定這個專案，則也需要 ValueOperator 元素。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 ValueOperator 和 Value ，將會刪除任何現有的 ValueOperator 和 Value 設定		 十進位
ValueOperator 可套用至 Value 元素值的運算子。

添加： 如果您包含一或多個其他事件，則為選擇性;您必須包含下列一或多個事件運算子配對： (ActionOperator 和 ActionExpression) 、 (CategoryOperator 和 CategoryExpression) 、 (LabelOperator 和 LabelExpression) 、 (ValueOperator 和 Value) 。
更新： 如果您包含一或多個其他事件，則為選擇性;如果您在更新期間未包含 ValueOperator 和 Value ，則會刪除任何現有的 ValueOperator 和 Value 設定。		 ValueOperator

EventGoal物件具有Inherited Elements。

繼承的專案

從 ConversionGoal 繼承的專案

EventGoal物件衍生自ConversionGoal物件，並繼承下列元素：AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBidding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、 ViewThroughConversionWindowInMinutes。 下列描述是 EventGoal特有的，而且可能不適用於從 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 用來分割轉換目標的類別。

不過，將轉換目標分類對您的業務而言是合理的。 目標類別不會影響效能 - 這些類別可協助您分割目標及其效能計量。

支援的類別值會因轉換目標型別而有所不同。 事件目標支援 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
類型 轉換目標的類型。 當您擷取事件目標時，此值為 Event。 如需轉換目標型別的詳細資訊，請參閱 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