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

Pré-lançamento

Este recurso está sujeitos aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter suporte limitado. Você encontra mais detalhes nas descrições das fases de lançamento.

Observação: para receber suporte ou enviar feedback sobre esse recurso, entre em contato com [e-mail].

Neste documento, descrevemos como seus relatórios do Facebook Ads são transformados quando você executa uma transferência do Facebook Ads para o BigQuery.

Mapeamento de tabelas em relatórios do Facebook Ads

Com a transferência para o BigQuery, seus relatórios do Facebook Ads são transformados nas tabelas e visualizações mostradas a seguir.

Relatório AdAccounts

Nome do campo da API Meta	Nome do campo mapeado do BigQuery	Tipo	Descrição
id	ID [KEY]	String	O ID da conta de anúncios.
	Destino	String	O destino usado para receber contas de anúncios. Esse valor é "null" para receber todas as contas de anúncios.
account_id	AccountId	String	O ID da conta de anúncios quando visualizada diretamente no Facebook.
account_status	AccountStatus	Número inteiro	Status da conta. 1 = Ativo, 2 = Desativado, 3 = Não resolvido, 7 = Revisão pendente, 9 = Em período de carência, 101 = Temporariamente indisponível, 100 = Fechamento pendente.
age	Idade	Double	É o tempo em dias que a conta de anúncios está aberta.
amount_spent	AmountSpent	Número inteiro	Valor total gasto pela conta. Isso pode ser redefinido.
balance	Saldo	Número inteiro	Valor da fatura pendente.
business_city	BusinessCity	String	Cidade do endereço comercial.
business_country_code	BusinessCountryCode	String	Código do país do endereço comercial.
business_name	BusinessName	String	O nome da empresa da conta.
business_state	BusinessState	String	Abreviatura do estado para o endereço comercial.
business_street	BusinessStreet	String	Primeira linha do endereço comercial da conta.
business_street2	BusinessStreet2	String	Segunda linha do endereço da empresa para a conta.
business_zip	BusinessZip	String	CEP do endereço comercial.
capabilities	Recursos	String	Recursos permitidos para esta conta de anúncios.
created_time	CreatedTime	Data/hora	A hora em que a conta foi criada.
currency	Moeda	String	A moeda usada na conta, com base no valor correspondente nas configurações da conta.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	String	O limite mínimo de gasto do grupo de campanhas.
name	Nome	String	Nome da conta. Muitas contas não têm nome, então esse campo pode estar vazio.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	String	Indica se o contrato dos Termos de Serviço do pixel externo foi assinado.
owner	OwnerId	String	ID do Facebook do proprietário da conta de anúncios.
spend_cap	SpendCap	Número inteiro	O valor máximo que pode ser gasto por essa conta antes que as campanhas sejam pausadas. Um valor de 0 significa que não há 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	Double	Diferença de fuso horário do UTC.

Relatório AdInsights

Nome do campo da API Meta	Nome do campo mapeado do BigQuery	Tipo	Descrição
	Destino	String	O ID da conta para receber insights.
date_start	DateStart	Data	A data de início para recuperar insights. Na interface do Facebook, esse é o campo "Início do relatório".
date_stop	DateEnd	Data	A data de término para recuperar insights. Na interface do Facebook, esse é o campo "Fim do relatório".
	TimeIncrement	String	O número de dias de agregação de dados. Esse valor é definido como 1.
	Nível	String	O nível em que os resultados serão representados. Esse valor é definido como "ad".
