Trasformazione dei report di Facebook Ads

Questo documento descrive come vengono trasformati i report sugli annunci di Facebook quando esegui un trasferimento degli annunci di Facebook a BigQuery.

Mappatura delle tabelle per i report sugli annunci di Facebook

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

Report AdAccounts

Nome del campo API Meta Nome del campo BigQuery mappato Tipo Descrizione
id ID [KEY] Stringa L'ID dell'account pubblicitario.
Target Stringa Il target utilizzato per 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 su Facebook.
account_status AccountStatus Numero intero Stato dell'account. 1 = Attivo, 2 = Disattivato, 3 = Non saldato, 7 = In attesa di revisione, 9 = In periodo di tolleranza, 101 = Temporaneamente non disponibile, 100 = In attesa di chiusura.
age Età Doppia Il periodo di tempo in cui l'account pubblicitario è stato aperto, in giorni.
amount_spent AmountSpent Numero intero Importo totale attuale speso dall'account. Questo può essere reimpostato.
balance Saldo Numero intero Importo dovuto della fattura.
business_city BusinessCity Stringa Città dell'indirizzo dell'attività.
business_country_code BusinessCountryCode Stringa Il codice paese dell'indirizzo commerciale.
business_name BusinessName Stringa Il nome dell'attività per l'account.
business_state BusinessState Stringa Abbreviazione dello stato per l'indirizzo commerciale.
business_street BusinessStreet Stringa La 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 Il 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 un nome, quindi questo campo potrebbe essere vuoto.
offsite_pixels_tos_accepted OffsitePixelsTosAccepted Stringa Indica se il contratto relativo ai Termini di servizio del pixel offsite è stato firmato.
owner OwnerId Stringa ID Facebook del proprietario dell'account pubblicitario.
spend_cap SpendCap Numero intero L'importo massimo che può essere speso da questo account, dopo 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 all'UTC.

Report AdInsights

