16.3 Verbinden von GCP und BigQuery mit Adobe Experience Platform

Ziele

  • API und Dienste in der Google Cloud-Plattform
  • Machen Sie sich mit OAuth Playground vertraut, um Google APIs zu testen
  • Erste BigQuery-Verbindung in Adobe Experience Platform erstellen

Kontext

Adobe Experience Platform stellt einen Connector innerhalb von Sources bereit, der Ihnen hilft, BigQuery-Datensätze in Adobe Experience Platform zu importieren. Dieser Datenanschluss basiert auf der Google BigQuery-API. Daher ist es wichtig, Ihre Google Cloud-Plattform und Ihre BigQuery-Umgebung ordnungsgemäß vorzubereiten, um API-Aufrufe von Adobe Experience Platform zu empfangen.

Zum Konfigurieren des BigQuery Source Connector in Adobe Experience Platform benötigen Sie die folgenden 4 Werte:

  • Projekt
  • clientId
  • clientSecret
  • refreshToken

Bislang haben Sie nur die erste, die Projekt-ID. Dieser Wert Projekt-ID ist eine zufällige ID, die von Google generiert wurde, als Sie Ihr BigQuery-Projekt während Übung 16.1 erstellt haben.

Kopieren Sie die Projekt-ID in eine separate Textdatei.

Berechtigung Namenskonvention Beispiel
Projekt-ID random zusammensetzung-Aufgabe-306413

Sie können Ihre Projekt-ID jederzeit überprüfen, indem Sie in der oberen Menüleiste auf Projektname klicken:

demo

Sie sehen die Projekt-ID auf der rechten Seite:

demo

In dieser Übung lernen Sie, wie Sie die anderen 3 erforderlichen Felder abrufen können:

  • clientId
  • clientSecret
  • refreshToken

16.3.1 Google Cloud-API und -Dienste

Gehen Sie zum Beginn zurück zur Startseite der Google Cloud-Plattform. Klicken Sie dazu einfach auf das Logo in der oberen linken Ecke Ihres Bildschirms.

demo

Sobald Sie sich auf der Startseite befinden, wechseln Sie zum linken Menü und klicken Sie auf APIs und Dienste und klicken Sie dann auf Dashboard.

demo

Sie sehen nun die Homepage APIs und Dienste.

demo

Auf dieser Seite können Sie die Nutzung Ihrer verschiedenen Google API-Verbindungen sehen. Um eine API-Verbindung einzurichten, damit Adobe Experience Platform von BigQuery lesen kann, müssen Sie die folgenden Schritte ausführen:

  • Zunächst müssen Sie einen OAuth-Bildschirm für die Zustimmung erstellen, um künftige Authentifizierungen zu ermöglichen. Die Sicherheitsgründe von Google erfordern auch, dass ein Mensch die erste Authentifizierung vornimmt, bevor ein programmatischer Zugriff erlaubt ist.
  • Zweitens benötigen Sie API-Anmeldeinformationen (clientId und clientSecret), die für die API-Authentifizierung und den Zugriff auf Ihren BigQuery Connector verwendet werden.

16.3.2 OAuth-Bildschirm "Zustimmung"

Beginn zum Erstellen des Bildschirms für die OAuth-Zustimmung. Klicken Sie im linken Menü auf der Homepage APIs und Dienste auf OAuth-Bildschirm für die Einwilligung.

demo

Dann sehen Sie Folgendes:

demo

Wählen Sie den Benutzertyp aus: External. Klicken Sie anschließend auf CREATE.

demo

Sie befinden sich dann im Fenster OAuth Konfiguration des Bildschirms für die Zustimmung.

Hier müssen Sie nur den Namen des Bildschirms für die Einwilligung in das Feld Anwendungsname eingeben und die E-Mail zur Benutzerunterstützung auswählen. Verwenden Sie für den Anwendungsnamen folgende Benennungsregel:

Namenskonvention Beispiel
ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector

demo

