Esta página foi traduzida pela API Cloud Translation.

Registro de mudança da origem de dados do serviço de transferência de dados do BigQuery

Nesta página, você encontra detalhes sobre mudanças nos esquemas e mapeamentos de esquemas da fonte de dados do serviço de transferência de dados do BigQuery. Para saber mais 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 Facebook Ads API, ou nomes de tabela ou valores específicos.

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 da API com suporte 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.

20 de janeiro de 2025

O Google Ads Transfers planeja atualizar a versão da API Google Ads da v16 para a v18. Após o upgrade da API, os valores das colunas dos dados transferidos nas tabelas afetadas vão mudar. Para mais informações, consulte o Upgrade da API Google Ads.

Data de início desejada: 20 de janeiro de 2025
Data de entrega: pendente

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

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 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 têm planos de atualizar a versão da API Google Ads da v14 para a v16. Neste upgrade da API, os nomes das colunas dos dados recém-transferidos nas tabelas afetadas são alterados. Além disso, algumas colunas foram descontinuadas. Para mais informações, consulte o Upgrade da API Google Ads.

Data de início desejada: 17 de junho de 2024
Data de entrega: 23 de junho de 2024

Tabelas afetadas	Colunas suspensas	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, 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.