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

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 para 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 = Ativa, 2 = Desativada, 3 = Não resolvida, 7 = Revisão pendente, 9 = Período de carência, 101 = Temporariamente indisponível, 100 = Fechamento pendente.
age Idade Double Tempo em dias em 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 devido.
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 O horário 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ú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 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 é colocado 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 de saída 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 guia 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.

Relatório AdInsightsActions

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 para as 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 A coleção de ações a ser recuperada. O valor é definido como 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 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.
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 gerada pelo modelo baseado em dados.