Trasformazione dei report di Facebook Ads

Questo documento descrive come vengono trasformati i report di Facebook Ads quando esegui un trasferimento di Facebook Ads in BigQuery.

Mappatura delle tabelle per i report di Facebook Ads

Quando i report di Facebook Ads vengono trasferiti in BigQuery, vengono trasformati nelle seguenti tabelle e viste BigQuery.

Report AdAccounts

Nome del campo dell'API Meta Nome del campo BigQuery mappato Tipo Descrizione
id ID [KEY] Stringa L'ID dell'account Google Ads.
Target Stringa La destinazione da cui ottenere gli account pubblicitari. Questo valore è "null" per ottenere tutti gli account pubblicitari.
account_id AccountId Stringa L'ID dell'account pubblicitario quando viene visualizzato direttamente in Facebook.
account_status AccountStatus Numero intero Stato dell'account. 1 = attivo, 2 = disattivato, 3 = non risolto, 7 = in attesa di revisione, 9 = in periodo di tolleranza, 101 = temporaneamente non disponibile, 100 = in attesa di chiusura.
age Età Doppia Tempo di apertura dell'account pubblicitario, in giorni.
amount_spent AmountSpent Numero intero Importo totale corrente speso dall'account. Questo valore può essere reimpostato.
balance Saldo Numero intero Importo dovuto della fattura.
business_city BusinessCity Stringa Città per l'indirizzo dell'attività.
business_country_code BusinessCountryCode Stringa Codice paese per l'indirizzo dell'attività.
business_name BusinessName Stringa Il nome dell'attività per l'account.
business_state BusinessState Stringa Abbreviazione della provincia per l'indirizzo dell'attività.
business_street BusinessStreet Stringa Prima riga dell'indirizzo dell'attività per l'account.
business_street2 BusinessStreet2 Stringa Seconda riga dell'indirizzo dell'attività per l'account.
business_zip BusinessZip Stringa Codice postale dell'indirizzo dell'attività.
capabilities Funzionalità Stringa Funzionalità consentite per questo account pubblicitario.
created_time CreatedTime Data/ora L'ora in cui è stato creato l'account.
currency Valuta Stringa La valuta utilizzata per l'account, in base al valore corrispondente nelle impostazioni dell'account.
min_campaign_group_spend_cap MinCampaignGroupSpendCap Stringa Il limite di spesa minimo del gruppo di campagne.
name Nome Stringa Nome dell'account. Tieni presente che molti account non hanno nome, pertanto questo campo potrebbe essere vuoto.
offsite_pixels_tos_accepted OffsitePixelsTosAccepted Stringa Indica se è stato firmato il contratto relativo ai Termini di servizio dei pixel offsite.
owner OwnerId Stringa L'ID Facebook del proprietario dell'account pubblicitario.
spend_cap SpendCap Numero intero L'importo massimo che può essere speso da questo account, oltre il quale le campagne verranno messe in pausa. Un valore pari a 0 indica che non esiste un limite di spesa.
timezone_id TimezoneId Stringa ID del fuso orario.
timezone_name TimezoneName Stringa Nome del fuso orario.
timezone_offset_hours_utc TimezoneOffsetHoursUTC Doppia Differenza di fuso orario rispetto a UTC.

Report AdInsights

