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