[Ultimate]{class="badge positive"}

Google PubSub source

IMPORTANT
Die Quelle "Google PubSub" steht Benutzern, die Real-time Customer Data Platform Ultimate erworben haben, im Quellkatalog zur Verfügung.

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 werden die erforderlichen Einrichtungsschritte beschrieben, die Sie ausführen müssen, bevor Sie Ihr Google PubSub-Konto mit Experience Platform verbinden.

Dienstkonto erstellen create-service-account

Ein Dienstkonto ist ein Kontotyp, der häufig von einer Anwendung verwendet wird oder den Arbeitsaufwand berechnet, anstatt von einer Person verwendet zu werden. Ein Dienstkonto wird durch seine E-Mail-Adresse identifiziert, die für das Konto eindeutig ist.

  • Zum einen sind Dienstkonten Prinzipale - Sie können Dienstkonten Zugriff auf Google Cloud -Ressourcen gewähren. Sie können beispielsweise einem Dienstkonto die Rolle "Administrator berechnen"(roles/compute.admin) für ein bestimmtes Projekt zuweisen. Dadurch kann das Dienstkonto dann die Ressourcen des Compute Engine in diesem bestimmten Projekt verwalten.
  • Andererseits sind Dienstkonten auch Ressourcen. Sie können anderen Prinzipalen Zugriff auf das Dienstkonto gewähren. Sie können einem Benutzer beispielsweise die Benutzerrolle "Dienstkonto-Benutzer"(roles/iam.serviceAccountUser) für ein Dienstkonto zuweisen, damit der Benutzer dieses Dienstkonto an Ressourcen anhängen kann. Alternativ können Sie einem Benutzer die Rolle "Dienstkonto-Admin"(roles/iam.serviceAccountAdmin) zuweisen, damit der Benutzer Aufgaben wie das Anzeigen, Bearbeiten, Deaktivieren und Löschen des Dienstkontos erledigen kann.

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

Gehen Sie wie folgt vor, um ein Dienstkonto zu erstellen:

Navigieren Sie zuerst zur Seite "IAM" des Felds "Google Developer Console" und wählen Sie dann "Create Service Account".

Das Fenster zum Erstellen eines Dienstkontos in der Google Developer Console

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

Die Details des Dienstkontos in der Google Developer Console

Generieren von Dienstkontoschlüsseln generate-service-account-keys

Um Schlüssel für Ihr Dienstkonto zu generieren, wählen Sie auf der Seite Dienstkonten die Kopfzeile Schlüssel aus. 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ügenim Google Developer Console

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

Gewähren von Berechtigungen auf Themen- und Abonnementebene grant-permissions

Um Berechtigungen auf Themen- und Abonnementebene zu erteilen, 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 dann den Prinzipal des Dienstkontos 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 die Konfigurationen beschrieben, die Sie vornehmen sollten, um die Verwendung der Google PubSub -Quelle auf dem Experience Platform zu optimieren.

Abonnementeigenschaften subscription-properties

Verwenden Sie die Google Developer Console zu Erhöhen Sie Ihren Bestätigungszeitraum. Dadurch kann Google Publisher entsprechend der von Ihnen konfigurierten Zeit warten, bevor die Nachricht erneut gesendet wird. Diese Verzögerung trägt dazu bei, unnötige Auslastung auf Abonnentenebene zu verringern.

Die Benutzeroberfläche für die Bestätigung der Frist in der Google Developer Console.

Aktivieren Sie exactly one delivery. Diese Konfiguration informiert die Google Publisher darüber, dass sichergestellt wird, dass an das Abonnement gesendete Nachrichten nicht vor Ablauf der Bestätigung erneut gesendet werden. Sie können diese Einstellung verwenden, um sicherzustellen, dass Bestätigungsnachrichten nicht an das Abonnement zurückgesendet werden.

Die genau eine Bereitstellungskonfigurationsseite in der Google Developer Console.

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

Das Fenster Richtlinie erneut versuchen in der Google Developer Console

Sie müssen die Aufbewahrungsdauer der Abonnementnachricht auf 24 Stunden oder mehr festlegen, um sicherzustellen, dass nicht bestätigte Daten bei Spitzenladevorgängen nicht verloren gehen. Außerdem aktivieren Sie ein Dead-Letter-Thema, um sicherzustellen, dass Datenverlust auch in seltenen Edge-Fällen nicht eintritt.

IMPORTANT
Pro Google PubSub Abonnement kann nur ein Datenfluss erstellt werden. Die Wiederverwendung eines Abonnements, auch über Sandboxes hinweg, führt zum 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