DokumentationExperience PlatformZielhandbuch

Google Cloud Storage-Verbindung

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

Übersicht overview

Erstellen Sie eine ausgehende Live-Verbindung zu Google Cloud Storage, um Datendateien aus Adobe Experience Platform regelmäßig in Ihre eigenen Behälter zu exportieren.

Verbindung zu Ihrem Google Cloud Storage-Speicher über API oder Benutzeroberfläche herstellen connect-api-or-ui

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.

Audience Origin
Unterstützt
Beschreibung
Segmentation Service
✓
Zielgruppen, die durch den Experience Platform Segmentierungsdienst generiert wurden.
Benutzerdefinierte Uploads
✓
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit export-type-frequency

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
Sie exportieren alle Mitglieder eines Segments zusammen mit den entsprechenden Schemafeldern, wie sie im Bildschirm „Profilattribute auswählen“ des Zielaktivierungs-Workflows ausgewählt sind.
Exporthäufigkeit
Batch
Batch-Ziele exportieren Dateien in Schritten von drei, sechs, acht, zwölf oder vierundzwanzig Stunden auf nachgelagerte Plattformen. Weitere Informationen finden Sie unter Batch-Datei-basierte Ziele.

Datensätze exportieren export-datasets

Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:

Dateiformat der exportierten Daten file-format

Beim Exportieren von Zielgruppendaten erstellt Platform eine .csv-, parquet- oder .json-Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Unterstützte Dateiformate für den Export im Tutorial zur Aktivierung der Zielgruppe.

Beim Exportieren von Datensätzen erstellt Platform eine .parquet - oder .json -Datei am von Ihnen angegebenen Speicherort. Weitere Informationen zu den Dateien finden Sie im Abschnitt Überprüfen des erfolgreichen Datensatzexports im Tutorial zum Exportieren von Datensätzen.

Vorausgesetzte Einrichtung für das Verbinden Ihres Google Cloud Storage-Kontos prerequisites

Um Platform mit Google Cloud Storage zu verbinden, müssen Sie zunächst die Interoperabilität für Ihr Google Cloud Storage-Konto aktivieren. Um auf die Interoperabilitätseinstellung zuzugreifen, öffnen Sie Google Cloud Platform und wählen Sie Einstellungen in der Option Cloud-Speicher im Navigationsbereich aus.

Das Dashboard der Google Cloud-Plattform mit Hervorhebung von Cloud-Speicher und Einstellungen.

Die Seite Einstellungen wird angezeigt. Von hier aus können Sie Informationen zu Ihrer Google-Projekt-ID und Details zu Ihrem Google Cloud Storage-Konto ansehen. Um auf die Interoperabilitätseinstellungen zuzugreifen, wählen Sie Interoperabilität aus der oberen Kopfzeile aus.

Die hervorgehobene Registerkarte „Interoperabilität“ im Dashboard der Google Cloud-Plattform.

Die Seite Interoperabilität enthält Informationen zur Authentifizierung, zu Zugriffsschlüsseln und zum Standardprojekt, das mit Ihrem Service-Konto verknüpft ist. Um eine neue Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel für Ihr Service-Konto zu generieren, wählen Sie Schlüssel für ein Service-Konto erstellen aus.

Das hervorgehobene Steuerelement „Schlüssel für ein Dienstkonto erstellen“ im Dashboard der Google Cloud-Plattform.

Sie können die neu generierte Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel verwenden, um Ihr Google Cloud Storage-Konto mit Platform zu verbinden.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen und Ziele verwalten .Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Zielkonfigurations-Workflow die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Beim Ziel authentifizieren authenticate

Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder aus und wählen Sie Mit Ziel verbinden aus.

  • Zugriffsschlüssel-ID: eine 61-stellige alphanumerische Zeichenfolge, die zur Authentifizierung Ihres Google Cloud Storage-Kontos bei Platform verwendet wird. Informationen zum Abrufen dieses Werts finden Sie im Abschnitt Voraussetzungen weiter oben.

  • Geheimer Zugriffsschlüssel: eine mit Base64 verschlüsselte Zeichenfolge mit 40 Zeichen, die zum Authentifizieren Ihre Google Cloud Storage-Kontos bei Platform verwendet wird. Informationen zum Abrufen dieses Werts finden Sie im Abschnitt Voraussetzungen weiter oben.

  • Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.

    Abbildung eines Beispiels für einen korrekt formatierten PGP-Schlüssel in der Benutzeroberfläche

