[Ultimate]{class="badge positive"}

Google PubSub

IMPORTANT
Die Google PubSub ist im Quellkatalog für Benutzende verfügbar, die Real-Time CDP Ultimate erworben haben.

Adobe Experience Platform bietet native Konnektivität für Cloud-Anbieter wie AWS, Google Cloud Platform und Azure, sodass Sie Daten aus diesen Systemen zur Verwendung in nachgelagerten Services und Zielen in Platform importieren können.

Cloud-Speicher sind eine Quelle, von der Sie Ihre Daten in Platform übertragen können, ohne diese herunterladen, formatieren oder hochladen zu müssen. Aufgenommene Daten können als XDM JSON, XDM Parquet oder mit Trennzeichen formatiert werden. Jeder Schritt des Prozesses wird in den Quell-Workflow integriert. Mit Platform können Sie Daten aus Google PubSub in Echtzeit importieren.

Voraussetzungen prerequisites

In diesem Abschnitt wird die erforderliche Einrichtung beschrieben, die Sie durchführen müssen, bevor Sie Ihr Google PubSub-Konto mit Experience Platform verbinden.

Service-Konto erstellen create-service-account

Ein Dienstkonto ist ein Kontotyp, der häufig von einer Anwendung oder einem Compute-Workload und nicht von einer Person verwendet wird. Ein Service-Konto wird anhand seiner E-Mail-Adresse identifiziert, die eindeutig für das Konto ist.

  • Einerseits sind Dienstkonten Prinzipale - Sie können Dienstkonten Zugriff auf Google Cloud Ressourcen gewähren. Beispielsweise können Sie einem Dienstkonto die für ein bestimmtes Projekt (roles/compute.admin) Compute-Administratorrolle gewähren. Auf diese Weise kann das Service-Konto Compute-Engine-Ressourcen in diesem bestimmten Projekt verwalten.
  • Auf der anderen Seite sind Dienstkonten auch Ressourcen - Sie können anderen Prinzipalen die Berechtigung zum Zugriff auf das Dienstkonto erteilen. Sie können beispielsweise einem Benutzer die Rolle Dienstkonto-Benutzer (roles/iam.serviceAccountUser) auf einem Dienstkonto gewähren, damit der Benutzer dieses Dienstkonto mit Ressourcen verknüpfen kann. Alternativ können Sie einem Benutzer die (roles/iam.serviceAccountAdmin) „Dienstkonto-Administrator“ gewähren, damit er Aufgaben wie das Anzeigen, Bearbeiten, Deaktivieren und Löschen des Dienstkontos ausführen kann.

Weitere Informationen zur Bestimmung des richtigen Authentifizierungstyps für Ihren Anwendungsfall finden Sie im Google Handbuch zu Authentifizierungsmethoden.

Gehen Sie wie folgt vor, um ein Service-Konto zu erstellen:

Navigieren Sie zunächst zur IAM Seite der Google Developer Console und wählen Sie dann Create Service Account aus.

Das Fenster „Service-Konto erstellen“ in Google Developer Console

Geben Sie als Nächstes einen Anzeigenamen und eine ID für Ihr Service-Konto ein und wählen Sie dann Create and Continue aus.

Die Details des Service-Kontos in der Google Developer Console

Generieren von Service-Kontoschlüsseln generate-service-account-keys

Um Schlüssel für Ihr Service-Konto zu generieren, wählen Sie die Kopfzeile Schlüssel auf der Seite Service-Konten . Wählen Sie dort Add key und dann Create new key aus dem Dropdown-Menü aus. Sie können dieses Bedienfeld auch verwenden, um einen vorhandenen Schlüssel hochzuladen.

Das Fenster Schlüssel hinzufügen in der Google Developer Console

Bei erfolgreicher Ausführung erhalten Sie eine Meldung, die angibt, dass der private Schlüssel auf Ihrem Computer gespeichert wurde und eine Datei heruntergeladen wird. Sie können dann den Inhalt dieser Datei als Anmeldeinformationen verwenden, wenn Sie Ihr Google PubSub-Konto auf Experience Platform erstellen.

Berechtigungen auf Themen- und Abonnementebene erteilen grant-permissions

Um Berechtigungen auf der Themen- und Abonnementebene zu gewähren, navigieren Sie zur Seite „Themenkonsole“ und wählen Sie dann Show info panel aus. Wählen Sie anschließend auf der Registerkarte Permissions die Option Add Principal aus und fügen Sie den Service-Kontoprinzipal zusammen mit den Berechtigungen hinzu.

Das Popup-Fenster in der Google Developer Console, in dem Sie Berechtigungen auf Themen- und Abonnementebene gewähren können

Konfigurationen für optimale Google PubSub usage optimal-configurations

In diesem Abschnitt werden Konfigurationen beschrieben, die Sie vornehmen sollten, um die Verwendung der Google PubSub auf Experience Platform zu optimieren.

Abonnementeigenschaften subscription-properties

Verwenden Sie die Google Developer Console , um die Frist für die Bestätigung zu verlängern. Dadurch kann der Google Publisher entsprechend der konfigurierten Zeit warten, bevor die Nachricht erneut gesendet wird. Diese Verzögerung trägt dazu bei, unnötige Belastungen auf Teilnehmerebene zu reduzieren.

Die Benutzeroberfläche zum Bestätigungs-Deadline in Google Developer Console.

exactly one delivery aktivieren. Diese Konfiguration informiert die Google Publisher, um sicherzustellen, dass an das Abonnement gesendete Nachrichten nicht vor Ablauf der Bestätigungsfrist erneut gesendet werden. Mit dieser Einstellung können Sie sicherstellen, dass Bestätigungsnachrichten nicht erneut an das Abonnement gesendet werden.

Die genau eine Versandkonfigurationsseite in der Google Developer Console.

Sie können Retry after exponential backoff delay aktivieren, um das Risiko einer weiteren Überlastung des Servers zu reduzieren. Sie können diese Konfiguration in der Google Developer Console aktivieren, um vorübergehende Fehler (temporäre Fehler, die sich normalerweise selbst beheben) besser zu reduzieren, indem Sie dem System mehr Zeit zum Wiederherstellen geben, bevor Sie eine andere Verbindung versuchen.

Das Fenster „Richtlinie erneut versuchen“ in Google Developer Console.

Sie müssen die Aufbewahrungsdauer Ihrer Abonnementnachricht auf 24 Stunden oder mehr festlegen um sicherzustellen, dass nicht quittierte Daten bei Spitzenbelastungen nicht verloren gehen. Zusätzlich sollten Sie Dead-Letter-Thema aktivieren um sicherzustellen, dass auch in seltenen Randfällen kein Datenverlust auftritt.

IMPORTANT
Pro Google PubSub-Abonnement kann nur ein Quelldatenfluss erstellt werden. Die Wiederverwendung eines Abonnements führt selbst über Sandboxes hinweg zu Datenverlust.

Google PubSub mit Experience Platform verbinden

Die folgende Dokumentation enthält Informationen dazu, wie Sie Google PubSub mithilfe von APIs oder der Benutzeroberfläche mit Platform verbinden können:

Verwenden von APIs

Verwenden der Benutzeroberfläche

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