Compartir a través de


Objeto de datos CombinedList: Administración de campañas

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

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. Cada lista puede incluir hasta 100 reglas de combinación o conjuntos de condiciones lógicas, y cada CombinationRule puede contener hasta 100 identificadores de audiencia.

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 .

Sintaxis

<xs:complexType name="CombinedList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="CombinationRules" nillable="true" type="tns:ArrayOfCombinationRule" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto CombinedList tiene los siguientes elementos: CombinationRules.

Elemento Descripción Tipo de datos
CombinationRules Condiciones lógicas que se usan para determinar a quién agregar a la lista combinada.

Cada lista puede incluir hasta 100 reglas de combinación o conjuntos de condiciones lógicas, y cada CombinationRule puede contener hasta 100 identificadores de audiencia.

Para obtener más información, consulte los comentarios de CombinationRule.

Añadir: Obligatorio
Actualizar: Obligatorio. Si desea conservar cualquiera de las reglas anteriores, debe volver a establecerlas explícitamente durante la actualización.
Matriz CombinationRule

El objeto CombinedList tiene elementos heredados.

Elementos heredados

Elementos heredados del público

El objeto CombinedList deriva del objeto Audience y hereda los siguientes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Las descripciones siguientes son específicas de CombinedList y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto Audience .

Elemento Descripción Tipo de datos
AudienceNetworkSize 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
Largo
CustomerShare Este elemento no es compatible con las audiencias de lista combinadas.

Añadir: No compatible
Actualizar: No compatible
CustomerShare
Descripción Descripción de la audiencia. Use una descripción que le ayude a recordar el público al que se dirige.

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.
string
ForwardCompatibilityMap Lista de cadenas de clave y valor para la compatibilidad con reenvíos para evitar cambios importantes en caso contrario cuando se agregan nuevos elementos en la versión actual de la API.

Los cambios de compatibilidad de reenvío se anotarán aquí en futuras versiones. Actualmente no hay cambios de compatibilidad de reenvío para el objeto Audience .
Matriz KeyValuePairOfstringstring
Id Identificador de Microsoft Advertising de la audiencia.

Añadir: Solo lectura
Actualizar: Obligatorio y de solo lectura
Largo
MembershipDuration Este elemento no es compatible con las audiencias de lista combinadas.

Añadir: No compatible
Actualizar: No compatible
int
Nombre Nombre de la audiencia. 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.
string
ParentId Identificador de Microsoft Advertising 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: Obligatorio
Actualizar: Solo lectura. No se puede cambiar el identificador primario.
Largo
Ámbito El ámbito define qué cuentas pueden usar esta audiencia.

Si el ámbito está establecido en Cuenta, la audiencia solo se puede asociar a campañas y grupos de anuncios en una cuenta, es decir, a través del ParentId. Si el ámbito está establecido en Cliente, la audiencia se puede asociar a campañas y grupos de anuncios en todas las cuentas del cliente.

Añadir: Obligatorio
Actualizar: Opcional. Puede cambiar el ámbito de Cuenta a Cliente, pero no puede cambiar el ámbito de Cliente a Cuenta.
EntityScope
SearchSize 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á nula o 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 será nula o vacía si la etiqueta de UET asociada a la lista combinada tiene un estado de 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
Largo
SupportedCampaignTypes Lista de tipos de campaña que admiten esta audiencia.

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
matriz de cadenas
Tipo Tipo de audiencia. Este valor es CombinedList cuando se recupera una audiencia de lista combinada. Para obtener más información sobre los tipos de audiencia, consulte comentarios sobre los objetos de datos de audiencia.

Añadir: Solo lectura
Actualizar: Solo lectura
AudienceType

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13