Guía de migración de Search Ads 360

El conector de Search Ads 360 (antes conocido como Doubleclick Search) se basa en la nueva API de Search Ads 360 Reporting. La API de Search Ads 360 Reporting anterior ya no es compatible, por lo que debes migrar los flujos de trabajo del Servicio de transferencia de datos de BigQuery para que sean compatibles con la nueva API de Search Ads 360 Reporting. En este documento, se muestran los cambios de la nueva experiencia de Search Ads 360 desde la anterior y se proporciona información de asignación para migrar los recursos existentes a la nueva experiencia de Search Ads 360.

Novedades de Search Ads 360

La nueva API de Search Ads 360 Reporting ofrece varios cambios que podrían afectar los flujos de trabajo existentes del Servicio de transferencia de datos de BigQuery.

Estructura de la cuenta

La nueva API de Search Ads 360 Reporting organiza las cuentas en una jerarquía de cuentas de administrador, de subadministrador y de cliente. Para obtener más información, consulta Diferencias en la jerarquía de la cuenta y Acerca de las cuentas de administrador.

Espacio de ID

Las entidades de la nueva experiencia de Search Ads 360 tienen una asignación de espacio de ID diferente al de las versiones anteriores de Search Ads 360. Para obtener información sobre la asignación entre IDs anteriores y nuevos, consulta Asignación de ID.

Informes basados en recursos

El nuevo modelo de datos de la API de Search Ads 360 usa un modelo de datos basado en recursos, en lugar de la API anterior 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 en la nueva API de Search Ads 360, consulta la estructura de la API de Search Ads 360 Reporting.

Migra configuraciones de transferencia

No hay un método automatizado para convertir las configuraciones de transferencia existentes de Search Ads 360 en la nueva API de Search Ads 360 Reporting. Debes crear una nueva transferencia de datos de Search Ads 360 con la nueva API de Search Ads 360 Reporting como la fuente de datos.

Revisa la información de asignación

Revisa la siguiente información de asignación para asignar tus recursos existentes de Search Ads 360 a la nueva API de Search Ads 360 Reporting.

Asignación de informes

Los nuevos informes de Search Ads 360 se basan en recursos y tienen una estructura diferente a los informes de la versión anterior. Para obtener una asignación completa de los informes antiguos y nuevos, consulta Asignaciones de informes de la API de Search Ads 360 Reporting.

La siguiente tabla enumera las tablas compatibles con el Servicio de transferencia de datos de BigQuery junto con los recursos consultados para generar las tablas.

Informe anterior de los anuncios de búsqueda Nuevo recurso de los anuncios de búsqueda Nuevo nombre de la 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
ad 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 recurso p_sa_Asset_customer_id
bidStrategy bidding_strategy p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
campaign campaign 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

El Servicio de transferencia de datos de BigQuery admite un subconjunto de campos de informes de Search Ads 360 como se indica en la transformación de informes de Search Ads 360. BigQuery no admite . en nombres de columna, por lo que todos los informes transferidos reemplazan . por _. Por ejemplo, el campo ad_group_ad.ad.text_ad.description1 en un recurso de Search Ads 360 se transfiere a BigQuery como ad_group_ad_ad_text_ad_description1.

Asignación de ID

Las entidades en la nueva experiencia de Search Ads 360, como los clientes, las campañas y los grupos de anuncios, tienen un espacio de ID diferente al de la versión anterior. Para obtener más información sobre las tablas de asignación de ID para la nueva experiencia de Search Ads 360, consulta Tablas de asignación de ID.

Ejemplos de consultas migradas

Los siguientes ejemplos muestran cómo puede verse una consulta de BigQuery antes y después de que se asigne a la nueva API de Search Ads 360 Reporting.

Considera la siguiente consulta de ejemplo que analiza el rendimiento de las campañas de Search Ads de los últimos 30 días con la API anterior de Search Ads 360 Reporting.

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 ser compatible con la nueva API de Search Ads 360 Reporting, 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 obtener más ejemplos de consultas compatibles con la nueva experiencia de Search Ads 360, visita Ejemplos de consultas.

¿Qué sigue?