Registo de alterações da origem de dados do Serviço de transferência de dados do BigQuery

Esta página fornece detalhes sobre as alterações aos esquemas das origens de dados do Serviço de transferência de dados do BigQuery e aos mapeamentos de esquemas. Para obter informações sobre as próximas alterações aos conetores do Serviço de transferência de dados do BigQuery, pode pesquisar nesta página origens de dados, como Google Ads API ou Display & Video 360 API, ou nomes de tabelas ou valores específicos.

Campaign Manager 360

O conetor do Serviço de transferência de dados do BigQuery para o Campaign Manager 360 é atualizado periodicamente para suportar colunas novas, descontinuadas ou migradas. O conector do Serviço de transferência de dados do BigQuery para o Campaign Manager 360 extrai dados dos ficheiros de transferência de dados do Campaign Manager 360.

As secções seguintes descrevem as alterações. As alterações estão organizadas por data de lançamento e cada entrada fornece informações sobre as alterações que tem de fazer para continuar a receber dados do Campaign Manager 360.

7 de julho de 2025

O Campaign Manager 360 fez um anúncio para atualizar os respetivos IDs de critérios para navegador, sistema operativo, marca e modelo de dispositivos móveis, e dados de ISP de forma a alinharem-se com as normas de dados multiplataforma. Após a migração, o Campaign Manager 360 vai deixar de preencher valores para colunas descontinuadas e vai começar a preencher as novas colunas. As colunas afetadas são as seguintes:

Colunas descontinuadas Novas colunas
DBM_Browser_Platform_ID DV360_Browser_Platform_Reportable_ID
DBM_ISP_ID DV360_ISP_Reportable_ID
DBM_Operating_System_ID DV360_Operating_System_Reportable_ID
DBM_Mobile_Make_ID DV360_Mobile_Make_Reportable_ID
DBM_Mobile_Model_ID DV360_Mobile_Model_Reportable_ID

API Display & Video 360

O conetor do Serviço de transferência de dados do BigQuery para o Display & Video 360 é atualizado periodicamente para suportar novas colunas e adaptar-se às alterações introduzidas pelas novas versões da API Display & Video 360. O conetor do Serviço de transferência de dados do BigQuery para o Display & Video 360 usa a versão da API suportada para obter dados de configuração.

As secções seguintes descrevem as alterações quando faz a atualização para uma nova versão da API Display & Video 360. As alterações estão organizadas por data de lançamento e cada entrada fornece informações sobre as alterações que tem de fazer para continuar a receber dados do Display & Video 360.

26 de agosto de 2025

O conetor do Display & Video 360 planeia atualizar a versão da API Display & Video 360 usada para obter dados de configuração de v3 para v4. As alterações da atualização da API estão listadas na secção seguinte. Para mais informações, consulte o guia de migração da API Display & Video 360 v3 para v4.

Esta atualização do conetor do Display & Video 360 está planeada para começar a 26 de agosto de 2025.

Tabelas descontinuadas

As seguintes tabelas vão deixar de receber novos dados. Os dados existentes vão permanecer, mas não vão ser preenchidas mais atualizações.

  • CampaignTargeting
  • InsertionOrderTargeting

Tabelas com colunas renomeadas

Tabelas afetadas Colunas descontinuadas Novas colunas
  • AdGroupTargeting
  • LineItemTargeting
 audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.firstAndThirdPartyAudienceId audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.recency audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.recency
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.firstAndThirdPartyAudienceId audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.recency audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.recency

Tabelas com colunas descontinuadas

Tabelas afetadas Colunas descontinuadas
Creative reviewStatus.publisherReviewStatuses

O Serviço de transferência de dados do BigQuery para o Google Ads é atualizado periodicamente para suportar novas colunas e adaptar-se às alterações introduzidas pelas novas versões da API Google Ads. O conetor do Serviço de transferência de dados do BigQuery para o Google Ads usa a versão da API suportada no conetor do Google Ads.

As secções seguintes descrevem as alterações quando atualiza para uma nova versão da API Google Ads. As alterações estão organizadas por data de lançamento e cada entrada fornece informações sobre as alterações que tem de fazer para continuar a receber dados do Google Ads.

Para mais informações sobre o calendário de lançamentos da API Google Ads, consulte o calendário.

1 de agosto de 2025

As transferências do Google Ads planeiam atualizar a versão da API Google Ads de v18 para v20. Após a atualização da API, os valores das colunas dos dados transferidos recentemente nas tabelas afetadas vão mudar. Para mais informações, consulte o artigo Atualização da API Google Ads.

Tabela: p_ads_Ad_customer_id

