OfflineConversion 数据对象 - 市场活动管理
定义发送到Microsoft广告的脱机转换。
若要设置脱机转换跟踪，请创建 OfflineConversionGoal。 如果将 OfflineConversionGoal 的 CountType 设置为 All，则会累积添加具有不同转换时间的同一 MicrosoftClickId 的所有脱机转换。 如果将 OfflineConversionGoal 的 CountType 设置为 Unique，则只会统计广告点击后发生的第一次转换。 将忽略具有相同 MicrosoftClickId 和 ConversionTime 的重复脱机转换。 换句话说，仅计算给定 MicrosoftClickId 和 ConversionTime 的第一次脱机转换。
重要
设置 OfflineConversionGoal 后，请等待两小时，然后通过 ApplyOfflineConversions 操作发送Microsoft Advertising the OfflineConversion 数据。 在Microsoft广告报告中查看转换数据可能需要长达 6 小时的时间。
注意
尽管可以在沙盒中上传脱机转换进行功能测试，但脱机转换数据不会在沙盒性能报告数据中归因。
语法
<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广告作为脱机转换进行计数，必须满足以下附加要求： - 转换的日期和时间必须晚于记录的单击的日期和时间。 - 日期和时间必须在转换时段内。 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 日 (转换时段内。 重要： 该值必须采用协调世界时 (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单击 ID 跟踪启用自动标记，请使用 GetAccountProperties 和 SetAccountProperties 操作。 应用： 自选 注意：当你提供经过哈希处理的电子邮件地址或电话号码进行增强转换时，MSCLKID 是可选的。 |
string |
要求
服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13