[Ultimate]{class="badge positive"}

Erstellen eines Quell-Connectors für Google PubSub in der Benutzeroberfläche

IMPORTANT
Die Google PubSub ist im Quellkatalog für Benutzende verfügbar, die Real-time Customer Data Platform Ultimate erworben haben.

In diesem Tutorial werden Schritte zum Erstellen eines Google PubSub (nachstehend „PubSub“ genannt) in der Benutzeroberfläche von Platform beschrieben.

Erste Schritte

Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
  • Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.

Wenn Sie bereits über eine gültige PubSub-Verbindung verfügen, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum Konfigurieren eines Datenflusses fortfahren.

Sammeln erforderlicher Anmeldedaten

Sie müssen Werte für die unten beschriebenen Verbindungseigenschaften angeben, um Ihr PubSub-Konto mit Experience Platform zu verbinden. Weitere Informationen zur Authentifizierung und zur Einrichtung vorausgesetzter Komponenten finden Sie unter PubSub source Übersicht.

Projektbasierte Authentifizierung
table 0-row-2 1-row-2 2-row-2
Anmeldedaten Beschreibung
Projekt-ID Die zur Authentifizierung von PubSub erforderliche Projekt-ID.
Anmeldedaten Die zum Authentifizieren von PubSub erforderlichen Anmeldedaten. Sie müssen sicherstellen, dass Sie die vollständige JSON-Datei ablegen, nachdem Sie die Leerzeichen aus Ihren Anmeldeinformationen entfernt haben.
Topic- und abonnementbasierte Authentifizierung
table 0-row-2 1-row-2 2-row-2 3-row-2
Anmeldedaten Beschreibung
Anmeldedaten Die zum Authentifizieren von PubSub erforderlichen Anmeldedaten. Sie müssen sicherstellen, dass Sie die vollständige JSON-Datei ablegen, nachdem Sie die Leerzeichen aus Ihren Anmeldeinformationen entfernt haben.
Themenname Der Name Ihres PubSub. In PubSub können Sie mit Abonnements Nachrichten empfangen, indem Sie das Thema abonnieren, in dem Nachrichten veröffentlicht wurden. Hinweis: Ein einzelnes PubSub kann nur für einen Datenfluss verwendet werden. Um mehrere Datenflüsse durchzuführen, müssen Sie über mehrere Abonnements verfügen.
Abonnementname Der Name Ihres PubSub. In PubSub können Sie mit Abonnements Nachrichten empfangen, indem Sie das Thema abonnieren, in dem Nachrichten veröffentlicht wurden.

Weitere Informationen zu diesen Werten finden Sie im folgenden Dokument PubSub-Authentifizierung. Wenn Sie die auf dem Service-Account basierende Authentifizierung verwenden, lesen Sie das folgende PubSub-Handbuch, in dem die Schritte zum Generieren Ihrer Anmeldedaten beschrieben werden.

TIP
Wenn Sie die auf Service-Konten basierende Authentifizierung verwenden, stellen Sie sicher, dass Sie einen ausreichenden Benutzerzugriff auf Ihr Service-Konto gewährt haben und dass in JSON keine zusätzlichen Leerzeichen vorhanden sind, wenn Sie Ihre Anmeldedaten kopieren und einfügen.

Nachdem Sie die erforderlichen Anmeldedaten zusammen haben, können Sie die folgenden Schritte ausführen, um Ihr PubSub-Konto mit Platform zu verknüpfen.

Verbinden Sie Ihr PubSub-Konto

Wählen Sie in der Platform-Benutzeroberfläche in der linken Navigationsleiste die Option Quellen, um auf den Arbeitsbereich Quellen zuzugreifen. Der Katalog zeigt eine Vielzahl von Quellen an, mit denen Sie ein Konto erstellen können.

Sie können die gewünschte Kategorie aus dem Katalog auf der linken Bildschirmseite auswählen. Alternativ können Sie die gewünschte Quelle mithilfe der Suchoption finden.

Wählen Sie unter der Kategorie Cloud-Speicherplatz die Option Google PubSub und dann die Option Daten hinzufügen aus.

Der Quellkatalog auf der Experience Platform-Benutzeroberfläche.

Die Seite Verbinden mit Google PubSub wird angezeigt. Auf dieser Seite können Sie entweder neue oder vorhandene Anmeldedaten verwenden.

Vorhandenes Konto

Um ein vorhandenes Konto zu verwenden, wählen Sie das PubSub-Konto, mit dem Sie einen neuen Datenfluss erstellen möchten, und klicken Sie dann auf Weiter, um fortzufahren.

Die Auswahl eines vorhandenen Kontos im Quell-Workflow.

Neues Konto

