Métricas de rendimiento y atributos de configuración de los grupos de anuncios
Este informe solo se puede mostrar mediante una solicitud asíncrona (es decir, a través del método Reports.request()).
Solicitar un extracto
Envía un cuerpo de solicitud Reports.request() normal, pero especifica "reportType": "adGroup".
{
...
"reportType": "adGroup",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Para cada columna que quieras que se muestre o filtre en el informe, especifica el columnName que se indica en la siguiente tabla.
De manera opcional, también puedes especificar
headerText,
startDate y
endDate.
Ten en cuenta que no se pueden filtrar algunas columnas. Consulta "Filtrable" en la siguiente tabla.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
|---|---|---|---|---|
status |
Es un alias para el atributo adGroupStatus. |
atributo | Status |
Sí |
engineStatus |
Estado adicional del grupo de anuncios en la cuenta de motor externa. Los estados posibles (según el tipo de cuenta externa) incluyen eligible, campaign ended, etcétera. |
atributo | String |
Sí |
creationTimestamp |
Marca de tiempo de la creación del grupo de anuncios, con formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
Marca de tiempo de la última modificación del grupo de anuncios, con formato ISO 8601. | atributo | Timestamp |
Sí |
agency |
Nombre de la agencia | atributo | String |
Sí |
agencyId |
Es el ID de la agencia de DS. | atributo | ID |
Sí |
advertiser |
Es el nombre del anunciante. | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
account |
Es el nombre de la cuenta de motor. | atributo | String |
Sí |
accountId |
ID de la cuenta del motor de DS. | atributo | ID |
Sí |
accountEngineId |
ID de la cuenta de la cuenta de motor externa. | atributo | String |
Sí |
accountType |
Tipo de cuenta de motor: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu o Comparison Shopping. |
atributo | Engine type |
Sí |
campaign |
Nombre de la campaña. | atributo | String |
Sí |
campaignId |
ID de la campaña de DS. | atributo | ID |
Sí |
campaignStatus |
Es el estado de la campaña que contiene este artículo. | atributo | Status |
Sí |
adRotation |
Rotación de publicación de anuncios que utiliza el grupo de anuncios: Optimize o Rotate indefinitely. |
atributo | String |
No |
adGroup |
Nombre del grupo de anuncios. | atributo | String |
Sí |
adGroupId |
ID del grupo de anuncios de DS. | atributo | ID |
Sí |
adGroupStatus |
El estado del grupo de anuncios: Active, Paused o Removed. Ten en cuenta que las campañas, los grupos de anuncios, las palabras clave, los anuncios y los objetivos tienen su propio estado. Consulta el estado. |
atributo | Status |
Sí |
adGroupEngineId |
ID del grupo de anuncios en la cuenta de motor externo. | atributo | ID |
Sí |
adGroupStartDate |
Es la fecha de inicio del grupo de anuncios. | atributo | Date |
Sí |
adGroupEndDate |
Es la fecha de finalización del grupo de anuncios. | atributo | Date |
Sí |
adGroupSearchMaxCpc |
Es la oferta predeterminada para las palabras clave de búsqueda en este grupo de anuncios. | atributo | Money |
Sí |
adGroupBroadMaxCpc |
Es la oferta predeterminada para las palabras clave de búsqueda de concordancia amplia en este grupo de anuncios (solo para Bing Ads). | atributo | Money |
Sí |
adGroupExactMaxCpc |
Es la oferta predeterminada para las palabras clave de concordancia exacta en este grupo de anuncios (solo para Bing Ads). | atributo | Money |
Sí |
adGroupPhraseMaxCpc |
Es la oferta predeterminada para las palabras clave de concordancia de frase en este grupo de anuncios (solo para Bing Ads). | atributo | Money |
Sí |
adGroupContentMaxCpc |
Es la oferta predeterminada para las palabras clave de contenido de este grupo de anuncios. | atributo | Money |
Sí |
adGroupMobileBidAdjustment |
Es el porcentaje según el cual se ajustan las ofertas para dispositivos móviles. Por ejemplo, 0.2 significa un aumento del 20%, por lo que las ofertas para dispositivos móviles son 1.2 veces la oferta predeterminada. El rango de valores válidos difiere según el motor externo. | atributo | Number |
Sí |
adGroupTabletBidAdjustment |
Es el porcentaje en el que se ajustan las ofertas para tablets. Por ejemplo, 0.2 significa un aumento del 20%, por lo que las ofertas para tablets son 1.2 veces la oferta predeterminada. El rango de valores válidos difiere según el motor externo. | atributo | Number |
Sí |
adGroupDesktopBidAdjustment |
Es el porcentaje según el cual se ajustan las ofertas para computadoras de escritorio. Por ejemplo, 0.2 significa un aumento del 20%, por lo que las ofertas para computadoras de escritorio son 1.2 veces la oferta predeterminada. El rango de valores válidos difiere según el motor externo. | atributo | Number |
Sí |
adGroupType |
(Solo se aplica a Google Ads) Indica el tipo de grupo de anuncios: Standard, Dynamic o Showcase. |
atributo | Ad group type |
Sí |
bingAdsLanguage |
Es el idioma de los anuncios y las palabras clave de un grupo de anuncios de Bing Ads. | atributo | Microsoft language code |
Sí |
bingAdsAdDistributions |
Son los canales de distribución de anuncios que utilizan los grupos de anuncios de Bing Ads; una combinación de Search y Content. |
atributo | String |
No |
adGroupLabels |
Son los nombres de las etiquetas asignadas directamente a este grupo de anuncios. No se incluyen las etiquetas heredadas. | atributo | String list |
Sí |
effectiveBidStrategyId |
Es el ID de DS de la estrategia de ofertas asignada a esta entidad o heredada por esta. | atributo | ID |
Sí |
effectiveBidStrategy |
Es el nombre de la estrategia de ofertas asignada a esta entidad o que hereda esta entidad. | atributo | String |
Sí |
bidStrategyInherited |
Indica si se hereda la estrategia de ofertas de esta entidad. | atributo | Boolean |
Sí |
deviceTargets |
Segmentaciones por dispositivo a nivel del grupo de anuncios; una combinación de Desktop, Mobile, Tablet o Other |
atributo | String |
No |
effectiveDeviceTargets |
Segmentaciones por dispositivo a nivel del grupo de anuncios o heredadas de la campaña; una combinación de Desktop, Mobile, Tablet o Other |
atributo | String |
No |
countryTargets |
Los objetivos de país incluidos en el grupo de anuncios Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
provinceTargets |
Los objetivos de provincia incluidos en el grupo de anuncios Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
metroTargets |
Los objetivos de área metropolitana incluidos en el grupo de anuncios Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
cityTargets |
Son los objetivos de ciudades incluidos en el grupo de anuncios. Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
effectiveCountryTargets |
Segmentaciones por país incluidas en el grupo de anuncios o heredadas de la campaña Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
effectiveProvinceTargets |
Segmentaciones por provincia incluidas en el grupo de anuncios o heredadas de la campaña Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
effectiveMetroTargets |
Segmentaciones por área metropolitana incluidas en el grupo de anuncios o heredadas de la campaña Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
effectiveCityTargets |
Segmentaciones por ciudad incluidas en el grupo de anuncios o heredadas de la campaña Descarga plantillas de carga y códigos de idioma y ubicación geográfica. | atributo | String |
No |
effectiveLabels |
Son los nombres de todas las etiquetas heredadas o asignadas directamente a este grupo de anuncios. | atributo | String list |
Sí |
engineRemarketingListTargetAll |
Indica si el grupo de anuncios solo utiliza segmentaciones por remarketing para ajustar las ofertas. Valores posibles:
|
atributo | Boolean |
Sí |
clicksWithFeedItemShowing |
Clics en cualquier vínculo del anuncio mientras se mostraba el elemento del feed Esta columna solo muestra un valor en un informe de artículos del feed o en un informe segmentado por una columna de artículos del feed. | métrica | Integer |
Sí |
costWithFeedItemShowing |
Es el costo de todos los anuncios cuando se mostraba el artículo del feed. Esta columna solo muestra un valor en un informe de artículos del feed o en un informe segmentado por una columna de artículos del feed. | métrica | Money |
Sí |
dfaActions |
Es la cantidad total de acciones de Campaign Manager. | métrica | Integer |
Sí |
dfaRevenue |
Son los ingresos agregados que generan las transacciones de Campaign Manager. | métrica | Money |
Sí |
dfaTransactions |
Es la cantidad total de transacciones del Administrador de campañas. | métrica | Integer |
Sí |
dfaWeightedActions |
Es la suma ponderada de las acciones de Campaign Manager. | métrica | Number |
Sí |
dfaActionsCrossEnv |
Es la cantidad total de acciones del Administrador de campañas en varios entornos. | métrica | Number |
Sí |
dfaRevenueCrossEnv |
Son los ingresos agregados que generan las transacciones de Campaign Manager en varios entornos. | métrica | Money |
Sí |
dfaTransactionsCrossEnv |
Es la cantidad total de transacciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
dfaWeightedActionsCrossEnv |
Es la suma ponderada de las acciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
avgCpc |
Es el costo por clic promedio. | métrica | Money |
Sí |
avgCpm |
Costo promedio por cada mil impresiones. | métrica | Money |
Sí |
avgPos |
Posición promedio. | métrica | Number |
Sí |
clicks |
Clics agregados | métrica | Integer |
Sí |
cost |
Es el costo total pagado a las cuentas de motor. | métrica | Money |
Sí |
ctr |
Tasa de clics promedio. | métrica | Number |
Sí |
impr |
Es la cantidad total de impresiones. | métrica | Integer |
Sí |
adWordsConversions |
Son los datos que el anunciante configuró para que se registren en la columna Conversiones de Google Ads. Cuando se crea una acción de conversión de Google Ads, el anunciante puede elegir si registrar esas conversiones en la columna de informes Conversiones. | métrica | Number |
Sí |
adWordsConversionValue |
Es el valor agregado de las conversiones de Google Ads. | métrica | Number |
Sí |
adWordsViewThroughConversions |
Es la cantidad total de conversiones posimpresión de Google Ads. | métrica | Integer |
Sí |
visits |
Es la cantidad total de visitas a DS. | métrica | Integer |
Sí |
searchImpressionShare |
Solo para Google Ads y Bing Ads. Es la cantidad de impresiones que recibiste en la Red de Búsqueda dividida por la cantidad estimada de impresiones que podrías haber recibido. Se muestra como un número entre 0.1 y 1 o, si la parte es inferior a 0.1, la cadena < 10%. |
métrica | Impression share |
Sí |
searchRankLostImpressionShare |
Solo para Google Ads y Bing Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Búsqueda debido a un ranking del anuncio bajo. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
displayImpressionShare |
Solo para Google Ads. Es la cantidad de impresiones que recibiste en la Red de Display dividida por la cantidad estimada de impresiones que podrías haber recibido. Se muestra como un número entre 0.1 y 1 o, si la parte es inferior a 0.1, la cadena < 10%. |
métrica | Impression share |
Sí |
displayRankLostImpressionShare |
Solo para Google Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Display debido a un ranking del anuncio bajo. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
qualityScoreAvg |
Solo para Google Ads y Bing Ads. Es el promedio ponderado por cantidad de impresiones del Nivel de calidad (NC) del motor en todos los días y palabras clave del alcance del informe. | métrica | Number |
Sí |
topOfPageBidAvg |
Solo para Google Ads. Es la oferta de CPC promedio aproximada que se necesita durante el período del informe para que tus anuncios aparezcan con regularidad en las posiciones principales sobre los resultados de la búsqueda. | métrica | Money |
Sí |
absoluteTopImpressionPercentage |
Es el porcentaje de tus impresiones de anuncios que se muestran como el primer anuncio por encima de los resultados de la búsqueda orgánica. | métrica | Impression share |
Sí |
searchAbsoluteTopImpressionShare |
Son las impresiones que recibiste en la ubicación superior absoluta (el primer anuncio por encima de los resultados de la búsqueda orgánica) divididas por la cantidad estimada de impresiones que podrías haber recibido en esa ubicación. | métrica | Impression share |
Sí |
topImpressionPercentage |
Es el porcentaje de tus impresiones de anuncios que se muestran en cualquier lugar por encima de los resultados de la búsqueda orgánica. | métrica | Impression share |
Sí |
searchTopImpressionShare |
Son las impresiones que recibiste en la ubicación superior (cualquier lugar por encima de los resultados de la búsqueda orgánica) en comparación con la cantidad estimada de impresiones que podrías haber obtenido en esa ubicación. | métrica | Impression share |
Sí |
searchRankLostAbsoluteTopImpressionShare |
Es una estimación de la frecuencia con la que tu anuncio no se mostró en el primer lugar por encima de los resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. | métrica | Impression share |
Sí |
searchRankLostTopImpressionShare |
Es una estimación de la frecuencia con la que tu anuncio no se mostró en ningún lugar por encima de los resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. | métrica | Impression share |
Sí |
date |
Segmenta el informe por días. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada día. Esta columna muestra la fecha de cada fila. | segmento | Date |
Sí |
monthStart |
Segmenta el informe por meses. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada mes. Esta columna muestra el primer día del mes de cada fila. | segmento | Date |
Sí |
monthEnd |
Segmenta el informe por meses. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada mes. Esta columna muestra el último día del mes de cada fila. | segmento | Date |
Sí |
quarterStart |
Segmenta el informe por trimestres. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada trimestre. Esta columna muestra el primer día del trimestre de cada fila. | segmento | Date |
Sí |
quarterEnd |
Segmenta el informe por trimestres. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada trimestre. Esta columna muestra el último día del trimestre de cada fila. | segmento | Date |
Sí |
weekStart |
Segmenta el informe por semanas (de domingo a sábado). Cada fila y sus métricas agregadas se dividen en varias filas, una para cada semana. Esta columna muestra el primer día (domingo) de cada fila. | segmento | Date |
Sí |
weekEnd |
Segmenta el informe por semanas (de domingo a sábado). Cada fila y sus métricas agregadas se dividen en varias filas, una para cada semana. Esta columna muestra el último día (sábado) de cada fila. | segmento | Date |
Sí |
yearStart |
Segmenta el informe por años. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada año. Esta columna muestra el primer día del año de cada fila. | segmento | Date |
Sí |
yearEnd |
Segmenta el informe por años. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada año. Esta columna muestra el último día del año de cada fila. | segmento | Date |
Sí |
deviceSegment |
Segmenta el informe por dispositivo. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada segmento de dispositivo. Esta columna muestra el segmento de dispositivo de cada fila. | segmento | Device segment |
Sí |
floodlightGroup |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra el nombre del grupo de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightGroupId |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra el ID del grupo de Floodlight de DS de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | ID |
Sí |
floodlightGroupTag |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra la etiqueta del grupo de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightActivity |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra el nombre de la actividad de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightActivityId |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra el ID de la actividad de Floodlight de DS de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | ID |
Sí |
floodlightActivityTag |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra la etiqueta de actividad de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
sitelinkDisplayText |
Segmenta el informe por vínculos a sitios. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada vínculo a sitio. Esta columna muestra el texto de visualización del vínculo a sitio de cada fila. | segmento | String |
Sí |
sitelinkDescription1 |
Segmenta el informe por vínculos a sitios. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada vínculo a sitio. Esta columna muestra la descripción 1 del vínculo a sitio de cada fila. | segmento | String |
Sí |
sitelinkDescription2 |
Segmenta el informe por vínculos a sitios. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada vínculo a sitio. Esta columna muestra la descripción 2 del vínculo a sitio de cada fila. | segmento | String |
Sí |
sitelinkLandingPageUrl |
Segmenta el informe por vínculos a sitios. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada vínculo a sitio. Esta columna muestra la URL de página de destino del vínculo a sitio de cada fila. | segmento | String |
Sí |
sitelinkClickserverUrl |
Segmenta el informe por vínculos a sitios. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada vínculo a sitio. Esta columna muestra la URL del servidor de clics del vínculo a sitio de cada fila. | segmento | String |
Sí |
locationBusinessName |
Segmenta el informe por extensiones de ubicación actualizadas vinculadas a una cuenta de Perfil de Negocio. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada ubicación que tenga métricas disponibles. Esta columna muestra el nombre de la empresa de la ubicación para cada fila. | segmento | String |
Sí |
locationCategory |
Segmenta el informe por extensiones de ubicación actualizadas vinculadas a una cuenta de Perfil de Negocio. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada ubicación que tenga métricas disponibles. Esta columna muestra la categoría de la ubicación para cada fila. | segmento | String |
Sí |
locationDetails |
Segmenta el informe por extensiones de ubicación actualizadas vinculadas a una cuenta de Perfil de Negocio. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada ubicación que tenga métricas disponibles. Esta columna muestra los detalles de una ubicación para cada fila. | segmento | String |
Sí |
locationFilter |
Segmenta el informe por extensiones de ubicación actualizadas vinculadas a una cuenta de Perfil de Negocio. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada ubicación que tenga métricas disponibles. Esta columna muestra el filtro de la ubicación para cada fila. | segmento | String |
No |
callPhoneNumber |
Segmenta el informe por extensión de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra el número de teléfono de una extensión de llamada. | segmento | String |
Sí |
callCountryCode |
Segmenta el informe por extensión de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra el código de país de la extensión de llamada de cada fila. | segmento | String |
Sí |
callIsTracked |
Segmenta el informe por extensión de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra verdadero si se realizará un seguimiento de las llamadas de la extensión de llamada; de lo contrario, muestra falso. | segmento | Boolean |
Sí |
callCallOnly |
Segmenta el informe por extensión de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra un valor verdadero si la extensión de llamada solo muestra un número de teléfono o un valor falso si la extensión muestra un número de teléfono y un vínculo. | segmento | Boolean |
Sí |
callConversionTracker |
Segmenta el informe por extensiones de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra el nombre del servicio de seguimiento de conversiones asociado con el artículo del feed, si corresponde. | segmento | String |
Sí |
callConversionTrackerId |
Segmenta el informe por extensiones de llamada. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de llamada. Esta columna muestra el ID del servicio de seguimiento de conversiones asociado con la extensión de llamada, si existe. | segmento | ID |
Sí |
appId |
Segmenta el informe por extensión de app. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de app. Esta columna muestra el ID de la app, si existe. | segmento | String |
Sí |
appStore |
Segmenta el informe por extensión de app. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada extensión de app. Esta columna muestra el tipo de tienda de aplicaciones (App Store de Apple, Google Play Store), si existe. | segmento | App store |
Sí |
feedItemId |
Segmenta el informe por elementos del feed. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada elemento del feed. Esta columna muestra el ID de fila del artículo del feed de DS para cada fila. | segmento | ID |
Sí |
feedId |
Segmenta el informe por elementos del feed. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada elemento del feed. Esta columna muestra el ID de la tabla del feed de DS para cada fila. | segmento | ID |
Sí |
feedType |
Segmenta el informe por elementos del feed. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada elemento del feed. Esta columna muestra el tipo de elemento del feed para cada fila. | segmento | Feed type |
Sí |