AdGroupCriterion

Um critério de grupo de anúncios. O relatório adGroupcriterio retorna somente critérios que foram explicitamente adicionados ao grupo de anúncios.

Representação JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Campos
resourceName

string

Imutável. O nome do recurso do critério do grupo de anúncios. Os nomes dos recursos do critério do grupo de anúncios têm o seguinte formato:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Apenas saída. O nome de exibição do critério.

Este campo é ignorado para mutações.
status

enum (AdGroupCriterionStatus)

O status do critério.

Este é o status da entidade do critério do grupo de anúncios, definido pelo cliente. Observação: os relatórios da interface do usuário podem incorporar informações adicionais que afetam a qualificação de um critério para execução. Em alguns casos, um critério REMOVIDO na API ainda pode aparecer como ativado na IU. Por exemplo, as campanhas são exibidas por padrão para usuários de todas as faixas etárias, a menos que sejam excluídas. A interface vai mostrar cada faixa etária como "ativada", já que elas estão qualificadas para ver os anúncios. mas gclid.status mostrará "removido", já que nenhum critério positivo foi adicionado.
qualityInfo

object (QualityInfo)

Apenas saída. Informações sobre a qualidade do critério.
type

enum (CriterionType)

Apenas saída. Tipo do critério.
systemServingStatus

enum (CriterionSystemServingStatus)

Apenas saída. Status de veiculação do critério.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Apenas saída. Status de aprovação do critério.
disapprovalReasons[]

string

Apenas saída. Lista de motivos de reprovação do critério.

Veja os diferentes motivos para a reprovação de um critério aqui: https://support.google.com/adspolicy/answer/6008942

Este campo é somente leitura.
labels[]

string

Apenas saída. Os nomes dos recursos dos rótulos anexados a este critério do grupo de anúncios.
effectiveCpcBidSource

enum (BiddingSource)

Apenas saída. Origem do lance de CPC efetivo.
effectiveCpmBidSource

enum (BiddingSource)

Apenas saída. Origem do lance de CPM efetivo.
effectiveCpvBidSource

enum (BiddingSource)

Apenas saída. Origem do lance de CPV efetivo.
effectivePercentCpcBidSource

enum (BiddingSource)

Apenas saída. Origem do lance de CPC percentual efetivo.
positionEstimates

object (PositionEstimates)

Apenas saída. Estimativas para lances de critério em várias posições.
finalUrls[]

string

A lista dos possíveis URLs finais após todos os redirecionamentos de vários domínios do anúncio.
finalMobileUrls[]

string

A lista de possíveis URLs finais para dispositivos móveis após todos os redirecionamentos de vários domínios.
urlCustomParameters[]

object (CustomParameter)

A lista de mapeamentos usados para substituir tags de parâmetros personalizados em um trackingUrlTemplate, um finalUrls ou um mobile_final_urls.
criterionId

string (int64 format)

Apenas saída. ID do critério.

Este campo é ignorado para mutações.
adGroup

string

Imutável. O grupo de anúncios ao qual o critério pertence.
negative

boolean

Imutável. Define se o critério será segmentado (false) ou excluído (true).

Este campo não pode ser modificado. Para mudar um critério de positivo para negativo, remova-o e adicione-o novamente.
bidModifier

number

O modificador do lance quando o critério corresponde. O modificador precisa estar no intervalo: 0,1 a 10,0. A maioria dos tipos de critérios segmentáveis são compatíveis com modificadores.
cpcBidMicros

string (int64 format)

Lance de CPC (custo por clique).
cpmBidMicros

string (int64 format)

O lance de CPM (custo por mil impressões visíveis).
cpvBidMicros

string (int64 format)

É o lance de CPV (custo por visualização).
percentCpcBidMicros

string (int64 format)

O valor do lance de CPC expresso como uma fração do preço anunciado de um produto ou serviço. O intervalo válido para a fração é [0,1) e o valor armazenado aqui é 1.000.000 * [fração].
effectiveCpcBidMicros

string (int64 format)

Apenas saída. O lance de CPC (custo por clique) efetivo.
effectiveCpmBidMicros

string (int64 format)

Apenas saída. É o lance de CPM (custo por mil impressões visíveis) efetivo.
effectiveCpvBidMicros

string (int64 format)

Apenas saída. O lance de CPV (custo por visualização) efetivo.
effectivePercentCpcBidMicros

string (int64 format)

Apenas saída. O valor efetivo do lance de CPC percentual.
finalUrlSuffix

string

Modelo de URL para anexar parâmetros ao URL final.
trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento.

Campo de união criterion. O critério do grupo de anúncios.

Exatamente um deve ser definido. criterion pode ser apenas de um dos tipos a seguir:
keyword

object (KeywordInfo)

Imutável. Palavra-chave.
placement

object (PlacementInfo)

Imutável. Posição.
mobileAppCategory

object (MobileAppCategoryInfo)

Imutável. Categoria do app para dispositivos móveis.
mobileApplication

object (MobileApplicationInfo)

Imutável. Aplicativo para dispositivos móveis.
listingGroup

object (ListingGroupInfo)

Imutável. Grupo de fichas.
ageRange

object (AgeRangeInfo)

Imutável. Faixa etária.
gender

object (GenderInfo)

Imutável. Sexo.
incomeRange

