Guia do desenvolvedor de públicos de remarketing

Este documento descreve como usar a API Management para gerenciar os públicos de remarketing do Google Analytics.

Observação :ao usar essa API, você precisa aderir à política de recursos de publicidade do Google Analytics, incluindo as regras relacionadas a categorias sensíveis.

Introdução

Com a API Management, você pode definir públicos-alvo de remarketing create, get, delete, list, update e patch em uma propriedade do Google Analytics. Para saber mais sobre como os públicos-alvo de remarketing funcionam, consulte o artigo Sobre os públicos-alvo de remarketing no Google Analytics da Central de Ajuda.

Casos de uso

O recurso de público-alvo de remarketing oferece suporte a get, delete, list, patch e update, mas os principais casos de uso são:

• listar públicos de remarketing;
• criar um novo público de remarketing;
• atualizar um público de remarketing existente.

Observação :os públicos-alvo de remarketing vão permanecer vazios, e as campanhas de remarketing não serão exibidas se você não ativar a tag para coletar os dados apropriados. Para começar, ative os Recursos de publicidade nas configurações da propriedade do Google Analytics.

Listar públicos de remarketing

Para listar todos os públicos de remarketing de uma propriedade, siga estas etapas:

1. Use a API Management ou o Explorador de contas para recuperar o accountId e o webPropertyId.
2. Execute o método list do recurso "Públicos-alvo de remarketing".

Consulte a referência da API para ver detalhes sobre o método list do recurso de público-alvo de remarketing.

Criar um novo público de remarketing

Para criar um novo público de remarketing para uma propriedade, siga estas etapas:

1. Use a API Management ou o Explorador da conta para recuperar o accountId e o webPropertyId.
2. Use a API Management ou o Explorador da conta para recuperar o ID da vista (perfil) da propriedade linkedViews [].
3. Use o conjunto Vinculações do Google Ads para recuperar o ID de uma conta do Google Ads para linkedAdAccounts.linkedAccountId.
   • No momento, a propriedade linkedAdAccounts[] está limitada a apenas um linkedForeignAccount.
   • O linkedAdAccounts[].type pode ser definido como ADWORDS_LINKS, DBM_LINKS, MCC_LINKS ou OPTIMIZE.
4. Use a coleção Segmentos para ver opções que definem a propriedade segment do includeConditions. Se você criar um público-alvo baseado em estado, faça o mesmo para excludeConditions. Consulte também a referência de segmentos para definir um segmento.
   • Opcionalmente, includeConditions pode ter valores para membershipDurationDays e daysToLookBack.
   • excludeConditions.exclusionDuration pode ser definido como PERMANENT.
5. Execute o método insert do recurso de público-alvo de remarketing.

A API permite que você crie dois tipos de público-alvo: SIMPLE e STATE_BASED. Para públicos-alvo SIMPLE, você só precisa criar o audienceDefinition com um segment positivo, sem um operador NOT (o caractere !). Se você quiser incluir uma condição de exclusão, defina um statebasedDefinition. Consulte Públicos-alvo com base no estado para saber mais. Consulte o exemplo de referência para ver mais detalhes.

Observação: você pode definir um audienceDefinition ou um stateBasedAudienceDefinition e configurar audienceType como o valor correspondente. Além disso, há um limite de 2.000 públicos de remarketing permitidos. Tenha cuidado ao automatizar a criação de públicos-alvo de remarketing.

Atualizar um público de remarketing existente

Para atualizar um público de remarketing existente de uma propriedade, siga estas etapas:

1. Se você já tem o ID do público-alvo de remarketing, chame get. Caso contrário, chame list e selecione o público-alvo que você quer atualizar.
2. Atualize um dos campos graváveis e chame update transmitindo o objeto atualizado do público-alvo.

Observação: depois que um público-alvo é criado, não é possível mudar o audienceType. Em outras palavras, se um público-alvo tiver um valor para audienceDefinition, não será possível chamar uma atualização com um valor para stateBasedAudienceDefinition. Consulte Públicos com base em estado para saber mais. Veja o exemplo de referência para mais detalhes.