OfflineConversion 數據物件 - 營銷活動管理
定義您傳送至 Microsoft Advertising 的離線轉換。
若要設定離線轉換追蹤,請建立 OfflineConversionGoal。 如果您將 OfflineConversionGoal 的 CountType 設定為 All,則會累計新增相同 MicrosoftClickId 與不同轉換時間的所有離線轉換。 如果您將 OfflineConversionGoal 的 CountType 設定為 Unique,則只會計算在按兩下廣告之後發生的第一個轉換。 將會忽略具有相同 MicrosoftClickId 和 ConversionTime 的重複離機轉換。 換句話說,只會計算給定 MicrosoftClickId 和 ConversionTime 的第一個離線轉換。
重要事項
設定 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 物件具有下列元素:ConversionCurrencyCode、ConversionName、ConversionTime、ConversionValue、ExternalAttributionCredit、ExternalAttributionModel、HashedEmailAddress、HashedPhoneNumber、MicrosoftClickId。
元素 | 描述 | 資料類型 |
---|---|---|
ConversionCurrencyCode | 離線轉換的貨幣代碼。 如需詳細資訊,請參閱 貨幣。 應用: 自選。 如果您未指定離線轉換貨幣代碼,則會使用目標 ConversionGoalRevenue 的 CurrencyCode 元素。 |
string |
ConversionName | 轉換目標名稱。 此名稱必須符合現有的轉換目標名稱,否則將不會套用離線轉換目標數據。 應用: 必填 |
string |
ConversionTime | 離線轉換發生的日期和時間。 日期和時間必須在過去 90 天內,否則當您嘗試傳送Microsoft通知離機轉換數據時,作業將會失敗。 若要在成功上傳後由 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