Precaución: Estás viendo la documentación de la interfaz REST de la API. La mayoría de nuestras bibliotecas cliente oficiales usan gRPC. Consulta la Introducción a REST para obtener más detalles.

Se usó la API de Cloud Translation para traducir esta página.

AdGroup

Representación JSON
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- Representación JSON

Un grupo de anuncios

Representación JSON

Representación JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Campos
`resourceName`	`string` Inmutable. El nombre del recurso del grupo de anuncios. Los nombres de recursos de los grupos de anuncios tienen el siguiente formato: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` El estado del grupo de anuncios.
`type`	`enum (AdGroupType)` Inmutable. Indica el tipo de grupo de anuncios.
`adRotationMode`	`enum (AdGroupAdRotationMode)` El modo de rotación de anuncios del grupo de anuncios
`urlCustomParameters[]`	`object (CustomParameter)` La lista de asignaciones usadas para sustituir las etiquetas de parámetros personalizados en un `trackingUrlTemplate`, `finalUrls` o `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` Verdadero si está habilitada la segmentación optimizada. La segmentación optimizada reemplaza la expansión del público.
`displayCustomBidDimension`	`enum (TargetingDimension)` Permite que los anunciantes especifiquen una dimensión de segmentación para establecer ofertas absolutas. Esto es válido solo para las campañas que se orientan solo a la Red de Display y no a la Red de búsqueda.
`targetingSetting`	`object (TargetingSetting)` Es el parámetro de configuración de las funciones relacionadas con la segmentación.
`audienceSetting`	`object (AudienceSetting)` Inmutable. Es el parámetro de configuración de las funciones relacionadas con el público.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Solo salida. La fuente del CPA objetivo eficaz Este campo es de solo lectura.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Solo salida. La fuente del ROAS objetivo eficaz Este campo es de solo lectura.
`labels[]`	`string` Solo salida. Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Los tipos de campos de recursos que deben excluirse de este grupo de anuncios. Este grupo de anuncios no heredará los vínculos de recursos con estos tipos de campos de los niveles superiores.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Los tipos de conjuntos de recursos que deben excluirse de este grupo de anuncios. Este grupo de anuncios no heredará las vinculaciones de conjuntos de recursos con estos tipos de los niveles superiores. Los tipos de grupos por ubicación (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP y STATIC_LOCATION_GROUP) son tipos secundarios de LOCATION_SYNC. Por lo tanto, si se configura LOCATION_SYNC para este campo, no se permitirá vincular ningún conjunto de recursos del grupo por ubicación a este grupo de anuncios, y las extensiones de ubicación (LE) y las extensiones de ubicación afiliada (ALE) no se publicarán en este grupo de anuncios. Por el momento, solo se admite LOCATION_SYNC.
`id`	`string (int64 format)` Solo salida. El ID del grupo de anuncios.
`name`	`string` El nombre del grupo de anuncios. Este campo es obligatorio y no debe estar vacío cuando se crean grupos de anuncios nuevos. Debe contener menos de 255 caracteres de ancho completo UTF-8. No debe contener caracteres nulos (punto de código 0x0), de salto de línea NL (punto de código 0xA) ni de retorno de carro (punto de código 0xD).
`baseAdGroup`	`string` Solo salida. Para grupos de anuncios en borrador o experimentales, este campo es el nombre del recurso del grupo de anuncios base a partir del cual se creó este grupo de anuncios. Si un grupo de anuncios borrador o experimental no tiene un grupo de anuncios base, este campo será nulo. Para los grupos de anuncios base, este campo es igual al nombre del recurso del grupo de anuncios. Este campo es de solo lectura.
`trackingUrlTemplate`	`string` La plantilla de URL para crear una URL de seguimiento.
`campaign`	`string` Inmutable. La campaña a la que pertenece el grupo de anuncios.
`cpcBidMicros`	`string (int64 format)` La oferta de CPC (costo por clic) máxima.
`effectiveCpcBidMicros`	`string (int64 format)` Solo salida. El valor será el mismo que el de la oferta de CPC (costo por clic) cuando la estrategia de ofertas sea uno de CPC manual, CPC avanzado, porcentaje de ranking superior objetivo o promocionado de página uno. De lo contrario, el valor será nulo.
`cpmBidMicros`	`string (int64 format)` Es la oferta de CPM (costo por cada mil impresiones visibles) máximo.
`targetCpaMicros`	`string (int64 format)` El costo por adquisición (CPA) objetivo. Si la estrategia de oferta de la campaña del grupo de anuncios es CPA objetivo o Maximizar conversiones (con su campo targetCpa configurado), este campo anulará el CPA objetivo especificado en la estrategia de oferta de la campaña. De lo contrario, se ignora este valor.
`cpvBidMicros`	`string (int64 format)` Es la oferta de CPV (costo por vista).
`targetCpmMicros`	`string (int64 format)` Importe promedio en micros que el anunciante está dispuesto a pagar cada vez que el anuncio se muestre mil veces.
`targetRoas`	`number` La anulación del ROAS (retorno de la inversión publicitaria) objetivo Si la estrategia de ofertas de la campaña del grupo de anuncios es TargetRoas o MaximizarConversionValue (con su campo targetRoas configurado), este campo anulará el ROAS objetivo especificado en la estrategia de oferta de la campaña. De lo contrario, se ignora este valor.
`percentCpcBidMicros`	`string (int64 format)` Es el importe porcentual de la oferta de CPC, expresado como una fracción del precio anunciado para 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].
`finalUrlSuffix`	`string` Plantilla de URL para agregar parámetros a la URL final.
`effectiveTargetCpaMicros`	`string (int64 format)` Solo salida. El costo por adquisición (CPA) objetivo eficaz. Este campo es de solo lectura.
`effectiveTargetRoas`	`number` Solo salida. El ROAS (retorno de la inversión publicitaria) objetivo eficaz Este campo es de solo lectura.

AdGroupStatus

Los estados posibles de un grupo de anuncios

Enumeradores
`UNSPECIFIED`	No se especificó el estado.
`UNKNOWN`	No se conoce el valor recibido en esta versión. Este es un valor de solo respuesta.
`ENABLED`	El grupo de anuncios está habilitado.
`PAUSED`	El grupo de anuncios está detenido.
`REMOVED`	Se quita el grupo de anuncios.

AdGroupType

Es una enumeración que enumera los tipos posibles de un grupo de anuncios.

Enumeradores
`UNSPECIFIED`	No se especificó el tipo.
`UNKNOWN`	No se conoce el valor recibido en esta versión. Este es un valor de solo respuesta.
`SEARCH_STANDARD`	Es el tipo de grupo de anuncios predeterminado para las campañas de Búsqueda.
`DISPLAY_STANDARD`	Es el tipo de grupo de anuncios predeterminado para las campañas de Display.
`SHOPPING_PRODUCT_ADS`	Es el tipo de grupo de anuncios para las campañas de Shopping que publican anuncios de productos estándar.
`HOTEL_ADS`	Es el tipo de grupo de anuncios predeterminado para las campañas de hoteles.
`SHOPPING_SMART_ADS`	Indica el tipo para los grupos de anuncios en las campañas de Shopping inteligentes.
`VIDEO_BUMPER`	Anuncios de video in-stream cortos que no se pueden omitir
`VIDEO_TRUE_VIEW_IN_STREAM`	Anuncios de video in-stream TrueView (que se pueden omitir).
`VIDEO_TRUE_VIEW_IN_DISPLAY`	anuncios de video TrueView en display
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Anuncios de video in-stream que no se pueden omitir
`VIDEO_OUTSTREAM`	Anuncios de video outstream
`SEARCH_DYNAMIC_ADS`	Es el tipo de grupo de anuncios para los grupos de anuncios dinámicos de búsqueda.
`SHOPPING_COMPARISON_LISTING_ADS`	Indica el tipo para los grupos de anuncios en las campañas de comparación de productos.
`PROMOTED_HOTEL_ADS`	Es el tipo de grupo de anuncios para los grupos de anuncios de Hoteles promocionados.
`VIDEO_RESPONSIVE`	Grupos de anuncios responsivos de video
`VIDEO_EFFICIENT_REACH`	Grupos de anuncios de alcance eficiente de video
`SMART_CAMPAIGN_ADS`	Es el tipo de grupo de anuncios para las campañas inteligentes.
`TRAVEL_ADS`	Es el tipo de grupo de anuncios para las campañas de viajes.

AdGroupAdRotationMode

Son los modos posibles de rotación de anuncios de un grupo de anuncios.

Enumeradores
`UNSPECIFIED`	No se especificó el modo de rotación de anuncios.
`UNKNOWN`	No se conoce el valor recibido en esta versión. Este es un valor de solo respuesta.
`OPTIMIZE`	Optimiza los anuncios del grupo de anuncios según los clics o las conversiones.
`ROTATE_FOREVER`	Rotar de manera uniforme y permanente

AudienceSetting

Es la configuración de la segmentación por público.

Representación JSON
{ "useAudienceGrouped": boolean }

Campos

Campos
`useAudienceGrouped`	`boolean` Inmutable. Si es verdadero, este grupo de anuncios usa un recurso de público para la Segmentación por público. Si es falso, este grupo de anuncios puede usar los criterios de segmento de público en su lugar.

useAudienceGrouped

boolean

Inmutable. Si es verdadero, este grupo de anuncios usa un recurso de público para la Segmentación por público. Si es falso, este grupo de anuncios puede usar los criterios de segmento de público en su lugar.