Compartir a través de


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

Define una conversión sin conexión que se envía a Microsoft Advertising.

Para configurar el seguimiento de conversiones sin conexión, cree un offlineConversionGoal. Si establece CountType de OfflineConversionGoal en All, todas las conversiones sin conexión para el mismo MicrosoftClickId con diferentes tiempos de conversión se agregarán acumulativamente. Si estableces CountType de OfflineConversionGoal en Unique, solo se contará la primera conversión que se produce después de un clic en un anuncio. Se omitirán las conversiones sin conexión duplicadas con los mismos MicrosoftClickId y ConversionTime . En otras palabras, solo se contará la primera conversión sin conexión para un Determinado MicrosoftClickId y ConversionTime .

Importante

Una vez configurado OfflineConversionGoal , espere dos horas y envíe a Microsoft Advertising los datos offlineConversion a través de la operación ApplyOfflineConversions . Puede tardar hasta seis horas en ver los datos de conversión en los informes de Microsoft Advertising.

Nota:

Aunque puede cargar conversiones sin conexión en el espacio aislado para pruebas funcionales, los datos de conversión sin conexión no se atribuirán en los datos de informes de rendimiento del espacio aislado.

Sintaxis

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

Elementos

El objeto OfflineConversion tiene los siguientes elementos: ConversionCurrencyCode, ConversionName, ConversionTime, ConversionValue, ExternalAttributionCredit, ExternalAttributionModel, HashedEmailAddress, HashedPhoneNumber, MicrosoftClickId.

Elemento Descripción Tipo de datos
ConversionCurrencyCode Código de moneda para la conversión sin conexión.

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

Aplicar: Opcional. Si no especifica un código de moneda de conversión sin conexión, se usa el elemento CurrencyCode del objeto ConversionGoalRevenue del objetivo.
string
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.

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
ConversionValue Valor de conversión sin conexión.

Aplicar: Opcional. Si no especifica un valor de conversión sin conexión, se usa el elemento Value del objetivo ConversionGoalRevenue .
Doble
ExternalAttributionCredit Este campo solo se puede establecer para las acciones de conversiones que usan atribución externa. Representa la fracción de la conversión que se atribuye a cada clic. Su valor debe ser mayor que 0 y menor o igual que 1.

Se devolverá un error GoalNotEligibleForExternalAttribution si este campo se usa con una acción de conversión no atribuible externamente.

Aplicar: Opcional
Doble
ExternalAttributionModel Este campo solo se puede establecer para las acciones de conversiones que usan atribución externa. Especifica el nombre del modelo de atribución.

Se devolverá un error GoalNotEligibleForExternalAttribution si este campo se usa con una acción de conversión no atribuible externamente.

Aplicar: Opcional
string
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
Nombres: https://bingads.microsoft.com/CampaignManagement/v13

Usado por

ApplyOfflineConversions