Un grupo de anuncios
Representación JSON |
---|
{ "resourceName": string, "status": enum ( |
Campos | |
---|---|
resourceName |
Inmutable. El nombre del recurso del grupo de anuncios. Los nombres de recursos de los grupos de anuncios tienen el siguiente formato:
|
status |
El estado del grupo de anuncios. |
type |
Inmutable. Indica el tipo de grupo de anuncios. |
adRotationMode |
El modo de rotación de anuncios del grupo de anuncios |
urlCustomParameters[] |
La lista de asignaciones usadas para sustituir las etiquetas de parámetros personalizados en un |
optimizedTargetingEnabled |
Verdadero si está habilitada la segmentación optimizada. La segmentación optimizada reemplaza la expansión del público. |
displayCustomBidDimension |
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 |
Es el parámetro de configuración de las funciones relacionadas con la segmentación. |
audienceSetting |
Inmutable. Es el parámetro de configuración de las funciones relacionadas con el público. |
effectiveTargetCpaSource |
Solo salida. La fuente del CPA objetivo eficaz Este campo es de solo lectura. |
effectiveTargetRoasSource |
Solo salida. La fuente del ROAS objetivo eficaz Este campo es de solo lectura. |
labels[] |
Solo salida. Los nombres de recursos de las etiquetas adjuntas a este grupo de anuncios. |
excludedParentAssetFieldTypes[] |
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[] |
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 |
Solo salida. El ID del grupo de anuncios. |
name |
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 |
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 |
La plantilla de URL para crear una URL de seguimiento. |
campaign |
Inmutable. La campaña a la que pertenece el grupo de anuncios. |
cpcBidMicros |
La oferta de CPC (costo por clic) máxima. |
effectiveCpcBidMicros |
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 |
Es la oferta de CPM (costo por cada mil impresiones visibles) máximo. |
targetCpaMicros |
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 |
Es la oferta de CPV (costo por vista). |
targetCpmMicros |
Importe promedio en micros que el anunciante está dispuesto a pagar cada vez que el anuncio se muestre mil veces. |
targetRoas |
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 |
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 |
Plantilla de URL para agregar parámetros a la URL final. |
effectiveTargetCpaMicros |
Solo salida. El costo por adquisición (CPA) objetivo eficaz. Este campo es de solo lectura. |
effectiveTargetRoas |
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 | |
---|---|
useAudienceGrouped |
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. |