Transformação de relatórios do Facebook Ads

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" 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. Para mais informações, consulte as descrições da fase 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 seguintes tabelas e visualizações.

Relatório AdAccounts

Nome do campo da API Meta	Nome do campo do BigQuery mapeado	Tipo	Descrição
id	ID [KEY]	String	O ID da conta de anúncios.
	Destino	String	O destino usado para buscar 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 visualizado diretamente no Facebook.
account_status	AccountStatus	Número inteiro	Status da conta. 1 = Ativo, 2 = Desativado, 3 = Pendente, 7 = Revisão pendente, 9 = no período de carência, 101 = temporariamente indisponível, 100 = encerramento pendente.
age	Idade	Duplo	Tempo de abertura da conta de anúncios, em dias.
amount_spent	AmountSpent	Número inteiro	Valor total gasto pela conta até o momento. Isso pode ser redefinido.
balance	Saldo	Número inteiro	Valor da fatura.
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	Abreviação 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 para a conta com base no valor correspondente nas configurações da conta.
min_campaign_group_spend_cap	MinCampaignGroupSpendCap	String	O limite mínimo de gastos do grupo de campanhas.
name	Nome	String	Nome da conta. Muitas contas não têm nome, portanto, esse campo pode estar vazio.
offsite_pixels_tos_accepted	OffsitePixelsTosAccepted	String	Indica se o contrato dos Termos de Serviço do pixel off-site 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, após o qual as campanhas são 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	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 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 "Report End".
	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 que está sendo 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 aconteceram 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 publicidade associada à linha do relatório.
account_name	AdAccountName	String	O nome da conta de publicidade 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.
AdId	ad_id	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 "Clicks (All)".
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 extra que, segundo nossas estimativas, vai se lembrar de ter visto seu anúncio se for perguntada 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 no 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 para ter 1.000 impressões no seu anúncio.
cpp	CPP (custo por chamada telefônica)	Decimal	O custo médio que você pagou para veicular seu anúncio para 1.000 pessoas únicas.
ctr	CTR	Duplo	O número de cliques que você recebeu dividido pelo número de impressões. Na interface do Facebook, esse é o campo "CTR (All)".
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 que ele alcançou.
estimated_ad_recallers	EstimatedAdRecallers	Duplo	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	Duplo	O número médio de vezes que seu anúncio foi exibido para cada pessoa.
impressions	Impressões	Long	O número de vezes que o anúncio foi veiculado. Em apps para dispositivos móveis, um anúncio é contabilizado como veiculado na primeira vez que é visualizado. Em todas as outras interfaces do Facebook, um anúncio é veiculado na primeira vez que é colocado no Feed de Notícias de uma pessoa ou sempre que é colocado na coluna à direita.
inline_link_clicks	InlineLinkClicks	Long	Número total de cliques nos links do anúncio.
inline_link_click_ctr	InlineLinkClicksCounter	Duplo	A taxa de cliques para links inline.
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 que você selecionou para a campanha. O 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 a quem o anúncio foi exibido.
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	Duplo	É 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, sua taxa de cliques únicos será de 2%.
inline_link_clicks	UniqueInlineLinkClicks	Long	O número de cliques em links inline únicos que seu anúncio recebeu. Na interface do Facebook, esse é o campo "Unique Clicks to Link".
	UniqueInlineLinkClickCounter	Duplo	A taxa de cliques para cliques únicos no link inline.
	UniqueLinkClicksCounter	Duplo	A taxa de cliques única para links. É 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 será de 2%.
	Check-ins	Int	O número de check-ins atribuídos ao anúncio.
	EventResponses	Int	É o número de respostas de 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 marcações "Gostei" da página atribuídas ao anúncio.
	PageMentions	Int	O número de menções de 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.
	Video3SecondViews	Int	É o número de visualizações do vídeo atribuídas ao anúncio. As visualizações são contabilizadas se pelo menos 3 segundos ou o vídeo inteiro (se tiver menos de 3 segundos) forem reproduzidos.

Relatório AdInsightsActions

Nome do campo da API Meta	Nome do campo do BigQuery mapeado	Tipo	Descrição
	Destino	String	O ID da conta para receber insights.
date_start	DateStart	Data	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 final para recuperar insights. Na interface do Facebook, esse é o campo "Report End".
	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 em 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 aconteceram 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 e "default".
	ActionCollection	String	A coleção de ações a ser recuperada. O valor é definido em Actions.
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 publicidade 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.
actions.action_type	ActionType	String	As ações realizadas no seu anúncio, página, app ou evento depois que ele foi veiculado para alguém, mesmo que a pessoa não tenha clicado nele.
actions.value	ActionValue	Número inteiro	Valor da métrica da janela de atribuição padrão.
actions.1d_click	Action1dClick	String	Valor da métrica da janela de atribuição um dia após o clique no anúncio.
actions.1d_view	Action1dView	String	Valor da métrica da janela de atribuição um dia após a visualização do anúncio.
actions.7d_click	Action7dClick	String	Valor da métrica da janela de atribuição 7 dias após o clique no anúncio.
actions.7d_view	Action7dView	String	Valor da métrica da janela de atribuição 7 dias após a visualização do anúncio.
actions.28d_click	Action28dClick	String	Valor da métrica da janela de atribuição 28 dias após o clique no anúncio.
actions.28d_view	Action28dView	String	Valor da métrica da janela de atribuição 28 dias após a visualização do anúncio.
actions.dda	ActionDDA	String	Valor da métrica da janela de atribuição que é gerada pelo modelo baseado em dados.
actions.action_canvas_component_name	ActionCanvasComponentName	String	Nome de um componente em um anúncio de tela.
actions.action_carousel_card_id	ActionCarouselCardId	String	O ID do card específico do carrossel que as pessoas interagiram quando viram seu anúncio.
actions.action_carousel_card_name	ActionCarouselCardName	String	O card específico do carrossel que as pessoas interagiram quando viram seu anúncio. Os cards são identificados pelas manchetes.
actions.action_destination	ActionDestination	String	O destino para onde as pessoas vão depois de clicar no seu anúncio.
actions.action_device	ActionDevice	String	O dispositivo em que o evento de conversão que você está acompanhando ocorreu.
actions.action_reaction	ActionReaction	String	O número de reações nos seus anúncios ou postagens impulsionadas.
actions.action_target_id	ActionTargetId	String	O ID do destino para onde as pessoas vão depois de clicar no seu anúncio.
actions.action_video_sound	ActionVideoSound	String	O status do som (ativado/desativado) quando o usuário assiste seu anúncio em vídeo.