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

定義轉換目標的基底物件。

請勿嘗試具現化 ConversionGoal。 您可以建立一或多個衍生自它的下列物件。

• AppInstallGoal
• DurationGoal
• EventGoal
• InStoreTransactionGoal
• OfflineConversionGoal
• PagesViewedPerVisitGoal
• UrlGoal

語法

<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、ExcludeFromBidding、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	這會決定如何在您選擇的轉換視窗中記錄轉換。 有兩個選擇，如果您未設定值，預設值為 All： - 全部：在按一下廣告之後發生的所有轉換都會計算在內。 這是銷售的常見選擇。 - 唯一：只會計算按一下廣告之後發生的一個轉換。 這是潛在客戶的常見選擇。 例如：您追蹤兩個轉換：潛在客戶和銷售。 您會針對潛在客戶選擇 [ 唯 一]，並針對銷售選擇 [全部 ]。 當按一下一次廣告會變成兩個潛在客戶和兩個銷售，則會計算為三個轉換：一個用於唯一的潛在客戶，兩個用於所有銷售。 此元素不適用於 AppInstallGoal。	ConversionGoalCountType
ExcludeFromBidding	判斷是否要從效能報表資料行的子集排除與此轉換目標相關的資料。 此元素僅適用于已啟用 [包含在轉換中] 功能的客戶 (GetCustomerPilotFeatures 會傳回 574) 。 如果這個專案設定為 true，則與此轉換目標相關的資料將會從 Conversions 、 ConversionRate 、 CostPerConversion 、 ReturnOnAdSpend 、 RevenuePerConversion 和 Revenue 報表資料行中排除。 此外，如果您使用自動化的申請策略，將此屬性設定為 true 會導致目標的轉換不再納入自動化計算。 設定此屬性 「true」 實際上與取消核取 Microsoft Advertising Web 應用程式中的 [包含在轉換中] 相同。 不論這個元素值為何， AllConversions 、 AllConversionRateAllCostPerConversionAllReturnOnAdSpend 、 AllRevenuePerConversion 和 AllRevenue 報表資料行都會包含所有轉換目標的資料。 根據預設，此元素為 false，而且與此轉換目標相關的資料會包含在所有報表資料行中。 如需詳細資訊，請 參閱報表屬性和效能統計資料 和說明文章 轉換目標：「轉換」與「所有轉換」。	布林
GoalCategory	用來分割轉換目標的類別。 不過，將轉換目標分類對您的業務而言是合理的。 目標類別不會影響效能 - 這些類別可協助您分割目標及其效能計量。 支援的類別值會因轉換目標型別而有所不同，因此請參閱對應的參考頁面以取得詳細需求。	ConversionGoalCategory
識別碼	轉換目標的唯一 Microsoft Advertising 識別碼。	長
IsEnhancedConversionsEnabled	判斷是否啟用轉換目標的增強轉換。 注意：若要建立增強的轉換目標並設定 isEnhancedConversionsEnabled=true ，您必須透過 Microsoft Advertising UI 建立帳戶的轉換目標，並選取增強的轉換設定，並核取相關聯的核取方塊。	布林
名稱	轉換目標名稱。 名稱的最大長度為 100，且名稱在屬於相同客戶的所有轉換目標中必須是唯一的。	string
收入	決定每個轉換對您企業的價值。 如果您未指定任何收益追蹤喜好設定，則新增轉換目標時，每個 ConversionGoalRevenue 都會設定為其各自的預設值。 更新轉換目標時，如果 Revenue 元素為 nil 或空白，則不會更新任何巢狀屬性。 不過，如果這個專案不是 nil 或空白，則您實際上會取代任何現有的收益屬性。 VariableValue選項不適用於AppInstallGoal、DurationGoal或PagesViewedPerVisitGoal。	ConversionGoalRevenue
範圍	判斷目標是否適用于所有帳戶，或僅適用于必要 CustomerAccountId 標頭元素中指定的帳號。 如果您有多個 Microsoft Advertising 帳戶，您可以追蹤所有這些帳戶的轉換。 如果您將目標與一個帳戶建立關聯，則只會針對該帳戶追蹤轉換。 可能的值為 Account 和 Customer。 設定範圍之後，就無法加以變更。 如果您想要變更範圍，您必須建立新的轉換目標，並暫停舊的轉換目標。 AppInstallGoal僅支援客戶範圍。	EntityScope
狀態	定義轉換目標的可能使用者決定狀態值。 這些是使用者可以決定設定的狀態值，例如，如果您不想再追蹤該目標的轉換，可以將目標設定為 [ 暫停 ]。 如需系統可以設定的狀態值，例如是否驗證 UET 標籤，請參閱 TrackingStatus 元素。	ConversionGoalStatus
TagId	您新增至網站之 UET 標籤的唯一 Microsoft Advertising 識別碼，可讓 Microsoft Advertising 收集使用者在您的網站上採取的動作。 在您對標記識別項進行相依性之前，請注意 UET 標籤可以與其他客戶共用或與另一個客戶共用。 共用的 UET 標籤和物件僅適用于試驗客戶。 如需在客戶階層中共用物件和 UET 標籤的概觀，請參閱 共用物件和 UET 標籤 技術指南。 此元素不適用於 AppInstallGoal、 InStoreTransactionGoal和 OfflineConversionGoal。	長
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>類型屬性，如下列範例所示，以指定轉換目標的類型。

<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