object (IncomeRangeInfo)

Imutável. Faixa de renda.
parentalStatus

object (ParentalStatusInfo)

Imutável. Status parental.
userList

object (UserListInfo)

Imutável. Lista de usuários.
youtubeVideo

object (YouTubeVideoInfo)

Imutável. Vídeo do YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Imutável. Canal do YouTube
topic

object (TopicInfo)

Imutável. Tópico.
userInterest

object (UserInterestInfo)

Imutável. Interesse do usuário.
webpage

object (WebpageInfo)

Imutável. Página da Web
appPaymentModel

object (AppPaymentModelInfo)

Imutável. Modelo de pagamento de apps.
customAffinity

object (CustomAffinityInfo)

Imutável. Afinidade personalizada.
customIntent

object (CustomIntentInfo)

Imutável. Intenção personalizada.
customAudience

object (CustomAudienceInfo)

Imutável. Público-alvo personalizado.
combinedAudience

object (CombinedAudienceInfo)

Imutável. Público-alvo combinado.
audience

object (AudienceInfo)

Imutável. Público-alvo.
location

object (LocationInfo)

Imutável. Local.
language

object (LanguageInfo)

Imutável. e linguagem Hashicorp.

AdGroupCriterionStatus

Os status possíveis de um ficam.

Enums
UNSPECIFIED Nenhum valor foi especificado.
UNKNOWN

O valor recebido não é conhecido nesta versão.

Esse é um valor apenas de resposta.
ENABLED O critério do grupo de anúncios está ativado.
PAUSED O critério do grupo de anúncios foi pausado.
REMOVED O critério do grupo de anúncios foi removido.

QualityInfo

Um contêiner para as informações de qualidade do critério do grupo de anúncios.

Representação JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Campos
creativeQualityScore

enum (QualityScoreBucket)

Apenas saída. A performance do anúncio em comparação com outros anunciantes.
postClickQualityScore

enum (QualityScoreBucket)

Apenas saída. O Índice de qualidade da página de destino.
searchPredictedCtr

enum (QualityScoreBucket)

Apenas saída. A taxa de cliques em comparação com a de outros anunciantes.
qualityScore

integer

Apenas saída. Índice de qualidade.

Esse campo não será preenchido se o Google não tiver informações suficientes para determinar um valor.

CriterionSystemServingStatus

Enumera os status de exibição do sistema de critérios.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
ELIGIBLE Qualificado.
RARELY_SERVED Baixo volume de pesquisas.

AdGroupCriterionApprovalStatus

Enumera os status de aprovação de ficam.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
APPROVED Aprovado.
DISAPPROVED Reprovado.
PENDING_REVIEW Análise pendente.
UNDER_REVIEW Em revisão.

PositionEstimates

Estimativas para lances de critério em várias posições.

Representação JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Campos
firstPageCpcMicros

string (int64 format)

Apenas saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na primeira página dos resultados da pesquisa.
firstPositionCpcMicros

string (int64 format)

Apenas saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na primeira posição, na parte superior da primeira página de resultados de pesquisa.
topOfPageCpcMicros

string (int64 format)

Apenas saída. A estimativa do lance de CPC necessário para que o anúncio seja exibido na parte superior da primeira página dos resultados de pesquisa.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Apenas saída. Estimativa de quantos cliques por semana você pode obter alterando seu lance de palavra-chave para o valor em firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Apenas saída. Estimativa de como seu custo por semana pode ser alterado ao alterar seu lance de palavra-chave para o valor em firstPositionCpcMicros.

ListingGroupInfo

Um critério do grupo de fichas.

Representação JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Campos
type

enum (ListingGroupType)

Tipo do grupo de produtos anunciados.
caseValue

object (ListingDimensionInfo)

É o valor de dimensão com que esse grupo de fichas está refinando o principal. Indefinido para o grupo raiz.
parentAdGroupCriterion

string

Nome do recurso do critério do grupo de anúncios, que é a subdivisão principal do grupo de fichas. Nulo para o grupo raiz.
path

object (ListingDimensionPath)

O caminho das dimensões que definem este grupo de fichas.

ListingGroupType

O tipo do grupo de fichas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
SUBDIVISION Subdivisão de produtos com algumas dimensões de listagem. Esses nós não são usados para veiculação em entradas da listagem, mas servem apenas para definir a estrutura da árvore.
UNIT Unidade do grupo de produtos anunciados que define um lance.

ListingDimensionPath

O caminho das dimensões que definem um grupo de fichas.

Representação JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Campos
dimensions[]

object (ListingDimensionInfo)

O caminho completo das dimensões na hierarquia do grupo de fichas, da raiz (excluindo a raiz) até este grupo.

AppPaymentModelInfo

Um critério de modelo de pagamento de aplicativo.

Representação JSON 
{
  "type": enum (AppPaymentModelType)
}
Campos
type

enum (AppPaymentModelType)

Tipo de modelo de pagamento do app.

AppPaymentModelType

Enumeração que descreve possíveis modelos de pagamento do app.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
PAID Representa aplicativos pagos.

CustomIntentInfo

Um critério de intenção personalizada. Um critério desse tipo só pode ser segmentado.

Representação JSON 
{
  "customIntent": string
}
Campos
customIntent

string

O nome do recurso Custominterest.