Objeto de Dados ProductAudience - Gestão de Campanhas

Artigo
07/19/2024

Define uma audiência de produto que pode utilizar para remarketing produtos da sua loja Microsoft Merchant Center.

Nota

As listas dinâmicas de remarketing eram anteriormente conhecidas como audiências de produtos no Microsoft Advertising. Verá "Lista de remarketing dinâmico" na IU do Microsoft Advertising, mas para evitar alterações interruptivas, os objetos da API continuam a ter o nome "público do produto".

As listas de remarketing dinâmica emparelham os clientes com produtos específicos com base no que analisaram, consideraram ou já compraram no seu site. Pode utilizar listas de remarketing dinâmicas em campanhas de pesquisa e campanhas de audiência (nem todos têm ainda campanhas de audiência).

As listas de remarketing dinâmica funcionam melhor com campanhas de Compras e campanhas de Audiência baseadas em feeds, ou seja, as campanhas que tiram partido de um ID de loja do Microsoft Merchant Center.

Importante

Certifique-se de que edita o script correspondente ao ID da Etiqueta UET no seu site para incluir os ecomm_prodid parâmetros e ecomm_pagetype . O parâmetro ecomm_prodid é o ID de produto do produto na página. É exclusivo para cada item e tem de corresponder ao atributo ID ou item_group_id no feed de produto. Apenas carateres numéricos e alfanuméricos (incluindo hífenes), com um máximo de 50 carateres. O parâmetro ecomm_pagetype identifica o tipo de página que o utilizador visitou. Opções válidas: home page, searchresults, category, product, cart, purchase, other.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Sintaxe

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto ProductAudience tem os seguintes elementos: ProductAudienceType, TagId.

Elemento	Descrição	Tipo de Dados
ProductAudienceType	Determina se pretende remarketing os seus produtos para visitantes gerais, pesquisas de produtos, visualizadores de produtos, abandonos de carrinhos de compras ou compradores anteriores. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	ProductAudienceType
TagId	O identificador do Microsoft Advertising da etiqueta Deteção de Eventos Universais (UET) que é utilizada com a lista de remarketing. Antes de assumir uma dependência do ID da etiqueta, tenha em atenção que a etiqueta UET pode ser partilhada com ou a partir de outro cliente. As etiquetas e audiências UET partilhadas só estão disponíveis para clientes piloto. Para obter uma descrição geral da partilha de audiências e etiquetas UET numa hierarquia de clientes, consulte o guia técnico Partilhar Audiências e Etiquetas UET . Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	Longo

O objeto ProductAudience tem Elementos Herdados.

Elementos Herdados

Elementos Herdados da Audiência

O objeto ProductAudience 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 de ProductAudience 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	Longo
CustomerShare	Este elemento não é suportado para audiências de produtos. Pode utilizar um TagId partilhado com audiências de produtos, mas não é possível partilhar uma audiência de produto. 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	Longo
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. Adicionar: Opcional. Se não for especificado, a duração da associação será definida como 30 por predefinição. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.	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.	Longo
Â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 até 24 horas enquanto a audiência estiver a ser criada, por exemplo, se adicionar ou atualizar a duração da associação ou o identificador de etiqueta. Adicionar: Só de leitura Atualização: Só de leitura	Longo
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 é ProductAudience quando obtém uma audiência do produto. 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

Partilhar via