Guía de migración de Search Ads 360
El conector de Search Ads 360 (anteriormente llamado DoubleClick Search) se basa en la nueva API Reporting de Search Ads 360. La antigua API Reporting de Search Ads 360 ya no se admite, por lo que debe migrar sus flujos de trabajo de BigQuery Data Transfer Service para que sean compatibles con la nueva API Reporting de Search Ads 360. En este documento se muestran los cambios de la nueva experiencia de Search Ads 360 con respecto a la antigua y se proporciona información sobre la asignación para migrar los recursos que ya tenga a la nueva experiencia de Search Ads 360.
Novedades de Search Ads 360
La nueva API Reporting de Search Ads 360 ofrece varios cambios que pueden afectar a sus flujos de trabajo de BigQuery Data Transfer Service.
Estructura de la cuenta
La nueva API de informes de Search Ads 360 organiza las cuentas en una jerarquía de cuentas de administrador, de subadministrador y de cliente. Para obtener más información, consulta las diferencias entre las jerarquías de cuentas y qué son las cuentas de administrador.
Espacio de identificación
Las entidades de la nueva experiencia de Search Ads 360 tienen una asignación de espacio de ID diferente a la de las versiones anteriores de Search Ads 360. Para obtener información sobre la asignación entre los IDs anteriores y los nuevos, consulta Asignación de IDs.
Informes basados en recursos
El nuevo modelo de datos de la API de Search Ads 360 usa un modelo de datos basado en recursos, a diferencia de la antigua API de Search Ads 360, que usa un modelo de datos basado en informes. El nuevo conector de la API de Search Ads 360 crea tablas de BigQuery consultando recursos en Search Ads 360. Para obtener más información sobre la estructura de los recursos de la nueva API de Search Ads 360, consulte Estructura de la API Reporting de Search Ads 360.
Migrar configuraciones de transferencia
No hay ningún método automatizado para convertir las configuraciones de transferencia de Search Ads 360 a la nueva API Reporting de Search Ads 360. Debe crear una transferencia de datos de Search Ads 360 con la nueva API de informes de Search Ads 360 como fuente de datos.
Revisar la información de la asignación
Consulta la siguiente información de asignación para asignar tus recursos de Search Ads 360 a la nueva API Reporting de Search Ads 360.
Asignación de informes
Los informes de la nueva experiencia de Search Ads 360 se basan en recursos y tienen una estructura diferente a los de la experiencia anterior. Para ver una asignación completa de los informes antiguos y nuevos, consulte Asignaciones de informes de la API Reporting de Search Ads 360.
En la siguiente tabla se enumeran las tablas admitidas por BigQuery Data Transfer Service junto con los recursos consultados para generar las tablas.
| Informe de la versión antigua de Search Ads | Nuevo recurso de anuncios de búsqueda | Nuevo nombre de tabla de BigQuery |
|---|---|---|
| adGroup | ad_group | p_sa_AdGroupStats_customer_id p_sa_AdGroup_customer_id p_sa_AdGroupDeviceStats_customer_id p_sa_AdGroupConversionActionAndDeviceStats_customer_id |
| anuncio | ad_group_ad | p_sa_AdConversionActionAndDeviceStats_customer_id p_sa_AdDeviceStats_customer_id p_sa_Ad_customer_id |
| N/A | ad_group_asset | p_sa_AdGroupAssetStats_customer_id p_sa_AdGroupConversionActionAndAssetStats_customer_id |
| N/A | ad_group_asset_set | p_sa_AdGroupAssetSet_customer_id |
| adGroupTarget | ad_group_audience_view | p_sa_AdGroupAudienceDeviceStats_customer_id p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id |
| adGroupTarget | ad_group_criterion | p_sa_NegativeAdGroupCriterion_customer_id p_sa_NegativeAdGroupKeyword_customer_id p_sa_AdGroupCriterion_customer_id |
| adGroupTarget | age_range_view | p_sa_AgeRangeDeviceStats_customer_id p_sa_AgeRangeConversionActionAndDeviceStats_customer_id |
| N/A | asset | p_sa_Asset_customer_id |
| bidStrategy | bidding_strategy | p_sa_BidStrategy_customer_id p_sa_BidStrategyStats_customer_id |
| campaña | campaña | p_sa_CampaignConversionActionAndDeviceStats_customer_id p_sa_Campaign_customer_id p_sa_CampaignDeviceStats_customer_id p_sa_CampaignStats_customer_id |
| N/A | campaign_asset | p_sa_CampaignAssetStats_customer_id p_sa_CampaignConversionActionAndAssetStats_customer_id |
| N/A | campaign_asset_set | p_sa_CampaignAssetSet_customer_id |
| campaignTarget | campaign_audience_view | p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id p_sa_CampaignAudienceDeviceStats_customer_id |
| campaignTarget | campaign_criterion | p_sa_CampaignCriterion_customer_id p_sa_NegativeCampaignKeyword_customer_id p_sa_NegativeCampaignCriterion_customer_id |
| productLeadAndCrossSell | cart_data_sales_view | p_sa_CartDataSalesStats_customer_id |
| conversión | conversión | p_sa_Conversion_customer_id |
| floodlightActivity | conversion_action | p_sa_ConversionAction_customer_id |
| cuenta | cliente | p_sa_Account_customer_id p_sa_AccountDeviceStats_customer_id p_sa_AccountConversionActionAndDeviceStats_customer_id p_sa_AccountStats_customer_id |
| N/A | customer_asset | p_sa_CustomerAssetStats_customer_id p_sa_CustomerConversionActionAndAssetStats_customer_id |
| N/A | customer_asset_set | p_sa_CustomerAssetSet_customer_id |
| adGroupTarget | gender_view | p_sa_GenderDeviceStats_customer_id p_sa_GenderConversionActionAndDeviceStats_customer_id |
| palabra clave | keyword_view | p_sa_Keyword_customer_id p_sa_KeywordDeviceStats_customer_id p_sa_KeywordStats_customer_id p_sa_KeywordConversionActionAndDeviceStats_customer_id |
| adGroupTarget | location_view | p_sa_LocationDeviceStats_customer_id p_sa_LocationConversionActionAndDeviceStats_customer_id |
| productAdvertised | shopping_performance_view | p_sa_ProductAdvertised_customer_id p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id p_sa_ProductAdvertisedDeviceStats_customer_id |
| productGroup | product_group_view | p_sa_ProductGroupStats_customer_id p_sa_ProductGroup_customer_id |
| visita | visita | p_sa_Visit_customer_id |
| adGroupTarget | webpage_view | p_sa_WebpageDeviceStats_customer_id p_sa_WebpageConversionActionAndDeviceStats_customer_id |
Asignación de campos
BigQuery Data Transfer Service admite un subconjunto de campos de informes de Search Ads 360, tal como se indica en Transformación de informes de Search Ads 360.
BigQuery no admite . en los nombres de las columnas, por lo que en todos los informes transferidos se sustituye . por _. Por ejemplo, el campo ad_group_ad.ad.text_ad.description1 de un recurso de Search Ads 360 se transfiere a BigQuery como ad_group_ad_ad_text_ad_description1.
Asignación de IDs
Las entidades de la nueva experiencia de Search Ads 360, como los clientes, las campañas y los grupos de anuncios, tienen un espacio de IDs diferente al de la antigua experiencia de Search Ads 360. Para obtener más información sobre las tablas de asignación de IDs de la nueva experiencia de Search Ads 360, consulte Tablas de asignación de IDs.
Ejemplos de consultas migradas
En los siguientes ejemplos se muestra cómo podría ser una consulta de BigQuery antes y después de asignarse a la nueva API Reports de Search Ads 360.
Consulta el siguiente ejemplo de consulta que analiza el rendimiento de una campaña de búsqueda de los últimos 30 días mediante la antigua API de informes de Search Ads 360.
SELECT c.accountId, c.campaign, C.status, SUM(cs.impr) AS Impressions, SUM(cs.clicks) AS Clicks, (SUM(cs.cost) / 1000000) AS Cost FROM `previous_dataset.Campaign_advertiser_id` c LEFT JOIN `previous_dataset.CampaignStats_advertiser_id` cs ON (c.campaignId = cs.campaignId AND cs._DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)) WHERE c._DATA_DATE = c._LATEST_DATE GROUP BY 1, 2, 3 ORDER BY Impressions DESC
Cuando se asigna para que sea compatible con la API de informes de la nueva experiencia de Search Ads 360, la misma consulta se convierte en lo siguiente:
SELECT c.customer_id, c.campaign_name, C.campaign_status, SUM(cs.metrics_impressions) AS Impressions, SUM(cs.metrics_clicks) AS Clicks, (SUM(cs.metrics_cost_micros) / 1000000) AS Cost FROM `new_dataset.sa_Campaign_customer_id` c LEFT JOIN `new_dataset.sa_CampaignStats_customer_id` cs ON (c.campaign_id = cs.campaign_id AND cs._DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY)) WHERE c._DATA_DATE = c._LATEST_DATE GROUP BY 1, 2, 3 ORDER BY Impressions DESC
Para ver más ejemplos de consultas compatibles con la nueva experiencia de Search Ads 360, consulte Consultas de ejemplo.
Siguientes pasos
- Para saber cómo programar y gestionar tareas de carga periódicas desde Search Ads 360, consulte Transferencias de Search Ads 360.
- Para saber cómo transformar sus informes de Search Ads 360, consulte el artículo Transformación de informes de Search Ads 360.