Einbindung in Google Ads

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

Google Ads ist eine Onlinewerbeplattform, über die Unternehmen ihre Produkte oder Dienstleistungen in verschiedenen Google-Produkten bewerben können. Cortex Framework kombiniert Ihre Google Ads-Daten mit Daten aus anderen Marketingkanälen, analysiert sie umfassend und nutzt KI, um Ihre Kampagnenergebnisse zu verbessern.

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

Abbildung 1. Google Ads-Datenquelle

Hinweis :Informationen zum Zugriff auf Konfigurationsdateien, Analyseansichten und Modelle für die Google Ads-Datenquelle finden Sie im Verzeichnis der Datenquellen.

Konfigurationsdatei

In der Datei config.json werden die Einstellungen für die Übertragung von Daten aus einer beliebigen Datenquelle konfiguriert, einschließlich Google Ads. Diese Datei enthält die folgenden Parameter für Google Ads:

  "marketing": {
          "deployGoogleAds": true,
          "GoogleAds": {
              "deployCDC": true,
              "lookbackDays": 180,
              "datasets": {
                  "cdc": "",
                  "raw": "",
                  "reporting": "REPORTING_GoogleAds"
                    }
                  }
                 }

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

Parameter	Bedeutung	Standardwert	Beschreibung
marketing.deployGoogleAds	Google Ads implementieren	true	Führen Sie die Bereitstellung für die Google Ads-Datenquelle aus.
marketing.GoogleAds.deployCDC	CDC für Google Ads bereitstellen	true	Google Ads-CDC-Verarbeitungsscripts generieren, die als DAGs in Cloud Composer ausgeführt werden
marketing.GoogleAds.lookbackDays	Lookback-Tage für Google Ads	180	Anzahl der Tage, nach denen mit dem Abrufen von Daten aus der Google Ads API begonnen werden soll.
marketing.GoogleAds.datasets.cdc	CDC-Datensatz für Google Ads		CDC-Dataset für Google Ads
marketing.GoogleAds.datasets.raw	Rohdatensatz für Google Ads		Rohdatensatz für Google Ads.
marketing.GoogleAds.datasets.reporting	Dataset für Google Ads-Berichte	"REPORTING_GoogleAds"	Dataset für Google Ads-Berichte.

Datenmodell

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

Abbildung 2 Google Ads: Entitätsbeziehungsdiagramm

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/GoogleAds/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/GoogleAds/src/reporting/ddls ansehen

API-Verbindung

In Cortex Framework-Aufnahmevorlagen werden mithilfe der Google Ads API Berichtsattribute und -messwerte aus Google Ads abgerufen. Die aktuellen Cortex Framework-Vorlagen verwenden die Google Ads API-Version 17.1. Beachten Sie die folgenden Einschränkungen der Google Ads API:

• Grundlegende Zugriffsvorgänge pro Tag: 15.000 (paginierte Anfragen mit gültiger next_page_token werden nicht gezählt).
• Maximale Seitengröße:10.000 Zeilen pro Seite.
• Empfohlene Standardparameter:Seitengröße entspricht 10.000 Zeilen pro Seite.

Weitere Informationen zur API-Verbindung finden Sie in der Google Ads API-Dokumentation.

Kontoauthentifizierung

So richten Sie die Kontoauthentifizierung ein:

1. Klicken Sie in der Google Cloud Console auf Navigationsmenü > APIs und Dienste > Anmeldedaten > Anmeldedaten erstellen.

2. Erstellen Sie Anmeldedaten mit OAuth-Client-ID mit den folgenden Eigenschaften. Weitere Informationen finden Sie im Hilfeartikel Mit OAuth 2.0 auf Google APIs zugreifen.

   Application type: "Web Application"
   Name: CHOSEN_NAME #(For example,"Cortex Authentication Client").
   Authorized redirect URIs: http://127.0.0.1
   

   Ersetzen Sie CHOSEN_NAME durch den Namen, den Sie für das Anmeldedatenkonto der OAuth-Client-ID ausgewählt haben.

3. Speichern Sie Client ID und Client secret, nachdem die Anmeldedaten konfiguriert wurden. Sie benötigen ihn später.

4. Erstelle ein neues Token mit OAuth 2.0-Zugriff auf Google APIs. Cortex Data Foundation erkennt und nimmt automatisch Daten von allen Kunden (Konten) auf, auf die über die Anmeldedaten zugegriffen werden kann, die zum Generieren des Tokens verwendet wurden.