Nome del campo dell'API Meta Nome del campo BigQuery mappato Tipo Descrizione
Target Stringa L'ID dell'account per cui visualizzare gli approfondimenti.
date_start DataStart Date La data di inizio per il recupero delle statistiche. Nell'interfaccia utente di Facebook, si tratta del campo Data inizio report.
date_stop DataFine Date La data di fine per il recupero delle informazioni. Nell'interfaccia utente di Facebook, si tratta del campo Fine report.
TimeIncrement Stringa Il numero di giorni di aggregazione dei dati. Questo valore è impostato su 1.
Livello Stringa Il livello a cui rappresentare i risultati. Questo valore è impostato su "ad".
account_currency AccountCurrency Stringa La valuta utilizzata dall'account pubblicitario.
action_attribution_windows ActionAttributionWindows Stringa Un elenco separato da virgole che determina la finestra di attribuzione per le azioni. Ad esempio, 28d_click indica che l'API restituisce tutte le azioni che si sono verificate 28 giorni dopo che un utente ha fatto clic sull'annuncio. Questa opzione è impostata su [1d_view,28d_click].
account_id AdAccountId Stringa L'ID dell'account pubblicitario associato alla riga del report.
account_name AdAccountName Stringa Il nome dell'account pubblicitario associato alla riga del report.
campaign_id CampaignId Stringa L'ID della campagna associata alla riga del report.
campaign_name Nome campagna Stringa Il nome della campagna associata alla riga del report.
adset_id AdSetId Stringa L'ID del gruppo di annunci associato alla riga del report.
adset_name AdSetName Stringa Il nome del gruppo di annunci associato alla riga del report.
ad_id AdId Stringa L'ID dell'annuncio associato alla riga del report.
ad_name AdName Stringa Il nome dell'annuncio associato alla riga del report.
buying_type BuyingType Stringa Il metodo di pagamento degli annunci target nelle tue campagne.
clicks Clic Lungo Il numero totale di clic sul tuo annuncio. A seconda di cosa stai promuovendo, possono essere inclusi i Mi piace alla pagina, le risposte agli eventi o le installazioni di app. Nell'interfaccia utente di Facebook, si tratta del campo Clic (tutti).
conversion_rate_ranking ConversionRateRanking Stringa Il ranking del tasso di conversione.
cost_per_estimated_ad_recallers CostPerEstimatedAdRecallers Decimale Il costo medio per persona aggiuntiva che stimiamo ricorderà di aver visto il tuo annuncio se le viene chiesto entro 2 giorni.
cost_per_inline_link_click CostPerInlineLinkClick Decimale Il costo per clic medio sui link nell'annuncio.
cost_per_inline_post_engagement CostPerInlinePostEngagement Decimale Il costo medio per interazione sul post.
cost_per_unique_click CostPerUniqueClick Decimale Il costo medio per clic univoco per questi annunci, calcolato dividendo l'importo speso per il numero di clic unici ricevuti.
cost_per_unique_inline_link_click CostPerUniqueInlineLinkClick Decimale La media che hai pagato per ogni clic sui link in linea univoci.
cpc CPC Decimale Il costo per clic medio di questi annunci, calcolato dividendo l'importo speso per il numero di clic ricevuti.
cpm CPM Decimale Il costo medio che hai pagato per ottenere 1000 impressioni del tuo annuncio.
cpp CPP Decimale Il costo medio che hai pagato per la pubblicazione del tuo annuncio a 1000 utenti unici.
ctr CTR Doppia Il numero di clic ricevuti diviso per il numero di impressioni. Nell'interfaccia utente di Facebook, si tratta del campo % CTR (tutti).
estimated_ad_recall_rate EstimatedAdRecallRate Doppia Il numero stimato di utenti che ricordano il tuo annuncio diviso per il numero di utenti raggiunti dall'annuncio.
estimated_ad_recallers EstimatedAdRecallers Doppia Il numero aggiuntivo di utenti che stimiamo ricorderanno di aver visto i tuoi annunci se gli viene chiesto entro 2 giorni.
frequency Frequenza Doppia Il numero medio di volte in cui il tuo annuncio è stato pubblicato per ogni persona.
impressions Impressioni Lungo Il numero di volte in cui il tuo annuncio è stato pubblicato. Nelle app mobile, un annuncio viene conteggiato come pubblicato la prima volta che viene visualizzato. In tutte le altre interfacce di Facebook, un annuncio viene pubblicato la prima volta che viene inserito nel Feed di notizie di una persona o ogni volta che viene inserito nella colonna a destra.
inline_link_clicks InlineLinkClicks Lungo Numero totale di clic sui link nell'annuncio.
inline_link_click_ctr InlineLinkClicksCounter Doppia La percentuale di clic per i clic in linea al link.
inline_post_engagement InlinePostEngagement Lungo Il numero totale di interazioni con il post.
instant_experience_clicks_to_open InstantExperienceClicksToOpen Lungo Corrisponde al campo instant_experience_clicks_to_open dell'API META.
instant_experience_clicks_to_start InstantExperienceClicksToStart Lungo Corrisponde al campo instant_experience_clicks_to_start dell'API META.
instant_experience_outbound_clicks InstantExperienceOutboundClicks Lungo Corrisponde al campo instant_experience_outbound_clicks dell'API META.
objective Obiettivo Stringa Lo scopo selezionato per la campagna. Lo scopo riflette l'obiettivo che vuoi raggiungere con la tua pubblicità.
quality_ranking QualityRanking Stringa Il ranking della qualità.
reach Copertura Lungo Il numero di utenti a cui è stato pubblicato il tuo annuncio.
spend Spesa Decimale L'importo totale speso finora.
UniqueClicks Lungo Il numero totale di utenti unici che hanno fatto clic sul tuo annuncio. Ad esempio, se tre persone fanno clic sullo stesso annuncio cinque volte, vengono conteggiati tre clic unici.
UniqueCTR Doppia Il numero di utenti che hanno fatto clic sul tuo annuncio diviso per il numero di utenti raggiunti. Ad esempio, se hai ricevuto 20 clic unici e il tuo annuncio è stato pubblicato per 1000 utenti unici, la percentuale di clic unici sarà del 2%.
inline_link_clicks UniqueInlineLinkClicks Lungo Il numero di clic sui link in linea unici ricevuti dal tuo annuncio. Nell'interfaccia utente di Facebook, si tratta del campo Clic unici sul link.
UniqueInlineLinkClickCounter Doppia La percentuale di clic per i clic in linea univoci sul link.
UniqueLinkClicksCounter Doppia La percentuale di clic univoca per i clic sul link. Il numero di utenti che hanno fatto clic sul link nel tuo annuncio che rimanda a una pagina esterna a Facebook diviso per il numero di utenti raggiunti. Ad esempio, se hai ricevuto 20 clic unici sul link e il tuo annuncio è stato mostrato a 1000 utenti unici, la percentuale di clic unici sarà pari al 2%.
Check-in Int Il numero di check-in attribuiti all'annuncio.
EventResponses Int Il numero di risposte evento attribuite all'annuncio.
inline_link_clicks LinkClicks Int Il numero di clic sui link attribuiti all'annuncio.
OfferSaves Int Il numero di offerte ricevute attribuite all'annuncio.
outbound_clicks OutboundClicks Int Il numero di clic in uscita attribuiti all'annuncio.
Coinvolgimenti nella pagina Int Il numero di impegni con la pagina attribuiti all'annuncio.
PageLikes Int Il numero di Mi piace alla pagina attribuiti all'annuncio.
PageMentions Int Il numero di menzioni della pagina attribuite all'annuncio.
PagePhotoViews Int Il numero di visualizzazioni delle foto attribuite all'annuncio.
PostComments Int Il numero di commenti al post attribuiti all'annuncio.
Coinvolgimenti post Int Il numero di interazioni con i post attribuite all'annuncio.
PostShares Int Il numero di condivisioni del post attribuite all'annuncio.
PostReactions Int Il numero di reazioni ai post attribuite all'annuncio.
PageTabViews Int Il numero di visualizzazioni della scheda attribuite all'annuncio.
Regione Stringa La regione da cui un utente ha visualizzato l'annuncio. Questo è un campo di distribuzione.
Video3SecondViews Int Il numero di visualizzazioni video attribuite all'annuncio. Le visualizzazioni vengono conteggiate se vengono riprodotti almeno 3 secondi del video o l'intero video (se dura meno di 3 secondi).

