共用方式為


OfflineConversion 數據物件 - 營銷活動管理

定義您傳送至 Microsoft Advertising 的離線轉換。

若要設定離線轉換追蹤,請建立 OfflineConversionGoal。 如果您將 OfflineConversionGoalCountType 設定為 All,則會累計新增相同 MicrosoftClickId 與不同轉換時間的所有離線轉換。 如果您將 OfflineConversionGoalCountType 設定為 Unique,則只會計算在按兩下廣告之後發生的第一個轉換。 將會忽略具有相同 MicrosoftClickIdConversionTime 的重複離機轉換。 換句話說,只會計算給定 MicrosoftClickIdConversionTime 的第一個離線轉換。

重要事項

設定 OfflineConversionGoal 之後,請等候兩小時,然後透過 ApplyOfflineConversions 作業傳送 Microsoft Advertising the OfflineConversion 數據。 在 Microsoft Advertising 報告中檢視轉換數據最多可能需要六小時的時間。

注意事項

雖然您可以在沙盒中上傳脫機轉換以進行功能測試,但離線轉換數據不會在沙箱效能報告數據中歸屬。

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
      <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="HashedPhoneNumber" nillable="true" type="xs:string">
      <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="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

OfflineConversion 物件具有下列元素:ConversionCurrencyCodeConversionNameConversionTimeConversionValueExternalAttributionCreditExternalAttributionModelHashedEmailAddressHashedPhoneNumberMicrosoftClickId

元素 描述 資料類型
ConversionCurrencyCode 離線轉換的貨幣代碼。

如需詳細資訊,請參閱 貨幣

應用: 自選。 如果您未指定離線轉換貨幣代碼,則會使用目標 ConversionGoalRevenueCurrencyCode 元素。
string
ConversionName 轉換目標名稱。

此名稱必須符合現有的轉換目標名稱,否則將不會套用離線轉換目標數據。

應用: 必填
string
ConversionTime 離線轉換發生的日期和時間。

日期和時間必須在過去 90 天內,否則當您嘗試傳送Microsoft通知離機轉換數據時,作業將會失敗。

若要在成功上傳後由 Microsoft Advertising 計算為離線轉換,必須符合下列額外需求:
- 轉換的日期和時間必須晚於錄製點選的日期和時間。
- 日期和時間必須在轉換視窗內。 OfflineConversionGoalConversionWindowInMinutes 屬性會在按兩下之後以分鐘為單位判斷將追蹤轉換的最大時間長度。

例如,如果在 4 月 30 日錄製了三次點選,如果 OfflineConversionGoalConversionWindowInMinutes 等於 30 天, (43200 分鐘) ,而且如果您在 7 月 31 日傳送 Microsoft Advertising 下列脫機轉換,則 Microsoft Advertising 只會將 MicrosoftClickId=2 的轉換算為脫機轉換。
- MicrosoftClickId=1;ConversionTime=2020-04-30T17:02:35.6853793Z
- MicrosoftClickId=2;ConversionTime=2020-05-15T17:02:35.6853793Z
- MicrosoftClickId=3;ConversionTime=2020-06-15T17:02:35.6853793Z

因為轉換日期和時間超過90天前,所以不會上傳使用 MicrosoftClickId=1 的離線轉換數據,而且不會計算使用 MicrosoftClickId=3 的離線轉換數據,因為它不在 4 月 30 日 (到 5 月 29 日) 的轉換期間內。

重要: 此值必須以國際標準時間 (UTC) 。 這與您在 Microsoft Advertising Web 應用程式中上傳脫機轉換時的時區選項不同。 如需日期和時間格式的相關信息,請參閱 基本 XML 數據類型中的 dateTime 專案。

應用: 必填
dateTime
ConversionValue 離線轉換值。

應用: 自選。 如果您未指定離線轉換值,則會使用目標 ConversionGoalRevenueValue 元素。
ExternalAttributionCredit 此欄位只能針對使用外部屬性的轉換動作設定。 它代表屬性化為每次點選的轉換分數。 其值必須大於 0 且小於或等於 1。

如果此欄位與非外部屬性轉換動作搭配使用,則會傳回 GoalNotEligibleForExternalAttribution 錯誤。

應用: 自選
ExternalAttributionModel 此欄位只能針對使用外部屬性的轉換動作設定。 它會指定屬性模型名稱。

如果此欄位與非外部屬性轉換動作搭配使用,則會傳回 GoalNotEligibleForExternalAttribution 錯誤。

應用: 自選
string
HashedEmailAddress 使用 SHA-256 演算法來搭配增強轉換使用的哈希電子郵件位址。 string
HashedPhoneNumber 根據 E.164 標準的哈希電話號碼,用於增強轉換。 string
MicrosoftClickId 離線轉換的 MSCLKID。

若要確保已針對按兩下標識符追蹤啟用自動標記Microsoft,請使用 GetAccountPropertiesSetAccountProperties 作業。

應用: 自選

注意:當您提供哈希電子郵件地址或電話號碼以進行增強轉換時,MSCLKID 是選擇性的。
string

需求

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

消費者

ApplyOfflineConversions