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;
- criar um novo público de remarketing;
- atualizar um público de remarketing existente.
Listar públicos de remarketing
Para listar todos os públicos de remarketing de uma propriedade, siga estas etapas:
- Use a API Management ou o Explorador da conta para recuperar o
accountId
e owebPropertyId
. - 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:
- Use a API Management ou o Explorador da conta para recuperar o
accountId
e owebPropertyId
. - Use a API Management ou o Explorador da conta para recuperar o ID da vista (perfil) da propriedade
linkedViews []
. - 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 umlinkedForeignAccount
. - O
linkedAdAccounts[].type
pode ser definido comoADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
ouOPTIMIZE
.
- Atualmente, a propriedade
- Use o conjunto Segments para ver opções de como definir a propriedade
segment
doincludeConditions
. Se você estiver criando um público com base em estado, faça o mesmo para oexcludeConditions
. Consulte também a referência de segmentos para definir um segmento.- Como alternativa,
includeConditions
pode ter valores paramembershipDurationDays
edaysToLookBack
. - Se você preferir,
excludeConditions.exclusionDuration
pode ser definido comoPERMANENT
.
- Como alternativa,
- 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:
- Se você já tem o ID do público de remarketing, pode chamar
get
. Caso contrário, é possível chamarlist
e selecionar o público que você quer atualizar. - Atualize um dos campos graváveis e chame
update
transmitindo o objeto atualizado do público.