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 recuperare 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 |
DateStart | Data | La data di inizio per il recupero delle statistiche. Nell'interfaccia utente di Facebook, si tratta del campo Data inizio report. |
date_stop |
DateEnd | Data | 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 |
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. |
AdId | ad_id |
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 sul 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 5 volte, vengono conteggiati 3 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 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 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. |
|
PostEngagements | 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. |
|
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 |
DateStart | Data | La data di inizio per cui recuperare gli approfondimenti. Nell'interfaccia utente di Facebook, si tratta del campo Data inizio report. |
date_stop |
DateEnd | Data | 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 |
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. |
actions.action_type |
ActionType | Stringa | Le azioni intraprese sul tuo annuncio, sulla tua pagina, nella tua app o nel tuo evento dopo che l'annuncio è stato pubblicato per un utente, anche se non ha fatto clic sull'annuncio. |
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 |
Action28dClick | 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. |
actions.action_canvas_component_name |
ActionCanvasComponentName | Stringa | Nome di un componente all'interno di un annuncio Canvas. |
actions.action_carousel_card_id |
ActionCarouselCardId | Stringa | L'ID della scheda del carosello specifica con cui gli utenti hanno interagito quando hanno visto il tuo annuncio. |
actions.action_carousel_card_name |
ActionCarouselCardName | Stringa | La scheda del carosello specifica con cui gli utenti hanno interagito quando hanno visto il tuo annuncio. Le schede sono identificate dai relativi titoli. |
actions.action_destination |
ActionDestination | Stringa | La destinazione a cui vengono indirizzati gli utenti dopo aver fatto clic sul tuo annuncio. |
actions.action_device |
ActionDevice | Stringa | Il dispositivo su cui si è verificato l'evento di conversione che stai monitorando. |
actions.action_reaction |
ActionReaction | Stringa | Il numero di reazioni ai tuoi annunci o post migliorati. |
actions.action_target_id |
ActionTargetId | Stringa | L'ID della destinazione a cui vengono indirizzati gli utenti dopo aver fatto clic sul tuo annuncio. |
actions.action_video_sound |
ActionVideoSound | Stringa | Lo stato dell'audio (on/off) quando l'utente guarda il tuo annuncio video. |