Transformação de relatórios de anúncios do Facebook

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Nota: para receber apoio técnico ou enviar feedback sobre esta funcionalidade, contacte [e-mail].

Este documento descreve como os seus relatórios do Facebook Ads são transformados quando executa uma transferência do Facebook Ads para o BigQuery.

Mapeamento de tabelas para relatórios de anúncios do Facebook

Quando os relatórios do Facebook Ads são transferidos para o BigQuery, são transformados nas seguintes tabelas e vistas do BigQuery.

Relatório AdAccounts

Nome do campo da API Meta	Nome do campo do BigQuery mapeado	Tipo	Descrição
id	ID [CHAVE]	String	O ID da conta de publicidade.
	Destino	String	O alvo usado para obter contas de anúncios. Este valor é "null" para obter todas as contas de publicidade.
account_id	AccountId	String	O ID da conta de anúncios quando visualizada diretamente no Facebook.
account_status	AccountStatus	Inteiro	Estado da conta. 1 = Ativa, 2 = Desativada, 3 = Não liquidada, 7 = Revisão pendente, 9 = Período de tolerância, 101 = Temporariamente indisponível, 100 = Encerramento pendente.
age	Idade	Duplo	O tempo que a conta de publicidade está aberta, em dias.
amount_spent	AmountSpent	Inteiro	Valor total atual gasto pela conta. Pode repor esta definição.
balance	Equilíbrio	Inteiro	Valor da fatura em dívida.
business_city	BusinessCity	String	Cidade da morada da empresa.
business_country_code	BusinessCountryCode	String	Código do país da morada da empresa.
business_name	BusinessName	String	O nome da empresa para a conta.
business_state	BusinessState	String	Abreviatura do estado da morada da empresa.
business_street	BusinessStreet	String	Primeira linha da morada da empresa da conta.
business_street2	BusinessStreet2	String	Segunda linha da morada da empresa para a conta.
business_zip	BusinessZip	String	Código postal da morada da empresa.
capabilities	Capacidades	String	Capacidades permitidas para esta conta de publicidade.
created_time	CreatedTime	Data/hora	A hora em que a conta foi criada.
currency	Moeda	String	A moeda usada para a conta, com base no valor correspondente nas definições da conta.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	String	O limite de gastos mínimo do grupo de campanhas.
name	Nome	String	Nome da conta. Tenha em atenção que muitas contas não têm nome, pelo que este campo pode estar vazio.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	String	Indica se o contrato dos Termos de Utilização do píxel externo foi assinado.
owner	OwnerId	String	ID do Facebook do proprietário da conta de publicidade.
spend_cap	SpendCap	Inteiro	O valor máximo que esta conta pode gastar, após o qual as campanhas são pausadas. Um valor de 0 significa que não existe limite de gastos.
timezone_id	TimezoneId	String	ID do fuso horário.
timezone_name	TimezoneName	String	Nome do fuso horário.
timezone_offset_hours_utc	TimezoneOffsetHoursUTC	Duplo	Diferença de fuso horário em relação ao UTC.

Relatório AdInsights

Nome do campo da API Meta	Nome do campo do BigQuery mapeado	Tipo	Descrição
	Destino	String	O ID da conta para a qual quer obter estatísticas.
date_start	DateStart	Data	A data de início para obter estatísticas. Na IU do Facebook, este é o campo Início do relatório.
date_stop	DateEnd	Data	A data de fim para obter estatísticas. Na IU do Facebook, este é o campo Fim do relatório.
	TimeIncrement	String	O número de dias de agregação de dados. Este valor está definido como 1.
	Nível	String	O nível ao qual representar os resultados. Este valor está definido como "ad".
