Objeto de Dados de Audiência - Gestão de Campanhas

Artigo
12/21/2023

Define o objeto base de uma audiência.

Não tente instanciar uma Audiência. Pode criar um ou mais dos seguintes objetos que derivam do mesmo.

Nota

O Microsoft Advertising irá gerar automaticamente audiências semelhantes para listas de remarketing para os participantes piloto, ou seja, GetCustomerPilotFeatures devolve o identificador de funcionalidade 317.

Sintaxe

<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:q123="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q123: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:q124="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q124:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Elementos

O objeto Audiência tem os seguintes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

Elemento	Descrição	Tipo de Dados
AudienceNetworkSize	O número total de pessoas que são membros ativos desta audiência na rede audiência. Isto dá-lhe uma ideia do número de utilizadores de rede de Audiência que pode direcionar. Veja mais detalhes na documentação sobre os objetos que herdam este elemento, por exemplo, RemarketingList.	long
CustomerShare	Determina a lista de clientes e contas que partilham a audiência. Os detalhes incluem contagens de associação de audiências. Este elemento só é suportado com uma RemarketingList. As audiências de outros tipos não podem ser partilhadas na hierarquia do cliente.	CustomerShare
Descrição	A descrição da audiência. Utilize uma descrição para o ajudar a lembrar-se da audiência que está a direcionar. A descrição pode conter um máximo de 1024 carateres.	cadeia
ForwardCompatibilityMap	A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para este objeto.	Matriz KeyValuePairOfstringstring
ID	O identificador do Microsoft Advertising da audiência.	long
MembershipDuration	Quando cria uma audiência, pode especificar até que ponto o Microsoft Advertising deve procurar ações que correspondam à definição da sua audiência. A duração mínima é de 1 dia e a duração máxima permitida é de 180 dias.	int
Nome	O nome da audiência. O nome pode conter um máximo de 128 carateres.	cadeia
ParentId	O identificador do Microsoft Advertising da conta ou cliente. Se o Âmbito estiver definido como Conta, este é o ID da conta e, caso contrário, é o ID do cliente.	long
Âmbito	O âmbito define que contas podem utilizar esta audiência. Se o âmbito estiver definido como Conta, a audiência só pode ser associada a campanhas e grupos de anúncios numa conta, ou seja, através do ParentId. Se o âmbito estiver definido como Cliente, a audiência pode ser associada a campanhas e grupos de anúncios em todas as contas do cliente.	EntityScope
SearchSize	O número total de pessoas que são membros ativos desta audiência na rede de Pesquisa. Isto dá-lhe uma ideia do número de utilizadores de pesquisa que pode direcionar. Veja mais detalhes na documentação sobre os objetos que herdam este elemento, por exemplo, RemarketingList.	long
SupportedCampaignTypes	A lista de tipos de campanha que suportam esta audiência. Os valores suportados são Audience, DynamicSearchAds, Search e Shopping. Poderão ser adicionados novos tipos de campanha no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.	matriz de cadeia
Tipo	O tipo de audiência. Para obter mais informações sobre os tipos de audiência, consulte as Observações.	AudienceType

Observações

Para linguagens Java e .NET, não defina o elemento Tipo porque o valor é determinado se instancia uma audiência personalizada ou outro tipo de audiência. Se gerar o SOAP manualmente, utilize o atributo type do nó Audiência , conforme mostrado no exemplo seguinte.

<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

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Utilizado Por

AddAudiences
GetAudiencesByIds
UpdateAudiences

Partilhar via