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 campaign recurso, y las métricas específicas de los términos de búsqueda están disponibles en el smart_campaign_search_term_view recurso. En el smart_campaign_search_term_view, el search_term campo contiene cualquier consulta coincidente que haya generado resultados. Para recuperar el estado operativo y los detalles de elegibilidad de una campaña inteligente (como el estado en revisión, los motivos por los que no es apta 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 términos de búsqueda principales 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

Debido a que 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 a la vez. Para recuperar 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 en 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 campañas inteligentes, tu aplicación debe satisfacer un conjunto de Funcionalidades Mínimas Obligatorias (RMF).

En cuanto a los informes específicamente, se debe poner a disposición del usuario final una serie de campos de informes. A continuación, te indicamos cómo recuperar los campos obligatorios del elemento número R.20 Rendimiento de la campaña en las 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 indicamos cómo recuperar los campos obligatorios del elemento número 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

Esta es una consulta que incluye todas las métricas por tienda disponibles 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, te indicamos cómo recuperar todas las métricas de llamadas telefónicas entre las 12:00 p.m. y las 5:00 p.m. (valores segments.hour de 12 a 16, donde 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
  AND segments.date DURING LAST_30_DAYS