Führen Sie anschließend einen Bildlauf nach unten durch, bis Kontaktinformationen für Entwickler angezeigt werden, und füllen Sie eine E-Mail-Adresse aus.

demo

Klicken Sie auf SPEICHERN UND FORTFAHREN.

demo

Dann sehen Sie das. Klicken Sie auf SPEICHERN UND FORTFAHREN.

demo

Dann sehen Sie das. Klicken Sie auf SPEICHERN UND FORTFAHREN.

demo

Dann sehen Sie das. Klicken Sie auf ZURÜCK ZU DASHBOARD.

demo

Dann sehen Sie das. Klicken Sie auf PUBLISH APP.

demo

Klicken Sie auf CONFIRM.

demo

Dann sehen Sie das.

demo

Im nächsten Schritt beenden Sie die API-Einrichtung und erhalten Ihre API-Anmeldeinformationen.

16.3.3 Google API-Anmeldeinformationen: geheimer Clientschlüssel und Client-ID

Klicken Sie im linken Menü auf Berechtigungen. Dann sehen Sie Folgendes:

demo

Klicken Sie auf die Schaltfläche + CREDENTIALS ERSTELLEN.

demo

Es werden drei Optionen angezeigt. Klicken Sie auf die OAuth Client-ID:

demo

Wählen Sie im nächsten Bildschirm Webanwendung.

demo

Es werden mehrere neue Felder angezeigt. Sie müssen nun die Name der OAuth-Client-ID eingeben und auch die Autorisierten Umleitungs-URIs eingeben.

Befolgen Sie die folgende Benennungsregel:

Feld Wert Beispiel
Name ldap - AEP BigQuery Connector vangeluw - Platform BigQuery Connector
Autorisierte Umleitungs-URIs https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

Das Feld Autorisierte Umleitungs-URIs ist ein sehr wichtiges Feld, da Sie es später benötigen, um das RefreshToken zu erhalten, das Sie zum Abschluss der Einrichtung des BigQuery Source Connector in Adobe Experience Platform benötigen.

demo

Bevor Sie fortfahren, müssen Sie nach Eingabe der URL die Schaltfläche Enter physisch drücken, um den Wert im Feld Autorisierte Umleitungs-URIs zu speichern. Wenn Sie nicht auf die Schaltfläche Eingabetaste klicken, treten zu einem späteren Zeitpunkt im Ordner OAuth 2.0 Playground Probleme auf.

Klicken Sie anschließend auf Erstellen:

demo

Jetzt sehen Sie Ihre Client-ID und Ihren geheimen Clientschlüssel.

demo

Kopieren Sie diese beiden Felder und fügen Sie sie in eine Textdatei auf Ihrem Desktop ein. Sie können auf diese Anmeldedaten jederzeit zu einem späteren Zeitpunkt zugreifen. Es ist jedoch einfacher, sie in einer Textdatei neben Ihrer BigQuery Project-ID zu speichern.

Die folgenden Werte stehen Ihnen als Referenz für Ihr BigQuery Source Connector-Setup in Adobe Experience Platform bereits zur Verfügung:

BigQuery Connector-Berechtigungen Wert
Projekt-ID Ihre eigene Projekt-ID (z. B.: zusammensetzung-Aufgabe-306413)
clientid yourclientid
cilsecret yourclientsecret

Das refreshToken fehlt noch. Das refreshToken ist aus Sicherheitsgründen eine Anforderung. In der Welt der APIs laufen Token normalerweise alle 24 Stunden ab. Daher ist das refreshToken erforderlich, um das Sicherheits-Token alle 24 Stunden zu aktualisieren, damit Ihr Source Connector-Setup weiterhin eine Verbindung zur Google Cloud-Plattform und BigQuery herstellen kann.

16.3.4 BigQuery API und das refreshToken

Es gibt viele Möglichkeiten, ein refreshToken für den Zugriff auf Google Cloud-Plattform-APIs abzurufen. Eine dieser Optionen ist z.B. Postman.
Google hat jedoch etwas einfacher zu testen und mit ihren APIs zu spielen, ein Tool namens OAuth 2.0 Playground.

