Informes

Al igual que con otros tipos de campañas, puedes usar GoogleAdsService.SearchStream para recuperar atributos y métricas de rendimiento de las campañas inteligentes.

Las métricas de las campañas inteligentes están disponibles en el recurso campaign, y las métricas específicas de los términos de búsqueda están disponibles en el recurso smart_campaign_search_term_view. En smart_campaign_search_term_view, el campo search_term contiene las búsquedas coincidentes que generaron resultados. Para recuperar el estado operativo y los detalles de elegibilidad de una campaña inteligente (como el estado en revisión, los motivos de no elegibilidad o las marcas de tiempo de las impresiones), usa SmartCampaignSettingService.GetSmartCampaignStatus como se describe en Estado de la campaña.

Impresiones y clics de las campañas inteligentes en los últimos 30 días

La siguiente consulta recupera las impresiones y los clics de cada término de búsqueda de los últimos 30 días para todas las campañas inteligentes, segmentados por fecha.

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.clicks,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS

Los 10 principales términos de búsqueda por impresiones

La siguiente consulta recupera los 10 términos de búsqueda principales que generaron la mayor cantidad de impresiones en los últimos 30 días, junto con su costo. Ten en cuenta que se omite segments.date de la cláusula SELECT para que las impresiones y el costo se agreguen en todo el período de 30 días por término de búsqueda.

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions,
  metrics.cost_micros,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 10

Recupera atributos de un KeywordThemeConstant

Dado que los KeywordThemeConstants se recuperan de un conjunto de datos grande que no es específico del cliente, no es posible analizar todo el recurso keyword_theme_constant de una sola vez. Para recuperar objetos KeywordThemeConstants individuales, debes consultar el recurso campaign_criterion para encontrar los nombres de los recursos de los temas de palabras clave asociados con tus campañas y, luego, usar esos nombres de recursos para consultar el recurso keyword_theme_constant.

SELECT
  campaign.id,
  campaign_criterion.type,
  campaign_criterion.status,
  campaign_criterion.criterion_id,
  campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = 'KEYWORD_THEME'

Luego, usa el nombre del recurso en el campo campaign_criterion.keyword_theme.keyword_theme_constant de la siguiente consulta:

SELECT
  keyword_theme_constant.resource_name,
  keyword_theme_constant.display_name,
  keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'

Requisitos de la funcionalidad de informes

Para implementar las campañas inteligentes, tu aplicación debe satisfacer un conjunto de funcionalidades mínimas requeridas (FMR).

Específicamente para la generación de informes, se debe poner a disposición del usuario final una cantidad de campos de informes. A continuación, te indicamos cómo recuperar los campos obligatorios del elemento número R.20 Campaign Performance en el RMF:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

A continuación, te mostramos cómo recuperar los campos obligatorios del elemento R.70 Vista de términos de búsqueda de la campaña inteligente, junto con la campaña y el término de búsqueda asociados:

SELECT
  campaign.id,
  campaign.name,
  smart_campaign_search_term_view.search_term,
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

Métricas por tienda

A continuación, se incluye una consulta que incluye todas las métricas disponibles por tienda para las campañas inteligentes. Estos campos también se pueden combinar con otros campos en una sola consulta:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.all_conversions_from_click_to_call,
  metrics.all_conversions_from_directions,
  metrics.all_conversions_from_menu,
  metrics.all_conversions_from_order,
  metrics.all_conversions_from_other_engagement,
  metrics.all_conversions_from_store_visit,
  metrics.all_conversions_from_store_website
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'

Llamadas telefónicas segmentadas por hora

A continuación, se explica cómo recuperar todas las métricas de llamadas telefónicas entre las 12:00 p.m. y las 5:00 p.m. (valores de segments.hour de 12 a 16, en los que cada número entero representa un período de 1 hora que comienza a esa hora):

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
  AND segments.hour BETWEEN 12 AND 16