Einrichten von Openflow Connector für Google Ads¶
Bemerkung
Der Konnektor unterliegt den Bedingungen für Konnektoren.
Unter diesem Thema werden die Schritte zur Einrichtung des Openflow Connector für Google Ads beschrieben.
Voraussetzungen¶
Stellen Sie sicher, dass Sie Openflow Connector für Google Ads gelesen haben.
Stellen Sie sicher, dass Sie Openflow eingerichtet haben.
Die Anmeldeinformationen erhalten¶
Führen Sie als Google Ads-Administrator die folgenden Schritte aus:
Vergewissern Sie sich, dass Sie Zugang zu einem Google Cloud-Projekt haben, oder erstellen Sie ein neues Projekt.
Vergewissern Sie sich, dass die Google Ads-API für Ihr Google Cloud-Projekt aktiviert ist. Für die Datenaufnahme ist der Zugriff auf die Google Ads-API erforderlich.
Konfigurieren Sie Dienstkonto-Authentifizierung für Google Ads.
Beziehen Sie das Entwicklertoken für Ihre Organisation nach den Anweisungen.
Bemerkung
Das Entwicklertoken sollte entweder die Zugriffsebene „Basic“ oder „Standard“ haben. Weitere Informationen zur Zugriffsebene finden Sie in der Dokumentation.
Snowflake-Konto einrichten¶
Als Snowflake-Kontoadministrator führen Sie die folgenden Aufgaben aus:
Erstellen Sie eine neue Rolle oder verwenden Sie eine vorhandene Rolle und erteilen Sie die Berechtigungen von Datenbanken.
Erstellen Sie einen neuen Benutzer für den Snowflake-Dienst mit dem Typ SERVICE.
Weisen Sie dem Benutzer des Snowflake-Dienstes die Rolle zu, die Sie in den vorherigen Schritten erstellt haben.
Konfigurieren Sie mit Schlüsselpaar-Authentifizierung für den Snowflake SERVICE-Benutzer aus Schritt 2.
Snowflake empfiehlt diesen Schritt dringend. Konfigurieren Sie einen von Openflow unterstützten Geheimnismanager, z. B. AWS, Azure und Hashicorp, und speichern Sie die öffentlichen und privaten Schlüssel im Geheimnisspeicher.
Bemerkung
Wenn Sie aus irgendeinem Grund keinen Geheimnismanager verwenden möchten, sind Sie dafür verantwortlich, die für die Schlüsselpaar-Authentifizierung verwendeten öffentlichen und privaten Schlüsseldateien gemäß den Sicherheitsrichtlinien Ihrer Organisation zu schützen.
Nachem der Geheimnismanager konfiguriert ist, legen Sie fest, wie Sie sich bei ihm authentifizieren möchten. Auf AWS wird empfohlen, die mit Openflow verknüpfte EC2-Instanzrolle zu verwenden, da auf diese Weise keine weiteren Geheimnisse gespeichert werden müssen.
Konfigurieren Sie in Openflow einen mit diesem Geheimnismanager verknüpften Parameter Provider über das Hamburger-Menü oben rechts. Navigieren Sie zu Controller Settings » Parameter Provider, und rufen Sie Ihre Parameterwerte ab.
Zu diesem Zeitpunkt können alle Anmeldeinformationen mit den zugehörigen Parameterpfaden referenziert werden, und es müssen keine sensiblen Werte innerhalb von Openflow aufbewahrt werden.
Wenn andere Snowflake-Benutzer Zugriff auf die vom Konnektor aufgenommenen Rohdokumente und -tabellen benötigen (z. B. für die benutzerdefinierte Verarbeitung in Snowflake), weisen Sie diesen Benutzern die in Schritt 1 erstellte Rolle zu.
Bestimmen Sie ein Warehouse, das der Konnektor verwenden soll. Beginnen Sie mit der kleinsten Warehouse-Größe und experimentieren Sie dann mit der Größe in Abhängigkeit von der Anzahl der zu replizierenden Tabellen und der Menge der übertragenen Daten. Große Tabellenzahlen lassen sich in der Regel besser mit Multi-Cluster-Warehouses skalieren als mit größeren Warehouse-Größen.
Einrichten des Konnektors¶
Als Data Engineer führen Sie die folgenden Aufgaben aus, um den Konnektor zu installieren und zu konfigurieren:
Konnektor installieren¶
#. Create a database and schema in Snowflake for the connector to store ingested data. Grant required Berechtigungen von Datenbanken to the role created in the first step. Substitute the role placeholder with the actual value and use the following sql commands:
CREATE DATABASE GOOGLE_ADS_DESTINATION_DB; CREATE SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA; GRANT USAGE ON DATABASE GOOGLE_ADS_DESTINATION_DB TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>; GRANT USAGE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>; GRANT CREATE TABLE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
Navigieren Sie zur Openflow-Übersichtsseite. Wählen Sie im Abschnitt Featured connectors die Option View more connectors aus.
Suchen Sie auf der Seite Openflow-Konnektoren den Konnektor und wählen Sie Add to runtime.
Wählen Sie im Dialog Select runtime Ihre Laufzeit aus der Dropdown-Liste Available runtimes aus.
Wählen Sie Add aus.
Bemerkung
Bevor Sie den Konnektor installieren, stellen Sie sicher, dass Sie in Snowflake eine Datenbank und ein Schema für den Konnektor erstellt haben, in dem die aufgenommenen Daten gespeichert werden.
Authentifizieren Sie sich bei der Bereitstellung mit den Anmeldedaten Ihres Snowflake-Kontos und wählen Sie Allow, wenn Sie dazu aufgefordert werden, damit die Laufzeitanwendung auf Ihr Snowflake-Konto zugreifen kann. Die Installation des Konnektors nimmt einige Minuten in Anspruch.
Authentifizieren Sie sich bei der Laufzeit mit den Anmeldeinformationen Ihres Snowflake-Kontos.
Das Openflow-Canvas wird mit der hinzugefügten Prozessgruppe des Konnektors angezeigt.
Konnektor konfigurieren¶
Klicken Sie mit der rechten Maustaste auf die importierte Prozessgruppe und wählen Sie Parameters.
Geben Sie die erforderlichen Parameterwerte ein, wie unter Ablaufparameter beschrieben.
Ablaufparameter¶
Es gibt drei Parameterkontexte. Zielsystemparameter für Google Ads
und Quellsystemparameter für Google Ads
sind jeweils für die Zulassung von Verbindungen mit derGoogleAds-API und Snowflake zuständig . Aufnahmeparameter für Google Ads
werden verwendet, um die Neukonfiguration der von Google Ads heruntergeladenen Daten zu definieren. Google Ads-Parameter
fasst alle diese Parameter in einem zusammen.
Aufnahmeparameter für Google Ads¶
Parameter |
Beschreibung |
Erforderlich |
---|---|---|
Client Account ID |
ID des Kontos in den Google Ads, für das der jeweilige Bericht aufgenommen werden soll |
true |
Google Ads Ressource Name |
Name der Ressource in Google Ads, die eine Quelle für den Bericht ist |
true |
Report Attributes |
Attribute der ausgewählten Ressource |
true |
Report Metrics |
Metriken, die im Zusammenhang mit einer bestimmten Ressource gesammelt werden |
false |
Report Segments |
Buckets, in denen Metriken gruppiert werden sollen |
false |
Report Start Date |
Startdatum, ab dem die Aufnahme erfolgen soll. Das Datumsformat ist YYYY-MM-DD. |
false |
Zeitplan |
Zeitplan für Google Ads Report Prozessor abrufen |
true |
Bemerkung
Der einfachste Weg, die richtige Kombination von Berichtsattributen
, Berichtsmetriken
und Berichtssegmenten
zu erhalten, ist die Verwendung von Google Ads Query Builder. Wählen Sie die Ressource anhand des Parameters Google Ads Resource Name
aus und erstellen Sie die Abfrage. Kopieren Sie dann Attribute, Metriken und Segmente und fügen Sie sie den entsprechenden Parametern hinzu.
Quellsystemparameter für Google Ads¶
Parameter |
Beschreibung |
Erforderlich |
---|---|---|
Google Developer Token |
Entwicklertoken für die Abfrage der Google Ads-API erforderlich |
true |
Google Service Account JSON |
Für die Google Ads-Authentifizierung ist ein JSON-Dienstkonto erforderlich. |
true |
Zielsystemparameter für Google Ads¶
Parameter |
Beschreibung |
Erforderlich |
---|---|---|
Destination Database |
Die Datenbank, in der die Daten persistiert werden. Sie muss bereits in Snowflake vorhanden sein. |
true |
Destination Schema |
Das Schema, in dem die Daten persistiert werden. Sie muss bereits in Snowflake vorhanden sein. |
true |
Snowflake Account Identifier |
Snowflake-Kontoname im Format [organisation-name]-[account-name], in dem die Daten gespeichert werden |
true |
Snowflake Authentication Strategy |
Strategie zur Authentifizierung bei Snowflake. Mögliche Werte: |
true |
Snowflake Private Key |
Der private RSA Schlüssel, der für die Authentifizierung verwendet wird. Der RSA-Schlüssel muss nach den PKCS8-Standards formatiert sein und den Standard-PEM-Header und -Footer enthalten. Beachten Sie, dass entweder Snowflake Private Key File oder Snowflake Private Key definiert sein muss |
false |
Snowflake Private Key File |
Die Datei, die den privaten RSA-Schlüssel enthält, der für die Authentifizierung bei Snowflake verwendet wird. Sie ist nach den PKCS8-Standards formatiert und hat die Standard-PEM-Header und -Footer. Die Header beginnt mit |
false |
Snowflake Private Key Password |
Das Kennwort, das mit der Snowflake Private Key-Datei verknüpft ist |
false |
Snowflake Role |
Snowflake-Rolle, die bei der Ausführung der Abfrage verwendet wird |
true |
Snowflake-Benutzername |
Benutzername für die Verbindung zur Snowflake-Instanz |
true |
Snowflake Warehouse |
Snowflake Warehouse zur Ausführung von Abfragen |
true |
Führen Sie den Ablauf aus¶
Klicken Sie mit der rechten Maustaste auf die Ebene, und wählen Sie Enable all Controller Services.
Klicken Sie mit der rechten Maustaste auf die importierte Prozessgruppe und wählen Sie Start. Der Konnektor startet die Datenaufnahme.
Zurücksetzen des Konnektors¶
Um den Konnektor vollständig in den Ausgangszustand zurückzusetzen, gehen Sie wie folgt vor:
Vergewissern Sie sich, dass sich keine FlowFiles mehr in den Warteschlangen befinden.
Halten Sie alle Prozessoren an.
Löschen Sie den Status des ursprünglichen Prozessors.
Klicken Sie mit der rechten Maustaste auf den Prozessor
Get Google Ads Report
, und wählen Sie View State.Wählen Sie die Option Clear State aus. Dies setzt den Status des Prozessors zurück.
Löschen Sie die Zieltabelle in Snowflake ab.