Compartilhar via

Controlo de Eventos Universal

  • Artigo

O UET é uma poderosa ferramenta de Publicidade da Microsoft. Só precisa de criar uma única etiqueta UET e, em seguida, adicioná-la ao seu site uma vez. Esta etiqueta regista o que os clientes fazem no seu site e, em seguida, o Microsoft Advertising começa a recolher esses dados, permitindo-lhe controlar conversões (como compras ou oportunidades potenciais) ou audiências de destino através de listas de remarketing. O UET é um pré-requisito para o controlo de conversão e o remarketing na pesquisa paga.

Controlo Universal de

Existem alguns passos para configurar esta configuração. Terá de:

Para obter detalhes, veja estas secções de descrição geral da API abaixo:

APIs de Controlo de Eventos Universais

Antes de poder controlar conversões ou audiências de destino através de uma lista de remarketing, tem de criar uma etiqueta UET no Microsoft Advertising (aplicação Web ou API) e, em seguida, adicionar o código de controlo de etiquetas UET a todas as páginas do seu site. Esta secção descreve como pode configurar etiquetas UET com a API de Anúncios do Bing. Para obter informações sobre como configurar etiquetas UET com a aplicação Web Microsoft Advertising, consulte Como devo proceder para criar uma etiqueta UET? e FAQ: Controlo de Eventos Universal.

Nota

Para cada uma das operações descritas nesta secção, tem de especificar o identificador do cliente no elemento de cabeçalho CustomerId .

  1. Primeiro, deve chamar a operação GetUetTagsByIds para verificar se já foi criada uma etiqueta. Pode deixar o elemento TagIds nulo ou vazio para pedir todas as etiquetas UET disponíveis para o cliente.
  2. Pode utilizar uma etiqueta UET com todos os seus objetivos de conversão e listas de remarketing. Antes de criar várias etiquetas UET, veja Motivos para criar mais do que uma etiqueta UET. Se ainda não tiver uma etiqueta UET que possa ser utilizada ou se precisar de outra etiqueta UET, chame a operação de serviço AddUetTags para criar uma nova etiqueta UET. Se a chamada for efetuada com êxito, o script de controlo que deve adicionar ao seu site será incluído num UetTag correspondente na mensagem de resposta. Mais tarde, conforme necessário, pode atualizar o nome e a descrição de uma UetTag com a operação UpdateUetTags .

Depois de obter o script de controlo da operação AddUetTags ou GetUetTagsByIds , o passo seguinte é adicionar o código de controlo de etiquetas UET ao seu site. Recomendamos que o utilizador, ou o administrador do seu site, o adicione a todo o site nas secções de cabeça ou corpo. Se o seu site tiver uma página de esquema ao nível do site, esse é o melhor local para adicioná-lo porque o adiciona uma vez e está incluído em todas as páginas. Para obter mais informações, consulte Como devo proceder para adicionar a etiqueta UET ao meu site?

Dependendo do que pretende fazer, configure o controlo de conversão ou audiências.

APIs de Objetivo de Conversão

Uma das maiores propostas de valor do UET é que lhe permite instalar uma etiqueta no seu site para controlar vários tipos de conversões. Assim que o código de controlo de etiquetas UET for adicionado ao seu site, o Microsoft Advertising pode registar visitas a páginas e quaisquer eventos personalizados, como subscrever uma newsletter ou transferir um documento.

No entanto, nem todas as ações são criadas iguais. Provavelmente tem um subconjunto de ações que considera mais importantes para campanhas publicitárias bem-sucedidas. Estes podem incluir fazer compras, preencher um formulário de oportunidade potencial ou ver um vídeo. É aqui que os objetivos de conversão podem ajudar. Os objetivos de conversão permitem-lhe especificar as ações (registadas pelo UET) a contar como conversões. Para obter mais informações sobre a Conversão Goals, veja O que são objetivos de conversão e tipos de objetivos?.

APIs de Gestão de Campanhas de Objetivo de Conversão

Existem cinco tipos de objetivos de conversão. ConversionGoal é a classe base a partir da qual todos os objetivos são derivados.

