Conector de datos de Google Ads (AdWords)

 

Detalles rápidos

Tecnología del conector de datos API (Google Ads API v19)
Desglose de datos (segmentación)

En la configuración predeterminada, tus datos se desglosan por:

  • País
  • Campaña
  • Subcampaña (Ad Group)
  • Subred publicitaria (Ad Network Type).

Para elegir una configuración diferente, consulta Mapeo de datos más abajo.

Desde cuándo extraemos datos Todos los días, Singular extrae datos de los últimos 7 días. Una vez por semana, los lunes, Singular extrae datos de los últimos 30 días.
Zona horaria Definida por el cliente en la configuración de Google, para cada cuenta
¿Hay datos disponibles a nivel creativo (anuncio)?
¿Muestra Singular tus activos creativos? Sí (excepto los videos de YouTube, de los que Singular solo muestra miniaturas)
Limitaciones conocidas
  • La granularidad por país no está disponible para los creativos.
  • En los reportes de creativos, la métrica Installs con granularidad de activo se asigna desde biddable_app_install_conversions"; lo cual difiere de otras granularidades, que usan "metrics.conversions"

Mapeo de datos

Puedes obtener tus datos en una de varias configuraciones de desglose, cada una de las cuales ofrece un conjunto distinto de dimensiones y tiene sus propias ventajas y limitaciones.

  • La configuración predeterminada es Country. Para elegir otra, comunícate con el soporte de Singular.
  • La configuración Metro (DMA) solo es útil para publicidad dirigida a Estados Unidos (la información de DMA solo está disponible allí). Si alguna o todas tus campañas operan fuera de Estados Unidos, usa en su lugar la configuración City.
  • Las configuraciones Keyword y Publisher no incluyen datos de campañas UAC debido a limitaciones de la API de Google Ads.
  • Si bien las configuraciones Keyword y Publisher no incluyen país ni otras dimensiones de ubicación, Singular puede llegar a proporcionar el país según la configuración de países segmentados.
  • Edad o Género están disponibles como desgloses demográficos independientes (por ejemplo, mujer/hombre, 20-29, etc.).   

Consejos sobre terminología:

  • El Creative de Singular corresponde al Adde Google Ads.
  • La nueva dimensión Asset de Singular corresponde al Assetde Google Ads. Agregamos este nuevo nivel de granularidad porque en Google algunos tipos de anuncios, como los de UAC (app móvil), contienen varios assets.
  • Para ver la descripción de todos los campos de los reportes de Singular, consulta el Glosario de métricas y dimensiones de Singular.
  • Para ver más consejos sobre cómo ejecutar reportes de creativos en Google, consulta ¿Cómo ejecutar reportes de creativos en Meta y Google Ads?
Country Metro (DMA) City Keyword Keyword+Quality Score Publisher Shopping Video

