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

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

  2. Stellen Sie sicher, dass Sie Openflow einrichten – BYOC oder Openflow einrichten – Snowflake-Bereitstellung – Überblick zu Aufgaben haben.

Die Anmeldeinformationen erhalten

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

  1. Stellen Sie sicher, dass Sie Zugang zu einem Amazon Ads-Konto haben.

  2. Erwerben Sie Zugang zur Amazon Ads-API, und schließen Sie den Onboarding-Prozess ab.

  3. Rufen Sie die Client-ID und das Client-Geheimnis ab.

  4. Erstellen Sie eine Autorisierungsberechtigung und rufen Sie ein Aktualisierungstoken ab.

  5. Ü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.

  6. Rufen Sie Profil-IDs für die Berichtskonfiguration ab.

Snowflake-Konto einrichten

Als Snowflake-Kontoadministrator führen Sie die folgenden Aufgaben aus:

  1. Erstellen Sie eine neue Rolle oder verwenden Sie eine vorhandene Rolle und erteilen Sie die Berechtigungen von Datenbanken.

  2. Erstellen Sie einen neuen Benutzer für den Snowflake-Dienst mit dem Typ SERVICE.

  3. Weisen Sie dem Benutzer des Snowflake-Dienstes die Rolle zu, die Sie in den vorherigen Schritten erstellt haben.

  4. Konfigurieren Sie mit Schlüsselpaar-Authentifizierung für den Snowflake SERVICE-Benutzer aus Schritt 2.

  5. 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 über das Hamburger-Menü oben rechts einen Parameteranbieter, der mit diesem Secrets Manager verbunden ist. Navigieren Sie zu Controller Settings » Parameter Provider und rufen Sie dann 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.

  6. 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.

  7. 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

  1. Navigieren Sie zur Openflow-Übersichtsseite. Wählen Sie im Abschnitt Featured connectors die Option View more connectors aus.

  2. Suchen Sie auf der Seite Openflow-Konnektoren den Konnektor und wählen Sie Add to runtime.

  3. Wählen Sie im Dialog Select runtime Ihre Laufzeit aus der Dropdown-Liste Available runtimes aus.

  4. 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.

  5. 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.

  6. 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

  1. Klicken Sie mit der rechten Maustaste auf die importierte Prozessgruppe und wählen Sie Parameters.

  2. 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:

Amazon Ads-Quellparameter

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:

Aktualisierungstoken

Aktualisierungstoken für die Amazon Ads-API

Region

Umgebung, aus der die Werbedaten heruntergeladen werden

Mögliche Werte:

  • NA

  • EU

  • FE

Amazon Ads-Zielparameter

Parameter

Beschreibung

Erforderlich

Destination Database

Die Datenbank, in der die Daten als persistent gespeichert werden. Muss bereits in Snowflake vorhanden sein. Beim Namen wird zwischen Groß- und Kleinschreibung unterschieden. Bei Bezeichnern ohne Anführungszeichen geben Sie den Namen in Großbuchstaben an.

Ja

Destination Schema

Das Schema, in dem Daten beibehalten werden, muss bereits in Snowflake vorhanden sein. Beim Namen wird zwischen Groß- und Kleinschreibung unterschieden. Bei Bezeichnern ohne Anführungszeichen geben Sie den Namen in Großbuchstaben an.

Sehen Sie sich die folgenden Beispiele an:

  • CREATE SCHEMA SCHEMA_NAME oder CREATE SCHEMA schema_name: verwenden Sie SCHEMA_NAME

  • CREATE SCHEMA "schema_name" oder CREATE SCHEMA "SCHEMA_NAME": verwenden Sie schema_name bzw. SCHEMA_NAME.

Ja

Snowflake Account Identifier

Bei Verwendung von:

  • Strategie für die Authentifizierung mit Sitzungstoken: Muss leer sein.

  • KEY_PAIR: Snowflake-Kontoname im Format [Organisationsname]-[Kontoname], wobei die Daten persistent gespeichert werden.

Ja

Snowflake Authentication Strategy

Bei Verwendung von:

  • Snowflake Openflow-Bereitstellung: Verwenden Sie SNOWFLAKE_SESSION_TOKEN. Dieses Token wird automatisch von Snowflake verwaltet.

  • BYOC: Verwenden Sie KEY_PAIR als Wert für die Authentifizierungsstrategie.

Ja

Snowflake Private Key

Bei Verwendung von:

  • Strategie für die Authentifizierung mit Sitzungstoken: Muss leer sein.

  • KEY_PAIR$RSA Muss der RSA private Schlüssel sein, der für die Authentifizierung verwendet wird.

    Der RSA-Schlüssel muss entsprechend den PKCS8-Standards formatiert sein und standardmäßige PEM-Header und Footer haben. Beachten Sie, dass entweder die private Snowflake-Schlüsseldatei oder der private Snowflake-Schlüssel definiert werden muss.

Nein

Snowflake Private Key File

