Referenz zum Aufnahmekonnektor für Metaanzeigen

Von Bedeutung

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Verwalten von Azure Databricks-Vorschauen.

Diese Seite enthält Referenzdokumentation für den Meta Ads-Ingestions-Connector in Databricks Lakeflow Connect.

Automatische Datentransformationen

Databricks transformiert Metaanzeigen-Datentypen wie folgt in deltakompatible Datentypen:

Metaanzeigentyp Delta-Typ
Schnur String
INT Integer
long Lang
Schweben Schweben
doppelt Double
boolean Boolean
Datum/Uhrzeit Zeitstempel
date Datum
Liste Array
Karte Map
enum String

Unterstützte Objekte

Der Meta Ads-Konnektor unterstützt das Einlesen der folgenden Objekte:

Object Description
Anzeigen Individuelle Anzeigen in Ihren Kampagnen
Anzeigensets Anzeigensets, die Anzeigen zusammen mit gemeinsamen Zielgruppen, Budget- und Zeitplaneinstellungen gruppieren.
campaigns Kampagnenobjekte der obersten Ebene, die Anzeigensätze enthalten
Anzeigenbilder In Anzeigen verwendete Bildressourcen
Werbungseinblicke Leistungsmetriken und Analysedaten für Anzeigen, Anzeigensätze, Kampagnen oder Konten
ad_creatives Kreative Elemente (Bilder, Videos, Text), die in Anzeigen verwendet werden
benutzerdefinierte_Zielgruppen Benutzerdefinierte Zielgruppendefinitionen für die Zielgruppenadressierung
Werbevideos In Anzeigen verwendete Videoressourcen
benutzerdefinierte Konversionen Benutzerdefinierte Konvertierungsereignisdefinitionen

konfigurationsoptionen für ad_insights

Das ad_insights Objekt unterstützt zusätzliche Konfigurationsoptionen für die Analyse von Leistungsdaten.

Startdatum

Legen Sie das früheste Datum fest, ab dem historische ad_insights Daten aufgenommen werden sollen. Die Insights-API speichert nur Daten für ungefähr 36 Monate, muss also start_date innerhalb der letzten 36 Monate sein. Wenn dies nicht festgelegt ist, wird der Verbinder standardmäßig 36 Monate vor dem aktuellen Datum festgelegt.

Granularitätsebenen

Geben Sie die Ebene an, auf der Leistungsmetriken abgerufen werden sollen:

  • account: Metriken auf Kontoebene
  • campaign: Metriken auf Kampagnenebene
  • adset: Metriken auf Anzeigensatzebene
  • ad: Metriken auf Anzeigenebene (Standard)

Aufschlüsselungsdimensionen

Konfigurieren von Aufschlüsselungsdimensionen zum Segmentieren von Leistungsdaten:

  • age: Altersbereiche
  • gender:Geschlecht
  • country:Land
  • region: Geografische Region
  • dma: Designated Market Area (nur Vereinigte Staaten)
  • device_platform: Geräteplattform (Mobil, Desktop usw.)
  • placement: Position der Anzeigenplatzierung
  • publisher_platform: Publisher-Plattform (Facebook, Audience Network usw.)
  • impression_device: Gerätetyp für Impressionen

Dimensionen der Aktionsaufschlüsselung

Konfigurieren Sie die Dimensionen der Aktionsaufgliederung, um Konvertierungsaktionen zu analysieren.

  • action_type: Typ der Konvertierungsaktion
  • action_destination: Ziel der Konvertierungsaktion
  • action_carousel_card_id: Karussellkartenbezeichner
  • action_carousel_card_name: Karussellkartenname
  • action_video_sound: Einstellung für Videosound
  • action_video_type: Videotyp

Zeitinkrementierung

Konfigurieren des Aggregationszeitraums für ad_insights Daten:

  • all_days: Ein einzelner Bucket, der den vollen Zeitraum abdeckt (Insights-API-Standard).
  • monthly: Ein Bucket pro Kalendermonat.
  • Eine ganze Zahl von Tagen als Zeichenfolge (z "1" . B. für tägliche Buckets, "7" für wöchentliche Buckets).

Die Insights-API unterstützt stündliche Zeitschritte nicht.

Zeit des Aktionsberichts

Konfigurieren Sie den Zeitstempel, der zum Melden von Aktionsstatistiken verwendet wird:

  • impression: Konvertierungen werden an dem Datum des Eindrucks gemeldet, der sie angetrieben hat.
  • conversion: Konvertierungen werden an dem Datum gemeldet, an dem die Konvertierung erfolgt ist.
  • mixed: Klick-und-Durch-Konvertierungen verwenden Impressionszeit, Ansicht-Through-Konvertierungen verwenden Konvertierungszeit.
  • lifetime: Lebensdauerkonvertierungen für die Entität.

Attributionsfenster

Konfigurieren Sie Zuordnungsfenster für die Aktionen.

  • 1d_click, , 7d_click: 28d_clickKlick-durch-Durch-Zuschreibungsfenster
  • 1d_view, , 7d_view: 28d_viewAnsichts-durch-Zuschreibungsfenster

Sie können mehrere Werte angeben (z. B ["7d_click", "1d_view"]. ). Wenn action_attribution_windows dies nicht festgelegt ist, verwendet der Connector die Standardzuordnungseinstellungen Ihres Meta ads-Kontos. Eine Liste der Werte finden Sie in der Insights-API-Referenz von Meta.

Lookbackfenster

Konfigurieren Sie, wie weit zurück der Connector Daten (in Tagen) für jede Synchronisierung erneut erfasst:

Verhalten:

  • Erneute Erfassung des Zeitraums: Bei jeder Synchronisierung nach der ersten Synchronisierung werden daten für [last_sync_cursor - <N> days, today] so spät ankommende Konvertierungen erfasst. Wenn custom_insights_lookback_window der Verbinder nicht festgelegt ist, werden die letzten 7 Tage standardmäßig erneut aufgenommen.
  • Attributions-Fallback: Wenn Sie explizit festlegen custom_insights_lookback_windowund nicht festgelegt action_attribution_windowshaben, übergibt <N>d_click,1d_view der Connector auch das Attributionsfenster an die Insights-API. Legen Sie fest action_attribution_windows, um die Zuordnung unabhängig vom Lookback zu steuern.

API-Versionen

Der Meta Ads-Connector verwendet die Insights-API. Databricks hält den Connector mit der neuesten stabilen API-Version auf dem neuesten Stand.

  • Last updated on