account_currency	AccountCurrency	String	A moeda usada pela conta de anúncios.
action_attribution_windows	ActionAttributionWindows	String	Uma lista separada por vírgulas que determina qual é a janela de atribuição das ações. Por exemplo, "28d_click" significa que a API retorna todas as ações que ocorreram 28 dias depois que alguém clicou no anúncio. Essa opção é definida como [1d_view,28d_click].
account_id	AdAccountId	String	O ID da conta de anúncio 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 de pagamento dos anúncios segmentados nas suas campanhas.
clicks	Cliques	Long	O número total de cliques no seu anúncio. Dependendo do que você está promovendo, isso pode incluir curtidas na página, respostas a eventos ou instalações de apps. Na interface do Facebook, esse é o campo "Cliques (todos)".
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 vai se lembrar de ter visto seu anúncio se for questionada em até dois dias.
cost_per_inline_link_click	CostPerInlineLinkClick	Decimal	O custo médio por clique nos links do anúncio.
cost_per_inline_post_engagement	CostPerInlinePostEngagement	Decimal	É o custo médio por engajamento na postagem.
cost_per_unique_click	CostPerUniqueClick	Decimal	O custo médio por clique único desses anúncios, calculado como o valor gasto dividido pelo número de cliques únicos recebidos.
cost_per_unique_inline_link_click	CostPerUniqueInlineLinkClick	Decimal	O valor médio que você pagou por cada clique único em um link inline.
cpc	CPC	Decimal	O custo médio por clique desses anúncios, calculado como o valor gasto dividido pelo número de cliques recebidos.
cpm	CPM	Decimal	O custo médio pago por mil impressões do seu anúncio.
cpp	CPP (custo por chamada telefônica)	Decimal	O custo médio pago para veicular seu anúncio a mil pessoas únicas.
ctr	CTR	Double	O número de cliques recebidos dividido pelo número de impressões. Na interface do Facebook, esse é o campo "CTR (todos) %".
estimated_ad_recall_rate	EstimatedAdRecallRate	Double	O número estimado de pessoas que se lembram do seu anúncio dividido pelo número de pessoas que ele alcançou.
estimated_ad_recallers	EstimatedAdRecallers	Double	O número adicional de pessoas que estimamos que vão se lembrar de ter visto seus anúncios se forem questionadas em até dois dias.
frequency	Frequência	Double	O número médio de vezes que seu anúncio foi veiculado para cada pessoa.
impressions	Impressões	Long	O número de vezes que seu anúncio foi veiculado. Em apps para dispositivos móveis, um anúncio é contado como veiculado na primeira vez em que é visualizado. Em todas as outras interfaces do Facebook, um anúncio é veiculado na primeira vez que aparece no Feed de Notícias de uma pessoa ou sempre que é colocado na coluna da direita.
inline_link_clicks	InlineLinkClicks	Long	Número total de cliques nos links do anúncio.
inline_link_click_ctr	InlineLinkClicksCounter	Double	A taxa de cliques para cliques inline em links.
inline_post_engagement	InlinePostEngagement	Long	O número total de interações na postagem.
instant_experience_clicks_to_open	InstantExperienceClicksToOpen	Long	Corresponde ao campo "instant_experience_clicks_to_open" da API META.
instant_experience_clicks_to_start	InstantExperienceClicksToStart	Long	Corresponde ao campo "instant_experience_clicks_to_start" da API META.
instant_experience_outbound_clicks	InstantExperienceOutboundClicks	Long	Corresponde ao campo "instant_experience_outbound_clicks" da API META.
objective	Objetivo	String	O objetivo selecionado para sua campanha. Seu objetivo reflete a meta que você quer alcançar com a publicidade.
quality_ranking	QualityRanking	String	A classificação de qualidade.
reach	Alcance	Long	O número de pessoas para quem seu anúncio foi veiculado.
spend	Gasto	Decimal	O valor total que você gastou até o momento.
	UniqueClicks	Long	O número total de pessoas únicas que clicaram no seu anúncio. Por exemplo, se três pessoas clicarem no mesmo anúncio cinco vezes, isso será contabilizado como três cliques únicos.
	UniqueCTR	Double	O número de pessoas que clicaram no seu anúncio dividido pelo número de pessoas que você alcançou. Por exemplo, se você recebeu 20 cliques únicos e seu anúncio foi veiculado para 1.000 pessoas únicas, sua taxa de cliques únicos seria de 2%.
inline_link_clicks	UniqueInlineLinkClicks	Long	O número de cliques únicos em links inline que seu anúncio recebeu. Na interface do Facebook, esse é o campo "Cliques únicos no link".
	UniqueInlineLinkClickCounter	Double	A taxa de cliques para cliques inline únicos no link.
	UniqueLinkClicksCounter	Double	A taxa de cliques única para cliques no link. O número de pessoas que clicaram no link do seu anúncio que direciona as pessoas para fora do Facebook dividido pelo número de pessoas que você alcançou. Por exemplo, se você recebeu 20 cliques únicos no link e seu anúncio foi mostrado para 1.000 pessoas únicas, sua 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 de evento 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 externos atribuídos ao anúncio.
	PageEngagements	Int	O número de engajamentos na página atribuídos ao anúncio.
	PageLikes	Int	O número de marcações "Gostei" na página atribuídas ao anúncio.
	PageMentions	Int	O número de menções à página 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 na postagem atribuídos ao anúncio.
	PostEngagements	Int	O número de interações com a postagem atribuídas ao anúncio.
	PostShares	Int	O número de compartilhamentos de postagens atribuídos ao anúncio.
	PostReactions	Int	O número de reações à postagem atribuídas ao anúncio.
	PageTabViews	Int	O número de visualizações de guias atribuídas ao anúncio.
	Região	String	A região de onde alguém visualizou o anúncio. Esse é um campo de detalhamento.
	Video3SecondViews	Int	O número de visualizações de vídeo atribuídas ao anúncio. As visualizações são contabilizadas se pelo menos 3 segundos ou o vídeo inteiro (se ele tiver menos de 3 segundos) forem reproduzidos.