Weitere Informationen zu diesen Werten finden Sie im Handbuch HMAC-Schlüssel für Google Cloud Storage. Anweisungen zum Generieren Ihrer eigenen Zugriffsschlüssel-ID und Ihres geheimen Zugriffsschlüssels finden Sie im Abschnitt Google Cloud Storage Quelle – Übersicht.

Ausfüllen der Zieldetails destination-details

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.

  • Name: Geben Sie einen bevorzugten Namen für das Ziel ein.

  • Beschreibung: Optional. Hier können Sie beispielsweise erwähnen, für welche Kampagne Sie dieses Ziel verwenden.

  • Behältername: Geben Sie den Namen des Google Cloud Storage-Behälters ein, der von diesem Ziel verwendet werden soll.

  • Ordnerpfad: Geben Sie den Pfad zum Zielordner ein, in dem die exportierten Dateien gespeichert werden.

  • Dateityp: Wählen Sie das Format, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie die Option CSV auswählen, können Sie auch die Dateiformatierungsoptionen konfigurieren.

  • Komprimierungsformat: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll.

  • Manifestdatei einschließen: Schalten Sie diese Option ein, wenn Sie möchten, dass die Exporte eine Manifest-JSON-Datei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird mit dem Format manifest-<<destinationId>>-<<dataflowRunId>>.json benannt. Anzeigen einer Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:

    • flowRunId: Der Datenfluss-Lauf , der die exportierte Datei generiert hat.
    • scheduledTime: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.
    • exportResults.sinkPath: Der Pfad in Ihrem Speicherort, an dem die exportierte Datei abgelegt wird.
    • 0: Der Name der exportierten Datei.exportResults.name
    • size: Die Größe der exportierten Datei in Byte.

Aktivieren von Warnhinweisen enable-alerts

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.

Erforderliche Google Cloud Storage-Berechtigungen required-google-cloud-storage-permission

Um Daten erfolgreich mit Ihrem Google Cloud Storage -Speicherort zu verbinden und zu exportieren, benötigen Sie die folgenden Google Cloud Storage -Berechtigungen für Ihre Behälter:

  • orgpolicy.policy.get
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storage.managedFolders.create
  • storage.multipartUploads.abort
  • storage.multipartUploads.create
  • storage.multipartUploads.listParts
  • storage.objects.create
  • storage.objects.list

Weitere Informationen zu Zugriffssteuerung und -berechtigungen in Google Cloud Storage.

Aktivieren von Zielgruppen für dieses Ziel activate

IMPORTANT
  • Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
  • Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
    Wählen Sie den im Workflow hervorgehobenen Identitäts-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profilexportziele .

Planung

Im Schritt Planung können Sie für Ihr Google Cloud Storage-Ziel den Exportplan einrichten, und Sie können dort auch den Namen Ihrer exportierten Dateien konfigurieren.

Zuordnen von Attributen und Identitäten map

Im Schritt Zuordnung können Sie festlegen, welche Attribute und Identitätsfelder für Ihre Profile exportiert werden sollen. Sie können auch festlegen, dass die Kopfzeilen in der exportierten Datei in einen beliebigen Anzeigenamen geändert werden. Weitere Informationen finden Sie im Zuordnungsschritt im Tutorial zur Benutzeroberfläche der Aktivierung von Batch-Zielen.

Überprüfen auf einen erfolgreichen Datenexport exported-data

Um festzustellen, ob die Daten erfolgreich exportiert wurden, überprüfen Sie Ihren Google Cloud Storage-Behälter und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.

Zulassungsliste von IP-Adressen ip-address-allow-list

Lesen Sie den Artikel IP-Adresse Zulassungsliste, wenn Sie einer Adobe IPs hinzufügen müssen.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6