account_currency	AccountCurrency	String	A moeda que está a ser usada pela conta de publicidade.
action_attribution_windows	ActionAttributionWindows	String	Uma lista separada por vírgulas que determina o período de atribuição para as ações. Por exemplo, 28d_click significa que a API devolve todas as ações que ocorreram 28 dias depois de alguém clicar no anúncio. Esta opção está definida como [1d_view,28d_click].
account_id	AdAccountId	String	O ID da conta de anúncios associada à linha do relatório.
account_name	AdAccountName	String	O nome da conta de anúncios associada à linha do relatório.
campaign_id	CampaignId	String	O ID da campanha associada à linha do relatório.
campaign_name	CampaignName	String	O nome da campanha associada à linha do relatório.
adset_id	AdSetId	String	O ID do conjunto de anúncios associado à linha do relatório.
adset_name	AdSetName	String	O nome do conjunto de anúncios associado à linha do relatório.
ad_id	AdId	String	O ID do anúncio associado à linha do relatório.
ad_name	AdName	String	O nome do anúncio associado à linha do relatório.
buying_type	BuyingType	String	O método pelo qual os anúncios segmentados são pagos nas suas campanhas.
clicks	Cliques	Longo	O número total de cliques no seu anúncio. Consoante o que está a promover, isto pode incluir gostos na página, respostas a eventos ou instalações de apps. Na IU do Facebook, este é o campo Cliques (tudo).
conversion_rate_ranking	ConversionRateRanking	String	A classificação da taxa de conversão.
cost_per_estimated_ad_recallers	CostPerEstimatedAdRecallers	Decimal	O custo médio por pessoa adicional que estimamos que se lembre de ter visto o seu anúncio se lhe for perguntado no prazo de 2 dias.
cost_per_inline_link_click	CostPerInlineLinkClick	Decimal	O custo médio por clique em links no anúncio.
cost_per_inline_post_engagement	CostPerInlinePostEngagement	Decimal	O custo por interação médio na publicação.
cost_per_unique_click	CostPerUniqueClick	Decimal	O custo médio por clique único para estes anúncios, calculado como o valor gasto dividido pelo número de cliques únicos recebidos.
cost_per_unique_inline_link_click	CostPerUniqueInlineLinkClick	Decimal	A média que pagou por cada clique único em link inline.
cpc	CPC (Custo por Clique)	Decimal	O custo por clique médio destes anúncios, calculado como o valor gasto dividido pelo número de cliques recebidos.
cpm	CPM	Decimal	O custo médio que pagou para ter 1000 impressões no seu anúncio.
cpp	CPP (Custo por Telefonema)	Decimal	O custo médio que pagou para que o seu anúncio fosse publicado para 1000 pessoas únicas.
ctr	Taxa de cliques (CTR)	Duplo	O número de cliques que recebeu dividido pelo número de impressões. Na IU do Facebook, este é o campo CTR (tudo) %.
estimated_ad_recall_rate	EstimatedAdRecallRate	Duplo	O número estimado de pessoas que se lembram do seu anúncio dividido pelo número de pessoas alcançadas pelo anúncio.
estimated_ad_recallers	EstimatedAdRecallers	Duplo	O número adicional de pessoas que estimamos que se vão lembrar de ter visto os seus anúncios se lhes for perguntado no prazo de 2 dias.
frequency	Frequência	Duplo	O número médio de vezes que o seu anúncio foi publicado para cada pessoa.
impressions	Impressões	Longo	O número de vezes que o seu anúncio foi publicado. Em apps para dispositivos móveis, um anúncio é contabilizado como publicado na primeira vez que é visto. Em todas as outras interfaces do Facebook, um anúncio é publicado na primeira vez que é colocado no Feed de notícias de uma pessoa ou sempre que é colocado na coluna da direita.
inline_link_clicks	InlineLinkClicks	Longo	Número total de cliques em links no anúncio.
inline_link_click_ctr	InlineLinkClicksCounter	Duplo	A taxa de cliques para cliques inline no link.
inline_post_engagement	InlinePostEngagement	Longo	O número total de interações na publicação.
instant_experience_clicks_to_open	InstantExperienceClicksToOpen	Longo	Corresponde ao campo instant_experience_clicks_to_open da API META.
instant_experience_clicks_to_start	InstantExperienceClicksToStart	Longo	Corresponde ao campo instant_experience_clicks_to_start da API META.
instant_experience_outbound_clicks	InstantExperienceOutboundClicks	Longo	Corresponde ao campo instant_experience_outbound_clicks da API META.
objective	Objetivo	String	O objetivo que selecionou para a campanha. O objetivo reflete o objetivo que quer alcançar com a sua publicidade.
quality_ranking	QualityRanking	String	A classificação de qualidade.
reach	Alcance	Longo	O número de pessoas para as quais o anúncio foi publicado.
spend	Gastos	Decimal	O valor total que gastou até agora.
	UniqueClicks	Longo	O número total de pessoas únicas que clicaram no seu anúncio. Por exemplo, se 3 pessoas clicarem no mesmo anúncio 5 vezes, conta como 3 cliques únicos.
	UniqueCTR	Duplo	O número de pessoas que clicaram no seu anúncio dividido pelo número de pessoas que alcançou. Por exemplo, se recebeu 20 cliques únicos e o seu anúncio foi publicado para 1000 pessoas únicas, a taxa de cliques únicos seria de 2%.
