Informazioni di riferimento sul connettore di inserimento di Meta Ads

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Questa pagina contiene materiale di riferimento per il connettore di inserimento Meta Ads in Databricks Lakeflow Connect.

Trasformazioni automatiche dei dati

Databricks trasforma i tipi di dati Meta Ads in tipi di dati compatibili con Delta come indicato di seguito:

Tipo di annunci Meta Tipo Delta
corda String
int Integer
lungo Long
galleggiare Galleggiare
doppio Double
boolean Boolean
datetime Marca temporale:
date Date
list Array
map Map
enum String

Oggetti supportati

Il connettore Meta Ads supporta l'acquisizione dei seguenti oggetti:

Oggetto Description
Annunci Annunci individuali nelle tue campagne
gruppi_annunci Insiemi di annunci che raggruppano gli annunci con impostazioni di targeting, budget e pianificazione condivise.
campaigns Oggetti di campagna di livello superiore che contengono set di annunci
immagini_pubblicitarie Asset di immagini utilizzati negli annunci
informazioni_annunci Metriche delle prestazioni e dati analitici per annunci, set di annunci, campagne o account
creativi pubblicitari Elementi creativi (immagini, video, testo) usati negli annunci
pubblico_personalizzato Definizioni di destinatari personalizzate per la destinazione
video_annuncio Asset video usati negli annunci
conversioni_personalizzate Definizioni di eventi di conversione personalizzate

ad_insights opzioni di configurazione

L'oggetto ad_insights supporta opzioni di configurazione aggiuntive per l'analisi dei dati sulle prestazioni.

Data di inizio

Impostare la data meno recente da cui inserire i dati cronologici ad_insights . L'API Insights conserva solo i dati per circa 36 mesi, quindi start_date deve essere entro gli ultimi 36 mesi. Se non è impostato, per impostazione predefinita il connettore è 36 mesi prima della data corrente.

Livelli di granularità

Specificare il livello a cui recuperare le metriche delle prestazioni:

  • account: metriche a livello di account
  • campaign: metriche a livello di campagna
  • adset: metriche a livello di set di annunci
  • ad: metriche a livello di annuncio (impostazione predefinita)

Dimensioni di scomposizione

Configurare le dimensioni di scomposizione per segmentare i dati sulle prestazioni:

  • age: intervalli di età
  • gender:Genere
  • country:Paese
  • region: area geografica
  • dma: Area di mercato designata (solo Stati Uniti)
  • device_platform: piattaforma del dispositivo (mobile, desktop e così via)
  • placement: posizione di posizionamento degli annunci
  • publisher_platform: piattaforma di pubblicazione (Facebook, Audience Network e così via)
  • impression_device: tipo di dispositivo per le impressioni

Dimensioni della suddivisione delle azioni

Configurare le dimensioni della suddivisione delle azioni per analizzare le azioni di conversione:

  • action_type: tipo di azione di conversione
  • action_destination: destinazione dell'azione di conversione
  • action_carousel_card_id: identificatore della scheda del carosello
  • action_carousel_card_name: nome della carta del carosello
  • action_video_sound: impostazione audio video
  • action_video_type: tipo di video

Incremento del tempo

Configurare il periodo di aggregazione per ad_insights i dati:

  • all_days: singolo bucket che copre l'intervallo di tempo completo (impostazione predefinita dell'API Insights).
  • monthly: un bucket al mese di calendario.
  • Numero intero di giorni sotto forma di stringa (ad esempio, "1" per i bucket giornalieri, "7" per i bucket settimanali).

L'API Insights non supporta incrementi orari.

Tempo report azioni

Configurare il timestamp usato per segnalare le statistiche delle azioni:

  • impression: le conversioni vengono segnalate alla data dell'impressione che li ha portati.
  • conversion: le conversioni vengono segnalate alla data in cui si è verificata la conversione.
  • mixed: le conversioni click-through usano il tempo di impression, le conversioni di visualizzazione usano il tempo di conversione.
  • lifetime: conversioni di durata per l'entità.

Finestre di attribuzione

Configurare le finestre di attribuzione per le azioni.

  • 1d_click, 7d_click, 28d_click: finestre di attribuzione click-through
  • 1d_view, 7d_view, 28d_view: finestre di attribuzione view-through

È possibile specificare più valori , ad esempio ["7d_click", "1d_view"]. Se action_attribution_windows non è impostato, il connettore usa le impostazioni di attribuzione predefinite dell'account Meta Ads. Per un elenco di valori, vedere Informazioni di riferimento sull'API Di Meta Insights.

Finestra lookback

Configurare il tempo di ripristino dei dati del connettore (in giorni) in ogni sincronizzazione:

Comportamento:

  • Re-inserimento nell'intervallo di tempo: in ogni sincronizzazione dopo la prima, il connettore esegue il pull dei dati per [last_sync_cursor - <N> days, today] le conversioni in ritardo vengono acquisite. Se custom_insights_lookback_window non è impostato, per impostazione predefinita il connettore esegue nuovamente il ripristino degli ultimi 7 giorni.
  • Fallback di attribuzione: quando si imposta custom_insights_lookback_window in modo esplicito e non è stato impostato action_attribution_windows, il connettore passa <N>d_click,1d_view anche come finestra di attribuzione all'API Insights. Per controllare l'attribuzione indipendentemente dal lookback, impostare action_attribution_windows.

Versioni dell'API

Il connettore Meta Ads usa l'API Insights. Databricks mantiene aggiornato il connettore con la versione più recente dell'API stabile.

  • Last updated on