Configurar el conector de datos
Configurar acciones de conversión
Detalles rápidos
Tecnología del conector dedatos | API (Google Ads API v10) |
Desglose de datos (segmentación) |
En la configuración por defecto, sus datos se desglosan por:
Para elegir una configuración diferente, consulte Mapeo de datosa continuación. |
Retroceso de los datos | Todos los días, Singular extrae datos de 7 días atrás. Una vez a la semana, los lunes, Singular extrae datos de 30 días atrás. |
Zona horaria | Definida por el cliente en la configuración de Google, por cuenta. |
¿Están disponibles los datos a nivel creativo (anuncio)? | Sí |
¿Muestra Singular sus activos creativos? | Sí (excepto los vídeos de YouTube, para los que Singular sólo muestra miniaturas). |
Limitaciones conocidas |
|
Asignación de datos
Puede obtener sus datos en una de varias configuraciones de desglose, cada una proporcionando un conjunto diferente de dimensiones y cada una con sus propias ventajas y limitaciones.
- La configuración por defecto es País. Para elegir una diferente, póngase en contacto con el soporte de Singular.
- La configuración Metro (DMA ) sólo es útil para la publicidad basada en EE.UU., (la información DMA sólo está disponible en EE.UU.). Si algunas o todas sus campañas operan fuera de EE.UU., utilice en su lugar la configuración Ciudad.
- Las configuraciones de palabras clave y editores no incluyen datos para campañas UAC debido a las limitaciones de Google Ads API.
- Aunque las configuraciones de palabras clave y editores no incluyen el país ni otras dimensiones de ubicación, Singular puede proporcionar el país en función de la configuración de países objetivo.
Consejos sobre terminología:
- Creative de Singular corresponde a Ad de Google Ads.
- La nueva dimensión de Activo de Singular corresponde al Activo de Google Ads. Hemos añadido este nuevo nivel de granularidad porque en Google, algunos tipos de anuncios, como los anuncios UAC (aplicación móvil), contienen múltiples activos.
- Para obtener descripciones de todos los campos de los informes de Singular, consulte el Glosario de métricas y dimensiones de Singular.
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 |
Field in Singular UI | Field in Singular API | Field in Google Metro 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 |
DMA Name |
dma_name_field |
geo_target_metro |
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 |
Region |
region_field |
geo_target_state |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
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 |
Field in Singular UI | Field in Singular API | Field in Google City 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 |
City |
city_field |
geo_target_city |
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 |
Region |
region_field |
geo_target_region |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
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 |
Field in Singular UI | Field in Singular API | Field in Google Keyword 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 |
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 |
Keyword | keyword | ad_group_criterion.keyword.text |
Keyword ID | keyword_id | ad_group_criterion.criterion_id |
Keyword Match Type | keyword_match_type | ad_group_criterion.keyword.match_type |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
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 |
Field in Singular UI | Field in Singular API | Field in Google Keyword + Quality Score 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 |
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 |
Keyword | keyword | ad_group_criterion.keyword.text |
Keyword ID | keyword_id | ad_group_criterion.criterion_id |
Keyword Match Type | keyword_match_type | ad_group_criterion.keyword.match_type |
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 |
Quality Score |
quality_score |
historicalQualityScore |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Search Impression Share (Google) | search_impression_share | search_impression_share |
Search Top Impression Share (Google) | search_top_impression_share | search_top_impression_share |
Search Absolute Top Impression Share (Google) | search_absolute_top_impression_share | search_absolute_top_impression_share |
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 |
Field in Singular UI | Field in Singular API | Field in Google Publisher 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 |
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 |
Publisher Site Name | publisher_site_name | adGroupCriterion.placement.url |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
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 |
Field in Singular UI | Field in Singular API | Field in Google Shopping 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”) |
Brand | brand | brand |
Campaign URL | adn_campaign_url | ad.finalUrl if not available, then ad.trackingUrlTemplate |
City |
city_field |
geo_target_city |
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 |
DMA Name |
dma_name_field |
geo_target_metro |
Final URL | final_url | campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls |
Keyword | keyword | ad_group_criterion.keyword.text |
Merchant ID | merchant_id | merchant_id |
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 |
Product Item ID | product_item_id | product_item_id |
Public Id | site_public_id | campaign.appCampaignSetting.appId |
Publisher Site Name | publisher_site_name | adGroupCriterion.placement.url |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
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 |
Field in Singular UI | Field in Singular API | Field in Google Video 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 |
City |
city_field |
geo_target_city |
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 |
DMA Name |
dma_name_field |
geo_target_metro |
Final URL | final_url | campaign.finalUrls OR adGroupCriterion.finalUrls OR adGroup.ad.finalUrls |
Keyword | keyword | ad_group_criterion.keyword.text |
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 |
Publisher Site Name | publisher_site_name | adGroupCriterion.placement.url |
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 (with some extra logic) |
Tracking URL | tracking_url | adGroupAd.ad.trackingUrlTemplate |
Video ID | video_id | video_id |
Video Channel ID | video_channel_id | video_channel_id |
Video Duration Millis | video_duration_millis | video_duration_millis |
Video Title | video_title | video_title |
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 |
Instrucciones especiales de configuración
Autenticación
Consulte las preguntas frecuentes sobre conectores de datos para obtener información general sobre la configuración de un conector de datos.
Cuando configure el conector de datos de AdWords, se le pedirá que acceda con una cuenta de Google Ads. Le recomendamos encarecidamente que acceda con una cuenta de Google Ads Manager (anteriormente conocida como cuenta MCC).
Una cuenta de Administrador de Google (MCC) nos da acceso a todas sus cuentas de publicidad a la vez. A continuación, puede elegir de la lista qué cuentas desea incluir en sus informes de Singular. Si no utilizas una cuenta Manager (MCC), tendrás que añadir un conector de datos independiente para cada cuenta publicitaria.
Para localizar su ID de cliente (tanto para cuentas de gestor como para cuentas individuales)
- Acceda a su cuenta de Google Ads.
- Haga clic en el icono de ayuda situado en la esquina superior derecha.
- Busque ID de cliente en la parte inferior del menú.
Eventos de conversión
Además de las métricas predeterminadas de la tabla anterior, Singular puede extraer cualquier métrica que necesite de Google Ads y mostrar sus estadísticas en los informes de Singular.
Si desea obtener información más detallada a nivel de activo, considere la posibilidad de añadir "biddable-app-post-install-conversion" como evento. Estos datos se obtienen de la API de Google Ad. Esta función le permite obtener datos adicionales sobre eventos de "acciones dentro de la aplicación" en sus respectivas campañas. Es importante tener en cuenta que los eventos de conversión carecen de datos de cohorte y sólo se asocian con el periodo de cohorte "real"."
Para configurar eventos de conversión en Singular, siga los siguientes pasos:
- En Singular, vaya a Configuración > Eventos. Si tiene las pestañas Eventos personalizados y Eventos de conversión, seleccione Eventos de conversión.
- Haga clic en Nuevo evento.
-
En el menú desplegable de AdWords, verá una lista de las métricas disponibles de AdWords. Puede asignar cada actividad a un evento de Singular independiente o combinar varias métricas en un único evento.
Al día siguiente, cuando Singular extraiga los datos diarios de su cuenta, también extraerá las estadísticas de estas actividades.
- Una vez que Singular haya rellenado los nuevos eventos de conversión con algunos datos, cuando ejecute un informe en la página Informes, seleccione los eventos de conversión en el menú desplegable Eventos.
Preguntas frecuentes y solución de problemas
Para localizar su ID de cliente (tanto para cuentas de administrador como individuales):
- Accede a tu cuenta de Google Ads.
- Haga clic en el icono de ayuda situado en la esquina superior derecha.
- Busque ID de cliente en la parte inferior del menú.
Para obtener más información, consulte Acerca de las cuentas de administrador de anuncios de Googleen la documentación de Google.
En su cuenta del Administrador de anuncios de Google, vaya a Configuración> Configuración de red. Asegúrate de haber activado el acceso a la API. A continuación, intenta volver a autenticar tu cuenta de Google Ads Manager en Singular.
Cuando se utiliza un desglose que no proporciona información sobre el país, Singular intenta proporcionar la granularidad del país de todos modos, consultando la configuración de orientación de la campaña en Google y/o los datos del rastreador (si los tenemos):
- Si la campaña está dirigida a un país, mostraremos ese país en el informe.
- Si la campaña está dirigida a varios países y también disponemos de datos de seguimiento de la misma campaña, calcularemos el coste por país en función de la proporción de instalaciones por país en los datos de seguimiento. Consulte ¿Cómo se calcula la métrica Coste por país?
Google Ads realiza un seguimiento de diferentes tipos de lo que denomina "acciones de conversión", como descargas de aplicaciones, registros de usuarios, compras y mucho más. Por defecto, dado que la mayoría de nuestros clientes están interesados en las instalaciones de aplicaciones, extraemos las conversiones del tipo descarga y mostramos sus métricas en el campo Instalaciones de red de nuestros informes.
Nota: Instalaciones de red es una métrica de Singular que refleja el número de instalaciones notificadas por la red publicitaria, que no debe confundirse con Instalaciones, que normalmente se basa en datos del rastreador de atribución. Para Adwords, Instalaciones de red es el número de conversiones "first_open" notificadas por Adwords.
Al crear una consulta de informe, puede seleccionar Instalaciones de red en la sección Métricas de origen . Consulte ¿Qué son las métricas de origen?para obtener más información.
Sí, Singular extrae métricas creativas, así como las propias creatividades (imágenes, textos, vídeos, etc.). Esto es así tanto si utiliza la versión antigua de la integración de AdWords como la nueva. Sin embargo, sólo la nueva integración muestra las creatividades de las campañas UAC.
El Creativo de Singular corresponde al Anuncio de Google Ads.
La nueva dimensión Activo de Singular corresponde al Activo de Google Ads. Hemos añadido este nuevo nivel de granularidad porque en Google, algunos tipos de anuncios, como los anuncios UAC (aplicación móvil), contienen múltiples activos. Las instalaciones informadas para el activo se extraen de la métrica "biddable_app_install_conversions"; que es diferente de otras granularidades que utilizan"metrics.conversions".
Singular admite los siguientes tipos de anuncios de Google:
Tipo de anuncio | Activo(s) publicitario(s) incluido(s) | ||
Texto | Imagen | Vídeo | |
Gmail | |||
Hotel | |||
Local | |||
Texto | |||
Texto ampliado | |||
Búsqueda dinámica ampliada | |||
Compras de productos | |||
Compras inteligentes | |||
Sólo llamadas | |||
Carga HTML5 | |||
HTML5 dinámico | |||
Búsqueda responsiva | |||
Búsqueda responsiva heredada | |||
Instalación de aplicaciones heredadas | |||
Pantalla responsiva | |||
Vídeo | |||
VIDEO PARACHOQUES | |||
VIDEO NO SALTABLE EN STREAM | |||
VÍDEO EN FLUJO SALIENTE | |||
VIDEO TRUEVIEW DISCOVERY | |||
VIDEO TRUEVIEW IN STREAM | |||
VIDEO RESPONSIVE | |||
App ( UAC) | |||
App Engagement (UAC - anuncios deep linked) | |||
PRERREGISTRO DE APLICACIONES |
Nota: el nombre de Google para el tipo de anuncio ("App Engagement", "Responsive Search", etc.) no aparece en sus informes Singular. La dimensión Tipo de creatividad que ve en sus informes no está relacionada: muestra si la creatividad es una imagen, un texto o un vídeo.
Esto puede ocurrir cuando hay discrepancias entre los datos que Google proporciona en diferentes endpoints para las mismas campañas.
Cuando Singular extrae datos de Google Ads API, realiza los siguientes pasos:
- Extrae los datos del desglose seleccionado del punto final de Google Ads API correspondiente, en este caso, el punto final location_view, que proporciona información sobre el país.
- Extrae los datos de las mismas campañas del punto final de campañade Google para obtener las métricas completas.
- Compara las métricas de cada campaña y, si es necesario, añade una fila para alinear los datos. En la siguiente ilustración se muestra un ejemplo. Ten en cuenta que los datos a nivel de campaña se consideran la fuente de la verdad.
La política de privacidad de Google no nos permite descargar vídeos de YouTube. Por lo tanto, para las creatividades de vídeo, incluimos la miniatura del vídeo + un enlace al vídeo en YouTube.
La métrica de visualizaciones de vídeo es un recuento de cuántas visualizaciones de vídeo se iniciaron. Cuenta todas las impresiones de su vídeo, tanto si el vídeo se ha visto en su totalidad como si sólo se ha mirado durante un segundo.
Las métricas de visionados de vídeo - 25%, 50% y 75% calculan cuántas de esas impresiones fueron personas que vieron su vídeo hasta la marca del 25%, 50% o 75% respectivamente. Del mismo modo, la métrica de visionados de vídeo completados sólo calcula las impresiones en las que el vídeo se ha visto en su totalidad. Para calcular estos valores, utilizamos la fórmula sugerida por Google: impresiones * tasa_vista_vídeo.
En función de tus necesidades, es posible que desees utilizar una de las métricas de porcentaje en lugar de la métrica de visualizaciones de vídeo. Consulta la sección "Vídeo reproducido hasta" en la documentación de Google.
Nota: existe una discrepancia inherente entre las vistas de los vídeos de YouTube y las vistas mostradas en la cuenta de Google Ads. Las visualizaciones de YouTube y las visualizaciones de la cuenta de Google Ads se calculan utilizando métricas diferentes.
- YouTube cuenta una visualización como alguien que ve el vídeo durante al menos 30 segundos o hasta el final del vídeo, lo que ocurra primero.
- Google Ads cuenta una visualización como una impresión de anuncio que se contabiliza cuando el anuncio se muestra en YouTube o en un sitio asociado.
- Como resultado, es posible que veamos una diferencia entre las visualizaciones indicadas en los análisis de YouTube y las visualizaciones mostradas en la cuenta de Google Ads.
- Además, los análisis de YouTube se actualizan en tiempo real, mientras que los datos de Google Ads pueden tardar hasta 48 horas en actualizarse.
Además, los anuncios de YouTube y las métricas de visitas funcionan de forma diferente a los anuncios online tradicionales. Cuando se publica un anuncio en YouTube, sólo se cobra cuando alguien ve el anuncio durante 30 segundos o interactúa con él de alguna manera, por ejemplo, haciendo clic en una llamada a la acción o en un banner complementario. Por lo tanto, es importante centrarse en las métricas de participación, como el porcentaje de visionados y las acciones ganadas, en lugar de sólo en los visionados para medir la eficacia de los anuncios de YouTube.
Un paquete de medios es otro tipo de creatividad, junto con "Imagen", "Texto" y "Vídeo". Si alguna de las creatividades de sus anuncios son paquetes de medios, podrá ver las métricas de estas creatividades, pero no la creatividad en sí, ya que la API de anuncios de Google no proporciona la creatividad.
Para las creatividades UAC, Google no proporciona un nombre, sólo un ID.