Compartir a través de

Registro de público personalizado: masivo

  • Artículo

Define una audiencia personalizada que se puede descargar y cargar en un archivo masivo.

Nota:

Solo se admite la actualización de los campos Audiencia (nombre de audiencia) y Descripción para la carga. Puede eliminar, pero no puede agregar una audiencia personalizada mediante bing ads API. Dicho esto, puede agregar y eliminar exclusiones y asociaciones de audiencia personalizadas.

Una audiencia personalizada es un tipo de lista de remarketing que se genera mediante el uso de sus propios datos de cliente para crear segmentos de usuario más completos. Puede usar audiencias personalizadas junto con las listas de remarketing, normalmente a través de su proveedor de administración de datos (DMP). Cuando el DMP se conecta a nuestra característica de audiencia personalizada, puede importar sus audiencias personalizadas en Microsoft Advertising para buscar el remarketing. Puede usar audiencias personalizadas por separado del remarketing, sin que sea necesario UET.

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 audiencia personalizada de la cuenta incluyendo el valor DownloadEntity de CustomAudiences 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.

El siguiente ejemplo de CSV masivo actualizaría la descripción de una audiencia personalizada. Nota: Para un público personalizado, la duración de la pertenencia no se establece en la aplicación web de Microsoft Advertising y Microsoft Advertising se aplaza a la configuración del proveedor de audiencia personalizado.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCustomAudience , 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 BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCustomAudience);

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

Público

Nombre de la audiencia personalizada.

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

Añadir: No compatible
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Tamaño de red de audiencia

El número total de personas que son miembros activos de esta audiencia en la red audience. Esto le da una idea del número de usuarios de red de audiencia a los que puede dirigirse.

La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones.

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

Tamaño de búsqueda de audiencia

El número total de personas que son miembros activos de esta audiencia en la red de búsqueda. Esto le da una idea del número de usuarios de búsqueda a los que puede dirigirse.

La audiencia debe tener al menos 300 personas antes de que Microsoft Advertising la use para las optimizaciones.

Esta propiedad estará vacía hasta 24 horas mientras se compila la audiencia, por ejemplo, si ha importado nuevas audiencias personalizadas desde DMP, la audiencia tarda 24 horas en crearse y, mientras tanto, esta propiedad estará vacía.

Añadir: No compatible
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: No compatible
Actualizar: Opcional
Eliminar: Solo lectura

Descripción

Descripción de la audiencia personalizada. Use una descripción para recordar a qué audiencia se dirige con esta audiencia personalizada.

La descripción puede contener un máximo de 1024 caracteres.

Añadir: No compatible
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Id

Identificador generado por el sistema de la audiencia personalizada.

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

Duración de la pertenencia

La duración de la pertenencia determina la distancia en el tiempo que Microsoft Advertising debe buscar acciones que coincidan con la definición de audiencia personalizada con el fin de agregar personas a la lista. Para un público personalizado, la duración de la pertenencia no se establece en la aplicación web de Microsoft Advertising y Microsoft Advertising se aplaza a la configuración del proveedor de audiencias personalizada.

Al solicitar la audiencia personalizada a través de bing Ads API, la duración de la pertenencia devuelta será nula.

Añadir: No compatible
Actualizar: No compatible
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: No compatible
Actualizar: Solo lectura
Eliminar: Solo lectura

Parent Id

Identificador de Microsoft Advertising del cliente que contiene la audiencia personalizada.

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

Ámbito

El ámbito define qué cuentas pueden usar esta audiencia personalizada. Para un público personalizado, el único ámbito admitido es Cliente y el público personalizado se puede asociar a cualquier campaña y grupo de anuncios en todas las cuentas del cliente.

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

Estado

Estado de audiencia personalizado.

Los valores posibles son Active o Deleted.

Añadir: No compatible
Actualizar: Solo lectura
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Tipos de campaña admitidos

Lista delimitada por punto y coma de los tipos de campaña que admiten esta audiencia personalizada.

Los valores admitidos son Audience, DynamicSearchAds, Search y Shopping. Es posible que en el futuro se agreguen nuevos tipos de campaña, por lo que no debe depender de un conjunto fijo de valores.

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