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.

Introdução

A API de gerenciamento permite realizar ações como create, get, delete, list, update e patch relacionadas a públicos de remarketing de uma propriedade do Google Analytics. Para saber mais sobre o funcionamento do público de remarketing, consulte o artigo da Central de Ajuda Sobre públicos de remarketing no Google Analytics.

Casos de uso

O recurso "Público de remarketing" permite realizar ações como get, delete, list, patch e update, mas os principais casos de uso são:

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 da conta para recuperar o accountId e o webPropertyId.
  2. Execute o método list do recurso "Públicos de remarketing".

Consulte a referência da API para ver detalhes sobre o método list do recurso Público 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 de vinculações do Google Ads para recuperar o ID de uma conta do Google Ads para linkedAdAccounts.linkedAccountId.
    • Atualmente, 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 o conjunto Segments para ver opções de como definir a propriedade segment do includeConditions. Se você estiver criando um público com base em estado, faça o mesmo para o excludeConditions. Consulte também a referência de segmentos para definir um segmento.
    • Como alternativa, includeConditions pode ter valores para membershipDurationDays e daysToLookBack.
    • Se você preferir, excludeConditions.exclusionDuration pode ser definido como PERMANENT.
  5. Execute o método insert do recurso "Público de remarketing".

A API permite a criação de dois tipos de público: SIMPLE e STATE_BASED. Para os públicos do tipo SIMPLE, você só precisa criar o audienceDefinition com um segment positivo, sem um operador NOT (o caractere ! ). Se quiser incluir uma condição de exclusão, você precisará definir uma statebasedDefinition. Consulte o artigo Públicos com base em estado para saber mais. Consulte o exemplo de referência para ver mais detalhes.

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 de remarketing, pode chamar get. Caso contrário, é possível chamar list e selecionar o público que você quer atualizar.
  2. Atualize um dos campos graváveis e chame update transmitindo o objeto atualizado do público.