離線轉換記錄 - 大量

定義可在大量檔案中上傳的離線轉換。

您可以新增、重新 (更新) 或 restract (刪除) 離線轉換。

• 若要上傳脫機轉換，請設定 [ 轉換貨幣代碼]、[ 轉換名稱]、[ 轉換時間]、[ 轉換值] ，Microsoft [按兩下標識元] 字 段。
• 若要視需要重述或更正先前上傳的離線轉換，請將 [ 調整類型 ] 欄位設定為 “Restate”，並設定原始 的 [轉換名稱]、[ 轉換時間]， 然後Microsoft [單擊標識符] 字段。 在同一筆記錄中包含任何調整，例如調整 值、 調整時間和 調整貨幣代碼。
• 若要視需要撤銷或刪除先前上傳的離線轉換，請將 [ 調整類型 ] 字段設定為 [撤銷]，然後設定原始的 [轉換名稱]、[ 轉換時間]， Microsoft [單擊標識符] 欄位。

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

重要事項

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

您必須透過營銷活動管理 API 建立 OfflineConversionGoal ，才能設定 IsExternallyAttributed 屬性。

注意事項

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

下列大量 CSV 範例會新增離線轉換。

Type,Status,Id,Parent Id,Client Id,Name,Conversion Currency Code,Conversion Name,Conversion Time,Conversion Value,Microsoft Click Id
Format Version,,,,,6.0,,,,,
Offline Conversion,,,,ClientIdGoesHere,,USD,My Goal Name,4/1/2020 6:50:54 PM,10,f894f652ea334e739002f7167ab8f8e3

如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，則可以使用 BulkServiceManager 來上傳 BulkOfflineConversion 物件來節省時間，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkOfflineConversion
var bulkOfflineConversion = new BulkOfflineConversion
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    OfflineConversion = new OfflineConversion
    {
        // 'Conversion Currency Code' column header in the Bulk file
        ConversionCurrencyCode = "USD",
        // 'Conversion Name' column header in the Bulk file
        ConversionName = "My Goal Name",
        // 'Conversion Time' column header in the Bulk file
        ConversionTime = DateTime.UtcNow,
        // 'Conversion Value' column header in the Bulk file
        ConversionValue = 10,
        // 'Microsoft Click Id' column header in the Bulk file
        MicrosoftClickId = "f894f652ea334e739002f7167ab8f8e3"
    },

    // 'Adjustment Currency Code' column header in the Bulk file
    AdjustmentCurrencyCode = null,

    // 'Adjustment Time' column header in the Bulk file
    AdjustmentTime = null,

    // 'Adjustment Type' column header in the Bulk file
    AdjustmentType = null,

    // 'Adjustment Value' column header in the Bulk file
    AdjustmentValue = null,

    // 'External Attribution Credit' column header in the Bulk file
    ExternalAttributionCredit = null,

    // 'External Attribution Model' column header in the Bulk file
    ExternalAttributionModel = null,

    // 'Hashed Email Address' column header in the Bulk file
    HashedEmailAddress = null,

    // 'Hashed Phone Number' column header in the Bulk file
    HashedPhoneNumber = null
};

uploadEntities.Add(bulkOfflineConversion);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 離線轉換 記錄， 大量檔案架構中提供下列屬性欄位。

• 調整貨幣代碼
• 調整時間
• 調整類型
• 調整值
• 用戶端識別碼
• 轉換貨幣代碼
• 轉換名稱
• 轉換時間
• 轉換值
• 外部屬性點數
• 外部屬性模型
• 哈希電子郵件位址
• 哈希電話號碼
• Microsoft按兩下標識碼

調整貨幣代碼

已重設離線轉換的貨幣代碼。

如需詳細資訊，請參閱 貨幣。

加： 不適用
重申： 必填。 如果您未使用重述指定調整貨幣代碼，則會使用目標 ConversionGoalRevenue 的 CurrencyCode 元素。
收回： 不適用

調整時間

發生調整的日期和時間。

調整時間不能早於原始離線 轉換日期和時間。

重要事項

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

加： 不適用
重申： 必填
收回： 必填

調整類型

決定是否要撤銷或重述離線轉換。

如果此值為 “Restate”，則會根據新的調整貨幣代碼、調整時間和調整值，調整先前屬性為指定Microsoft Click Id 的離線轉換。

如果此值為 “Retract”，則會撤銷或刪除先前屬性為指定 Microsoft Click Id 的離線轉換。

加： 不適用
重申： 必填。 此欄位必須設定為 「Restate」。
收回： 必填。 此欄位必須設定為 「Retract」。

調整值

調整后的離線轉換值。

加： 不適用
重申： 必填
收回： 不適用

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。

加： 自選
重申： 自選
收回： 自選

轉換貨幣代碼

離線轉換的貨幣代碼。

如需詳細資訊，請參閱 貨幣。

加： 自選。 如果您未指定離線轉換貨幣代碼，則會使用目標 ConversionGoalRevenue 的 CurrencyCode 元素。
重申： 不適用
收回： 不適用

轉換名稱

轉換目標名稱。

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

加： 必填
重申： 必填
收回： 必填

轉換時間

離線轉換發生的日期和時間。

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

重要事項

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

若要在成功上傳後由 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 日) 的轉換期間內。

加： 必填
重申： 必填
收回： 必填

轉換值

離線轉換值。

加： 自選。 如果您未指定離線轉換值，則會使用目標 ConversionGoalRevenue 的 Value 元素。
重申： 不適用
收回： 不適用

外部屬性點數

此欄位只能針對使用外部屬性的轉換動作設定。 它代表屬性化為每次點選的轉換分數。 其值必須大於 0 且小於或等於 1。

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

應用： 自選

外部屬性模型

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

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

應用： 自選

哈希電子郵件位址

使用 SHA-256 演算法來搭配增強轉換使用的哈希電子郵件位址。

加： 增強轉換的必要專案。
重申： 增強轉換的必要專案。
收回： 增強轉換的必要專案。

哈希電話號碼

根據 E.164 標準的哈希電話號碼，用於增強轉換。

加： 增強轉換的必要專案。
重申： 增強轉換的必要專案。
收回： 增強轉換的必要專案。

Microsoft按兩下標識碼

離線轉換的 MSCLKID。

若要確保已啟用自動標記以Microsoft按兩下標識元追蹤，請使用帳戶記錄的[MSCLKID 自動標記啟用] 字段。

加： 只有在未傳送哈希電子郵件或電話號碼時才需要。
重申： 只有在未傳送哈希電子郵件或電話號碼時才需要。
收回： 只有在未傳送哈希電子郵件或電話號碼時才需要。