Registro de criterio de radio de campaña: masivo

Define un criterio de radio de campaña que se puede cargar y descargar en un archivo masivo.

Con los criterios de radio, puede elegir mostrar anuncios a clientes potenciales en, buscar o ver páginas sobre un radio especificado alrededor de un código postal, coordenadas, punto de referencia o área.

Cada criterio de radio define un radio, una latitud y una longitud para el ajuste de puja del criterio correspondiente.

El número máximo de criterios de radio que puede especificar por campaña o grupo de anuncios es de 2000.

Nota:

Solo puedes tener un registro de criterio de intención de ubicación de campaña por campaña para determinar la opción de intención de ubicación que se aplica a todos los registros criterio de ubicación de la campaña y criterio de radio de campaña de la campaña. Al crear el primer criterio de la campaña, también se agregará automáticamente un registro criterio de intención de ubicación de campaña con el destino predeterminado establecido en PeopleInOrSearchingForOrViewingPages. Puedes agregar o actualizar el criterio de intención de ubicación de campaña de una campaña, independientemente de si la campaña tiene o no otros criterios. No puedes eliminar el criterio de intención de ubicación de campaña de una campaña, aunque no tiene ningún propósito sin criterios de ubicación o radio.

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

Tenga en cuenta también que debe tener en cuenta los criterios de ubicación, ubicación negativa y radio como un conjunto de criterios geográficos. Si el grupo de anuncios tiene algún criterio geográfico, no se hereda ninguno de los criterios geográficos de la campaña. Si el grupo de anuncios no tiene ningún criterio geográfico, se heredan todos los criterios geográficos de la campaña. Los criterios geográficos se pueden heredar de la campaña incluso si el grupo de anuncios tiene un criterio de intención de ubicación. Si se usan los criterios geográficos del grupo de anuncios, se usa el criterio de intención de ubicación del grupo de anuncios; Si se heredan los criterios geográficos de la campaña, se usa el criterio de intención de ubicación de la campaña y se omite el criterio de intención de ubicación del grupo de anuncios. No puedes eliminar el criterio de intención de ubicación de una campaña o grupo de anuncios, aunque no tiene ningún propósito sin criterios de ubicación o radio.

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 de Radio de campaña de la cuenta incluyendo el valor DownloadEntity de CampaignTargetCriterions 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ía un nuevo criterio de radio de campaña si se proporciona un valor de id. primario válido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCampaignRadiusCriterion , 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>();

// Map properties in the Bulk file to the BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
    // '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 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        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 = CampaignCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkCampaignRadiusCriterion);

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 de radio de campaña, los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Ajuste de la oferta
• Campaña
• Id. de cliente
• Id
• Latitude
• Longitude
• Tiempo de modificación
• Nombre
• Parent Id
• RADIUS
• Estado
• Unit

Ajuste de la oferta

Cantidad porcentual que desea ajustar la oferta para el criterio de radio correspondiente.

Los valores admitidos son noventa negativos (-90) a noventacientos (900) positivos.

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 en la que 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

Latitude

Latitud, en grados, del criterio de ubicación.

La latitud debe ser mayor o igual que -85,0 y menor o igual que +85,0.

Especifique la latitud y la longitud como valores decimales. Por ejemplo, la latitud y longitud de One Redmond Way, Redmond, WA es 47.755367 y -122.091827, respectivamente. Para obtener estos valores, puede escribir la dirección de una ubicación geográfica en Mapas de Bing y las coordenadas se mostrarán debajo de la dirección.

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

Longitude

Longitud, en grados, del criterio de ubicación.

La longitud debe ser mayor o igual que -180,0 y menor o igual que +180,0.

Especifique la latitud y la longitud como valores decimales. Por ejemplo, la latitud y longitud de One Redmond Way, Redmond, WA es 47.755367 y -122.091827, respectivamente. Para obtener estos valores, puede escribir la dirección de una ubicación geográfica en Mapas de Bing y las coordenadas se mostrarán debajo de la dirección.

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

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

Nombre

Nombre de la ubicación geográfica de destino.

El nombre puede contener un máximo de 50 caracteres.

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

Parent Id

Identificador de la campaña en la que se aplica o quita este criterio.

Este campo masivo se asigna al campo Id del registro Campaña .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de campaña existente o especificar un identificador negativo que sea igual al campo Id del registro de campaña primario. Esto se recomienda si va a agregar nuevos criterios a una nueva campaña 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

Radio

Radio que especifica el área que rodea la ubicación geográfica de destino.

Si el campo Unidad de radio se establece en Millas, se aceptan valores enteros positivos de 1 a 500.

Si el campo Unidad de radio se establece en Kilómetros, se aceptan valores enteros positivos de 1 a 800.

Nota:

El tipo de datos es doble y puede admitirse en una versión futura. Actualmente, el servicio solo acepta y devuelve valores enteros.

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

Estado

Representa el estado de asociación entre la campaña y el criterio. Si el criterio se aplica a la campaña, 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 ubicación específica, debe cargar el estado, el identificador y el identificador primario.

Unit

Unidad de medida para el radio especificado.

Los valores admitidos son Millas (valor predeterminado) y Kilómetros.

Añadir: Opcional. Si no se especifica, se establecerá el valor predeterminado de Miles .
Actualizar: Obligatorio
Eliminar: Solo lectura