Objeto de Dados CombinedList - Gestão de Campanhas

Artigo
07/19/2024

Uma lista combinada é uma audiência criada a partir de uma combinação de várias audiências existentes.

Pode combinar audiências personalizadas, listas de clientes, audiências de produtos, audiências semelhantes e listas de remarketing. Não pode incluir outras listas combinadas ou audiências no mercado numa lista combinada.

Pode criar um máximo de 1000 listas combinadas por conta de anúncio e até 5000 por cliente. Cada lista pode incluir até 100 regras de combinação ou conjuntos de condições lógicas e cada CombinationRule pode conter até 100 IDs de audiência.

Sugestão

Para obter uma descrição geral e mais informações sobre audiências, veja o Guia técnico das APIs de Audiência .

Sintaxe

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

Elementos

O objeto CombinedList tem os seguintes elementos: CombinationRules.

Elemento	Descrição	Tipo de Dados
CombinationRules	Condições lógicas utilizadas para determinar quem adicionar à sua lista combinada. Cada lista pode incluir até 100 regras de combinação ou conjuntos de condições lógicas e cada CombinationRule pode conter até 100 IDs de audiência. Para obter detalhes, veja As Observações de CombinationRule. Adicionar: Necessário Atualização: Obrigatório. Se quiser manter qualquer uma das regras anteriores, tem de as definir explicitamente novamente durante a atualização.	Matriz CombinationRule

O objeto CombinedList tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da Audiência

O objeto CombinedList deriva do objeto Audiência e herda os seguintes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. As descrições abaixo são específicas da CombinedList e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Audiência .

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. O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações. Adicionar: Só de leitura Atualização: Só de leitura	long
CustomerShare	Este elemento não é suportado para audiências de lista combinadas. Adicionar: Não suportado Atualização: Não suportado	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. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	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 o objeto Audiência .	Matriz KeyValuePairOfstringstring
ID	O identificador do Microsoft Advertising da audiência. Adicionar: Só de leitura Atualização: Obrigatório e só de leitura	long
MembershipDuration	Este elemento não é suportado para audiências de lista combinadas. Adicionar: Não suportado Atualização: Não suportado	int
Nome	O nome da audiência. O nome pode conter um máximo de 128 carateres. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	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. Adicionar: Necessário Atualização: Só de leitura. Não pode alterar o ID principal.	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. Adicionar: Necessário Atualização: Opcional. Pode alterar o âmbito de Conta para Cliente, mas não pode alterar o âmbito de Cliente para Conta.	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. O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações. Esta propriedade será nula ou vazia durante um máximo de 24 horas enquanto a audiência estiver a ser criada, por exemplo, se adicionar ou atualizar a duração combinada de associação à lista, regra ou identificador de etiqueta. Esta propriedade será nula ou vazia se a etiqueta UET associada à lista combinada tiver o estado Não Verificado ou Inativo, uma vez que a lista combinada não pode receber as informações do cliente do site de que precisa para criar a lista. Adicionar: Só de leitura Atualização: Só de leitura	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. Adicionar: Só de leitura Atualização: Só de leitura	matriz de cadeia
Tipo	O tipo de audiência. Este valor é CombinedList quando obtém uma audiência de lista combinada. Para obter mais informações sobre os tipos de audiência, veja Comentários sobre Objetos de Dados de Audiência. Adicionar: Só de leitura Atualização: Só de leitura	AudienceType

Requisitos

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

Compartilhar via