Compartir a través de

Objeto de datos de audiencia: administración de campañas

  • Artículo

Define el objeto base de una audiencia.

No intente crear una instancia de una audiencia. Puede crear uno o varios de los siguientes objetos que se derivan de él.

Nota:

Microsoft Advertising generará automáticamente audiencias similares para las listas de remarketing de los participantes piloto, es decir, GetCustomerPilotFeatures devuelve el identificador de característica 317.

Sintaxis

<xs:complexType name="Audience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceNetworkSize" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element xmlns:q124="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q124:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MembershipDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ParentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="SearchSize" nillable="true" type="xs:long" />
    <xs:element xmlns:q125="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q125:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Elementos

El objeto Audience tiene los siguientes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

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.

Consulte más detalles en la documentación de los objetos que heredan este elemento, por ejemplo, RemarketingList.		 largo
CustomerShare Determina la lista de clientes y cuentas que comparten la audiencia. Entre los detalles se incluyen los recuentos de asociaciones de audiencias.

Este elemento solo se admite con un objeto RemarketingList. Las audiencias de otros tipos no se pueden compartir en la jerarquía de clientes.		 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.		 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 este objeto.		 Matriz KeyValuePairOfstringstring
Identificación Identificador de Microsoft Advertising de la audiencia. 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 180 días.		 int
Nombre Nombre de la audiencia. El nombre puede contener un máximo de 128 caracteres. 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.		 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.		 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.

Consulte más detalles en la documentación de los objetos que heredan este elemento, por ejemplo, RemarketingList.		 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.		 matriz de cadenas
Tipo Tipo de audiencia. Para obtener más información sobre los tipos de audiencia, consulte los comentarios. AudienceType

Comentarios

En el caso de Java y los lenguajes .NET, no establezca el elemento Type porque el valor viene determinado por si crea una instancia de una audiencia personalizada u otro tipo de audiencia. Si genera soap manualmente, use el atributo type del nodo Audience , como se muestra en el ejemplo siguiente.

<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Audience i:type="CustomAudience">
    <Description i:nil="false">Custom Audience Description</Description>
    <ForwardCompatibilityMap xmlns:e43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
      <e43:KeyValuePairOfstringstring>
        <e43:key i:nil="false"></e43:key>
        <e43:value i:nil="false"></e43:value>
      </e43:KeyValuePairOfstringstring>
    </ForwardCompatibilityMap>
    <Id i:nil="true" />
    <MembershipDuration i:nil="false">30</MembershipDuration>
    <Name i:nil="false">Custom Audience Name</Name>
    <ParentId i:nil="false">ParentIdHere</ParentId>
    <Scope>Customer</Scope>
  </Audience>
</Audiences>

Requisitos

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

Usado por

AddAudiences
GetAudiencesByIds
UpdateAudiences