Um auf OAuth 2.0 Playground zuzugreifen, gehen Sie zu https://developers.google.com/oauthplayground.

Anschließend sehen Sie die Homepage OAuth 2.0 Playground.

demo

Klicken Sie oben rechts auf dem Bildschirm auf das Symbol Getriebe:

demo

Achten Sie darauf, dass Ihre Einstellungen mit denen im Bild oben übereinstimmen.

Dublette überprüfen Sie die Einstellungen, um 100% sicher zu sein.

Wenn Sie fertig sind, markieren Sie das Feld Verwenden Sie Ihre eigenen OAuth-Anmeldeinformationen

demo

Es sollten zwei Felder angezeigt werden, für die Sie den Wert haben.

demo

Bitte füllen Sie die folgenden Felder aus:

API-Einstellungen für Wiedergabe Ihre Google API-Anmeldeinformationen
OAuth Client-ID Ihre eigene Client-ID (in der Textdatei auf Ihrem Desktop)
OAuth Client Secret Ihren eigenen geheimen Clientschlüssel (in der Textdatei auf Ihrem Desktop)

demo

Kopieren Sie die Dateien Client-ID und Clientgeheimnis aus der Textdatei, die Sie auf Ihrem Desktop erstellt haben.

demo

Nachdem Sie Ihre Anmeldedaten ausgefüllt haben, klicken Sie auf Schließen

demo

Im linken Menü sehen Sie alle verfügbaren Google-APIs. Suchen Sie nach BigQuery API v2.

demo

Wählen Sie dann den Bereich wie in der folgenden Abbildung angegeben aus:

demo

Nachdem Sie sie ausgewählt haben, sollte eine blaue Schaltfläche mit der Meldung APIs autorisieren angezeigt werden. Klicken Sie darauf.

demo

Wählen Sie das Google-Konto aus, das Sie zum Einrichten von GCP und BigQuery verwendet haben.

Möglicherweise sehen Sie eine große Warnung: Diese App ist nicht verifiziert. Dies geschieht, weil Ihr Platform BigQuery Connector noch nicht offiziell überprüft wurde. Google weiß also nicht, ob es sich um eine authentische App handelt oder nicht. Sie sollten diese Benachrichtigung ignorieren.

Klicken Sie auf Erweitert.

demo

Klicken Sie anschließend auf Zu ldap - AEP BigQuery Connector (unsafe).

demo

Sie werden zu unserem OAuth-Bildschirm für die Zustimmung weitergeleitet, den Sie erstellt haben.

demo

Wenn Sie die Zweifaktorauthentifizierung (2FA) verwenden, geben Sie den an Sie gesendeten Bestätigungscode ein.

demo

Google zeigt Ihnen jetzt acht verschiedene Berechtigungen-Aufforderungen an. Klicken Sie für alle acht Berechtigungsanfragen auf Allow. (Dies ist ein Verfahren, das einmal von einem echten Menschen befolgt und bestätigt werden muss, bevor die API programmatische Anfragen zulässt.)

Wieder werden acht verschiedene Popup-Fenster nicht angezeigt. Sie müssen für alle auf Zulassen klicken.

demo

Nach den acht Berechtigungsanforderungen wird diese Übersicht angezeigt. Klicken Sie auf Allow, um den Prozess abzuschließen.

demo

Nach dem letzten Allow-Klick werden Sie zurück zum OAuth 2.0-Playground gesendet und Sie sehen Folgendes:

demo

Klicken Sie auf Exchange-Autorisierungscode für Tokens.

demo

Nach einigen Sekunden wird die Ansicht Schritt 2 - Exchange-Autorisierungscode für Tokens automatisch geschlossen. Sie sehen Schritt 3 - Anforderung für API konfigurieren.

Sie müssen zum Schritt 2 Exchange-Autorisierungscode für Tokens zurückkehren. Klicken Sie daher erneut auf Schritt 2 Exchange-Autorisierungscode für Token, um das Aktualisierungstoken anzuzeigen.