As seguintes operações estão disponíveis para gerir objetivos de conversão.

APIs de Audiência

Melhore o seu retorno sobre o investimento ao otimizar as suas campanhas para audiências específicas, que são grupos de pessoas que têm algo em comum relacionado com a sua campanha.

Tipos de Audiência

O Microsoft Advertising suporta vários tipos de audiência.

Lista Combinada

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 regra de combinação pode conter até 100 IDs de audiência.

Com algumas restrições descritas abaixo, pode combinar audiências com estes operadores lógicos:

  • OU: Isto incluirá clientes que estão em qualquer uma destas listas de audiências.
  • E: Isto incluirá apenas os clientes que estão em cada uma destas listas de audiências.
  • NÃO: Isto excluirá os clientes que estão em qualquer uma destas listas de audiências.

A avaliação da expressão lógica determina quem será adicionado à lista combinada. Várias combinações são sempre combinadas com uma função E. Isto significa que um cliente tem de cumprir todos os critérios de cada combinação para aparecer nesta lista de audiências de combinação personalizada.

Uma lista combinada tem de incluir, pelo menos, uma audiência com os operadores OU ou E. Uma lista combinada não pode utilizar apenas o operador NOT. Nesse caso, deve utilizar antes exclusões de audiência.

As audiências personalizadas e as listas de clientes não podem ser combinadas com outros tipos de audiência.

Não é possível combinar audiências semelhantes através dos operadores AND ou NOT. As audiências semelhantes só podem ser utilizadas numa única condição OR. Por outras palavras, só pode haver um conjunto de audiências que contenha audiências semelhantes e esse conjunto tem de utilizar o operador OR.

São permitidas audiências duplicadas, embora não seja possível combinar o mesmo ID de audiência através do operador E e NÃO.

Audiências Personalizadas

Uma audiência personalizada é gerada através da utilização dos seus próprios dados de cliente para criar segmentos de utilizador mais avançados. Pode utilizar audiências personalizadas em conjunto com as suas listas de remarketing, normalmente através do seu fornecedor de gestão de dados (DMP). Quando o seu DMP se ligar à nossa funcionalidade de audiência personalizada, pode importar as suas audiências personalizadas para o Microsoft Advertising para remarketing de pesquisa. Pode utilizar audiências personalizadas separadamente do remarketing, sem necessidade de UET. Apenas os dados de audiência originais (os dados de cliente que recolheu a partir do seu próprio site ou aplicações, por exemplo) são permitidos para filtragem na rede de Publicidade da Microsoft. Para obter mais informações, consulte Acerca de audiências personalizadas.

Nota

Pode eliminar, mas não pode adicionar uma audiência personalizada com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiência personalizadas.

De relance:

  • Utiliza os seus dados. As audiências personalizadas permitem-lhe utilizar os dados de audiência que já tem.
  • Cria públicos mais ricos. Crie segmentos de audiência mais avançados com mais dados do cliente.
  • Funciona como remarketing. As audiências personalizadas podem ser associadas a campanhas e grupos de anúncios como destino e licitação, apenas licitação ou como exclusão.

Para começar a utilizar audiências personalizadas, o DMP tem de:

  • Integre as nossas APIs de audiência personalizadas na respetiva plataforma.
  • Aceite a nossa partilha de dados e a nossa política de privacidade.

Consoante o fornecedor, terão os seus próprios passos de ativação no software. Certifique-se de que contacta o DMP para obter detalhes sobre como ativar esta funcionalidade.

Depois de concluída a integração, as audiências personalizadas serão apresentadas na secção Audiências da Biblioteca Partilhada na aplicação Web Microsoft Advertising. Também pode transferir audiências personalizadas através das APIs de Gestão de Campanhas e em Massa, conforme descrito abaixo.

Lista de Clientes

Uma lista de clientes é um conjunto de informações de contacto do cliente que compilou para permitir a correspondência do cliente.

Nota

As listas de clientes estão disponíveis através da API em Massa, mas ainda não estão disponíveis através da API de Gestão de Campanhas.