Bei Verwendung von:

  • Strategie für die Authentifizierung mit Sitzungstoken: Die private Schlüsseldatei muss leer sein.

  • KEY_PAIR$RSA Laden Sie die Datei hoch, die den RSA Private Key für die Authentifizierung bei Snowflake enthält, formatiert nach PKCS8-Standards und mit Standard-PEM-Header und -Footer. Die Kopfzeile beginnt mit -----BEGIN PRIVATE. Um die private Schlüsseldatei hochzuladen, wählen Sie das Kontrollkästchen Reference asset aus.

Nein

Snowflake Private Key Password

Bei Verwendung von

  • Strategie für die Authentifizierung mit Sitzungstoken: Muss leer sein.

  • KEY_PAIR: Geben Sie das Kennwort an, das mit der privaten Snowflake-Schlüsseldatei verbunden ist.

Nein

Snowflake Role

Bei Verwendung von

  • Strategie für die Authentifizierung mit Sitzungstoken: Verwenden Sie Ihre Laufzeitrolle. Sie finden Ihre Laufzeitrolle in der Openflow-UI, indem Sie zu View Details für Ihre Laufzeitumgebung navigieren.

  • KEY_PAIR Authentifizierungsstrategie: Verwenden Sie eine gültige Rolle, die für Ihren Dienstbenutzer konfiguriert ist.

Ja

Snowflake-Benutzername

Bei Verwendung von

  • Strategie für die Authentifizierung mit Sitzungstoken: Muss leer sein.

  • KEY_PAIR: Geben Sie den Benutzernamen an, der für die Verbindung mit der Snowflake-Instanz verwendet wird.

Ja

Snowflake Warehouse

Snowflake Warehouse, das für die Ausführung von Abfragen verwendet wird.

Ja

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 Endbericht enthalten sein werden. Die Liste der verfügbaren Spalten hängt vom Berichtstyp ab und befindet sich in der Dokumentation zur Amazon Ads API. Beispiel: Für den Berichtstyp spCampaigns befindet sich die Liste der verfügbaren Spalten in der Dokumentation zu gesponserten Produkten.

Report Filters

Satz von Filtern, die zum Kürzen der zurückgegebenen Daten verwendet werden. Die Liste der verfügbaren Filter hängt vom Berichtstyp ab und befindet sich in der Dokumentation zur Amazon Ads API. Beispiel: Für den Berichtstyp spCampaigns befindet sich die Liste der verfügbaren Spalten in der Dokumentation zu gesponserten Produkten. Die Filter müssen das Format columnName=filterValue aufweisen und die Werte und müssen durch ein Komma (,) getrennt sein. Beispiel: campaignStatus=ENABLED,PAUSED.

Report Group By

Legt die Granularität fest und wie die Daten im Bericht aggregiert und dargestellt werden. Die Liste der verfügbaren „Group By“-Spalten hängt vom Berichtstyp ab und befindet sich in der Dokumentation zur Amazon Ads API. Beispiel: Für den Berichtstyp spCampaigns befindet sich die Liste der verfügbaren „Group by“-Spalten in der Dokumentation zu gesponserten Produkten.

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 für ein Aufnahmefenster an, in dem Daten während der inkrementellen Erfassung heruntergeladen werden sollen. Bei einem Berichtsaufnahmefenster von 30 Tagen beginnt ein inkrementelles Laden beispielsweise die Datenaufnahme 30 Tage vor dem Datum der letzten erfolgreichen Datenaufnahme, es sei denn, dieses berechnete Datum liegt vor dem allgemeinen Startdatum; in diesem Fall beginnt die Datenaufnahme ab dem allgemeinen Startdatum. Wenn der Datenaufnahmestrategie SNAPSHOT verwendet wird, werden alle verfügbaren Daten vom Startdatum bis zur Gegenwart heruntergeladen, sodass kein Berichtsaufnahmefenster verwendet werden muss.

Report Profile ID

Die Profil-ID, die mit einem Werbekonto 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

Die Amazon Ads API unterstützt eine Reihe von Berichtstypen. Beispiel: sbAds und spCampaigns. Kopieren Sie den Wert von reportTypeId aus der Dokumentation, und fügen Sie ihn in den Parameterwert ein.

Report Start Date

Startdatum, ab dem die Aufnahme erfolgen soll. Das Datumsformat ist YYYY-MM-DD.

Report Schedule

Zeitplan für die Erstellung von Berichten durch den Prozessor. Beispiel: 8 h oder 1 d Das h steht für Stunden und das d für Tage.

Bemerkung

Die Datenaufbewahrung in den Amazon Ads API ist ein bestimmter Zeitrahmen, der je nach Berichtstyp zwischen 60 und 365 Tagen liegt und in dem historische Daten zur Werbeperformance gespeichert werden und abrufbereit sind. Nach diesem Zeitraum sind ältere Daten möglicherweise nicht mehr verfügbar.

Führen Sie den Ablauf aus

  1. Klicken Sie mit der rechten Maustaste auf die Ebene, und wählen Sie Enable all Controller Services.

  2. Klicken Sie mit der rechten Maustaste auf die importierte Prozessgruppe, und wählen Sie Start aus.

    Der Konnektor startet die Datenaufnahme.

Sprache: Deutsch