Detalhamentos genéricos
	Idade	String	A faixa etária das métricas nesta linha.
	Gênero	String	O gênero das métricas nesta linha.
	País	String	O país das métricas nesta linha.
	Região	String	A região de onde 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 veiculado para cada pessoa.
	HStatsByAdvertiserTZ	String	Período em que as estatísticas foram coletadas para o anunciante.
	HStatsByAudienceTZ	String	Período em que as estatísticas foram coletadas para o público-alvo.
	ImpressionDevice	String	Os dispositivos usados para visualizar o anúncio.
	PlatformPosition	String	A posição na plataforma.
	PublisherPlatform	String	As plataformas em que os anúncios foram publicados.
	ProductId	String	O ID do produto anunciado no anúncio.

Relatório AdInsightsActions

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

Nome do campo da API Meta	Nome do campo mapeado do BigQuery	Tipo	Descrição
	Destino	String	O ID da conta para receber insights.
date_start	DateStart	Data	A data de início para recuperar insights. Na interface do Facebook, esse é o campo "Início do relatório".
date_stop	DateEnd	Data	A data de término para recuperar insights. Na interface do Facebook, esse é o campo "Fim do relatório".
	TimeIncrement	String	O número de dias de agregação de dados. Esse valor é definido como 1.
	Nível	String	O nível em que os resultados serão representados. O valor é definido como ad.
action_attribution_windows	ActionAttributionWindows	String	Uma lista separada por vírgulas que determina qual é a janela de atribuição das ações. Por exemplo, "28d_click" significa que a API retorna todas as ações que ocorreram 28 dias depois que alguém clicou no anúncio. A opção padrão significa [1d_view,7d_click]. Os valores possíveis incluem 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, default.
	ActionCollection	String	Isso vem 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	Número inteiro	Valor da métrica da janela de atribuição padrão.
ACTION_COLLECTION.1d_click	Action1dClick	String	Valor da métrica da janela de atribuição um dia após o clique no anúncio.
ACTION_COLLECTION.1d_view	Action1dView	String	Valor da métrica da janela de atribuição um 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 o clique no anúncio.
ACTION_COLLECTION.7d_view	Action7dView	String	Valor da métrica da janela de atribuição 7 dias após a visualização do anúncio.
ACTION_COLLECTION.28d_click	Action28dClick	String	Valor da métrica da janela de atribuição 28 dias após o clique no anúncio.
ACTION_COLLECTION.28d_view	Action28dView	String	Valor da métrica da janela 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 gerada pelo modelo baseado em dados.
Detalhamentos genéricos
	Idade	String	A faixa etária das métricas nesta linha.
	Gênero	String	O gênero das métricas nesta linha.
	País	String	O país das métricas nesta linha.
	Região	String	A região de onde 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 veiculado para cada pessoa.
	HStatsByAdvertiserTZ	String	Período em que as estatísticas foram coletadas para o anunciante.
	HStatsByAudienceTZ	String	Período em que as estatísticas foram coletadas para o público-alvo.
	ImpressionDevice	String	Os dispositivos usados para visualizar o anúncio.
	PlatformPosition	String	A posição na plataforma.
	PublisherPlatform	String	As plataformas em que os anúncios foram publicados.
	ProductId	String	O ID do produto anunciado no anúncio.
Detalhamentos de ação
	ActionType	String	O tipo de ação realizada no seu anúncio depois que ele foi veiculado para alguém, mesmo que a pessoa não tenha clicado nele.
	ActionCanvasComponentName	String	Nome de um componente em um anúncio Canvas.
	ActionCarouselCardId	String	O ID do card específico do carrossel com que as pessoas interagiram quando viram seu anúncio.
	ActionCarouselCardName	String	O card específico do carrossel com que as pessoas interagiram quando viram seu anúncio. Os cards são identificados pelos títulos.
	ActionDestination	String	O destino para onde as pessoas vão depois de clicar no seu anúncio.
	ActionDevice	String	O dispositivo em que o evento de conversão que você está acompanhando ocorreu.
	ActionReaction	String	O número de reações nos seus anúncios ou postagens turbinadas.
	ActionTargetId	String	O ID do destino para onde as pessoas vão depois de clicar no seu anúncio.
	ActionVideoSound	String	O status do som (ativado/desativado) quando o usuário assiste seu anúncio em vídeo.
	ActionVideoType	String	Detalhamento das métricas de vídeo.
	ActionConvertedProductId	String	IDs de produtos convertidos para anúncios colaborativos.