Compartir a través de

Registro de conversión sin conexión: masivo

  • Artículo

Define una conversión sin conexión que se puede cargar en un archivo masivo.

Puede agregar, reestado (actualización) o restract (eliminar) conversiones sin conexión.

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.

Debe crear OfflineConversionGoal a través de campaign management API para establecer la propiedad IsExternallyAttributed .

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.

En el siguiente ejemplo de CSV masivo se agregaría una nueva conversión sin conexión.

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

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar el objeto BulkOfflineConversion , en lugar de llamar a las operaciones del servicio directamente y escribir código personalizado para analizar cada campo en el archivo masivo.

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();

Para un registro de conversión sin conexión , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Código de moneda de ajuste

Código de moneda de la conversión sin conexión restada.

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

Agregar: No aplicable
Reiterar: Obligatorio. Si no especifica un código de moneda de ajuste con la nueva afirmación, se usa el elemento CurrencyCode del objetivo ConversionGoalRevenue .
Retractarse: No aplicable

Tiempo de ajuste

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.

Agregar: No aplicable
Reiterar: Obligatorio
Retractarse: Obligatorio

Tipo de ajuste

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 id. de clic de Microsoft especificado se ajustará de acuerdo con el nuevo código de moneda de ajuste, tiempo de ajuste y valor de ajuste.

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

Agregar: No aplicable
Reiterar: Obligatorio. Este campo debe establecerse en "Restate".
Retractarse: Obligatorio. Este campo debe establecerse en "Retract".

Valor de ajuste

Valor de conversión sin conexión ajustado.

Agregar: No aplicable
Reiterar: Obligatorio
Retractarse: No aplicable

Identificador de cliente

Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.

Agregar: Opcional
Reiterar: Opcional
Retractarse: Opcional

Código de moneda de conversión

Código de moneda para la conversión sin conexión.

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

Agregar: 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.
Reiterar: No aplicable
Retractarse: No aplicable

Nombre de conversión

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.

Agregar: Obligatorio
Reiterar: Obligatorio
Retractarse: Obligatorio

Tiempo de conversión

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.

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.

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 se deben establecer 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).

Agregar: Obligatorio
Reiterar: Obligatorio
Retractarse: Obligatorio

Valor de conversión

Valor de conversión sin conexión.

Agregar: Opcional. Si no especifica un valor de conversión sin conexión, se usa el elemento Value del objetivo ConversionGoalRevenue .
Reiterar: No aplicable
Retractarse: No aplicable

Crédito de atribución externa

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

Modelo de atribución externa

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

Dirección de correo electrónico con hash

Dirección de correo electrónico con hash mediante el algoritmo SHA-256 para su uso con conversiones mejoradas.

Agregar: Necesario para las conversiones mejoradas.
Reiterar: Necesario para las conversiones mejoradas.
Retractarse: Necesario para las conversiones mejoradas.

Número de teléfono con hash

Número de teléfono con hash según el estándar E.164 para su uso con conversiones mejoradas.

Agregar: Necesario para las conversiones mejoradas.
Reiterar: Necesario para las conversiones mejoradas.
Retractarse: Necesario para las conversiones mejoradas.

Id. de clic de Microsoft

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 el campo MSCLKID Auto Tagging Enabled (Etiquetado automático de MSCLKID habilitado ) del registro de cuenta .

Agregar: Solo se requiere si no se envía un correo electrónico con hash o un número de teléfono.
Reiterar: Solo se requiere si no se envía un correo electrónico con hash o un número de teléfono.
Retractarse: Solo se requiere si no se envía un correo electrónico con hash o un número de teléfono.