Importante

Antes de poder carregar os dados da lista de clientes através da API em Massa, primeiro tem de criar uma audiência da lista de clientes e aceitar os termos e condições na IU do Microsoft Advertising. A lista inicial de clientes não precisa de conter dados do cliente, mas tem de selecionar ACEITO.

Ao selecionar "Aceito" o utilizador (1) concorda que pode divulgar legalmente os detalhes da audiência, que são dados pessoais, à Microsoft e (2) aceitar os Termos de Correspondência do Cliente, o Contrato de Publicidade da Microsoft e as políticas de Publicidade da Microsoft. A Microsoft utilizará os dados que carregar de acordo com os Termos de Correspondência do Cliente.

Cada lista pode incluir vários Email itens.

Pode adicionar ou atualizar um registo da Lista de Clientes sem registos de Itens da Lista de Clientes no mesmo ficheiro de carregamento em massa; no entanto, não pode carregar registos de Itens da Lista de Clientes sem o registo da Lista de Clientes principal que o acompanha.

Após 48 horas, verifique os campos Tamanho da Audiência, por exemplo, Tamanho da Pesquisa da Audiência para ver quantos destes clientes correspondemos na Rede Bing. Nessa altura, os seus anúncios podem começar a aparecer para esta nova audiência.

Audiências do In-Market

As audiências no mercado são listas organizadas de clientes que mostraram sinais de intenção de compra numa categoria específica, incluindo pesquisas e cliques no Bing e vistas de página nos serviços Microsoft. O Microsoft Advertising fornece a lista organizada de potenciais clientes, ao contrário do remarketing na pesquisa paga, onde o anunciante cria a lista. Pode direcionar e modificar propostas para estas audiências ao associar listas de audiências no mercado a grupos ou campanhas de anúncios, à semelhança do que faz com listas de remarketing. Para obter mais informações, consulte Audiências no mercado: Contacte as pessoas que estão prontas para comprar.

Nota

Não pode adicionar, atualizar ou eliminar uma audiência no mercado com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiências no mercado.

Nota

Esta funcionalidade está disponível na Austrália, Canadá, França, Alemanha, Reino Unido e Estados Unidos.

Audiências de Produtos

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

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

Para obter mais informações, veja Listas dinâmicas de remarketing: Remarketing para produtos.

Remarketing Listas

O remarketing na Pesquisa Paga permite-lhe melhorar o seu retorno sobre o investimento ao otimizar as suas campanhas para audiências específicas, que são as pessoas que visitaram o seu site anteriormente. Quando cria listas de remarketing, especifica que ações de utilizador no seu site as qualificam para fazerem parte das listas de remarketing.

Quando os utilizadores efetuam ações elegíveis, são adicionados às listas de remarketing dentro de minutos. Se o tamanho mínimo da lista de remarketing de 1000 (conjunto mínimo de cookies) for cumprido e tiver associado a lista de remarketing a uma campanha ou grupo de anúncios e definir um montante de licitação específico, o motor de entrega de anúncios começará a apresentar anúncios remarketed a esses utilizadores na Rede de Publicidade da Microsoft. Para obter mais informações sobre o Remarketing na Pesquisa Paga, consulte Contactar a sua audiência e FAQ: Remarketing.

Depois de configurar o Universal Event Tracking (UET), pode utilizar a API de Anúncios do Bing para criar listas de remarketing e associá-las a campanhas ou grupos de anúncios.

Listas de Remarketing Semelhante

O Microsoft Advertising irá gerar automaticamente audiências semelhantes para listas de remarketing se for um participante piloto. Não pode criar ou editar a audiência semelhante para uma lista de remarketing. Dito isto, pode adicionar e eliminar associações e exclusões de listas de remarketing semelhantes. Se eliminar a lista de remarketing de origem, a audiência semelhante também será eliminada. Se uma audiência semelhante estiver associada a uma campanha ou grupo de anúncios, não poderá eliminar a lista de remarketing de origem.

Nota

