Integration mit Campaign Manager 360

Auf dieser Seite werden die erforderlichen Konfigurationen beschrieben, um Daten aus Campaign Manager 360 als Datenquelle der Marketing-Arbeitslast der Cortex Framework Data Foundation zu verwenden.

Campaign Manager 360 (CM360) ist eine webbasierte Werbeverwaltungsplattform von Google, die speziell für Werbetreibende und Agenturen entwickelt wurde. Es dient als zentraler Hub zur Verwaltung und Optimierung aller digitalen Werbekampagnen über verschiedene Kanäle hinweg. Cortex Framework bietet die Tools und die Plattform, mit denen Sie CM360-Daten analysieren, mit Daten aus anderen Marketingkanälen kombinieren und mithilfe von KI detailliertere Informationen gewinnen und Ihre Marketingstrategie insgesamt optimieren können.

Das folgende Diagramm zeigt, wie CM360-Daten über die Marketing-Arbeitslast der Cortex Framework Data Foundation verfügbar sind:

CM360-Datenquelle

Abbildung 1. CM360-Datenquelle

Konfigurationsdatei

In der Datei config.json werden die Einstellungen konfiguriert, die für die Verbindung zu Datenquellen zur Übertragung von Daten aus verschiedenen Arbeitslasten erforderlich sind. Diese Datei enthält die folgenden Parameter für CM360:

   "marketing": {
        "deployCM360": true,
        }

        "CM360": {
            "deployCDC": true,
            "dataTransferBucket": "",
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_CM360"
            }
        }

In der folgenden Tabelle wird der Wert für jeden Marketingparameter beschrieben:

Parameter Bedeutung Standardwert Beschreibung
marketing.deployCM360 CM360 bereitstellen true Führen Sie die Bereitstellung für die CM360-Datenquelle aus.
marketing.CM360.deployCDC CDC-Scripts für CM360 bereitstellen true CM360-CDC-Verarbeitungsscripts generieren, die als DAGs in Cloud Composer ausgeführt werden.
marketing.CM360.dataTransferBucket Bucket mit Ergebnissen des Data Transfer Service - Bucket, in dem DTv2-Dateien gespeichert sind.
marketing.CM360.datasets.cdc CDC-Datensatz für CM360 CDC-Datensatz für CM360.
marketing.CM360.datasets.raw Rohdatensatz für CM360 Rohdatensatz für CM360.
marketing.CM360.datasets.reporting Berichtsdatensatz für CM360 "REPORTING_CM360" Berichtsdatensatz für CM360.

Datenmodell

In diesem Abschnitt wird das CM360-Datenmodell anhand eines Entitätsbeziehungsdiagramms (ERD) beschrieben.

Entitätsbeziehungsdiagramm für CM360

Abbildung 2 CM360: Entitäts-Beziehungs-Diagramm.

Basisansichten

Dies sind die blauen Objekte in der ERD. Sie sind Ansichten auf CDC-Tabellen ohne andere Transformationen als einige Aliasse für Spaltennamen. Scripts in src/marketing/src/CM360/src/reporting/ddls ansehen

Berichtsdatenansichten

Dies sind die grünen Objekte in der ERD und Berichtsansichten, die zusammengefasste Messwerte enthalten. Scripts in src/marketing/src/CM360/src/reporting/ddls ansehen

Speicherplatz für DTv2-Dateien

DTv2-Dateien (Data Transfer Version 2) sind ein spezielles Format, das in CM360 für die Bereitstellung von Kampagnenleistungsdaten verwendet wird. Richten Sie die Datenübertragung ein. Folgen Sie dazu der Dokumentation zur Datenübertragung V2.0, um CM360 mit dem Cortex-Framework zu verwenden.

Erstellen oder fügen Sie einen Cloud Storage-Bucket zum Speichern Ihrer DTv2-Dateien aus CM360 hinzu. Achten Sie darauf, dass die Dateien im Bucket für das Dienstkonto lesbar sind, das DAGs in Cloud Composer ausführt. Weitere Informationen finden Sie unter Storage-Buckets erstellen.

Datenaktualität und Verzögerung

Im Allgemeinen ist die Datenaktualität für Cortex Framework-Datenquellen durch die Möglichkeiten der Upstream-Verbindung und die Häufigkeit der DAG-Ausführung begrenzt. Passen Sie die Ausführungshäufigkeit des DAG an die Upstream-Frequenz, die Ressourcenbeschränkungen und Ihre Geschäftsanforderungen an.

Mit der Datenübertragung v2 in CM360 werden Daten zu Impressionen und Klicks 24 Mal täglich (stündlich) gesendet. Die Verarbeitungszeit kann je nach Datei variieren. Daher werden Dateien möglicherweise nicht in der richtigen Reihenfolge angezeigt. Aktivitätsdateien werden täglich übermittelt.