Colunas afetadas Tipo de dados descontinuado
ad_group_type VIDEO_OUTSTREAM
ad_group_ad_ad_type VIDEO_OUTSTREAM

Tabela: p_ads_Campaign_customer_id

Colunas afetadas Tipo de dados descontinuado
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

Tabela: p_ads_DisplayVideoKeywordStats_customer_id

Colunas afetadas Tipo de dados descontinuado
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

20 de janeiro de 2025

O Google Ads transfers planeia atualizar a versão da API Google Ads de v16 para v18. Após a atualização da API, os valores das colunas dos dados transferidos recentemente nas tabelas afetadas vão mudar. Para mais informações, consulte o artigo Atualização da API Google Ads.

Esta atualização do conetor do Google Ads começou a 20 de janeiro de 2025 e foi concluída a 4 de fevereiro de 2025.

Tabela: p_ads_Campaign_customer_id

Colunas afetadas Valor antigo (v16) Novo valor (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

Tabela: p_ads_Ad_customer_id

Colunas afetadas Valor antigo (v16) Novo valor (v18)
ad_type

DISCOVERY_MULTI_ASSET_AD

DISCOVERY_CAROUSEL_AD

DISCOVERY_VIDEO_RESPONSIVE_AD

DEMAND_GEN_MULTI_ASSET_AD

DEMAND_GEN_CAROUSEL_AD

DEMAND_GEN_VIDEO_RESPONSIVE_AD

Tabela: Asset

Colunas afetadas Valor antigo (v16) Novo valor (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

Para garantir que as suas consultas funcionam após a atualização, altere-as para selecionar os valores antigos e novos. Por exemplo, se tiver a seguinte condição WHERE na sua consulta SQL:

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

Substitua pela seguinte declaração:

WHERE
  asset_type='DISCOVERY_CAROUSEL_CARD'
  OR asset_type='DEMAND_GEN_CAROUSEL_CARD'

24 de junho de 2024

Os transferências do Google Ads planeiam atualizar a versão da API Google Ads de v14 para v16. Nesta atualização da API, os nomes das colunas dos dados transferidos recentemente nas tabelas afetadas são alterados. Além disso, algumas colunas estão descontinuadas. Para mais informações, consulte o artigo Atualização da API Google Ads.

Esta atualização do conetor do Google Ads começou a 17 de junho de 2024 e foi concluída a 23 de junho de 2024.

Tabelas afetadas Colunas descontinuadas Novas colunas
  • ShoppingProductStats
  • ShoppingProductConversionStats
 segments_product_bidding_category_level1 segments_product_category_level1
segments_product_bidding_category_level2 segments_product_category_level2
segments_product_bidding_category_level3 segments_product_category_level3
segments_product_bidding_category_level4 segments_product_category_level4
segments_product_bidding_category_level5 segments_product_category_level5
  • ProductGroupStats
 ad_group_criterion_listing_group_case_value_product_bidding_category_id ad_group_criterion_listing_group_case_value_product_category_category_id
ad_group_criterion_listing_group_case_value_product_bidding_category_level ad_group_criterion_listing_group_case_value_product_category_level
  • AssetGroupListingFilter
 asset_group_listing_group_filter_case_value_product_bidding_category_id asset_group_listing_group_filter_case_value_product_category_category_id
asset_group_listing_group_filter_case_value_product_bidding_category_level asset_group_listing_group_filter_case_value_product_category_level
asset_group_listing_group_filter_vertical asset_group_listing_group_filter_listing_source

Com a API Google Ads v14, foram adicionadas novas colunas, como segments_product_category_level1 e segments_product_category_level2, ao esquema da tabela do BigQuery, mas foram preenchidas com null. Com a atualização para a v16 da API Google Ads, estas novas colunas vão ser preenchidas com novos valores. As colunas descontinuadas, como segments_product_bidding_category_level1 e segments_product_bidding_category_level2, vão ser preenchidas com null, mas vão permanecer no esquema da tabela.

Para cada par de colunas, apenas uma coluna é preenchida com valores da API Google Ads, enquanto a outra é preenchida com null. Para garantir que as suas consultas existentes continuam a funcionar após a atualização, atualize-as para escolher uma das duas colunas. Por exemplo, se tiver a seguinte declaração na sua consulta SQL:

segments_product_bidding_category_level1

Substitua-o pela seguinte declaração que especifica a coluna correta:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

As configurações de transferência criadas após 24 de junho de 2024 vão usar sempre as novas colunas. As colunas descontinuadas permanecem no esquema da tabela, mas são preenchidas com null.

API Google Analytics

O conetor do Serviço de transferência de dados do BigQuery para o Google Analytics é atualizado periodicamente para suportar novas colunas e adaptar-se às alterações introduzidas pelas novas versões da API Google Analytics Data. O conetor do Serviço de transferência de dados do BigQuery para o Google Analytics usa a versão da API suportada mais recente para obter dados de relatórios.

As secções seguintes descrevem as alterações quando atualiza para uma nova versão da API Google Analytics Data. As alterações estão organizadas por data de lançamento e cada entrada fornece informações sobre as alterações que tem de fazer para continuar a receber dados do Google Analytics.

22 de setembro de 2025

O conector do Google Analytics planeia descontinuar tabelas e atualizar esquemas para refletir as alterações na API Google Analytics Data v1. Estas alterações estão listadas nas secções seguintes.

Esta atualização do conetor do Google Analytics está planeada para começar a 22 de setembro de 2025.

Tabelas descontinuadas

A tabela seguinte mostra as tabelas que vão ser descontinuadas e substituídas por novas tabelas com esquemas atualizados. Tenha em atenção que as tabelas p_ga4_conversions e p_ga4_inAppPurchases vão ser descontinuadas após esta atualização. As tabelas descontinuadas e novas vão ser preenchidas até 22 de setembro de 2025 para permitir tempo para a migração. Pode filtrar tabelas descontinuadas através da opção Filtro de tabelas na configuração da transferência.

Tabela descontinuada Nova tabela
p_ga4_audiences p_ga4_Audiences
p_ga4_conversions Deprecated
p_ga4_demographicDetails p_ga4_DemographicDetails
p_ga4_ecommercePurchase p_ga4_EcommercePurchase
p_ga4_events p_ga4_Events
p_ga4_inAppPurchases Deprecated
p_ga4_landingPage p_ga4_LandingPage
p_ga4_pagesAndScreens p_ga4_PagesAndScreens
p_ga4_promotions p_ga4_Promotions
p_ga4_techDetails p_ga4_TechDetails
p_ga4_trafficAcquisition p_ga4_TrafficAcquisition
p_ga4_userAcquisition p_ga4_UserAcquisition

Esquemas de tabelas atualizados

Pode encontrar novos esquemas de tabelas na página Transformação de relatórios do Google Analytics.

Resumo das alterações ao esquema:

  • Esquemas corrigidos: os esquemas dos relatórios de aquisição de tráfego, aquisição de utilizadores e página de destino foram corrigidos. Por exemplo, os esquemas dos relatórios Aquisição de tráfego e Aquisição de utilizadores foram trocados anteriormente, e o relatório Página de destino não tinha a dimensão landingPage.
  • Mudança de nome e descontinuação de campos: o nome do campo de conversões é alterado para keyEvents em todos os relatórios para se alinhar com a terminologia atual do Google Analytics. Consequentemente, o próprio relatório "conversões" é descontinuado.
  • Alterações ao tipo de dados: os campos de receita mudam de INTEGER para FLOAT no BigQuery para representar com precisão os microvalores de vírgula flutuante devolvidos pela API.
  • Nova convenção de nomenclatura de tabelas e campos: os nomes dos campos nas novas tabelas usam camelCase (por exemplo, eventCount) para consistência com a API Google Analytics, substituindo o snake_case anterior (por exemplo, event_count).

API YouTube Reporting

O conector do Serviço de transferência de dados do BigQuery para proprietários de conteúdo do YouTube e o conector do canal do YouTube são atualizados periodicamente para suportar novos relatórios introduzidos pela API YouTube Reporting e descontinuar relatórios antigos.

As secções seguintes descrevem as alterações quando são introduzidos novos relatórios pela API YouTube Reporting. As alterações estão organizadas por data de lançamento e cada entrada fornece informações sobre as alterações que tem de fazer para continuar a receber dados do YouTube.

22 de setembro de 2025

O conector do proprietário do conteúdo do YouTube e o conector do canal do YouTube planeiam introduzir novos relatórios e descontinuar os relatórios antigos para refletir a alteração da contagem de visualizações do YouTube Shorts. Estas alterações estão listadas nas secções seguintes.

Os novos relatórios vão começar a ser gerados a 7 de julho de 2025. Não é necessária nenhuma ação da sua parte para receber os novos relatórios. A descontinuação dos relatórios antigos está prevista para começar a 22 de setembro de 2025.

Conetor do proprietário do conteúdo do YouTube – tabelas descontinuadas

Para o conector de proprietário de conteúdo do YouTube, a tabela seguinte mostra as tabelas do BigQuery que vão ser descontinuadas e substituídas por novas tabelas com esquemas atualizados. As tabelas descontinuadas e novas vão ser preenchidas até 22 de setembro de 2025 para dar tempo para a migração. Após 22 de setembro de 2025, apenas as novas tabelas vão ser preenchidas. O valor de suffix é o sufixo da tabela que configurou quando criou a transferência.

Tabela descontinuada Nova tabela
p_content_owner_asset_basic_a2_suffix p_content_owner_asset_basic_a3_suffix
p_content_owner_asset_combined_a2_suffix p_content_owner_asset_combined_a3_suffix
p_content_owner_asset_device_os_a2_suffix p_content_owner_asset_device_os_a3_suffix
p_content_owner_asset_playback_location_a2_suffix p_content_owner_asset_playback_location_a3_suffix
p_content_owner_asset_province_a2_suffix p_content_owner_asset_province_a3_suffix
p_content_owner_asset_traffic_source_a2_suffix p_content_owner_asset_traffic_source_a3_suffix
p_content_owner_basic_a3_suffix p_content_owner_basic_a4_suffix
p_content_owner_combined_a2_suffix p_content_owner_combined_a3_suffix
p_content_owner_device_os_a2_suffix p_content_owner_device_os_a3_suffix
p_content_owner_playback_location_a2_suffix p_content_owner_playback_location_a3_suffix
p_content_owner_playlist_basic_a1_suffix p_content_owner_playlist_basic_a2_suffix
p_content_owner_playlist_combined_a1_suffix p_content_owner_playlist_combined_a2_suffix
p_content_owner_playlist_device_os_a1_suffix p_content_owner_playlist_device_os_a2_suffix
p_content_owner_playlist_playback_location_a1_suffix p_content_owner_playlist_playback_location_a2_suffix
p_content_owner_playlist_province_a1_suffix p_content_owner_playlist_province_a2_suffix
p_content_owner_playlist_traffic_source_a1_suffix p_content_owner_playlist_traffic_source_a2_suffix
p_content_owner_province_a2_suffix p_content_owner_province_a3_suffix
p_content_owner_subtitles_a2_suffix p_content_owner_subtitles_a3_suffix
p_content_owner_traffic_source_a2_suffix p_content_owner_traffic_source_a3_suffix
p_content_owner_shorts_ad_revenue_summary_a1_suffix p_content_owner_shorts_ad_revenue_summary_a2_suffix
p_content_owner_shorts_country_ad_revenue_summary_a1_suffix p_content_owner_shorts_country_ad_revenue_summary_a2_suffix
p_content_owner_shorts_day_ad_revenue_summary_a1_suffix p_content_owner_shorts_day_ad_revenue_summary_a2_suffix
p_content_owner_shorts_global_ad_revenue_summary_a1_suffix p_content_owner_shorts_global_ad_revenue_summary_a2_suffix

Conetor do canal do YouTube – tabelas descontinuadas

Para o conetor do canal do YouTube, a tabela seguinte mostra as tabelas do BigQuery que vão ser descontinuadas e substituídas por novas tabelas com esquemas atualizados. As tabelas descontinuadas e novas vão ser preenchidas até 22 de setembro de 2025 para dar tempo para a migração. Após 22 de setembro de 2025, apenas as novas tabelas vão ser preenchidas. O valor de suffix é o sufixo da tabela que configurou quando criou a transferência.

Tabela descontinuada Nova tabela
p_channel_basic_a2_suffix p_channel_basic_a3_suffix
p_channel_combined_a2_suffix p_channel_combined_a3_suffix
p_channel_device_os_a2_suffix p_channel_device_os_a3_suffix
p_channel_playback_location_a2_suffix p_channel_playback_location_a3_suffix
p_channel_province_a2_suffix p_channel_province_a3_suffix
p_channel_subtitles_a2_suffix p_channel_subtitles_a3_suffix
p_channel_traffic_source_a2_suffix p_channel_traffic_source_a3_suffix
p_playlist_basic_a1_suffix p_playlist_basic_a2_suffix
p_playlist_combined_a1_suffix p_playlist_combined_a2_suffix
p_playlist_device_os_a1_suffix p_playlist_device_os_a2_suffix
p_playlist_playback_location_a1_suffix p_playlist_playback_location_a2_suffix
p_playlist_province_a1_suffix p_playlist_province_a2_suffix
p_playlist_traffic_source_a1_suffix p_playlist_traffic_source_a2_suffix

Esquemas de tabelas atualizados

As novas tabelas vão ter uma nova coluna denominada engaged_views. Para mais informações sobre esta métrica, consulte o artigo Alterações à contagem de visualizações de vídeos curtos.