Tem de ter, pelo menos, uma lista de remarketing que tenha associações ativas com, pelo menos, 1000 utilizadores para o Microsoft Advertising gerar uma audiência semelhante.

Uma audiência semelhante precisa de ter, pelo menos, 300 utilizadores na rede de pesquisa ou na Rede de Audiências da Microsoft antes de poder ser associada a uma campanha ou grupo de anúncios ativo.

Uma audiência semelhante demora até 24 horas a criar e a segmentação não entrará em vigor até esse ponto.

APIs em Massa da Audiência

Com o Serviço em massa, pode utilizar os seguintes tipos de registo para transferir e carregar audiências:

Nota

Com audiências personalizadas, só é suportada a atualização do Nome e da Descrição. Pode eliminar, mas não pode adicionar uma audiência personalizada com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiência personalizadas.

Não pode adicionar, atualizar ou eliminar uma audiência no mercado com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiências no mercado.

O Microsoft Advertising irá gerar automaticamente audiências semelhantes para listas de remarketing se for um participante piloto. Não pode criar ou editar a audiência semelhante para uma lista de remarketing. Dito isto, pode adicionar e eliminar associações e exclusões de listas de remarketing semelhantes. Se eliminar a lista de remarketing de origem, a audiência semelhante também será eliminada. Se uma audiência semelhante estiver associada a uma campanha ou grupo de anúncios, não poderá eliminar a lista de remarketing de origem.

Com o Serviço em massa, pode utilizar os seguintes tipos de registo para transferir e carregar associações de audiência:

Nota

Os destinos de audiência não podem ser definidos ao nível da campanha e do grupo de anúncios. Se definir critérios de audiência ao nível da campanha, não pode definir critérios de audiência ao nível do grupo de anúncios bidíveis. As exclusões de audiência podem ser definidas ao nível da campanha e do grupo de anúncios. O Microsoft Advertising aplica uma união de exclusões ao nível da campanha e do grupo de anúncios.

Por predefinição, os anúncios numa campanha e grupo de anúncios podem mostrar a todos, mas o ajuste da oferta será aplicado às pessoas incluídas na audiência. Se apenas quiser que os anúncios sejam apresentados a pessoas incluídas na audiência, deverá definir a definição de destino "destino e licitação". Pode utilizar o campo Definição de Destino no registo Campanha ou Grupo de Anúncios para determinar a definição de destino aplicável a todas as audiências (ou seja, listas combinadas, audiências personalizadas, audiências no mercado, audiências de produtos, listas de remarketing e audiências semelhantes para listas de remarketing) que estão associadas à campanha ou ao grupo de anúncios. Cada audiência pode ser associada a várias campanhas e grupos de anúncios e cada definição de destino é aplicada de forma independente para entrega.

APIs de Gestão de Campanhas de Audiência

Os objetos CombinedList, CustomAudience, InMarketAudience, ProductAudience, RemarketingList e SimilarRemarketingList derivam da classe base Audience . Se estiver a utilizar o serviço Gestão de Campanhas, pode adicionar, obter, atualizar ou eliminar a audiência com as respetivas operações AddAudiences, GetAudiencesByIds, UpdateAudiences e DeleteAudiences .

Nota

Com audiências personalizadas, só é suportada a atualização do Nome e da Descrição. Pode eliminar, mas não pode adicionar uma audiência personalizada com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiência personalizadas.

Não pode adicionar, atualizar ou eliminar uma audiência no mercado com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiências no mercado.

Para adicionar, obter, atualizar ou eliminar a associação entre a sua audiência e campanha, utilize o objeto BiddableCampaignCriterion com as respetivas operações AddCampaignCriterions, GetCampaignCriterionsByIds, UpdateCampaignCriterions e DeleteCampaignCriterions . Pode utilizar o objeto NegativeCampaignCriterion com as mesmas operações para definir exclusões de audiência.

Para adicionar, obter, atualizar ou eliminar a associação entre a audiência e o grupo de anúncios, utilize o objeto BiddableAdGroupCriterion com as respetivas operações AddAdGroupCriterions, GetAdGroupCriterionsByIds, UpdateAdGroupCriterions e DeleteAdGroupCriterions . Pode utilizar o objeto NegativeAdGroupCriterion com as mesmas operações para definir exclusões de audiência.

