AdGroupCriterion

Un criterio del grupo de anuncios. El informe adGroupCriterion solo muestra los criterios que se agregaron explícitamente al grupo de anuncios.

Representación 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

Inmutable. El nombre del recurso del criterio del grupo de anuncios. Los nombres de los recursos del criterio del grupo de anuncios tienen el siguiente formato:

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

string

Solo salida. El nombre visible del criterio.

Este campo se ignora para las mutaciones.
status

enum (AdGroupCriterionStatus)

El estado del criterio.

Este es el estado de la entidad de criterio del grupo de anuncios, configurada por el cliente. Nota: Es posible que los informes de la IU incorporen información adicional que afecte si un criterio es apto para ejecutarse. En algunos casos, un criterio que se quita en la API aún puede mostrarse como habilitado en la IU. Por ejemplo, las campañas predeterminadas se mostrarán a los usuarios de todos los rangos de edad, a menos que se excluyan. La IU mostrará cada rango de edad como "habilitado", ya que son aptos para ver los anuncios, pero AdGroupCriterion.status mostrará “quitado”, ya que no se agregó ningún criterio positivo.
qualityInfo

object (QualityInfo)

Solo salida. Información sobre la calidad del criterio.
type

enum (CriterionType)

Solo salida. El tipo del criterio.
systemServingStatus

enum (CriterionSystemServingStatus)

Solo salida. Es el estado de publicación del criterio.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Solo salida. Es el estado de aprobación del criterio.
disapprovalReasons[]

string

Solo salida. Lista de los motivos de rechazo de los criterios.

Aquí encontrará los diferentes motivos para rechazar un criterio: https://support.google.com/adspolicy/answer/6008942

Este campo es de solo lectura.
labels[]

string

Solo salida. Los nombres de recursos de las etiquetas adjuntas a este criterio de grupo de anuncios.
effectiveCpcBidSource

enum (BiddingSource)

Solo salida. Fuente de la oferta de CPC efectiva
effectiveCpmBidSource

enum (BiddingSource)

Solo salida. Fuente de la oferta de CPM efectivo
effectiveCpvBidSource

enum (BiddingSource)

Solo salida. Fuente de la oferta de CPV efectiva
effectivePercentCpcBidSource

enum (BiddingSource)

Solo salida. Fuente de la oferta de CPC porcentual efectiva
positionEstimates

object (PositionEstimates)

Solo salida. Son estimaciones para ofertas de criterio en varias posiciones.
finalUrls[]

string

La lista de posibles URLs finales después de todos los redireccionamientos entre dominios del anuncio.
finalMobileUrls[]

string

Es la lista de posibles URLs finales para dispositivos móviles después de todos los redireccionamientos multidominio.
urlCustomParameters[]

object (CustomParameter)

Es la lista de asignaciones usadas para sustituir etiquetas de parámetros personalizados en trackingUrlTemplate, finalUrls o mobile_final_urls.
criterionId

string (int64 format)

Solo salida. El ID del criterio.

Este campo se ignora para las mutaciones.
adGroup

string

Inmutable. El grupo de anuncios al que pertenece el criterio
negative

boolean

Inmutable. Indica si se debe orientar (false) o excluir (true) el criterio.

Este campo es inmutable. Para cambiar un criterio de positivo a negativo, quítalo y, luego, vuelve a agregarlo.
bidModifier

number

El modificador para la oferta cuando el criterio coincida. El modificador debe estar en el rango de 0.1 a 10.0. La mayoría de los tipos de criterios de segmentación admiten modificadores.
cpcBidMicros

string (int64 format)

La oferta de CPC (costo por clic).
cpmBidMicros

string (int64 format)

Es la oferta de CPM (costo por cada mil impresiones visibles).
cpvBidMicros

string (int64 format)

La oferta de CPV (costo por vista).
percentCpcBidMicros

string (int64 format)

Es el importe de la oferta de CPC, expresado como una fracción del precio anunciado por algún producto o servicio. El rango válido para la fracción es [0,1) y el valor almacenado aquí es 1,000,000 * [fracción].
effectiveCpcBidMicros

string (int64 format)

Solo salida. La oferta de CPC (costo por clic) efectiva.
effectiveCpmBidMicros

string (int64 format)

Solo salida. La oferta de CPM (costo por cada mil impresiones visibles) efectivo.
effectiveCpvBidMicros

string (int64 format)

Solo salida. La oferta de CPV (costo por vista) efectivo.
effectivePercentCpcBidMicros

string (int64 format)

Solo salida. Es el importe de la oferta de CPC porcentual efectivo.
finalUrlSuffix

string

Plantilla de URL para agregar parámetros a la URL final.
trackingUrlTemplate

string

La plantilla de URL para crear una URL de seguimiento.

Campo de unión criterion. Es el criterio del grupo de anuncios.

Se debe establecer exactamente uno. criterion puede ser una de las siguientes opciones:
keyword

object (KeywordInfo)

Inmutable. Palabra clave.
placement

object (PlacementInfo)

Inmutable. Ubicación.
mobileAppCategory

object (MobileAppCategoryInfo)

Inmutable. Categoría de aplicación para dispositivos móviles.
mobileApplication

object (MobileApplicationInfo)

Inmutable. Aplicación para dispositivos móviles
listingGroup

object (ListingGroupInfo)

Inmutable. Grupo de fichas.
ageRange

object (AgeRangeInfo)

Inmutable. Rango de edad.
gender

object (GenderInfo)

Inmutable. Género
incomeRange

object (IncomeRangeInfo)

