Registro de mudanças da fonte de dados do serviço de transferência de dados do BigQuery
Nesta página, você encontra detalhes sobre as mudanças nos esquemas de origem de dados e nos mapeamentos de esquema do serviço de transferência de dados do BigQuery. Para informações sobre as próximas mudanças nos conectores do serviço de transferência de dados do BigQuery, pesquise nesta página fontes de dados, como Google Ads API
ou Display & Video 360 API
, ou nomes ou valores de tabelas específicos.
Campaign Manager 360
O conector do serviço de transferência de dados do BigQuery para o Campaign Manager 360 é atualizado periodicamente para oferecer suporte a colunas novas, descontinuadas ou migradas. O conector do serviço de transferência de dados do BigQuery para o Campaign Manager 360 recupera dados dos arquivos de transferência de dados do Campaign Manager 360.
As seções a seguir descrevem as mudanças. As mudanças são organizadas por data de lançamento, e cada entrada fornece informações sobre as mudanças que você precisa fazer para continuar recebendo dados do Campaign Manager 360.
7 de julho de 2025
O Campaign Manager 360 fez um anúncio para atualizar os IDs de critério para navegador, sistema operacional, marca e modelo do dispositivo móvel e dados do ISP para se alinhar aos padrões de dados multiplataforma. Após a migração, o Campaign Manager 360 vai parar de preencher valores para as colunas descontinuadas e vai começar a preencher as novas colunas. As colunas afetadas são:
Colunas suspensas | 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 conector do serviço de transferência de dados do BigQuery para o Display & Video 360 é atualizado periodicamente para oferecer suporte a novas colunas e se adaptar às mudanças introduzidas pelas novas versões da API do Display & Video 360. O conector do serviço de transferência de dados do BigQuery para o Display & Video 360 usa a versão compatível da API para extrair dados de configuração.
As seções a seguir descrevem as mudanças ao atualizar para uma nova versão da API Display & Video 360. As mudanças são organizadas por data de lançamento, e cada entrada fornece informações sobre as alterações que você precisa fazer para continuar recebendo dados do Display & Video 360.
26 de agosto de 2025
O conector do Display & Video 360 planeja atualizar a versão da API do Display & Video 360 usada para recuperar dados de configuração de v3 para v4. As mudanças do upgrade da API estão listadas na seção a seguir. Para mais informações, consulte o guia de migração da API Display & Video 360 v3 para v4.
Essa atualização do conector do Display & Video 360 está prevista para começar em 26 de agosto de 2025.
Tabelas descontinuadas
As tabelas a seguir vão parar de receber novos dados. Os dados atuais vão permanecer, mas não haverá mais atualizações.
CampaignTargeting
InsertionOrderTargeting
Tabelas com colunas renomeadas
Tabelas afetadas | Colunas suspensas | Novas colunas |
---|---|---|
|
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 suspensas |
---|---|
Creative
|
reviewStatus.publisherReviewStatuses |
API Google Ads
O serviço de transferência de dados do BigQuery para Google Ads é atualizado periodicamente para oferecer suporte a novas colunas e se adaptar às mudanças introduzidas pelas novas versões da API Google Ads. O conector do serviço de transferência de dados do BigQuery para Google Ads usa a versão compatível da API no conector do Google Ads.
As seções a seguir descrevem as mudanças ao atualizar para uma nova versão da API Google Ads. As mudanças são organizadas por data de lançamento, e cada entrada fornece informações sobre as alterações que você precisa fazer para continuar recebendo dados do Google Ads.
Para mais informações sobre a programação de lançamentos da API Google Ads, consulte os Horários.
1 de agosto de 2025
As transferências do Google Ads planejam atualizar a versão da API Google Ads de v18 para v20. Após o upgrade da API, os valores das colunas dos dados recém-transferidos nas tabelas afetadas vão mudar. Para mais informações, consulte Upgrade da API Google Ads.
Tabela: p_ads_Ad_customer_id
Colunas afetadas | Tipo de dado descontinuado |
---|---|
ad_group_type | VIDEO_OUTSTREAM |
ad_group_ad_ad_type | VIDEO_OUTSTREAM |
Tabela: p_ads_Campaign_customer_id
Colunas afetadas | Tipo de dado descontinuado |
---|---|
campaign_advertising_channel_sub_type | VIDEO_OUTSTREAM |
Tabela: p_ads_DisplayVideoKeywordStats_customer_id
Colunas afetadas | Tipo de dado descontinuado |
---|---|
campaign_advertising_channel_sub_type | VIDEO_OUTSTREAM |
20 de janeiro de 2025
As transferências do Google Ads planejam atualizar a versão da API Google Ads de v16 para v18. Após o upgrade da API, os valores das colunas dos dados recém-transferidos nas tabelas afetadas vão mudar. Para mais informações, consulte Upgrade da API Google Ads.
Essa atualização do conector do Google Ads começou em 20 de janeiro de 2025 e foi concluída em 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 suas consultas funcionem após a atualização, mude-as para selecionar os valores antigos e novos. Por exemplo, se você tiver a seguinte condição WHERE
na sua consulta SQL:
WHERE asset_type='DISCOVERY_CAROUSEL_CARD'
Substitua pela seguinte instrução:
WHERE asset_type='DISCOVERY_CAROUSEL_CARD' OR asset_type='DEMAND_GEN_CAROUSEL_CARD'
24 de Junho de 2024
As transferências do Google Ads planejam atualizar a versão da API Google Ads da v14 para a v16. Nessa 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 obsoletas. Para mais informações, consulte Upgrade da API Google Ads.
Essa atualização do conector do Google Ads começou em 17 de junho de 2024 e foi concluída em 23 de junho de 2024.
Tabelas afetadas | Colunas suspensas | Novas colunas |
---|---|---|
|
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 |
|
|
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 |
|
|
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, novas colunas, como segments_product_category_level1
e segments_product_category_level2
, foram adicionadas ao esquema da tabela do BigQuery, mas foram preenchidas com null
. Com a atualização para a API Google Ads v16, essas novas colunas serão 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 continuar no esquema da tabela.
Em cada par de colunas, apenas uma coluna é preenchida com valores da API Google Ads, enquanto a outra é preenchida com null
. Para garantir que suas consultas atuais continuem funcionando após a atualização, atualize-as para escolher uma das duas colunas. Por exemplo, se você tiver a seguinte instrução na sua consulta SQL:
segments_product_bidding_category_level1
Substitua pela seguinte instruçã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 sempre usarão as novas colunas. As colunas descontinuadas vão permanecer no esquema da tabela, mas preenchidas com null
.
API Google Analytics
O conector do serviço de transferência de dados do BigQuery para Google Analytics é atualizado periodicamente para oferecer suporte a novas colunas e se adaptar às mudanças introduzidas pelas novas versões da API Google Analytics Data. O conector do serviço de transferência de dados do BigQuery para Google Analytics usa a versão mais recente compatível da API para extrair dados de relatórios.
As seções a seguir descrevem as mudanças ao atualizar para uma nova versão da API de dados do Google Analytics. As mudanças são organizadas por data de lançamento, e cada entrada fornece informações sobre as alterações que você precisa fazer para continuar recebendo dados do Google Analytics.
22 de setembro de 2025
O conector do Google Analytics planeja descontinuar tabelas e atualizar esquemas para refletir as mudanças na API Google Analytics Data v1. Essas mudanças estão listadas nas seções a seguir.
Essa atualização do conector do Google Analytics está prevista para começar em 22 de setembro de 2025.
Tabelas descontinuadas
A tabela a seguir mostra as tabelas que serão descontinuadas e substituídas por novas tabelas com esquemas atualizados. As tabelas p_ga4_conversions
e p_ga4_inAppPurchases
serão descontinuadas após essa atualização. As tabelas novas e descontinuadas serão preenchidas até 22 de setembro de 2025 para permitir tempo para a migração. É possível filtrar tabelas descontinuadas usando a opção Filtro de tabela na configuração de 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 tabela atualizados
Os novos esquemas de tabela podem ser encontrados na página Transformação de relatórios do Google Analytics.
Resumo das alterações do esquema:
- Esquemas corrigidos:os esquemas dos relatórios de aquisição de tráfego, aquisição de usuários e página de destino foram corrigidos. Por exemplo, os esquemas dos relatórios de aquisição de tráfego e de usuários foram trocados, e o relatório de página de destino não tinha a dimensão
landingPage
. - Renomeação e descontinuação de campos:o campo "Conversões" foi renomeado como
keyEvents
em todos os relatórios para se alinhar à terminologia atual do Google Analytics. Como consequência, o próprio relatório "Conversões" foi desativado. - Mudanças no tipo de dados:os campos de receita mudam de
INTEGER
paraFLOAT
no BigQuery para representar com precisão os microvalores de ponto flutuante retornados pela API. - Nova convenção de nomenclatura de tabelas e campos:os nomes dos campos em novas tabelas usam
camelCase
(por exemplo,eventCount
) para consistência com a API Google Analytics, substituindo osnake_case
anterior (por exemplo,event_count
).
API YouTube Reporting
Os conectores do serviço de transferência de dados do BigQuery para proprietário de conteúdo do YouTube e para canal do YouTube são atualizados periodicamente para oferecer suporte a novos relatórios introduzidos pela API Reporting do YouTube e descontinuar os antigos.
As seções a seguir descrevem as mudanças quando novos relatórios são introduzidos pela API YouTube Reporting. As mudanças são organizadas por data de lançamento, e cada entrada fornece informações sobre as mudanças que você precisa fazer para continuar recebendo 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 planejam lançar novos relatórios e descontinuar os antigos para refletir a mudança na contagem de visualizações dos Shorts do YouTube. Essas mudanças estão listadas nas seções a seguir.
Os novos relatórios estão programados para começar em 7 de julho de 2025. Você não precisa fazer nada para receber os novos relatórios. A descontinuação dos relatórios antigos está prevista para começar em 22 de setembro de 2025.
Conector do proprietário do conteúdo do YouTube: tabelas descontinuadas
Para o conector do proprietário do conteúdo do YouTube, a tabela a seguir mostra as tabelas do BigQuery que serão descontinuadas e substituídas por novas tabelas com esquemas atualizados. As tabelas descontinuadas e novas serão preenchidas até 22 de setembro de 2025 para permitir a migração. Após 22 de setembro de 2025, apenas as novas tabelas serão preenchidas. O valor de suffix é o sufixo da tabela que você configurou ao criar 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 |
Conector do canal do YouTube: tabelas descontinuadas
Para o conector de canais do YouTube, a tabela a seguir mostra as tabelas do BigQuery que serão descontinuadas e substituídas por novas tabelas com esquemas atualizados. As tabelas descontinuadas e novas serão preenchidas até 22 de setembro de 2025 para permitir a migração. Após 22 de setembro de 2025, apenas as novas tabelas serão preenchidas. O valor de suffix é o sufixo da tabela que você configurou ao criar 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 tabela atualizados
As novas tabelas terão uma coluna chamada engaged_views
. Para mais informações sobre essa métrica, consulte Mudanças na contagem de visualizações dos Shorts.