Nota

Os destinos de audiência não podem ser definidos ao nível da campanha e do grupo de anúncios. Se definir critérios de audiência ao nível da campanha, não pode definir critérios de audiência ao nível do grupo de anúncios bidíveis. As exclusões de audiência podem ser definidas ao nível da campanha e do grupo de anúncios. O Microsoft Advertising aplica uma união de exclusões ao nível da campanha e do grupo de anúncios.

Por predefinição, os anúncios numa campanha e grupo de anúncios podem mostrar a todos, mas o ajuste da oferta será aplicado às pessoas incluídas na audiência. Se apenas quiser que os anúncios sejam apresentados a pessoas incluídas na audiência, deverá definir a definição de destino "destino e licitação". Pode utilizar o elemento Definições do objeto Campanha ou AdGroup para determinar a definição de destino aplicável a todas as audiências (ou seja, listas combinadas, audiências personalizadas, audiências no mercado, audiências de produtos, listas de remarketing e audiências semelhantes para listas de remarketing) que estão associadas à campanha ou ao grupo de anúncios. Cada audiência pode ser associada a várias campanhas e grupos de anúncios e cada definição de destino é aplicada de forma independente para entrega.

Partilhar Audiências e Etiquetas UET

Depois de ativado para a hierarquia do cliente e as etiquetas UET partilhadas e funcionalidades de audiências, pode partilhar etiquetas UET e listas de remarketing com outros clientes.

As etiquetas e audiências UET partilhadas só podem ser geridas através da API de Gestão de Campanhas. Embora possa adicionar, obter, atualizar e eliminar audiências com a API em Massa, não pode utilizar a API em Massa para gerir quaisquer aspetos da partilha de audiências numa hierarquia de clientes.

Seguem-se algumas regras para associações de audiência que dependem de uma Etiqueta UET.

  • Apenas as etiquetas UET e as listas de remarketing podem ser partilhadas, mas as audiências dos produtos também podem utilizar uma etiqueta UET partilhada. Os objetivos de conversão que dependem do UET também podem utilizar uma etiqueta UET partilhada. As listas de clientes podem ser partilhadas, mas não tem de associá-las a uma etiqueta UET.
  • Uma Etiqueta UET só pode ser partilhada ao nível do cliente, também conhecida como nível de conta de gestor. Não pode partilhar uma Etiqueta UET com uma conta de anunciante específica.
  • Pode atualizar o âmbito da conta para o cliente, mas assim que definir um âmbito ao nível do cliente, não pode restringir o âmbito de audiência a contas individuais. Por exemplo, na aplicação Web Microsoft Advertising se escolher "Partilhado com contas de gestor e contas de anunciantes selecionadas", a opção "Apenas utilizado pela Conta do Ad Foo (Barra)" deixará de estar disponível.
  • Pode partilhar etiquetas e audiências UET com um subconjunto da hierarquia. Por exemplo, digamos que tem uma hierarquia de cima para baixo, desde a Conta de Gestor L1 até à Conta de Gestor L2 até à Conta de Gestor L3. Pode optar por partilhar a etiqueta UET e a audiência pertencentes apenas à Conta de Gestor L1 com a Conta de Gestor L3 e não é obrigado a partilhar com a Conta de Gestor intermediário L2. Mais tarde, se a Conta de Gestor L4 for adicionada à hierarquia abaixo da Conta de Gestor L3, a etiqueta UET e a audiência não serão partilhadas automaticamente. Se esse for o seu objetivo, terá de partilhar explicitamente a etiqueta UET e a audiência com a Conta de Gestor L4.
  • Uma audiência só pode ser partilhada pelo mesmo conjunto de contas que já partilham a Etiqueta UET associada. Por exemplo, se as audiências utilizarem uma Etiqueta UET que só é partilhada pela Conta de Gestor L1, Conta de Gestor L2 e Conta de Gestor L3, não pode partilhar a audiência com a Conta de Gestor L4 ou com qualquer uma das contas do anunciante que contém.
  • Apenas um utilizador do Super Administração no cliente proprietário da audiência pode eliminá-lo.
  • Um utilizador do Super Administração no cliente que detém a audiência ou a etiqueta UET pode atualizar o âmbito de partilha da conta de cliente de uma audiência ou etiqueta UET. Os utilizadores super Administração em clientes principais da hierarquia também podem atualizar o âmbito. Por exemplo, se uma lista de remarketing for propriedade da Conta de Gestor L2, qualquer utilizador do Super Administração na Conta de Gestor L1 e na Conta de Gestor L2 pode atualizar o âmbito.
  • Outras propriedades de audiência ou etiqueta UET (para além do âmbito), como a descrição e o nome, só podem ser atualizadas por um utilizador de Super Administração no cliente que detém a audiência ou a etiqueta UET. Os utilizadores super Administração em clientes principais da hierarquia não podem atualizar estes detalhes. Por exemplo, se uma lista de remarketing for propriedade da Conta de Gestor L2, apenas o utilizador do Super Administração na Conta de Gestor L2 pode atualizar o nome e a descrição.
  • Quando a audiência ou a etiqueta UET não são partilhadas numa hierarquia, um utilizador Standard no cliente que possua a audiência ou etiqueta UET pode atualizar as propriedades da audiência ou da etiqueta UET (para além do âmbito), como a descrição e o nome. Enquanto a audiência ou a etiqueta UET são partilhadas, um utilizador Standard não pode atualizar estas propriedades.