Field in Singular UI Field in Singular API Field in Google Country Breakdown
Dimensions
Account ID adn_account_id customer.id
Account Name adn_account_name customer.descriptiveName
App Site ID app_site_id campaign.appCampaignSetting.appId
Asset ID asset_id asset.id
Asset Name asset_name asset.name (for assets of type Video we use “asset.youtubeVideoAsset.youtubeVideoTitle”)
Campaign URL adn_campaign_url ad.finalUrl
if not available, then ad.trackingUrlTemplate
Country country_field geographicView.countryCriterionId
Creative Format creative_format ad.type
Creative ID creative_id adGroupAd.ad.id
Creative Name creative_name adGroupAd.ad.name
Creative Reported URL creative_reported_url adGroupAd.ad.finalUrls.0
Date date_field segments.date
Final URL final_url campaign.finalUrls OR
adGroupCriterion.finalUrls OR
adGroup.ad.finalUrls
Network Campaign ID adn_campaign_id campaign.id
Network Campaign Name adn_campaign_name campaign.name
Network Creative ID adn_creative_id adGroupAd.ad.id
Network Creative Name adn_creative_name adGroupAd.ad.name
Network Sub Campaign ID adn_sub_campaign_id adGroup.id
Network Sub Campaign Name adn_sub_campaign_name adGroup.name
OS os campaign.appCampaignSetting.appStore
Platform platform A combination of campaign.appCampaignSetting.appStore and segments.device
Public Id site_public_id campaign.appCampaignSetting.appId
Retargeting retention campaign.advertisingChannelSubType == ‘APP_CAMPAIGN_FOR_ENGAGEMENT_’
Sub Ad Network adn_subadnetwork segments.adNetworkType
Target Countries target_countries_str See country
Text creative_text To create this field, we take any available text fields in the ad, which may differ based on the ad type. E.g., for UAC, the field in Google Ads is asset.textAsset.text. If there is more than one text (e.g. headline + description), we concatenate them into one string. 
Timezone adn_timezone customer.timeZone
(Singular receives time data from Adwords in the client's timezone and converts it to UTC.)
Tracking URL tracking_url adGroupAd.ad.trackingUrlTemplate
Asset Performance
asset_performance performance_label
Metrics
Cost adn_cost metrics.costMicro
Network Clicks adn_clicks metrics.clicks
Network Impressions adn_impressions metrics.impressions
Network Installs adn_installs metrics.conversions / metrics.allConversions
Original Cost adn_original_cost metrics.costMicro
Original Currency adn_original_currency customer.currencyCode
Video Views video_views metrics.videoViews
Completed Video Views completed_video_views metrics.video_quartile_p100_rate
Video Views - 25% video_views_25pct metrics.video_quartile_p25_rate
Video Views - 50% video_views_50pct metrics.video_quartile_p50_rate
Video Views - 75% video_views_75pct metrics.video_quartile_p75_rate

Singular también admite la extracción de propiedades de campaña para este partner: consulta más detalles aquí.

Instrucciones de configuración especiales

Autenticación

Consulta las FAQ de conectores de datos para información general sobre cómo configurar un conector de datos.

Al configurar el conector de datos de AdWords se te pide iniciar sesión con una cuenta de Google Ads. Recomendamos encarecidamente iniciar sesión con una cuenta de administrador de Google Ads (antes conocida como cuenta MCC).

Una cuenta de administrador de Google (MCC) nos da acceso a todas tus cuentas publicitarias a la vez. Luego puedes elegir de la lista qué cuentas quieres incluir en tus reportes de Singular. Si no usas una cuenta de administrador (MCC), tendrás que agregar un conector de datos independiente para cada cuenta publicitaria.

Para localizar tu ID de cliente (tanto en cuentas de administrador como individuales):

  1. Inicia sesión en tu cuenta de Google Ads.
  2. Haz clic en el icono de ayuda en la esquina superior derecha.
  3. Busca Customer ID al final del menú.

Eventos de conversión

Además de las métricas predeterminadas de la tabla anterior, Singular puede extraer cualquier métrica que necesites de Google Ads y mostrar sus estadísticas en tus reportes de Singular.

Si buscas información más detallada a nivel de activo, considera agregar 'biddable-app-post-install-conversion' como evento. Estos datos se extraen de la API de Google Ads. Esta función te permite incorporar datos adicionales sobre eventos de 'acciones in-app' en sus campañas correspondientes. Es importante señalar que los eventos de conversión carecen de datos de cohorte y solo se asocian al periodo de cohorte 'real'.

Para configurar eventos de conversión en Singular, sigue estos pasos:

  1. En Singular, ve a Settings > Events. Si tienes las pestañas Custom Events y Conversion Events, selecciona Conversion Events.
  2. Haz clic en New Event.
  3. En el menú desplegable AdWords verás una lista de las métricas disponibles en AdWords. Puedes asignar cada actividad a un evento de Singular independiente o combinar varias métricas en un solo evento.

    Al día siguiente, cuando Singular extraiga los datos diarios de tu cuenta, también extraerá las estadísticas de estas actividades.

  4. Una vez que Singular haya poblado los nuevos eventos de conversión con algunos datos, al ejecutar un reporte en la página Reports, elige los eventos de conversión en el menú desplegable Events.

FAQ y solución de problemas

¿Cómo encuentro mi ID de cuenta de administrador (ID de MCC)?

Para localizar tu ID de cliente (tanto en cuentas de administrador como individuales):

  1. Inicia sesión en tu cuenta de Google Ads.
  2. Haz clic en el icono de ayuda en la esquina superior derecha.
  3. Busca Customer ID al final del menú.

Para más información, consulta Acerca de las cuentas de administrador de Google Ads en la documentación de Google.

¿Por qué no puedo autenticar mi cuenta de administrador de Google Ads?

En tu cuenta de administrador de Google Ads, ve a Settings > Network Settings. Asegúrate de haber activado API access. Luego intenta volver a autenticar tu cuenta de administrador de Google Ads en Singular.

google_auth.png

¿Por qué a veces sigo viendo datos de país en el reporte, aunque esté usando un desglose diferente?

Cuando usas un desglose que no proporciona información de país, Singular intenta ofrecer granularidad por país de todos modos consultando, para la campaña la configuración de segmentación en Google o los datos del tracker (si los tenemos):

  1. Si la campaña está segmentada a un solo país, mostraremos ese país en el reporte.
  2. Si hay varios países segmentados y además tenemos datos del tracker para la misma campaña, estimaremos el costo por país según la proporción de instalaciones por país en los datos del tracker. Consulta ¿Cómo se calcula la métrica de costo por país?
¿Cómo extrae Singular las Network Installs de las campañas de AdWords?

Google Ads hace tracking de distintos tipos de lo que llama “acciones de conversión”: descargas de apps, registros de usuarios, compras y más. De forma predeterminada, dado que a la mayoría de nuestros clientes les interesan las instalaciones de apps, extraemos las conversiones del tipo download y mostramos sus métricas en el campo Network Installs de nuestros reportes.

Nota: Network Installs es una métrica de Singular que refleja el número de instalaciones reportadas por la red publicitaria, y no debe confundirse con Installs, que suele basarse en los datos del tracker de atribución. En el caso de AdWords, Network Installs es el número de conversiones "first_open" reportadas por AdWords.

Al crear una consulta de reporte, puedes seleccionar Network Installs en la sección Source Metrics . Consulta ¿Qué son las Source Metrics? para más información.

¿Extrae Singular los creativos de AdWords?

Sí, Singular extrae tanto las métricas de creativos como los creativos en sí (imágenes, textos, videos, etc.). Esto aplica tanto si usas la versión antigua de la integración de AdWords como la nueva. Sin embargo, solo la nueva integración muestra los creativos de campañas UAC.

¿Qué es un "creative" en el contexto de AdWords? ¿Cuál es la diferencia entre “creative” y “asset”?

El Creative de Singular corresponde al Adde Google Ads.

La nueva dimensión Asset de Singular corresponde al Assetde Google Ads. Agregamos este nuevo nivel de granularidad porque en Google algunos tipos de anuncios, como los de UAC (app móvil), contienen varios assets. Las instalaciones reportadas para un activo se extraen de la métrica "biddable_app_install_conversions", lo cual difiere de otras granularidades, que usan "metrics.conversions"

¿Qué tipos de anuncios de Google admite Singular?

Singular admite los siguientes tipos de anuncios de Google:

Tipo de anuncio Activos publicitarios incluidos
Texto Imagen Video
Gmail Incluido    
Hotel Incluido    
Local Incluido    
Text Incluido    
Expanded Text Incluido    
Expanded Dynamic Search Incluido    
Shopping Product Incluido    
Shopping Smart Incluido    
Call Only Incluido    
HTML5 Upload Incluido    
Dynamic HTML5 Incluido    
Responsive Search Incluido    
Legacy Responsive Search Incluido    
Legacy App Install Incluido    
Responsive Display   Incluido  
Video     Incluido
VIDEO BUMPER     Incluido
VIDEO NON SKIPPABLE IN STREAM     Incluido
VIDEO OUTSTREAM     Incluido
VIDEO TRUEVIEW DISCOVERY     Incluido
VIDEO TRUEVIEW IN STREAM     Incluido
VIDEO RESPONSIVE     Incluido
App (UAC) Incluido Incluido Incluido
App Engagement (UAC - deep linked ads) Incluido Incluido Incluido
APP PRE REGISTRATION Incluido Incluido Incluido

Nota: El nombre que Google usa para el tipo de anuncio (“App Engagement”, “Responsive Search”, etc.) no aparece en tus reportes de Singular. La dimensión Creative Type que ves en tus reportes no tiene relación: indica si el creativo es una imagen, un texto o un video.

Estoy extrayendo el desglose por país. ¿Por qué veo filas sin información de país?

Esto puede ocurrir cuando hay discrepancias entre los datos que Google proporciona en distintos endpoints para las mismas campañas.

Cuando Singular extrae datos de la API de Google Ads, realiza los siguientes pasos:

  1. Extrae los datos de tu desglose seleccionado del endpoint correspondiente de la API de Google Ads, en este caso el endpoint location_view, que proporciona la información de país.
  2. Extrae los datos de las mismas campañas del endpoint campaign de Google para obtener las métricas completas.
  3. Compara las métricas de cada campaña y, si es necesario, agrega una fila para alinear los datos. Consulta la ilustración de abajo para ver un ejemplo. Ten en cuenta que los datos a nivel de campaña se consideran la fuente de verdad.

Screen_Shot_2019-12-01_at_19.29.13.png

¿Por qué no puedo ver videos en mis reportes de creativos?

La política de privacidad de Google no nos permite descargar videos de YouTube. Por eso, para los creativos de video incluimos la miniatura del video más un enlace al video en YouTube.

¿Cuál es la diferencia entre video views y video views - 25%, 50%, 75%? ¿Puede video views ser mayor o menor que video views - completed?

La métrica video views es un recuento de cuántas reproducciones de video se iniciaron. Cuenta todas las impresiones de tu video, tanto si se vio por completo como si solo se miró un segundo.

Las métricas video views - 25%, 50%, and 75% calculan cuántas de esas impresiones correspondieron a personas que vieron tu video hasta el 25 %, el 50 % o el 75 %, respectivamente. De forma similar, la métrica completed video views solo calcula las impresiones en las que el video se vio por completo. Para calcular estos valores usamos la fórmula que sugiere Google: impressions * video_view_rate.

Según tus necesidades, quizá prefieras usar una de las métricas de porcentaje en lugar de la métrica de reproducciones de video. Consulta la sección "Video played to" en la documentación de Google.

Nota: Existe una discrepancia inherente entre las reproducciones de los videos en YouTube y las que se muestran en la cuenta de Google Ads. Las reproducciones de YouTube y las de la cuenta de Google Ads se calculan con métricas diferentes.

  • YouTube cuenta una reproducción cuando alguien ve el video durante al menos 30 segundos o hasta el final del video, lo que ocurra primero.
  • Google Ads cuenta una reproducción como una impresión del anuncio, que se contabiliza cuando el anuncio se muestra en YouTube o en un sitio asociado.
  • Como resultado, puede haber una diferencia entre las reproducciones reportadas en YouTube Analytics y las que se muestran en la cuenta de Google Ads.
  • Además, YouTube Analytics se actualiza en tiempo real, mientras que los datos de Google Ads pueden tardar hasta 48 horas en actualizarse.

Asimismo, los anuncios de YouTube y sus métricas de reproducción funcionan de forma distinta a la de los anuncios online tradicionales. Al publicar un anuncio en YouTube, solo se cobra cuando alguien lo ve durante 30 segundos o interactúa con él de algún modo, por ejemplo haciendo clic en una superposición de llamada a la acción o en un banner complementario. Por eso es importante centrarse en métricas de interacción, como la tasa de visualización (view-through rate) y las acciones ganadas (earned actions), en lugar de solo las reproducciones, para evaluar la eficacia de los anuncios de YouTube.

¿Por qué no puedo ver Media Bundles en mis reportes de creativos?

Un Media Bundle es otro tipo de creativo, junto con "Image", "Text" y "Video". Si alguno de tus creativos publicitarios es un media bundle, podrás ver las métricas de esos creativos, pero no el creativo en sí, porque la API de Google Ads no lo proporciona.

¿Por qué la dimensión Creative Name no siempre está disponible?

Para los creativos de UAC, Google no proporciona un nombre, solo un ID.