inline_link_clicks	UniqueInlineLinkClicks	Longo	O número de cliques únicos em links incorporados que o seu anúncio recebeu. Na IU do Facebook, este é o campo Cliques únicos no link.
	UniqueInlineLinkClickCounter	Duplo	A taxa de cliques únicos em links incorporados.
	UniqueLinkClicksCounter	Duplo	A taxa de cliques única para cliques no link. O número de pessoas que clicaram no link no seu anúncio que direciona as pessoas para fora do Facebook, dividido pelo número de pessoas que alcançou. Por exemplo, se recebeu 20 cliques únicos no link e o seu anúncio foi apresentado a 1000 pessoas únicas, a taxa de cliques única seria de 2%.
	Check-ins	Int	O número de check-ins atribuídos ao anúncio.
	EventResponses	Int	O número de respostas a eventos atribuídas ao anúncio.
inline_link_clicks	LinkClicks	Int	O número de cliques no link atribuídos ao anúncio.
	OfferSaves	Int	O número de ofertas recebidas atribuídas ao anúncio.
outbound_clicks	OutboundClicks	Int	O número de cliques de saída atribuídos ao anúncio.
	PageEngagements	Int	O número de interações com a página atribuídas ao anúncio.
	PageLikes	Int	O número de gostos na página atribuídos ao anúncio.
	PageMentions	Int	O número de menções de páginas atribuídas ao anúncio.
	PagePhotoViews	Int	O número de visualizações de fotos atribuídas ao anúncio.
	PostComments	Int	O número de comentários da publicação atribuídos ao anúncio.
	PostEngagements	Int	O número de interações com a publicação atribuídas ao anúncio.
	PostShares	Int	O número de partilhas de publicações atribuídas ao anúncio.
	PostReactions	Int	O número de reações a publicações atribuídas ao anúncio.
	PageTabViews	Int	O número de visualizações de separadores atribuídas ao anúncio.
	Região	String	A região a partir da qual alguém viu o anúncio. Este é um campo de discriminação.
	Video3SecondViews	Int	O número de visualizações de vídeo atribuídas ao anúncio. As visualizações são contabilizadas se tiverem sido vistos, pelo menos, 3 segundos ou o vídeo completo (se o vídeo tiver menos de 3 segundos).
Análises detalhadas genéricas
	Idade	String	A faixa etária das métricas nesta linha.
	Género	String	O sexo para as métricas nesta linha.
	País	String	O país para as métricas nesta linha.
	Região	String	A região a partir da qual alguém viu o anúncio.
	FrequencyValue	String	O número de vezes que um anúncio na sua campanha de alcance e frequência foi publicado para cada pessoa.
	HStatsByAdvertiserTZ	String	Período durante o qual as estatísticas foram recolhidas para o anunciante.
	HStatsByAudienceTZ	String	Período durante o qual as estatísticas foram recolhidas para o público.
	ImpressionDevice	String	Os dispositivos usados para ver o anúncio.
	PlatformPosition	String	A posição na plataforma.
	PublisherPlatform	String	As plataformas nas quais os anúncios foram publicados.
	ProductId	String	O ID do produto anunciado no anúncio.

Relatório AdInsightsActions

ACTION_COLLECTION refere-se aos tipos de ações que as pessoas realizaram em resposta ao seu anúncio. Para ver uma lista completa de coleções de ações, consulte o artigo Coleções de ações.

Nome do campo da API Meta	Nome do campo do BigQuery mapeado	Tipo	Descrição
	Destino	String	O ID da conta para a qual quer obter estatísticas.
date_start	DateStart	Data	A data de início para obter estatísticas. Na IU do Facebook, este é o campo Início do relatório.
date_stop	DateEnd	Data	A data de fim para obter estatísticas. Na IU do Facebook, este é o campo Fim do relatório.
	TimeIncrement	String	O número de dias de agregação de dados. Este valor está definido como 1.
	Nível	String	O nível ao qual representar os resultados. O valor está definido como ad.