Inmutable. Rango de ingresos.
parentalStatus

object (ParentalStatusInfo)

Inmutable. Estado parental.
userList

object (UserListInfo)

Inmutable. Lista de usuarios
youtubeVideo

object (YouTubeVideoInfo)

Inmutable. Video de YouTube
youtubeChannel

object (YouTubeChannelInfo)

Inmutable. tu canal de YouTube.
topic

object (TopicInfo)

Inmutable. Tema.
userInterest

object (UserInterestInfo)

Inmutable. Interés del usuario.
webpage

object (WebpageInfo)

Inmutable. Página web
appPaymentModel

object (AppPaymentModelInfo)

Inmutable. Modelo de pago de aplicaciones.
customAffinity

object (CustomAffinityInfo)

Inmutable. Afín personalizado.
customIntent

object (CustomIntentInfo)

Inmutable. público basado en intención personalizado.
customAudience

object (CustomAudienceInfo)

Inmutable. Público personalizado.
combinedAudience

object (CombinedAudienceInfo)

Inmutable. Público combinado.
audience

object (AudienceInfo)

Inmutable. Público.
location

object (LocationInfo)

Inmutable. Ubicación.
language

object (LanguageInfo)

Inmutable. de HashiCorp.

AdGroupCriterionStatus

Son los estados posibles de un Criterio del grupo de anuncios.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN

El valor recibido no se conoce en esta versión.

Este es un valor de solo respuesta.
ENABLED El criterio del grupo de anuncios está habilitado.
PAUSED El criterio del grupo de anuncios está detenido.
REMOVED Se quitó el criterio del grupo de anuncios.

QualityInfo

Un contenedor para la información sobre la calidad de los criterios del grupo de anuncios.

Representación JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Campos
creativeQualityScore

enum (QualityScoreBucket)

Solo salida. El rendimiento del anuncio en comparación con el de otros anunciantes.
postClickQualityScore

enum (QualityScoreBucket)

Solo salida. El nivel de calidad de la página de destino.
searchPredictedCtr

enum (QualityScoreBucket)

Solo salida. Es la tasa de clics en comparación con la de otros anunciantes.
qualityScore

integer

Solo salida. El nivel de calidad.

Este campo no se puede propagar si Google no tiene suficiente información para determinar un valor.

CriterionSystemServingStatus

Enumera los estados de entrega del sistema de criterios.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
ELIGIBLE Apto.
RARELY_SERVED Volumen de búsquedas bajo.

AdGroupCriterionApprovalStatus

Enumera los estados de aprobación de AdGroupCriterion.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
APPROVED Aprobado.
DISAPPROVED Rechazado.
PENDING_REVIEW Revisión pendiente.
UNDER_REVIEW En proceso de revisión

PositionEstimates

Son estimaciones para ofertas de criterio en varias posiciones.

Representación JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Campos
firstPageCpcMicros

string (int64 format)

Solo salida. Es la estimación de la oferta de CPC necesaria para que el anuncio se muestre en la primera página de los resultados de la búsqueda.
firstPositionCpcMicros

string (int64 format)

Solo salida. Es la estimación de la oferta de CPC necesaria para que el anuncio se muestre en la primera posición, en la parte superior de la primera página de los resultados de la búsqueda.
topOfPageCpcMicros

string (int64 format)

Solo salida. Es la estimación de la oferta de CPC necesaria para que el anuncio se muestre en la parte superior de la primera página de los resultados de la búsqueda.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Solo salida. Es una estimación de cuántos clics por semana podría obtener si cambia su oferta de palabra clave al valor en firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Solo salida. Es una estimación de cómo podría cambiar su costo por semana si cambia su oferta de palabra clave al valor en firstPositionCpcMicros.

ListingGroupInfo

Un criterio de grupo de fichas.

Representación JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Campos
type

enum (ListingGroupType)

Tipo del grupo de fichas.
caseValue

object (ListingDimensionInfo)

Valor de dimensión con la que este grupo de fichas está definiendo mejor a su elemento superior. No se define para el grupo raíz.
parentAdGroupCriterion

string

Nombre del recurso del criterio del grupo de anuncios, que es la subdivisión superior del grupo de fichas. Nulo para el grupo raíz.
path

object (ListingDimensionPath)

Es la ruta de las dimensiones que definen este grupo de fichas.

ListingGroupType

El tipo del grupo de fichas.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
SUBDIVISION Subdivisión de los productos junto a alguna dimensión de la ficha. Estos nodos no se utilizan en la entrega para orientar las entradas de la lista, sino que se utilizan exclusivamente para definir la estructura del árbol.
UNIT Unidad del grupo de fichas que define una oferta.

ListingDimensionPath

Es la ruta de las dimensiones que definen un grupo de fichas.

Representación JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Campos
dimensions[]

object (ListingDimensionInfo)

Es la ruta completa de las dimensiones a través de la jerarquía del grupo de fichas, desde la raíz (sin incluir la raíz) hasta este grupo de fichas.

AppPaymentModelInfo

Un criterio del modelo de pago de la app

Representación JSON 
{
  "type": enum (AppPaymentModelType)
}
Campos
type

enum (AppPaymentModelType)

Tipo de modelo de pago de la app.

AppPaymentModelType

Es una enumeración que describe los posibles modelos de pago de la app.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
PAID Representa aplicaciones pagadas.

CustomIntentInfo

Es un criterio de intención personalizado. Un criterio de este tipo solo es orientable.

Representación JSON 
{
  "customIntent": string
}
Campos
customIntent

string

El nombre del recurso CustomInterest.