Guia do desenvolvedor de públicos de remarketing

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

Introdução

A API de gerenciamento permite realizar ações como create, get, 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 de público de remarketing permite realizar ações como get, 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:

  1. Use a API de gerenciamento 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 de público de remarketing.

Criar um novo público de remarketing

Para criar um novo público de remarketing para uma propriedade:

  1. Use a API de gerenciamento ou o Explorador da conta para recuperar o accountId e o webPropertyId.
  2. Use a API de gerenciamento ou o Explorador da conta para recuperar o ID da vista (perfil) da propriedade linkedViews [].
  3. Use o conjunto de links do Google AdWords para recuperar o ID de uma conta do Google AdWords para linkedAdAccounts.linkedAccountId.
    • Atualmente, a propriedade linkedAdAccounts[] está limitada a apenas um linkedForeignAccount.
    • É possível definir o linkedAdAccounts[].type como ADWORDS_LINKS.
  4. Use o conjunto Segments para ver opções de como definir a propriedade segment do includudeConditions. Se você estiver criando um público com base em estado, faça a mesma operação para o excludeConditions. Consulte também a referência de segmentos para definir um segmento.
    • Se você preferir, 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ê precisa definir uma statebasedDefinition. Consulte 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:

  1. Se você já tiver o ID do público de remarketing, poderá chamar get. Caso contrário, é possível chamar list e selecionar o público que você deseja atualizar.
  2. Atualize um dos campos graváveis e chame update transmitindo o objeto atualizado do público.