action_attribution_windows	ActionAttributionWindows	String	Uma lista separada por vírgulas que determina qual é o período de atribuição para as ações. Por exemplo, 28d_click significa que a API devolve todas as ações que ocorreram 28 dias depois de alguém clicar no anúncio. A opção predefinida significa [1d_view,7d_click]. Os valores possíveis incluem 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click e default.
	ActionCollection	String	Isto resulta da sua escolha de coleções de ações na transferência.
account_id	AdAccountId	String	O ID da conta de anúncios associada à linha do relatório.
account_name	AdAccountName	String	O nome da conta de anúncios associada à linha do relatório.
campaign_id	CampaignId	String	O ID da campanha associada à linha do relatório.
campaign_name	CampaignName	String	O nome da campanha associada à linha do relatório.
adset_id	AdSetId	String	O ID do conjunto de anúncios associado à linha do relatório.
adset_name	AdSetName	String	O nome do conjunto de anúncios associado à linha do relatório.
ad_id	AdId	String	O ID do anúncio associado à linha do relatório.
ad_name	AdName	String	O nome do anúncio associado à linha do relatório.
ACTION_COLLECTION.value	ActionValue	Inteiro	Valor da métrica da janela de atribuição predefinida.
ACTION_COLLECTION.1d_click	Action1dClick	String	Valor da métrica da janela de atribuição 1 dia após clicar no anúncio.
ACTION_COLLECTION.1d_view	Action1dView	String	Valor da métrica do intervalo de atribuição 1 dia após a visualização do anúncio.
ACTION_COLLECTION.7d_click	Action7dClick	String	Valor da métrica da janela de atribuição 7 dias após clicar no anúncio.
ACTION_COLLECTION.7d_view	Action7dView	String	Valor da métrica do intervalo de atribuição 7 dias após a visualização do anúncio.
ACTION_COLLECTION.28d_click	Action28dClick	String	Valor da métrica do intervalo de atribuição 28 dias após clicar no anúncio.
ACTION_COLLECTION.28d_view	Action28dView	String	Valor da métrica do intervalo de atribuição 28 dias após a visualização do anúncio.
ACTION_COLLECTION.dda	ActionDDA	String	Valor da métrica da janela de atribuição baseada no modelo com orientação por dados.
Análises detalhadas genéricas
	Idade	String	A faixa etária das métricas nesta linha.
	Género	String	O sexo para as métricas nesta linha.
	País	String	O país para as métricas nesta linha.
	Região	String	A região a partir da qual alguém viu o anúncio.
	FrequencyValue	String	O número de vezes que um anúncio na sua campanha de alcance e frequência foi publicado para cada pessoa.
	HStatsByAdvertiserTZ	String	Período durante o qual as estatísticas foram recolhidas para o anunciante.
	HStatsByAudienceTZ	String	Período durante o qual as estatísticas foram recolhidas para o público.
	ImpressionDevice	String	Os dispositivos usados para ver o anúncio.
	PlatformPosition	String	A posição na plataforma.
	PublisherPlatform	String	As plataformas nas quais os anúncios foram publicados.
	ProductId	String	O ID do produto anunciado no anúncio.
Detalhes das ações
	ActionType	String	O tipo de ações realizadas no seu anúncio depois de este ter sido publicado para alguém, mesmo que essa pessoa não tenha clicado no anúncio.
	ActionCanvasComponentName	String	Nome de um componente num anúncio do Canvas.
	ActionCarouselCardId	String	O ID do cartão do carrossel específico com o qual as pessoas interagiram quando viram o seu anúncio.
	ActionCarouselCardName	String	O cartão específico do carrossel com o qual as pessoas interagiram quando viram o seu anúncio. Os cartões são identificados pelos respetivos títulos.
	ActionDestination	String	O destino para onde as pessoas são direcionadas depois de clicarem no seu anúncio.
	ActionDevice	String	O dispositivo no qual ocorreu o evento de conversão que está a acompanhar.
	ActionReaction	String	O número de reações nos seus anúncios ou publicações otimizadas.
	ActionTargetId	String	O ID do destino para onde as pessoas são direcionadas depois de clicarem no seu anúncio.
	ActionVideoSound	String	O estado do som (ativado/desativado) quando o utilizador vê o seu anúncio de vídeo.
	ActionVideoType	String	Análise detalhada das métricas de vídeo.
	ActionConvertedProductId	String	IDs de produtos convertidos: para anúncios colaborativos.