脱机转换记录 - 批量

项目
11/13/2024

定义可在批量文件中上传的脱机转换。

可以添加、重述 (更新) ，或重述 (删除) 脱机转换。

若要上传脱机转换，请设置 “换算货币代码”、“ 转换名称”、“ 转换时间”、“ 转换值”和 Microsoft“单击 ID” 字段。
若要根据需要重述或更正以前上传的脱机转换，请将“调整类型”字段设置为“Restate”，并设置原始转换名称、转换时间和 Microsoft单击 ID 字段。在同一记录中包含任何调整，例如调整值、调整时间和调整货币代码。
若要根据需要收回或删除以前上传的脱机转换，请将“调整类型”字段设置为“收回”，并设置原始转换名称、转换时间和 Microsoft单击 ID 字段。

若要设置脱机转换跟踪，请创建 OfflineConversionGoal。如果将 OfflineConversionGoal 的 CountType 设置为 All，则会累积添加具有不同转换时间的同一 MicrosoftClickId 的所有脱机转换。如果将 OfflineConversionGoal 的 CountType 设置为 Unique，则只会统计广告点击后发生的第一次转换。将忽略具有相同 MicrosoftClickId 和 ConversionTime 的重复脱机转换。换句话说，仅计算给定 MicrosoftClickId 和 ConversionTime 的第一次脱机转换。

重要

设置 OfflineConversionGoal 后，请等待两小时，然后通过 ApplyOfflineConversions 操作发送Microsoft Advertising the OfflineConversion 数据。在Microsoft广告报告中查看转换数据可能需要长达 6 小时的时间。

必须通过市场活动管理 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 的必应广告 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();

对于 脱机转换 记录，批量文件架构中提供了以下属性字段。

调整货币代码
调整时间
调整类型
调整值
客户端 ID
换算货币代码
转换名称
转换时间
转换值
外部归因信用
外部属性模型
哈希电子邮件地址
哈希电话号码
Microsoft单击 ID

调整货币代码

重述的脱机转换的货币代码。

有关详细信息，请参阅货币。

加：不適用
重申： 必填。如果未使用重述指定调整货币代码，则使用目标 ConversionGoalRevenue 的 CurrencyCode 元素。
收回： 不適用

调整时间

发生调整的日期和时间。

调整时间不能早于原始脱机转换日期和时间。

重要

该值必须采用协调世界时 (UTC) 。这与在 Microsoft Advertising Web 应用程序中上传脱机转换时的时区选项不同。有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

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

调整类型

确定是收回还是重述脱机转换。

如果此值为“Restate”，则会根据新的调整货币代码、调整时间和调整值来调整以前归因于指定Microsoft单击 ID 的脱机转换。

如果此值为“Retract”，则会收回或删除以前归因于指定 Microsoft单击 ID 的脱机转换。

加：不適用
重申： 必填。此字段必须设置为“Restate”。
收回： 必填。此字段必须设置为“收回”。

调整值

调整后的脱机转换值。

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

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。它可以是长度最大为 100 的任何有效字符串。

加：自选
重申： 自选
收回： 自选

换算货币代码

脱机转换的货币代码。

有关详细信息，请参阅货币。

加：自选。如果未指定脱机换算货币代码，则使用目标的 ConversionGoalRevenue 的 CurrencyCode 元素。
重申： 不適用
收回： 不適用

转换名称

转换目标名称。

此名称必须与现有转换目标名称匹配，否则将不应用脱机转换目标数据。

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

转换时间

发生脱机转换的日期和时间。

日期和时间必须在过去 90 天内，否则在尝试发送Microsoft播发脱机转换数据时，操作将失败。

重要

若要在成功上传后Microsoft广告作为脱机转换进行计数，必须满足以下附加要求：

转换的日期和时间必须晚于记录的单击的日期和时间。
日期和时间必须在转换时段内。 OfflineConversionGoal 的 ConversionWindowInMinutes 属性确定单击后将跟踪转换的最大时间长度（以分钟为单位）。

例如，如果在 4 月 30 日录制了三次单击，如果 OfflineConversionGoal 的 ConversionWindowInMinutes 等于 30 天 (43200 分钟) ，并且如果您在 7 月 31 日发送Microsoft广告以下脱机转换，则 Microsoft广告只会将 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

MicrosoftClickId=1 的脱机转换数据不会上传，因为转换日期和时间超过 90 天，并且不会计算 MicrosoftClickId=3 的脱机转换数据，因为它不在) 年 4 月 30 日至 5 月 29 日 (转换时段内。

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

转换值

脱机转换值。

加：自选。如果未指定脱机转换值，则使用目标的 ConversionGoalRevenue 的 Value 元素。
重申： 不適用
收回： 不適用

外部归因信用

只能为使用外部属性的转换操作设置此字段。它表示归因于每次单击的转换的分数。其值必须大于 0 且小于或等于 1。

如果此字段用于非外部特性化转换操作，将返回 GoalNotEligibleForExternalAttribution 错误。

应用： 自选

外部属性模型

只能为使用外部属性的转换操作设置此字段。它指定属性模型名称。

如果此字段用于非外部特性化转换操作，将返回 GoalNotEligibleForExternalAttribution 错误。

应用： 自选

哈希电子邮件地址

使用 SHA-256 算法的哈希电子邮件地址，用于增强转换。

加：增强转换所必需的。
重申： 增强转换所必需的。
收回： 增强转换所必需的。

哈希电话号码

根据 E.164 标准哈希电话号码，用于增强转换。