Exemplos de Partilha de Clientes

Vejamos alguns objetos SOAP de exemplo devolvidos quando obtém etiquetas UET e listas de remarketing através de GetUetTagsByIds e GetAudiencesByIds. Vamos basear-nos no exemplo de hierarquia a partir do guia Hierarquia de Contas .

Digamos, por exemplo, que uma hierarquia de agência foi configurada em Conta de Gestor L1 (ID do cliente 111) com ligações de cliente de conta de cliente e anunciante:

  • Antes da configuração da hierarquia, tinham sido aprovisionadas quatro contas de gestor separadas. A Conta de Gestor L1 contém a Conta do Ad 1A e a Conta de Anúncio 1B. A Conta de Gestor L2 contém a Conta de Anúncios 2A e a Conta de Anúncio 2B. A Conta de Gestor L3 contém a Conta de Anúncios 3A e a Conta de Anúncio 3B. A Conta de Gestor L4 contém a Conta do Ad 4A e a Conta de Anúncio 4B.
  • A Conta de Gestor L1 (ID do cliente 111) liga à Conta de Gestor L2 (ID do cliente 222) com uma ligação Administrativa.
  • A Conta de Gestor L2 (ID do cliente 222) liga à Conta de Gestor L3 (ID do cliente 333) com uma ligação Standard.
  • A Conta de Gestor L3 (ID do cliente 333) liga à Conta de Anúncio 4A (ID da conta 444111) com uma ligação ao nível da conta. A Conta de Anúncio 4A (ID da conta 444111) está diretamente na Conta de Gestor L4 (ID do cliente 444), que não está incluída na hierarquia ao nível do cliente. Neste exemplo, pode aceder à Conta de Anúncio 4A (ID da conta 444111) através da Conta de Gestor L3 (ID do cliente 333), ou seja, ao chamar operações de serviço que exijam o identificador do cliente, tem de utilizar a Conta de Gestor L3 (ID do cliente 333) para aceder à conta 444111.

Tenha em atenção que, se um cliente não estiver ativado para audiências e etiquetas UET partilhadas ou se não for possível partilhar um tipo de audiência, por exemplo, SimilarRemarketingList, o objeto CustomerShare será nulo quando receber a etiqueta UET ou a audiência.

<CustomerShare i:nil="true"/>

