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

Define un objeto de datos CustomerList.

Importante

Antes de crear datos de lista de clientes a través de Campaign Management API, primero debe crear una audiencia de lista de clientes y aceptar los términos y condiciones en la interfaz de usuario de Microsoft Advertising. La lista inicial de clientes no necesita contener datos de clientes, pero debe seleccionar Acepto. Al seleccionar "Acepto" usted (1) acepta que puede revelar legalmente los detalles de audiencia, que son datos personales, a Microsoft y (2) aceptar los Términos de coincidencia del cliente, el Contrato de Microsoft Advertising y las directivas de Microsoft Advertising. Microsoft usará los datos que cargue de acuerdo con los Términos de coincidencia del cliente.

Sintaxis

<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto CustomerList tiene elementos heredados.

Elementos heredados

Elementos heredados del público

El objeto CustomerList 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 CustomerList 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 Determina la lista de clientes y cuentas que comparten la audiencia. Entre los detalles se incluyen los recuentos de asociaciones de audiencias.

Las etiquetas y audiencias de UET compartidas solo están disponibles para los clientes piloto. Para obtener información general sobre cómo compartir audiencias y etiquetas de UET en una jerarquía de clientes, consulte la guía técnica Compartir audiencias y etiquetas de UET .

Agregar: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Establezca este elemento en null o vacío para conservar los recursos compartidos de cuenta de cliente existentes. Para quitar todos los recursos compartidos de cuentas de cliente, establezca el elemento CustomerAccountShares del objeto CustomerShare en null o vacío. Para quitar un subconjunto de recursos compartidos de cuentas de cliente, especifique los recursos compartidos de cuenta de cliente que desea conservar en el elemento CustomerAccountShares del objeto CustomerShare .
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 Al crear una audiencia, puede especificar la distancia en el tiempo que Microsoft Advertising debe buscar acciones que coincidan con la definición de audiencia.

La duración mínima es de 1 día y la duración máxima permitida es de 390 días. También puede establecer la duración en -1 para que no haya expiración.

Agregar: Opcional. Si no se especifica, la duración de la pertenencia se establecerá en 30 de forma predeterminada.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
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 48 horas mientras se compila la audiencia, por ejemplo, si agrega o actualiza la duración de la pertenencia a la lista de clientes.

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 CustomerList cuando se recupera una audiencia de lista de clientes. 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

Usado por

ApplyCustomerListItems