Públicos de remarketing

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações do recurso

Modelo JSON para um publico de remarketing do Google Analytics.

{
  "kind": "analytics#remarketingAudience",
  "id": string,
  "accountId": string,
  "webPropertyId": string,
  "internalWebPropertyId": string,
  "created": datetime,
  "updated": datetime,
  "name": string,
  "description": string,
  "linkedAdAccounts": [
    {
      "kind": "analytics#linkedForeignAccount",
      "id": string,
      "accountId": string,
      "webPropertyId": string,
      "internalWebPropertyId": string,
      "remarketingAudienceId": string,
      "linkedAccountId": string,
      "type": string,
      "status": string,
      "eligibleForSearch": boolean
    }
  ],
  "linkedViews": [
    string
  ],
  "audienceType": string,
  "audienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    }
  },
  "stateBasedAudienceDefinition": {
    "includeConditions": {
      "kind": "analytics#includeConditions",
      "isSmartList": boolean,
      "segment": string,
      "membershipDurationDays": integer,
      "daysToLookBack": integer
    },
    "excludeConditions": {
      "segment": string,
      "exclusionDuration": string
    }
  }
}
Nome da propriedade Valor Descrição Observações
accountId string ID da conta à qual esse público de remarketing pertence.
audienceDefinition object A definição de público simples que fará com que o usuário seja adicionado a um público. gravável
audienceDefinition.includeConditions nested object Define as condições para incluir usuários ao público. gravável
audienceDefinition.includeConditions.daysToLookBack integer A janela de lookback permite especificar um período para avaliar o comportamento que qualifica os usuários para o seu público. Por exemplo, se seus filtros incluem usuários da Ásia Central e Transações superiores a 2, e você define a janela de lookback como 14 dias, todo usuário da Ásia Central com mais de 2 transações acumuladas durante os últimos 14 dias é adicionado ao público. gravável
audienceDefinition.includeConditions.isSmartList boolean Booleano que indica se esse segmento é uma lista inteligente. https://support.google.com/analytics/answer/4628577 gravável
audienceDefinition.includeConditions.kind string Tipo de recurso para incluir condições.
audienceDefinition.includeConditions.membershipDurationDays integer Número de dias (no intervalo de 1 a 540) que um usuário permanece no público. gravável
audienceDefinition.includeConditions.segment string A condição do segmento que fará com que o usuário seja adicionado a um público. gravável
audienceType string O tipo de público, SIMPLE ou STATE_BASED.

Os valores aceitáveis são:
  • SIMPLE
  • STATE_BASED
gravável
created datetime Horário em que esse público de remarketing foi criado.
description string A descrição desse público de remarketing.
id string ID do público de remarketing.
internalWebPropertyId string ID interno da propriedade da Web a que esse público de remarketing pertence.
kind string Tipo de conjunto.
linkedAdAccounts[] list As contas de publicidade vinculadas associadas a esse público de remarketing. Atualmente, um público de remarketing pode ter somente um linkedAdAccount. gravável
linkedAdAccounts[].accountId string ID da conta a que essa conta externa vinculada pertence.
linkedAdAccounts[].eligibleForSearch boolean Booleano que indica se as contas vinculadas se qualificam para pesquisa.
linkedAdAccounts[].id string ID do link da conta de publicidade da entidade.
linkedAdAccounts[].internalWebPropertyId string ID interno da propriedade da Web à qual essa conta externa vinculada pertence.
linkedAdAccounts[].kind string Tipo de recurso da conta externa vinculada.
linkedAdAccounts[].linkedAccountId string ID da conta externa. Por exemplo, um "linkedAccountId" do Google Ads tem o seguinte formato: XXX-XXX-XXXX. gravável
linkedAdAccounts[].remarketingAudienceId string ID do público de remarketing público a que essa conta externa vinculada pertence.
linkedAdAccounts[].status string O status dessa vinculação da conta externa.

Os valores aceitáveis são:
  • CLOSED
  • OPEN
linkedAdAccounts[].type string O tipo da conta externa. Por exemplo, "ADWORDS_LINKS", "DBM_LINKS", "MCC_LINKS" ou "OPTIMIZE". gravável
linkedAdAccounts[].webPropertyId string ID da propriedade da Web na forma UA-XXXXX-YY a que essa conta externa vinculada pertence.
linkedViews[] list As vistas (perfis) às quais esse público de remarketing está vinculado. gravável
name string O nome desse público de remarketing. gravável
stateBasedAudienceDefinition object A definição de público com base no estado que fará com que o usuário seja adicionado ou removido de um público. gravável
stateBasedAudienceDefinition.excludeConditions object Define as condições para excluir usuários do público. gravável
stateBasedAudienceDefinition.excludeConditions.exclusionDuration string Determina se a exclusão será TEMPORÁRIA or PERMANENTE.

Os valores aceitáveis são:
  • PERMANENT
  • TEMPORARY
gravável
stateBasedAudienceDefinition.excludeConditions.segment string A condição do segmento que fará com que o usuário seja removido de um público. gravável
stateBasedAudienceDefinition.includeConditions nested object Define as condições para incluir usuários ao público. gravável
stateBasedAudienceDefinition.includeConditions.daysToLookBack integer A janela de lookback permite especificar um período para avaliar o comportamento que qualifica os usuários para o seu público. Por exemplo, se seus filtros incluem usuários da Ásia Central e Transações superiores a 2, e você define a janela de lookback como 14 dias, todo usuário da Ásia Central com mais de 2 transações acumuladas durante os últimos 14 dias é adicionado ao público. gravável
stateBasedAudienceDefinition.includeConditions.isSmartList boolean Booleano que indica se esse segmento é uma lista inteligente. https://support.google.com/analytics/answer/4628577 gravável
stateBasedAudienceDefinition.includeConditions.kind string Tipo de recurso para incluir condições.
stateBasedAudienceDefinition.includeConditions.membershipDurationDays integer Número de dias (no intervalo de 1 a 540) que um usuário permanece no público. gravável
stateBasedAudienceDefinition.includeConditions.segment string A condição do segmento que fará com que o usuário seja adicionado a um público. gravável
updated datetime Horário em que esse público de remarketing foi modificado pela última vez.
webPropertyId string ID da propriedade da Web na forma UA-XXXXX-YY a que esse público de remarketing pertence.

Métodos

delete
Exclui um público de remarketing.
get
Obtém um público de remarketing ao qual o usuário tem acesso.
insert
Cria um novo público de remarketing.
list
Lista os públicos de remarketing aos quais o usuário tem acesso.
patch
Atualiza um público de remarketing existente. Esse método é compatível com a semântica de patch.
update
Atualiza um público de remarketing existente.