Nome del campo API Meta Nome del campo BigQuery mappato Tipo Descrizione
Target Stringa L'ID dell'account per cui ottenere approfondimenti.
date_start DateStart Data La data di inizio per recuperare gli approfondimenti. Nell'UI di Facebook, questo è il campo Inizio report.
date_stop DateEnd Data La data di fine per recuperare le statistiche. Nell'interfaccia utente di Facebook, questo è il campo Fine report.
TimeIncrement Stringa Il numero di giorni di aggregazione dei dati. Questo valore è impostato su 1.
Livello Stringa Il livello in 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 eseguite 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 CampaignName 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 Long Il numero totale di clic sul tuo annuncio. A seconda di ciò che promuovi, possono essere inclusi Mi piace della pagina, risposte agli eventi o installazioni di app. Nell'interfaccia utente di Facebook, questo è il 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 interrogata entro 2 giorni.
cost_per_inline_link_click CostPerInlineLinkClick Decimale Il costo medio per clic sui link nell'annuncio.
cost_per_inline_post_engagement CostPerInlinePostEngagement Decimale Il costo medio per interazione con il post.
cost_per_unique_click CostPerUniqueClick Decimale Il costo medio per clic unico per questi annunci, calcolato come l'importo speso diviso 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 univoco.
cpc CPC Decimale Il costo medio per clic per questi annunci, calcolato come l'importo speso diviso per il numero di clic ricevuti.
cpm CPM Decimale Il costo medio che hai pagato per ottenere 1000 impressioni sul 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, questo è il campo CTR (tutti) %.
estimated_ad_recall_rate EstimatedAdRecallRate Doppia Il numero stimato di persone che ricordano il tuo annuncio diviso per il numero di persone raggiunte dal tuo annuncio.
estimated_ad_recallers EstimatedAdRecallers Doppia Il numero aggiuntivo di persone 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 Long 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. Su tutte le altre interfacce di Facebook, un annuncio viene pubblicato la prima volta che viene inserito nel feed di una persona o ogni volta che viene inserito nella colonna di destra.
inline_link_clicks InlineLinkClicks Long Il numero totale di clic sui link nell'annuncio.
inline_link_click_ctr InlineLinkClicksCounter Doppia La percentuale di clic per i clic in linea sul link.
inline_post_engagement InlinePostEngagement Long Il numero totale di interazioni con il post.
instant_experience_clicks_to_open InstantExperienceClicksToOpen Long Corrisponde al campo instant_experience_clicks_to_open dell'API META.
instant_experience_clicks_to_start InstantExperienceClicksToStart Long Corrisponde al campo instant_experience_clicks_to_start dell'API META.
instant_experience_outbound_clicks InstantExperienceOutboundClicks Long Corrisponde al campo instant_experience_outbound_clicks dell'API META.
objective Obiettivo Stringa L'obiettivo selezionato per la campagna. L'obiettivo riflette lo scopo che vuoi raggiungere con la tua pubblicità.
quality_ranking QualityRanking Stringa Il ranking di qualità.
reach Copertura Long Il numero di persone per le quali è stato pubblicato l'annuncio.
spend Spesa Decimale L'importo totale che hai speso finora.
UniqueClicks Long Il numero totale di persone uniche che hanno fatto clic sul tuo annuncio. Ad esempio, se 3 persone fanno clic sullo stesso annuncio 5 volte, vengono conteggiati 3 clic unici.
UniqueCTR Doppia Il numero di persone che hanno fatto clic sul tuo annuncio diviso per il numero di persone che hai raggiunto. Ad esempio, se hai ricevuto 20 clic unici e il tuo annuncio è stato pubblicato per 1000 persone uniche, la percentuale di clic unici sarà del 2%.
inline_link_clicks UniqueInlineLinkClicks Long Il numero di clic unici sui link in linea ricevuti dal tuo annuncio. Nell'interfaccia utente di Facebook, questo è il 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 persone che hanno fatto clic sul link nel tuo annuncio che reindirizza gli utenti al di fuori di Facebook diviso per il numero di persone che hai raggiunto. Ad esempio, se hai ricevuto 20 clic unici sul link e il tuo annuncio è stato mostrato a 1000 persone uniche, la percentuale di clic unica sarà pari al 2%.
Check-in Int Il numero di check-in attribuiti all'annuncio.
EventResponses Int Il numero di risposte agli eventi 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.
PageEngagements Int Il numero di coinvolgimenti sulla 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 di foto attribuite all'annuncio.
PostComments Int Il numero di commenti ai post attribuiti all'annuncio.
PostEngagements Int Il numero di interazioni con il 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 delle schede 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 sono stati riprodotti almeno 3 secondi o l'intero video (se dura meno di 3 secondi).
Suddivisioni generiche
Età Stringa La fascia d'età per le metriche in questa riga.
Genere Stringa Il genere per le metriche in questa riga.
Paese Stringa Il paese per le metriche in questa riga.
Regione Stringa La regione da cui un utente ha visualizzato l'annuncio.
FrequencyValue Stringa Il numero di volte in cui un annuncio della campagna Raggiunta e frequenza è stato pubblicato per ogni persona.
HStatsByAdvertiserTZ Stringa Il periodo di tempo in cui sono state rilevate le statistiche per l'inserzionista.
HStatsByAudienceTZ Stringa Periodo di tempo in cui sono state rilevate le statistiche per il pubblico.
ImpressionDevice Stringa I dispositivi utilizzati per visualizzare l'annuncio.
PlatformPosition Stringa La posizione sulla piattaforma.
PublisherPlatform Stringa Le piattaforme su cui sono stati pubblicati gli annunci.
ProductId Stringa L'ID prodotto pubblicizzato nell'annuncio.

Report AdInsightsActions

ACTION_COLLECTION si riferisce ai tipi di azioni che le persone hanno intrapreso in risposta al tuo annuncio. Per un elenco completo delle raccolte di azioni, vedi Raccolte di azioni.

