通过

OfflineConversionAdjustment 数据对象 - 市场活动管理

  • 项目

定义通过 ApplyOfflineConversionAdjustments 操作收回或重述脱机转换的对象。

可以调整以前通过 ApplyOfflineConversions 操作应用的脱机转换的转换时间和值。

语法

<xs:complexType name="OfflineConversionAdjustment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdjustmentCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="AdjustmentType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="AdjustmentValue" nillable="true" type="xs:double" />
    <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="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>

元素

OfflineConversionAdjustment 对象具有以下元素：AdjustmentCurrencyCode、AdjustmentTime、AdjustmentType、AdjustmentValue、ConversionName、ConversionTime、HashedEmailAddress、HashedPhoneNumber、MicrosoftClickId。

元素 说明 数据类型
AdjustmentCurrencyCode 重述的脱机转换的货币代码。

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

应用： 如果 AdjustmentType 设置为“Restate”，则是必需的，否则忽略此字段。 如果未使用重述指定调整货币代码，则使用目标 ConversionGoalRevenue 的 CurrencyCode 元素。		 string
AdjustmentTime 发生调整的日期和时间。

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

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

应用： 必填		 dateTime
AdjustmentType 确定是收回还是重述脱机转换。

如果此值为“Restate”，则会根据新的 AdjustmentCurrencyCode、AdjustmentTime 和 AdjustmentValue 调整以前归因于指定 MicrosoftClickId 的脱机转换。

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

应用： 必填		 string
AdjustmentValue 调整后的脱机转换值。

应用： 如果 AdjustmentType 设置为“Restate”，则是必需的，否则不应设置此字段。		 双
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
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

使用者

ApplyOfflineConversionAdjustments