Compartir a través de

Registro de lista combinado: masivo

  • Artículo

Define una lista combinada que se puede descargar y cargar en un archivo masivo.

Una lista combinada es una audiencia creada a partir de una combinación de varias audiencias existentes.

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 lista combinada de la cuenta incluyendo el valor DownloadEntity de CombinedLists 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 lista combinada.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCombinedList , en lugar de llamar directamente a las operaciones del servicio 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 BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CombinedList object of the Campaign Management service.
    CombinedList = new CombinedList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Combined List",
        // 'Id' column header in the Bulk file
        Id = combinedListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Combined List " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Combination Rule' column header in the Bulk file
        CombinationRules = new[]
        {
            // Each rule is delimited by a semicolon (;) in the Bulk file
            new CombinationRule
            {
                AudienceIds = new [] { 123, 234 },
                Operator = LogicalOperator.And
            },
            new CombinationRule
            {
                AudienceIds = new [] { 345, 456 },
                Operator = LogicalOperator.And
            },
        },
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // '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(bulkCombinedList);

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

Público

Nombre de la lista combinada.

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

Añadir: Obligatorio
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: Solo lectura
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 durante un máximo de 24 horas mientras se compila la audiencia, por ejemplo, si agrega o actualiza la duración combinada de pertenencia a la lista, la regla o el identificador de etiqueta.

Esta propiedad estará vacía si la etiqueta de UET asociada a la lista combinada tiene el estado No comprobado o Inactivo, ya que la lista combinada no puede recibir la información del cliente de su sitio web que necesita para compilar la lista.

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

Regla de combinación

Una regla de combinación incluye las condiciones que se usan para determinar a quién agregar a la lista combinada.

Puede combinar audiencias personalizadas, listas de clientes, audiencias de productos, audiencias similares y listas de remarketing. No puede incluir otras listas combinadas o audiencias en el mercado en una lista combinada.

Puede crear un máximo de 1000 listas combinadas por cuenta de anuncio y hasta 5000 por cliente. La regla de combinación de cada lista puede incluir hasta 100 conjuntos de condiciones lógicas y cada conjunto puede contener hasta 100 identificadores de audiencia.

Con algunas restricciones que se describen a continuación, puede combinar audiencias mediante estos operadores lógicos:

  • O bien: esto incluirá a los clientes que se encuentren en cualquiera de estas listas de audiencias.
  • Y: Esto solo incluirá a los clientes que se encuentren en cada una de estas listas de audiencias.
  • NO: Esto excluirá a los clientes que se encuentren en cualquiera de estas listas de audiencias.

Un conjunto de condición lógica hace referencia a un grupo de identificadores de audiencia calificados por OR, AND o NOT. En bulk API, cada conjunto está delimitado por un yerba ('&').

Por ejemplo, aquí hay 10 conjuntos para una regla de combinación, cada uno con un identificador de audiencia: NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)

Este es un ejemplo de 10 conjuntos para una regla de combinación, cada uno con dos identificadores de audiencia: NOT(1,101)&AND(2,102)&OR(3,103)&NOT(4,104)&AND(5,105))&OR(6,106)&NOT(7,107)&AND(8,108)&OR(9,109)&NOT(10,110)

La evaluación de la expresión lógica determina quién se agregará a la lista combinada. Siempre se combinan varias combinaciones con una función AND. Esto significa que un cliente debe cumplir todos los criterios de cada combinación para poder aparecer en esta lista de audiencias de combinación personalizada. Por ejemplo, supongamos que la regla de combinación se establece en NOT(123.234)&NOT(345.456)&AND(567.678)&OR(789.890)&OR(987.876)). La lista combinada incluirá los clientes que a) están en la audiencia 567 y 678, y b) están en la audiencia 789 u 890, y c) están en la audiencia 987 o 876, a menos que d) el cliente esté en cualquiera de las audiencias 123, 234, 345 o 456.

Una lista combinada debe incluir al menos una audiencia con los operadores OR o AND. Una lista combinada no puede usar solo el operador NOT. En ese caso, debe usar exclusiones de audiencia en su lugar.

Las audiencias personalizadas y las listas de clientes no se pueden combinar con otros tipos de audiencia.

No se pueden combinar audiencias similares a través de los operadores AND o NOT. Las audiencias similares solo se pueden usar en una única condición OR. En otras palabras, solo puede haber un conjunto de audiencias que contenga audiencias similares y ese conjunto debe usar el operador OR.

Se permiten audiencias duplicadas, aunque el mismo identificador de audiencia no se puede combinar a través del operador AND y NOT.

Si va a crear una nueva audiencia junto con esta lista combinada en la misma carga masiva, la regla de combinación puede incluir un identificador negativo que sea igual al campo Id de la otra audiencia nueva. Por ejemplo, si va a crear una nueva lista de remarketing y también quiere incluirla en la lista combinada, puede establecer el valor id . de la lista de remarketing en -1. En la misma carga masiva puede consultar la nueva lista de remarketing mediante -1 en la regla de combinación, por ejemplo, NOT(123.234)&AND(345.456)&OR(-1.678). Para obtener más información, vea Claves de referencia de esquema de archivos masivos.

Si va a crear una nueva audiencia junto con esta lista combinada en la misma carga masiva, la regla de combinación puede incluir una clave de referencia negativa en el campo id . negativo de la otra nueva audiencia. También puede usar una clave de referencia lógica para el campo Audiencia (nombre) de la otra nueva audiencia.

  • Como ejemplo de uso de una clave de referencia negativa, en la misma carga masiva se incluye una nueva lista de remarketing donde su id . está establecido en -1. A continuación, consulte la nueva lista de remarketing con -1 en la regla de combinación, por ejemplo, NOT(123.234)&AND(345.456)&OR(-1.678).
  • Como ejemplo de uso de una clave de referencia lógica, en la misma carga masiva se incluye una nueva lista de remarketing donde su nombre de audiencia se establece en Mi nueva audiencia. A continuación, consulte la nueva lista de remarketing con "Mi audiencia" (entre comillas simples) en la regla de combinación, por ejemplo, NOT(123.234)&AND(345.456)&OR('My New Audience',678)).

Para obtener más información, vea Claves de referencia de esquema de archivos masivos.

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

Descripción

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

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

Añadir: Opcional
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 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 de la cuenta o cliente. Si el ámbito se establece en Cuenta, este es el identificador de cuenta y, de lo contrario, es el identificador de cliente.

Añadir: Opcional
Actualizar: Solo lectura. No se puede cambiar el identificador primario.
Eliminar: Solo lectura

Ámbito

El ámbito define qué cuentas pueden usar esta lista combinada. Si el ámbito está establecido en Cuenta, la lista combinada solo se puede asociar a campañas y grupos de anuncios dentro de una cuenta especificada (Id. primario). Si el ámbito está establecido en Cliente, la lista combinada se puede asociar a cualquier campaña y grupo de anuncios en todas las cuentas del cliente.

Añadir: Obligatorio
Actualizar: Solo lectura. No se puede cambiar el ámbito.
Eliminar: Solo lectura

Estado

Estado de la lista combinada.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
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 lista combinada.

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: Solo lectura
Actualizar: Solo lectura
Eliminar: Solo lectura