Einrichten von Openflow Connector for Amazon Ads¶

Bemerkung

Der Konnektor unterliegt den Bedingungen für Konnektoren.

Unter diesem Thema werden die Schritte zur Einrichtung von Openflow Connector for Amazon Ads beschrieben.

Voraussetzungen¶

Stellen Sie sicher, dass Sie Allgemeine Informationen zu Openflow Connector for Amazon Ads gelesen haben.
Stellen Sie sicher, dass Sie Openflow eingerichtet haben.

Die Anmeldeinformationen erhalten¶

Als Amazon Ads-Administrator führen Sie die folgenden Aktionen durch:

Stellen Sie sicher, dass Sie Zugang zu einem Amazon Ads-Konto haben.
Erwerben Sie Zugang zur Amazon Ads-API, und schließen Sie den Onboarding-Prozess ab.
Rufen Sie die Client-ID und das Client-Geheimnis ab.
Erstellen Sie eine Autorisierungsberechtigung und rufen Sie ein Aktualisierungstoken ab.
Überprüfen Sie die verfügbaren Regionen, und erhalten Sie eine Basis-URL, die für Anfragen auf der Grundlage der Region, in der Sie werben, verwendet wird.
Rufen Sie Profil-IDs für die Berichtskonfiguration ab.

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.
1. 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.
2. 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.
3. 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¶

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¶

In diesem Abschnitt werden die Ablaufparameter beschrieben, die Sie anhand der folgenden Parameterkontexte konfigurieren können:

Quellsystemparameter für Amazon Ads: werden verwendet, um die Verbindung mit Amazon Ads herzustellen API.
Zielsystemparameter für Amazon Ads: werden verwendet, um die Verbindung mit Snowflake herzustellen.
Aufnahmeparameter für Amazon Ads: werden verwendet, um die Konfiguration der von Amazon Ads heruntergeladenen Daten zu definieren.

Quellsystemparameter für Amazon Ads¶

Parameter	Beschreibung
Client-ID	Client-ID des Amazon Advertising-Kontos
Client Secret	Client-Geheimnis des Amazon Advertising-Kontos
OAuth Base URL	Die URL des Autorisierungsservers, der das Zugriffstoken ausstellt Mögliche Werte: https://api.amazon.com/auth/o2/token https://api.amazon.co.uk/auth/o2/token https://api.amazon.co.jp/auth/o2/token
Aktualisierungstoken	Aktualisierungstoken für die Amazon Ads-API
Region	Umgebung, aus der die Werbedaten heruntergeladen werden Mögliche Werte: NA EU FE

Zielsystemparameter für Amazon Ads¶

Parameter	Beschreibung
Destination Database	Die Datenbank, in der die Daten persistiert werden. Sie muss bereits in Snowflake vorhanden sein
Destination Schema	Das Schema, in dem die Daten persistiert werden. Sie muss bereits in Snowflake vorhanden sein
Snowflake Account Identifier	Snowflake-Kontoname im Format [organisation-name]-[account-name], in dem die Daten gespeichert werden
Snowflake Authentication Strategy	Strategie zur Authentifizierung bei Snowflake. Mögliche Werte: SNOWFLAKE_SESSION_TOKEN – wenn wir den Ablauf auf SPCS ausführen, KEY_PAIR, wenn wir den Zugriff mit einem privaten Schlüssel einrichten wollen
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
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 `-----BEGIN PRIVATE`. Aktivieren Sie das Kontrollkästchen Reference asset, um die private Schlüsseldatei hochzuladen.
Snowflake Private Key Password	Das Kennwort, das mit der Snowflake Private Key-Datei verknüpft ist
Snowflake Role	Snowflake-Rolle, die bei der Ausführung der Abfrage verwendet wird
Snowflake-Benutzername	Benutzername für die Verbindung zur Snowflake-Instanz
Snowflake Warehouse	Snowflake Warehouse zur Ausführung von Abfragen

Aufnahmeparameter für Amazon Ads¶

Parameter	Beschreibung
Report Name	Name des Berichts, der als Name der Zieltabelle verwendet werden soll. Der Name muss innerhalb des Zielschemas eindeutig sein.
Report Ad Product	Art des im Bericht erfassten Werbeprodukts Mögliche Werte: SPONSORED_PRODUCTS SPONSORED_BRANDS SPONSORED_DISPLAY SPONSORED_TELEVISION DEMAND_SIDE_PLATFORM
Report Columns	Satz von Spalten, die im Abschlussbericht enthalten sein werden
Report Filters	Satz von Filtern, die zum Trimmen der zurückgegebenen Daten verwendet werden
Report Group By	Detaillierungsgrad des Berichts
Report Ingestion Strategy	Modus, in dem die Daten abgerufen werden – entweder Snapshot oder inkrementell Mögliche Werte: `SNAPSHOT` `INCREMENTAL`
Report Ingestion Window	Gibt die Anzahl der Tage an, aus denen Daten während der inkrementellen Erfassung heruntergeladen werden sollen.
Report Profile ID	Die Profil-ID, die mit einem Konto auf einem bestimmten Marketplace verbunden ist
Report Time Unit	Datumsaggregation Mögliche Werte: `DAILY`: Jeder Tag wird durch eine Zeile dargestellt `SUMMARY`: Der gesamte erfasste Datumszeitraum wird als eine Zeile dargestellt.
Report Type	Im Bericht enthaltener Datentyp
Report Start Date	Startdatum, ab dem die Aufnahme erfolgen soll. Das Datumsformat ist YYYY-MM-DD.
Report Schedule	Zeitplan für den Prozessor, der Berichte erstellt

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.