Compartir a través de

Objeto de datos OfflineConversionAdjustment: Administración de campañas

  • Artículo

Define un objeto para retirar o restablecer una conversión sin conexión mediante la operación ApplyOfflineConversionAdjustments .

Puede ajustar el tiempo de conversión y el valor de las conversiones sin conexión aplicadas anteriormente mediante la operación ApplyOfflineConversions .

Sintaxis

<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>

Elementos

El objeto OfflineConversionAdjustment tiene los siguientes elementos: AdjustmentCurrencyCode, AdjustmentTime, AdjustmentType, AdjustmentValue, ConversionName, ConversionTime, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Elemento Descripción Tipo de datos
AdjustmentCurrencyCode Código de moneda de la conversión sin conexión restada.

Para obtener más información, vea Monedas.

Aplicar: Obligatorio si AdjustmentType está establecido en "Restate" y, de lo contrario, se omite este campo. Si no especifica un código de moneda de ajuste con la nueva afirmación, se usa el elemento CurrencyCode del objetivo ConversionGoalRevenue .		 string
AdjustmentTime Fecha y hora en que se produjo el ajuste.

La hora de ajuste no puede ser anterior a la fecha y hora de conversión sin conexión originales.

Importante: El valor debe estar en hora universal coordinada (UTC). Esto difiere de las opciones de zona horaria cuando se cargan conversiones sin conexión en la aplicación web de Microsoft Advertising. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Aplicar: Obligatorio		 dateTime
AdjustmentType Determina si se retrae o se vuelve a establecer la conversión sin conexión.

Si este valor es "Restate", la conversión sin conexión que se atribuyó anteriormente al MicrosoftClickId especificado se ajustará según los nuevos AdjustmentCurrencyCode, AdjustmentTime y AdjustmentValue.

Si este valor es "Retract", la conversión sin conexión que se atribuyó anteriormente al MicrosoftClickId especificado se retirará o eliminará.

Aplicar: Obligatorio		 string
AdjustmentValue Valor de conversión sin conexión ajustado.

Aplicar: Obligatorio si AdjustmentType está establecido en "Restate" y, de lo contrario, este campo no debe establecerse.		 doble
ConversionName Nombre del objetivo de conversión.

Este nombre debe coincidir con un nombre de objetivo de conversión existente; de lo contrario, no se aplicarán los datos del objetivo de conversión sin conexión.

Aplicar: Obligatorio		 string
ConversionTime Fecha y hora en que se produjo la conversión sin conexión original.

La fecha y hora deben estar dentro de los últimos 90 días; de lo contrario, se producirá un error en la operación cuando intente enviar a Microsoft Advertising los datos de conversión sin conexión.

Para que Microsoft Advertising cuente como una conversión sin conexión después de una carga correcta, se deben cumplir los siguientes requisitos adicionales:
- La fecha y hora de la conversión debe establecerse más tarde de la fecha y hora del clic registrado.
- La fecha y hora deben estar dentro de la ventana de conversión. La propiedad ConversionWindowInMinutes de OfflineConversionGoal determina la longitud máxima de tiempo en minutos después de un clic en el que se realizará el seguimiento de las conversiones.

Por ejemplo, si el 30 de abril se registraron tres clics, si La conversiónWindowInMinutes de OfflineConversionGoal es igual a 30 días (43200 minutos) y si envía a Microsoft Advertising las siguientes conversiones sin conexión el 31 de julio, Microsoft Advertising solo contará el que tenga MicrosoftClickId=2 como conversión sin conexión.
- 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

Los datos de conversión sin conexión con MicrosoftClickId=1 no se cargarán desde la fecha y hora de conversión hace más de 90 días, y los datos de conversión sin conexión con MicrosoftClickId=3 no se contarán porque no se encuentran dentro de la ventana de conversión (del 30 de abril al 29 de mayo).

Importante: El valor debe estar en hora universal coordinada (UTC). Esto difiere de las opciones de zona horaria cuando se cargan conversiones sin conexión en la aplicación web de Microsoft Advertising. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Aplicar: Obligatorio		 dateTime
HashedEmailAddress Dirección de correo electrónico con hash mediante el algoritmo SHA-256 para su uso con conversiones mejoradas. string
HashedPhoneNumber Número de teléfono con hash según el estándar E.164 para su uso con conversiones mejoradas. string
MicrosoftClickId MSCLKID para la conversión sin conexión.

Para asegurarse de que el etiquetado automático está habilitado para el seguimiento de identificadores de clic de Microsoft, use las operaciones GetAccountProperties y SetAccountProperties .

Aplicar: Opcional

Nota: MSCLKID es opcional cuando se proporciona una dirección de correo electrónico con hash o un número de teléfono para conversiones mejoradas.		 string

Requisitos

Servicio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

ApplyOfflineConversionAdjustments