Este documento descreve como usar a API Management para gerenciar os públicos de remarketing do Google Analytics.
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.
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 de contas para
recuperar o
accountId
e owebPropertyId
. - 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:
- 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 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 umlinkedForeignAccount
. - O
linkedAdAccounts[].type
pode ser definido comoADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
ouOPTIMIZE
.
- No momento, a propriedade
- Use a coleção Segmentos para ver opções que definem a propriedade
segment
doincludeConditions
. Se você criar um público-alvo baseado em estado, faça o mesmo paraexcludeConditions
. Consulte também a referência de segmentos para definir um segmento.- Opcionalmente,
includeConditions
pode ter valores paramembershipDurationDays
edaysToLookBack
. excludeConditions.exclusionDuration
pode ser definido comoPERMANENT
.
- Opcionalmente,
- 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.
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-alvo de remarketing, chame
get
. Caso contrário, chamelist
e selecione o público-alvo que você quer atualizar. - Atualize um dos campos graváveis e chame
update
transmitindo o objeto atualizado do público-alvo.