Neste cenário de exemplo, todos os clientes na hierarquia estão ativados para audiências e etiquetas UET partilhadas. Digamos que a Conta de Gestor L1 (ID do cliente 111) acabou de criar uma etiqueta UET e uma lista de remarketing (que depende da mesma etiqueta UET) e ainda não as partilha com clientes na hierarquia. Quando os objetos UetTag e RemarketingList são obtidos, apenas o OwnerCustomerId será definido no objeto CustomerShare , ou seja, o cliente onde foi criada a etiqueta UET ou a lista de remarketing.

<CustomerShare>
    <CustomerAccountShares/>
    <OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>

Em seguida, digamos que a Conta de Gestor L1 (ID do cliente 111) partilha apenas a etiqueta UET com a Conta de Gestor L2 (ID do cliente 222) e a Conta de Gestor L3 (ID do cliente 333). A lista de remarketing utiliza a etiqueta UET partilhada, mas ainda não é partilhada.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d79e5bc6-2b90-440b-9fd0-4b2b39d6f79e</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetUetTagsByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <UetTags xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <UetTag>
               <CustomerShare>
                    <CustomerAccountShares>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>333</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>222</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations>
                                <CustomerAccountShareAssociation>
                                    <AssociationCount>1</AssociationCount>
                                    <UsageType>UETTagAssociateToRemarketingList</UsageType>
                                </CustomerAccountShareAssociation>
                            </Associations>
                            <CustomerId>111</CustomerId>
                        </CustomerAccountShare>
                    </CustomerAccountShares>
                    <OwnerCustomerId>111</OwnerCustomerId>
                </CustomerShare>
               <!--Removed some elements for brevity-->
            </UetTag>
         </UetTags>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetUetTagsByIdsResponse>
   </s:Body>
</s:Envelope>

Por fim, digamos que a Conta de Gestor L1 (ID do cliente 111) partilha a lista de remarketing com a Conta de Gestor L3 (ID do cliente 333) e a Conta de Anúncio 2A (ID da conta 222111). Conforme mencionado na introdução do cenário acima, a Conta de Anúncio 2A (ID da conta 222111) está diretamente em Conta de Gestor L2 (ID do cliente 222). Neste exemplo, vamos também assumir que a lista de remarketing está associada a um grupo de anúncios na Conta Ad 2A (ID da conta 222111).

  • Para cada subconjunto de conta de cliente ou anunciante que partilha a lista de remarketing, um objeto CustomerAccountShare é incluído no CustomerShare da etiqueta UET.
  • O elemento Associações é nulo quando os clientes podem aceder à lista de remarketing, mas ainda não o utilizaram, por exemplo, Conta do Ad 2A (ID da conta 222111).
  • Uma vez que a Conta de Gestor L3 (ID de cliente 333) associou a lista de remarketing a um grupo de anúncios, o elemento Associações inclui um objeto CustomerAccountShareAssociation com UsageType definido como RemarketingListAssociateToAdGroup.
  • Um objeto CustomerAccountShare também está incluído para o proprietário.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d0751178-2049-4afa-8171-435c55effdf3</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetAudiencesByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <Audience i:type="RemarketingList">
               <!--Removed some elements for brevity-->
               <CustomerShare>
                  <CustomerAccountShares>
                     <CustomerAccountShare>
                        <AccountId>222111</AccountId>
                        <Associations/>
                        <CustomerId i:nil="true"/>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations>
                           <CustomerAccountShareAssociation>
                              <AssociationCount>1</AssociationCount>
                              <UsageType>RemarketingListAssociateToAdGroup</UsageType>
                           </CustomerAccountShareAssociation>
                        </Associations>
                        <CustomerId>333</CustomerId>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations/>
                        <CustomerId>111</CustomerId>
                     </CustomerAccountShare>
                  </CustomerAccountShares>
                  <OwnerCustomerId>111</OwnerCustomerId>
               </CustomerShare>
               <!--Removed some elements for brevity-->
            </Audience>
         </Audiences>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetAudiencesByIdsResponse>
   </s:Body>
</s:Envelope>

See Also

Endereços do Serviço Web da API de Anúncios do Bing
FAQ: Controlo de Eventos Universal
FAQ: Remarketing