TIP
  • Beim Erstellen eines Kontos mit eingeschränktem Zugriff müssen Sie mindestens einen Themennamen oder einen Abonnementnamen angeben. Die Authentifizierung schlägt fehl, wenn beide Werte fehlen.
  • Nach der Erstellung können Sie den Authentifizierungstyp einer Google PubSub Basisverbindung nicht mehr ändern. Um den Authentifizierungstyp zu ändern, müssen Sie eine neue Basisverbindung erstellen.

Wenn Sie ein neues Konto erstellen, wählen Sie Neues Konto und geben Sie dann einen Namen und eine optionale Beschreibung für Ihr neues PubSub-Konto an.

Die neue Kontoschnittstelle für die Google PubSub-Quelle im Quell-Workflow

Mit der PubSub können Sie den Zugriffstyp angeben, den Sie während der Authentifizierung zulassen möchten. Sie können für Ihr Konto entweder eine projektbasierte Authentifizierung oder eine themen- und abonnementbasierte Authentifizierung einrichten. Mit der projektbasierten Authentifizierung können Sie Zugriff auf das Stammprojekt in Ihrem Konto gewähren, während Sie mit der themen- und abonnementbasierten Authentifizierung den Zugriff auf ein bestimmtes PubSub Thema und Abonnement einschränken können.

Projektbasierte Authentifizierung

So erstellen Sie ein Konto mit Zugriff auf den Stammordner PubSub Projektordners. Wählen Sie Anmeldedaten für die Google PubSub- als Authentifizierungstyp aus und geben Sie Ihre Projekt-ID und Ihre Anmeldedaten an. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Die neue Kontoschnittstelle für die Google PubSub-Quelle mit ausgewähltem Stammzugriff.

Topic- und abonnementbasierte Authentifizierung

Um ein Konto mit eingeschränktem Zugriff nur auf ein bestimmtes PubSub Thema und Abonnement zu erstellen, wählen Sie Authentifizierungsdaten für Google PubSub-Bereich und geben Sie dann Ihre Anmeldeinformationen, Ihren Themennamen und/oder Ihren Abonnementnamen an. Wenn Sie fertig sind, wählen Sie Mit Quelle verbinden und warten Sie, bis die neue Verbindung hergestellt ist.

Die neue Kontoschnittstelle für die Google PubSub-Quelle mit ausgewähltem Bereichszugriff.

NOTE
Einem PubSub Projekt zugewiesene Prinzipale (Rollen) werden in allen Themen und Abonnements übernommen, die in einem PubSub Projekt erstellt werden. Wenn Sie möchten, dass ein Prinzipal (eine Rolle) Zugriff auf ein bestimmtes Thema hat, muss dieser Prinzipal (diese Rolle) auch zum entsprechenden Abonnement des Themas hinzugefügt werden. Weitere Informationen finden Sie in der PubSub Dokumentation zur Zugriffssteuerung.

Daten auswählen

Bei einer erfolgreichen Authentifizierung gelangen Sie zum Schritt Daten auswählen, in dem Sie durch Ihre PubSub navigieren und die Daten auswählen können, die Sie zum Experience Platform bringen möchten.

Projektbasierte Authentifizierung

Wenn Sie sich mit projektbasiertem Zugriff authentifiziert haben, zeigt die Daten auswählen-Schnittstelle alle Abonnements in Ihrem Projekt an, an die ein Thema angehängt ist.

Der Schritt „Daten auswählen“ des Quell-Workflows mit projektbasierter Authentifizierung.

Topic- und abonnementbasierte Authentifizierung

Wenn Sie sich mit einem Thema und einem abonnementbasierten Zugriff authentifiziert haben, kann die Anzeige der Daten auswählen von den von Ihnen bereitgestellten Informationen abhängen.

  • Wenn Sie nur den Themennamen angeben, zeigt die Benutzeroberfläche alle Themen-Abonnement-Paare an, die dem angegebenen Thema entsprechen.
  • Wenn Sie nur den Abonnementnamen angeben, zeigt die Benutzeroberfläche alle Themen-Abonnementpaare an, die dem angegebenen Abonnementnamen entsprechen.
  • Wenn sowohl Themen- als auch Abonnementnamen angegeben werden, zeigt die Schnittstelle das Themen-/Abonnementpaar an, das beiden angegebenen Werten entspricht.

Der Schritt „Daten auswählen“ des Quell-Workflows mit themen- und abonnementbasierter Authentifizierung.

Nächste Schritte

In diesem Tutorial haben Sie eine Verbindung zwischen Ihrem PubSub-Konto und Platform hergestellt. Sie können jetzt mit dem nächsten Tutorial fortfahren und einen Datenfluss konfigurieren, um Streaming-Daten aus Ihrem Cloud-Speicher in Platform zu übertragen.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089