Métricas de rendimiento y atributos de configuración para grupos de productos. Los informes de grupos de productos difieren de los informes de palabras clave en varios aspectos. Obtenga más información.
Este informe solo se puede mostrar mediante una solicitud asíncrona (es decir, a través del método Reports.request()).
Solicitar extracto
Envía un cuerpo de solicitud Reports.request() normal, pero especifica "reportType": "productGroup"
.
{ ... "reportType": "productGroup", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Para cada columna que desees mostrar o filtrar en el informe, especifica la columnName
que aparece en la siguiente tabla.
De manera opcional, también puedes especificar headerText, startDate y endDate.
Tenga en cuenta que no se pueden filtrar algunas columnas. Consulte la sección “Filtrable” en la tabla a continuación.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
---|---|---|---|---|
status |
Es el estado del grupo de productos. Siempre es Active . |
atributo | Status |
Sí |
engineStatus |
Estado adicional del grupo de productos en la cuenta de motor externo. Los estados posibles (según el tipo de cuenta externa) incluyen review , campaign paused , etcétera. |
atributo | String |
Sí |
creationTimestamp |
Marca de tiempo de la creación del grupo de productos, con el formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
Marca de tiempo de la modificación más reciente del grupo de productos, con el formato ISO 8601. | atributo | Timestamp |
Sí |
agency |
Nombre de la agencia. | atributo | String |
Sí |
agencyId |
ID de agencia de DS. | atributo | ID |
Sí |
advertiser |
Nombre del anunciante | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
account |
Nombre de la cuenta de motor. | atributo | String |
Sí |
accountId |
ID de cuenta de motor de DS. | atributo | ID |
Sí |
accountEngineId |
ID de la cuenta en la cuenta de motor externo. | 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 campaña de DS. | atributo | ID |
Sí |
campaignStatus |
El estado de la campaña que contiene este elemento. | atributo | Status |
Sí |
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 que contiene este elemento. | atributo | Status |
Sí |
productGroupId |
ID del grupo de productos de DS. DS genera estos ID, que pueden cambiar aunque el árbol del grupo de productos resultante no se modifique. Obtenga más información. | atributo | ID |
Sí |
productGroup |
Los criterios que se usaron para definir el grupo de productos, como AND(CATEGORY="Electronics",BRAND = "example"). | atributo | String |
No |
productGroupPartitionType |
El tipo de partición para el grupo de productos: Subdivided , Excluded o Biddable . |
atributo | Product group partition type |
Sí |
productGroupLandingPage |
Página de destino del grupo de productos Consulta Página de destino y URL de clickserve. | atributo | String |
Sí |
productGroupClickserverUrl |
URL que DS utiliza para realizar el seguimiento de la actividad. Un usuario que haga clic en un anuncio primero visitará la URL del servidor de clics y, luego, se lo redireccionará a la página de destino final. Consulta Página de destino y URL de clickserve. | atributo | String |
Sí |
productGroupMaxCpc |
Muestra el CPC máximo que se estableció para este grupo de productos, si existe. Si no se estableció el CPC máx. para este grupo de productos, este campo estará vacío y el grupo de productos heredará la configuración de CPC máx. del grupo de anuncios. | atributo | Money |
Sí |
effectiveProductGroupMaxCpc |
El CPC (costo por clic máximo) máximo que está en vigor para este grupo de productos. Este valor será el mismo que el CPC máx. del grupo de anuncios o, si la orientación de producto anula la configuración del grupo de anuncios, el CPC máx. de la orientación de producto. | atributo | Money |
Sí |
productGroupMaxBid |
Si una estrategia de oferta de DS administra este grupo de productos, la estrategia de oferta nunca aumentará las ofertas que superen este límite. Consulte el artículo Cómo aplicar una estrategia de oferta a un grupo de productos. | atributo | Money |
Sí |
productGroupMinBid |
Si una estrategia de oferta de DS administra este grupo de productos, la estrategia de oferta nunca disminuirá por debajo de este límite. Consulte el artículo Cómo aplicar una estrategia de oferta a un grupo de productos. | atributo | Money |
Sí |
effectiveBidStrategyId |
El ID de DS de la estrategia de oferta asignada a esta entidad o heredada por esta entidad. | atributo | ID |
Sí |
effectiveBidStrategy |
Es el nombre de la estrategia de oferta asignada a esta entidad o heredada por esta. | atributo | String |
Sí |
bidStrategyInherited |
Indica si la estrategia de oferta de esta entidad es heredada. | atributo | Boolean |
Sí |
effectiveLabels |
Nombres de todas las etiquetas heredadas o asignadas directamente a este grupo de productos. | atributo | String list |
Sí |
dfaActions |
Es la cantidad total de acciones en Campaign Manager. | métrica | Integer |
Sí |
dfaRevenue |
Ingresos totales generados por transacciones de Campaign Manager. | métrica | Money |
Sí |
dfaTransactions |
Es la cantidad total de transacciones de Campaign Manager. | métrica | Integer |
Sí |
dfaWeightedActions |
Suma ponderada de acciones de Campaign Manager. | métrica | Number |
Sí |
dfaActionsCrossEnv |
La cantidad total de acciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
dfaRevenueCrossEnv |
Ingresos totales generados por transacciones de Campaign Manager en varios entornos. | métrica | Money |
Sí |
dfaTransactionsCrossEnv |
La cantidad total de transacciones de Campaign Manager entre entornos. | métrica | Number |
Sí |
dfaWeightedActionsCrossEnv |
Suma ponderada de acciones de Campaign Manager en varios entornos | métrica | Number |
Sí |
avgCpc |
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 totales | métrica | Integer |
Sí |
cost |
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 |
Los datos que el anunciante configuró para que se incluyan en la columna "Conversiones de Google Ads". Cuando se crea una acción de conversión de Google Ads, el anunciante puede elegir si desea registrar esas conversiones en la columna de informes "Conversiones". | métrica | Number |
Sí |
adWordsConversionValue |
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 |
Indica la cantidad total de visitas a DS. | métrica | Integer |
Sí |
date |
Segmenta el informe por días. Cada fila y sus métricas globales 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 globales 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 globales 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 globales 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 globales 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 globales 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 globales 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 globales se dividen en varias filas, hasta una por cada segmento de dispositivo. Esta columna muestra el segmento de dispositivos de cada fila. | segmento | Device segment |
Sí |