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 .

XML

<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>

JSON

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "CombinedList",
  "CombinationRules": [
    {
      "AudienceIds": [
        "LongValueHere"
      ],
      "Operator": "ValueHere"
    }
  ]
}

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. Agregar: 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. Agregar: Solo lectura Actualizar: Solo lectura	largo
CustomerShare	Este elemento no es compatible con las audiencias de lista combinadas. Agregar: 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. Agregar: 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
Identificación	Identificador de Microsoft Advertising de la audiencia. Agregar: Solo lectura Actualizar: Obligatorio y de solo lectura	largo
MembershipDuration	Este elemento no es compatible con las audiencias de lista combinadas. Agregar: No compatible Actualizar: No compatible	int
Nombre	Nombre de la audiencia. El nombre puede contener un máximo de 128 caracteres. Agregar: 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. Agregar: 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. Agregar: 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. Agregar: 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. Agregar: 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. Agregar: Solo lectura Actualizar: Solo lectura	AudienceType

Requisitos

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