OfflineConversion 數據物件 - 營銷活動管理
定義您傳送給 Microsoft Advertising 的離線轉換。
若要設定離線轉換追蹤，請建立 OfflineConversionGoal。 如果您將 OfflineConversionGoal 的 CountType 設定為 All，則會累計新增相同 MicrosoftClickId 與不同轉換時間的所有離線轉換。 如果您將 OfflineConversionGoal 的 CountType 設定為 Unique，則只會計算在按兩下廣告之後發生的第一個轉換。 將會忽略具有相同 MicrosoftClickId 和 ConversionTime 的重複離機轉換。 換句話說，只會計算給定 MicrosoftClickId 和 ConversionTime 的第一個離線轉換。
重要事項
設定 OfflineConversionGoal 之後，請等候兩小時，然後透過 ApplyOfflineConversions 作業傳送 Microsoft Advertising 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 物件具有下列元素：ConversionCurrencyCode、ConversionName、ConversionTime、ConversionValue、ExternalAttributionCredit、ExternalAttributionModel、HashedEmailAddress、HashedPhoneNumber、MicrosoftClickId。
| 元素 | 描述 | 資料類型 |
|---|---|---|
| ConversionCurrencyCode | 離線轉換的貨幣代碼。 如需詳細資訊，請參閱 貨幣。 應用： 選。 如果您未指定離線轉換貨幣代碼，則會使用目標 ConversionGoalRevenue 的 CurrencyCode 元素。 |
string |
| ConversionName | 轉換目標名稱。 此名稱必須符合現有的轉換目標名稱，否則將不會套用離線轉換目標數據。 應用： 必填 |
string |
| ConversionTime | 離線轉換發生的日期和時間。 日期和時間必須在過去 90 天內，否則當您嘗試傳送 Microsoft Advertising 離機轉換數據時，作業將會失敗。 若要在成功上傳後由 Microsoft Advertising 計算為離線轉換，必須符合下列其他需求： - 轉換的日期和時間必須晚於錄製點選的日期和時間。 - 日期和時間必須在轉換視窗內。 OfflineConversionGoal 的 ConversionWindowInMinutes 屬性會在按兩下之後以分鐘為單位判斷將追蹤轉換的最大時間長度。 例如，如果在 4 月 30 日錄製了三次點選，如果 OfflineConversionGoal 的 ConversionWindowInMinutes 等於 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 | 離線轉換值。 應用： 選。 如果您未指定離線轉換值，則會使用目標 ConversionGoalRevenue 的 Value 元素。 |
雙 |
| ExternalAttributionCredit | 此欄位只能針對使用外部屬性的轉換動作設定。 它代表屬性化為每次點選的轉換分數。 其值必須大於 0 且小於或等於 1。 如果此欄位與非外部屬性轉換動作搭配使用，則會傳回 GoalNotEligibleForExternalAttribution 錯誤。 應用： 選 |
雙 |
| ExternalAttributionModel | 此欄位只能針對使用外部屬性的轉換動作設定。 它會指定屬性模型名稱。 如果此欄位與非外部屬性轉換動作搭配使用，則會傳回 GoalNotEligibleForExternalAttribution 錯誤。 應用： 選 |
string |
| HashedEmailAddress | 使用 SHA-256 演算法來搭配增強轉換使用的哈希電子郵件位址。 | string |
| HashedPhoneNumber | 根據 E.164 標準的哈希電話號碼，用於增強轉換。 | string |
| MicrosoftClickId | 離線轉換的 MSCLKID。 若要確保 Microsoft 按兩下標識元追蹤已啟用自動標記，請使用 GetAccountProperties 和 SetAccountProperties 作業。 應用： 選 注意：當您提供哈希電子郵件地址或電話號碼以進行增強轉換時，MSCLKID 是選擇性的。 |
string |
需求
服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13