Nome del campo API Meta Nome del campo BigQuery mappato Tipo Descrizione
Target Stringa L'ID dell'account per cui ottenere approfondimenti.
date_start DateStart Data La data di inizio per recuperare gli approfondimenti. Nell'UI di Facebook, questo è il campo Inizio report.
date_stop DateEnd Data La data di fine per recuperare le statistiche. Nell'interfaccia utente di Facebook, questo è il campo Fine report.
TimeIncrement Stringa Il numero di giorni di aggregazione dei dati. Questo valore è impostato su 1.
Livello Stringa Il livello in 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 eseguite 28 giorni dopo che un utente ha fatto clic sull'annuncio. L'opzione predefinita indica [1d_view,7d_click]. I valori possibili includono 1d_view, 7d_view, 28d_view, 1d_click, 7d_click, 28d_click, default.
ActionCollection Stringa Deriva dalla tua scelta di raccolte di azioni nel trasferimento.
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 CampaignName 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.
ACTION_COLLECTION.value ActionValue Numero intero Valore della metrica della finestra di attribuzione predefinita.
ACTION_COLLECTION.1d_click Action1dClick Stringa Valore della metrica della finestra di attribuzione 1 giorno dopo il clic sull'annuncio.
ACTION_COLLECTION.1d_view Action1dView Stringa Valore della metrica della finestra di attribuzione 1 giorno dopo la visualizzazione dell'annuncio.
ACTION_COLLECTION.7d_click Action7dClick Stringa Valore della metrica della finestra di attribuzione 7 giorni dopo il clic sull'annuncio.
ACTION_COLLECTION.7d_view Action7dView Stringa Valore della metrica della finestra di attribuzione 7 giorni dopo la visualizzazione dell'annuncio.
ACTION_COLLECTION.28d_click Action28dClick Stringa Valore della metrica della finestra di attribuzione 28 giorni dopo il clic sull'annuncio.
ACTION_COLLECTION.28d_view Action28dView Stringa Valore della metrica della finestra di attribuzione 28 giorni dopo la visualizzazione dell'annuncio.
ACTION_COLLECTION.dda ActionDDA Stringa Valore della metrica della finestra di attribuzione basata sul modello basato sui dati.
Suddivisioni generiche
Età Stringa La fascia d'età per le metriche in questa riga.
Genere Stringa Il genere per le metriche in questa riga.
Paese Stringa Il paese per le metriche in questa riga.
Regione Stringa La regione da cui un utente ha visualizzato l'annuncio.
FrequencyValue Stringa Il numero di volte in cui un annuncio della campagna Raggiunta e frequenza è stato pubblicato per ogni persona.
HStatsByAdvertiserTZ Stringa Il periodo di tempo in cui sono state rilevate le statistiche per l'inserzionista.
HStatsByAudienceTZ Stringa Periodo di tempo in cui sono state rilevate le statistiche per il pubblico.
ImpressionDevice Stringa I dispositivi utilizzati per visualizzare l'annuncio.
PlatformPosition Stringa La posizione sulla piattaforma.
PublisherPlatform Stringa Le piattaforme su cui sono stati pubblicati gli annunci.
ProductId Stringa L'ID prodotto pubblicizzato nell'annuncio.
Suddivisioni delle azioni
ActionType Stringa Il tipo di azioni intraprese sul tuo annuncio dopo che è stato pubblicato per un utente, anche se non ha fatto clic.
ActionCanvasComponentName Stringa Il nome di un componente all'interno di un annuncio Canvas.
ActionCarouselCardId Stringa L'ID della scheda specifica del carosello con cui gli utenti hanno interagito quando hanno visto il tuo annuncio.
ActionCarouselCardName Stringa La scheda specifica del carosello con cui gli utenti hanno interagito quando hanno visualizzato il tuo annuncio. Le schede sono identificate dai titoli.
ActionDestination Stringa La destinazione a cui vengono indirizzati gli utenti dopo aver fatto clic sul tuo annuncio.
ActionDevice Stringa Il dispositivo su cui si è verificato l'evento di conversione che stai monitorando.
ActionReaction Stringa Il numero di reazioni ai tuoi annunci o post potenziati.
ActionTargetId Stringa L'ID della destinazione a cui vengono indirizzati gli utenti dopo aver fatto clic sul tuo annuncio.
ActionVideoSound Stringa Lo stato dell'audio (attivo/disattivato) quando l'utente guarda il tuo annuncio video.
ActionVideoType Stringa Suddivisione delle metriche video.
ActionConvertedProductId Stringa ID prodotto convertiti per gli annunci collaborativi.