Registro de asociación de lista combinada de grupos de anuncios: masiva
Define una asociación de lista combinada de grupos de anuncios que se puede cargar y descargar en un archivo masivo.
Los objetivos de audiencia no se pueden establecer tanto a nivel de campaña como de grupo de anuncios. Si estableces los criterios de audiencia de nivel de campaña que se pueden pujar, no puedes establecer ningún criterio de audiencia de nivel de grupo de anuncios pujable. Las exclusiones de público se pueden establecer en el nivel de campaña y grupo de anuncios. Microsoft Advertising aplica una unión de exclusiones de nivel de campaña y grupo de anuncios.
Sugerencia
Para obtener información general y más información sobre las audiencias, consulte la Guía técnica de las API de audiencia .
Puede descargar todos los registros de asociación de lista combinada de grupos de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupCombinedListAssociations 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 una nueva asociación de lista combinada de grupos de anuncios si se proporciona un valor de Id. primario válido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Combined List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,CombinedListIdHere,My Combined List
Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAdGroupCombinedListAssociation , 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 BulkAdGroupCombinedListAssociation
var bulkAdGroupCombinedListAssociation = new BulkAdGroupCombinedListAssociation
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// 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 AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = combinedListIdKey,
},
// 'Bid Adjustment' column header in the Bulk file
CriterionBid = new BidMultiplier
{
Multiplier = 10
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Paused
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Audience' column header in the Bulk file
AudienceName = null,
};
uploadEntities.Add(bulkAdGroupCombinedListAssociation);
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 asociación de lista combinada de grupos de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Grupo de anuncios
- Público
- Identificador de audiencia
- Ajuste de la oferta
- Campaña
- Id. de cliente
- Id
- Tiempo de modificación
- Parent Id
- Estado
Grupo de anuncios
Nombre del grupo de anuncios asociado a la lista combinada.
Añadir: Solo lectura y Obligatorio
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio
Nota:
Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .
Público
Nombre de la lista combinada.
Este campo masivo se asigna al campo Audiencia del registro Lista combinada .
Añadir: Solo lectura y Obligatorio para algunos casos de uso. Debe especificar el campo Audiencia o Identificador de audiencia . Si va a agregar nuevas asociaciones de listas combinadas de grupos de anuncios con nuevas listas combinadas en el mismo archivo masivo y no establece el campo Identificador de audiencia , este campo Audiencia debe establecerse como clave lógica en el mismo valor que el campo Audiencia del registro Lista combinada . Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Eliminar: Solo lectura
Identificador de audiencia
Identificador de Microsoft Advertising de la lista combinada asociada al grupo de anuncios.
Este campo masivo se asigna al campo Id del registro De lista combinada .
Añadir: Solo lectura y Obligatorio para algunos casos de uso. Debe especificar el campo Audiencia o Identificador de audiencia . Si establece el campo Identificador de audiencia , debe especificar un identificador de lista combinado existente o especificar un identificador negativo que sea igual al campo Id del registro de lista combinada principal. Si no se establece el campo Identificador de audiencia , debe establecer el campo Audiencia como clave lógica en el mismo valor que el campo Audiencia del registro Lista combinada . Se recomienda cualquiera de estas opciones si va a agregar nuevas asociaciones de listas combinadas de grupos de anuncios con nuevas listas combinadas en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Eliminar: Solo lectura
Ajuste de la oferta
Porcentaje que desea aumentar o reducir el importe de la oferta de la lista combinada.
Los valores admitidos son noventa negativos (-90,00) a través de noventacientos positivos (900,00).
Importante
Si no se especifica, el valor predeterminado del ajuste de puja es 0. El valor predeterminado está sujeto a cambios.
Importante
Microsoft Advertising no aplicará ningún aumento de puja hasta que la lista combinada asociada tenga al menos 1000 usuarios. Si alguien califica para formar parte de varias listas combinadas y las listas combinadas están asociadas con el mismo grupo de anuncios con diferentes ajustes de puja, se aplicará el ajuste de puja más alto. Para obtener más información sobre Combinado en búsqueda de pago, consulte Llegar a su audiencia.
Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura
Campaña
Nombre de la campaña que contiene el grupo de anuncios.
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: Solo lectura
Id
Identificador generado por el sistema para la asociación entre un grupo de anuncios y una lista combinada.
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 generado por el sistema del grupo de anuncios asociado a la lista combinada.
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 asociar listas combinadas 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
Nota:
Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .
Estado
Estado de la asociación.
Los valores posibles son Active, Paused o Deleted.
Añadir: Opcional. El valor de estado predeterminado es Active.
Actualizar: Opcional
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.