demo

Sie sehen nun das Aktualisierungstoken.

demo

Kopieren Sie das Aktualisierungstoken und fügen Sie es zusammen mit den anderen BigQuery Source Connector-Anmeldeinformationen in die Textdatei auf Ihrem Desktop ein:

BigQuery Source Connector-Berechtigungen Wert
Projekt-ID Ihre eigene zufällige Projekt-ID (z. B.: apt-Summer-273608)
clientid yourclientid
cilsecret yourclientsecret
refreshToken yourrefreshToken

Als Nächstes richten wir Ihren Source Connector in Adobe Experience Platform ein.

Übung 16.3.5 - Plattform mit eigener BigQuery-Tabelle verbinden

Melden Sie sich unter folgender URL bei Adobe Experience Platform an: https://experience.adobe.com/platform.

Nach dem Anmelden landen Sie auf der Homepage von Adobe Experience Platform.

Datenaufnahme

Bevor Sie fortfahren, müssen Sie eine Sandbox auswählen. Die auszuwählende Sandbox trägt den Namen --aepSandboxId--. Klicken Sie dazu auf den Text Produktions-Prod in der blauen Zeile oben auf Ihrem Bildschirm.

Datenaufnahme

Nachdem Sie die entsprechende Sandbox ausgewählt haben, sehen Sie die Änderung des Bildschirms, und jetzt befinden Sie sich in Ihrer eigenen Sandbox.

Datenaufnahme

Gehen Sie im linken Menü zu Quellen.

demo

Anschließend sehen Sie die Homepage Quellen. Klicken Sie im Menü Quellen auf Datenbanken.

demo

Klicken Sie auf die Karte Google BigQuery. Klicken Sie anschließend auf + Konfigurieren.

demo

Sie sollten jetzt eine neue Verbindung erstellen.

Klicken Sie auf Neues Konto. Sie müssen nun alle unten stehenden Felder ausfüllen, basierend auf dem Setup, das Sie in GCP und BigQuery durchgeführt haben.

demo

Beginn: Benennen Sie die Verbindung:

Bitte verwenden Sie diese Benennungsregel:

BigQuery Connector-Berechtigungen Wert Beispiel
Kontoname ldap - BigQuery Connection vangeluw - BigQuery-Verbindung
Beschreibung ldap - BigQuery Connection vangeluw - BigQuery-Verbindung

Was sollte Ihnen so etwas geben:

demo

Füllen Sie anschließend die GCP- und BigQuery-API Kontoauthentifizierung-Details aus, die Sie in einer Textdatei auf Ihrem Desktop gespeichert haben:

BigQuery Connector-Berechtigungen Wert
Projekt-ID Ihre eigene zufällige Projekt-ID (z. B.: apt-Summer-273608)
clientId
clientSecret
refreshToken

Ihre Kontoauthentifizierung-Details sollten nun wie folgt aussehen:

demo

Nachdem Sie alle diese Felder ausgefüllt haben, klicken Sie auf Mit Quelle verbinden.

demo

Wenn Ihre Kontoauthentifizierung korrekt ausgefüllt wurden, sollte nun eine visuelle Bestätigung angezeigt werden, dass die Verbindung ordnungsgemäß funktioniert. Die Bestätigung Verbunden wird angezeigt.

demo

Nachdem Sie Ihre Verbindung hergestellt haben, klicken Sie auf Weiter:

demo

Sie sehen nun den BigQuery-Datensatz, den Sie während Übung 16.2 erstellt haben.

demo

Gut gemacht! In der nächsten Übung laden Sie Daten aus dieser Tabelle und ordnen sie einem Schema und einem Datensatz in Adobe Experience Platform zu.

Nächster Schritt: 16.4 Daten von BigQuery nach Adobe Experience Platform laden

Zurück zu Modul 16

Zurück zu allen Modulen

Auf dieser Seite