Cloud Composer-Verbindungen

Erstellen Sie die folgenden Verbindungen in Cloud Composer. Weitere Informationen finden Sie in der Dokumentation zum Verwalten von Airflow-Verbindungen.

Verbindungsname Purpose
cm360_raw_dataflow Für CM360-DTv2-Dateien > BigQuery-Raw-Dataset
cm360_cdc_bq Für die Übertragung von Rohdatensätzen > CDC-Datensätzen
cm360_reporting_bq Für CDC-Datensatz > Berichtsdatensatzübertragung

Berechtigungen für das Cloud Composer-Dienstkonto

Gewähren Sie dem in Cloud Composer verwendeten Dienstkonto (wie in der cm360_raw_dataflow-Verbindung konfiguriert) Dataflow-Berechtigungen. Weitere Informationen finden Sie in der Dataflow-Dokumentation.

Aufnahmeeinstellungen

Die Source to Raw- und Raw to CDC-Datenpipelines können über die Einstellungen in der Datei src/CM360/config/ingestion_settings.yaml gesteuert werden. In diesem Abschnitt werden die Parameter der einzelnen Datenpipelines beschrieben.

Von der Quelle zu Rohtabellen

In diesem Abschnitt wird beschrieben, wie Einträge, die steuern, welche Dateien aus DTv2 verarbeitet werden, funktionieren. Jeder Eintrag entspricht Dateien, die mit einer Entität verknüpft sind. Basierend auf dieser Konfiguration erstellt das Cortex-Framework Airflow-DAGs, in denen Dataflow-Pipelines ausgeführt werden, um Daten aus den DTv2-Dateien zu verarbeiten.

Die folgenden Parameter steuern die Einstellungen für Source to Raw für jeden Eintrag:

Parameter Beschreibung
base_table Tabelle im Rohdatensatz, in der die Daten für eine Entität gespeichert sind (z. B. Daten zu „Klicks“).
load_frequency Gibt an, wie oft ein DAG für diese Entität ausgeführt wird, um die CDC-Tabelle zu füllen. Weitere Informationen zu den möglichen Werten finden Sie in der Airflow-Dokumentation.
file_pattern Basierend auf Dateinamenmustern, die einer Entität entsprechen.
schema_file Schemadatei im Verzeichnis src/table_schema, die DTv2-Felder den Spaltennamen und Datentypen der Zieltabelle zuordnet.
partition_details Optional:Gibt an, ob diese Tabelle aus Gründen der Leistung partitioniert werden soll. Weitere Informationen finden Sie unter Tabellenpartition.
cluster_details Optional:Wenn Sie möchten, dass diese Tabelle aus Gründen der Leistung gruppiert wird. Weitere Informationen finden Sie unter Clustereinstellungen.

Rohdaten in CDC-Tabellen

Dieser Abschnitt enthält Einträge, mit denen gesteuert wird, wie Daten aus Rohtabellen in CDC-Tabellen verschoben werden. Jeder Eintrag entspricht einer Rohtabelle, die wiederum der oben genannten DTv2-Entität entspricht.

Die folgenden Parameter steuern die Einstellungen für Raw to CDC für jeden Eintrag:

Parameter Beschreibung
base_table Tabelle im CDC-Dataset, in der die Rohdaten nach der CDC-Transformation gespeichert werden (z. B. customer).
load_frequency Gibt an, wie oft ein DAG für diese Entität ausgeführt wird, um die CDC-Tabelle zu füllen. Weitere Informationen zu den möglichen Werten finden Sie in der Airflow-Dokumentation.
row_identifiers Liste der Spalten (durch Kommas getrennt), die einen eindeutigen Datensatz für diese Tabelle bilden.
partition_details Optional:Wenn diese Tabelle aus Leistungsgründen partitioniert werden soll. Weitere Informationen finden Sie unter Tabellenpartition.
cluster_details Optional:Wenn Sie möchten, dass diese Tabelle aus Gründen der Leistung gruppiert wird. Weitere Informationen finden Sie unter Clustereinstellungen.
Berichtseinstellungen

Mit der Datei „Berichtseinstellungen“ (src/CM360/config/reporting_settings.yaml) können Sie konfigurieren und steuern, wie das Cortex-Framework Daten für die endgültige Berichtsebene in CM360 generiert. In dieser Datei wird festgelegt, wie BigQuery-Objekte der Berichtsebene (Tabellen, Ansichten, Funktionen oder gespeicherte Prozeduren) generiert werden.

Weitere Informationen finden Sie unter Datei mit Berichtseinstellungen anpassen.

Nächste Schritte