5. So erstellen Sie mit Secret Manager ein Secret:

   • Klicken Sie in der Google Cloud Console auf Secret Manager.
   • Erstellen Sie ein Secret mit dem Namen cortex-framework-google-ads-yaml im folgenden Format und ändern Sie die Werte entsprechend Ihren Einstellungen:

   {"developer_token": "DEVELOPER_TOKEN_VALUE", "refresh_token": "REFRESH_TOKEN_VALUE", "client_id": "CLIENT_ID_VALUE", "client_secret": "CLIENT_SECRET_VALUE", "use_proto_plus": False}
   

Ersetzen Sie Folgendes:

• DEVELOPER_TOKEN_VALUE mit dem im Google Ads-Konto verfügbaren Entwicklertokenwert.
• REFRESH_TOKEN_VALUE durch den Wert des Aktualisierungstokens, den Sie in Schritt 4 erhalten haben.
• CLIENT_ID_VALUE durch den Client-ID-Wert, den Sie in Schritt 2 bei der OAuth-Einrichtung erhalten haben.
• CLIENT_SECRET_VALUE durch den Clientschlüsselwert, den Sie in Schritt 2 bei der OAuth-Einrichtung erhalten haben.

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.

Daten, die mit der Google Ads API abgerufen werden, sind in der Regel mit einer Latenz von mehr als 3 Stunden verfügbar. Sie können später aufgrund von Conversions und der Erkennung ungültiger Zugriffe angepasst werden. Weitere Informationen finden Sie im Hilfeartikel Aktualität von Daten.

Berechtigungen für 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
googleads_raw_dataflow	Für die Google Ads API: > BigQuery-Raw-Dataset
googleads_cdc_bq	Für die Übertragung von Rohdatensätzen > CDC-Datensätzen.
googleads_reporting_bq	Für CDC-Datensatz > Berichtsdatensatz übertragen

Berechtigungen für das Cloud Composer-Dienstkonto

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

Aufnahmeeinstellungen

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

Von der Quelle zu Rohtabellen

In diesem Abschnitt wird beschrieben, welche Entitäten von APIs abgerufen werden und wie. Jeder Eintrag entspricht einer Google Ads-Entität. Basierend auf dieser Konfiguration erstellt Cortex Airflow-DAGs, in denen Dataflow-Pipelines ausgeführt werden, um Daten mithilfe der Google Ads APIs abzurufen.

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

Parameter	Beschreibung
load_frequency	Gibt an, wie oft ein DAG für dieses Element ausgeführt wird, um Daten aus Google Ads abzurufen. Weitere Informationen zu den möglichen Werten finden Sie in der Airflow-Dokumentation.
api_name	Name der API-Ressource (z. B. customer).
table_name	Tabelle im Rohdatensatz, in der die abgerufenen Daten gespeichert werden (z. B. customer).
schema_file	Schemadatei im Verzeichnis src/table_schema, die API-Antwortfelder den Spaltennamen der Zieltabelle zuordnet.
key	Spalten (durch Komma getrennt), die einen eindeutigen Datensatz für diese Tabelle bilden.
is_metrics_table	Gibt an, ob ein bestimmter Eintrag sich auf ein Messwertobjekt (in der Google Ads API) bezieht. Aufgrund der zusammengefassten Natur solcher Tabellen werden sie vom System etwas anders behandelt.
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.

Rohdaten in CDC-Tabellen

In diesem Abschnitt wird beschrieben, welche Einträge steuern, wie Daten aus Rohtabellen in CDC-Tabellen verschoben werden. Jeder Eintrag entspricht einer Rohtabelle, die wiederum dem oben genannten Google Ads API-Objekt entspricht.

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

Parameter	Beschreibung
table_name	Tabelle im CDC-Dataset, in der die Rohdaten nach der CDC-Transformation gespeichert werden (z. B. customer).
raw_table	Tabelle, in der Rohdaten repliziert wurden.
key	Spalten (durch Komma getrennt), die einen eindeutigen Datensatz für diese Tabelle bilden.
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.
schema_file	Schemadatei im Verzeichnis src/table_schema, die Rohspalten den CDC-Spalten und dem Datentyp der CDC-Spalte zuordnet. Dies ist dieselbe Schemadatei, auf die im vorherigen Abschnitt verwiesen wird.
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.

Berichtseinstellungen

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

Weitere Informationen finden Sie unter Datei mit Berichtseinstellungen anpassen.

Nächste Schritte

• Weitere Informationen zu anderen Datenquellen und Arbeitslasten finden Sie unter Datenquellen und Arbeitslasten.
• Weitere Informationen zu den Schritten für die Bereitstellung in Produktionsumgebungen finden Sie unter Voraussetzungen für die Bereitstellung der Cortex Framework Data Foundation.