Registro de criterio de DeviceOS de grupo de anuncios: masivo

Define un criterio de dispositivo de grupo de anuncios que se puede cargar y descargar en un archivo masivo.

Cuando te diriges por dispositivo, eliges mostrar anuncios a clientes potenciales cuando usen escritorios, tabletas o smartphones.

Cada criterio de dispositivo define un nombre de dispositivo para el ajuste de puja del criterio correspondiente.

El número máximo de criterios de dispositivo que puedes especificar por campaña o grupo de anuncios es tres. Debe tener tres criterios independientes para equipos, smartphones y tabletas; de lo contrario, no puede existir ningún criterio de dispositivo para la campaña o el grupo de anuncios.

Si se especifican los criterios de dispositivo de nivel de grupo de anuncios, se omiten los criterios de dispositivo de nivel de campaña para ese grupo de anuncios. En otras palabras, los criterios de dispositivo de grupo de anuncios invalidan los criterios del dispositivo de campaña y no se aplican como unión.

Sugerencia

Para obtener información general sobre cómo usar los criterios de destino, consulta Mostrar anuncios a tu audiencia de destino.

Puede descargar todos los registros de criterio deviceOS de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupTargetCriterions en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

En el siguiente ejemplo de CSV masivo se agregarían tres nuevos criterios de dispositivo de grupo de anuncios (uno para cada tipo de dispositivo) si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group DeviceOS Criterion,Active,,-1111,,,,ClientIdGoesHere,,Computers,20,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,,
Ad Group DeviceOS Criterion,,,-1111,,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

var bulkAdGroupDeviceCriterions = new [] {
    // Map properties in the Bulk file to the BulkAdGroupDeviceCriterion
    new BulkAdGroupDeviceCriterion
    {
        // 'Ad Group' column header in the Bulk file is read-only
        AdGroupName = null,
                    
        // 'Campaign' column header in the Bulk file is read-only
        CampaignName = null,

        // 'Client Id' column header in the Bulk file
        ClientId = "ClientIdGoesHere",

        // Map properties in the Bulk file to the 
        // BiddableAdGroupCriterion object of the Campaign Management service.

        BiddableAdGroupCriterion = new BiddableAdGroupCriterion
        {
            // 'Parent Id' column header in the Bulk file
            AdGroupId = adGroupIdKey,

            Criterion = new DeviceCriterion
            {
                // 'Target' column header in the Bulk file
                DeviceName = "Computers",
            },

            CriterionBid = new BidMultiplier
            {
                // 'Bid Adjustment' column header in the Bulk file
                Multiplier = 20,
            },

            // 'Id' column header in the Bulk file
            Id = null,

            // 'Status' column header in the Bulk file
            Status = AdGroupCriterionStatus.Active,
        }
    },
    new BulkAdGroupDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        BiddableAdGroupCriterion = new BiddableAdGroupCriterion
        {
            AdGroupId = adGroupIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Smartphones",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
    new BulkAdGroupDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        BiddableAdGroupCriterion = new BiddableAdGroupCriterion
        {
            AdGroupId = adGroupIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Tablets",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
};

foreach (var bulkAdGroupDeviceCriterion in bulkAdGroupDeviceCriterions)
{
    uploadEntities.Add(bulkAdGroupDeviceCriterion);
}

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 criterio deviceOS de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Grupo de anuncios
• Ajuste de la oferta
• Campaña
• Id. de cliente
• Id
• Tiempo de modificación
• Parent Id
• Estado
• Target

Grupo de anuncios

Nombre del grupo de anuncios donde se aplica o quita este criterio.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Ajuste de la oferta

Cantidad porcentual que desea ajustar la oferta para el objetivo correspondiente.

Los valores admitidos son -100 (cien negativos) a través del 900 (noventacientos) por ciento positivo. Si se establece el ajuste de puja en -100 %, se excluirá el objetivo correspondiente.

Añadir: Opcional. El ajuste de puja se establecerá en el valor predeterminado de 0 si no se incluye.
Actualizar: Obligatorio
Eliminar: Solo lectura

Campaña

Nombre de la campaña que contiene el grupo de anuncios donde se aplica o quita este criterio.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

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.

Añadir: Opcional
Actualizar: Opcional
Eliminar: Opcional

Id

Identificador único de Microsoft Advertising del criterio.

Añadir: Solo lectura
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Tiempo de modificación

Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).

Nota:

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Añadir: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura

Parent Id

Identificador del grupo de anuncios donde se aplica o quita este criterio.

Este campo masivo se asigna al campo Id del registro del grupo de anuncios .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a agregar nuevos criterios a un nuevo grupo de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Estado

Representa el estado de asociación entre el grupo de anuncios y el criterio. Si el criterio se aplica al grupo de anuncios, el valor de este campo es Activo. Para eliminar el criterio, establezca el estado en Eliminado.

Añadir: Solo lectura. El estado siempre se establecerá en Activo al agregar criterios. Si carga otro valor, por ejemplo, Foo , el archivo de resultados contendrá el mismo valor aunque el criterio esté activo.
Actualizar: Opcional
Eliminar: Obligatorio. El estado debe establecerse en Eliminado. Para eliminar una puja de criterio de dispositivo específica, debe cargar el estado, el identificador y el identificador primario.

Target

Nombre del dispositivo al que desea dirigirse con el ajuste de puja correspondiente.

Los valores admitidos son Equipos, Smartphones y Tabletas.

Añadir: Obligatorio. Se deben especificar tres pujas independientes para equipos, smartphones y tabletas en el archivo masivo (cada puja en un registro o fila independiente). Si no agrega criterios de dispositivo individuales que representen cada uno de los tres tipos de dispositivo, no se agregarán criterios de dispositivo para el grupo de anuncios.
Actualizar: Obligatorio
Eliminar: Solo lectura