Report AdInsightsActions

Nome del campo dell'API Meta Nome del campo BigQuery mappato Tipo Descrizione
Target Stringa L'ID dell'account per cui visualizzare gli approfondimenti.
date_start DataStart Date La data di inizio per cui recuperare gli approfondimenti. Nell'interfaccia utente di Facebook, si tratta del campo Data inizio report.
date_stop DataFine Date La data di fine per cui recuperare gli approfondimenti. Nell'interfaccia utente di Facebook, si tratta del campo Fine report.
TimeIncrement Stringa Il numero di giorni di aggregazione dei dati. Questo valore è impostato su 1.
Livello Stringa Il livello a cui rappresentare i risultati. Il valore è impostato su ad.
action_attribution_windows ActionAttributionWindows Stringa Un elenco separato da virgole che determina la finestra di attribuzione per le azioni. Ad esempio, 28d_click indica che l'API restituisce tutte le azioni che si sono verificate 28 giorni dopo che un utente ha fatto clic sull'annuncio. L'opzione predefinita è [1d_view,7d_click]. I valori possibili includono 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, default.
ActionCollection Stringa La raccolta di azioni da recuperare. Il valore è impostato su Actions.
account_id AdAccountId Stringa L'ID dell'account pubblicitario associato alla riga del report.
account_name AdAccountName Stringa Il nome dell'account pubblicitario associato alla riga del report.
campaign_id CampaignId Stringa L'ID della campagna associata alla riga del report.
campaign_name Nome campagna Stringa Il nome della campagna associata alla riga del report.
adset_id AdSetId Stringa L'ID del gruppo di annunci associato alla riga del report.
adset_name AdSetName Stringa Il nome del set di annunci associato alla riga del report.
ad_id AdId Stringa L'ID dell'annuncio associato alla riga del report.
ad_name AdName Stringa Il nome dell'annuncio associato alla riga del report.
actions.value ActionValue Numero intero Valore della metrica della finestra di attribuzione predefinita.
actions.1d_click Action1dClick Stringa Valore della metrica della finestra di attribuzione 1 giorno dopo il clic sull'annuncio.
actions.1d_view Action1dView Stringa Valore della metrica della finestra di attribuzione 1 giorno dopo la visualizzazione dell'annuncio.
actions.7d_click Action7dClick Stringa Valore della metrica della finestra di attribuzione 7 giorni dopo il clic sull'annuncio.
actions.7d_view Action7dView Stringa Valore della metrica della finestra di attribuzione 7 giorni dopo la visualizzazione dell'annuncio.
actions.28d_click Azione28giorniClic Stringa Valore della metrica della finestra di attribuzione 28 giorni dopo il clic sull'annuncio.
actions.28d_view Action28dView Stringa Valore della metrica della finestra di attribuzione 28 giorni dopo la visualizzazione dell'annuncio.
actions.dda ActionDDA Stringa Valore della metrica della finestra di attribuzione basata su un modello basato sui dati.