Azure Blob-Verbindung
Ziel-Änderungsprotokoll changelog
Mit der Experience Platform-Version vom Juli 2023 bietet das Ziel Azure Blob neue Funktionen, wie unten aufgeführt:
- Unterstützung für den Datensatzexport.
- Zusätzliche Dateibenennungsoptionen.
- Möglichkeit zum Festlegen benutzerdefinierter Datei-Kopfzeilen in exportierten Dateien durch den verbesserten Zuordnungsschritt.
- Möglichkeit zum Anpassen der Formatierung exportierter CSV-Datendateien.
Übersicht overview
Azure Blob (nachstehend: Blob) ist die Objektspeicherlösung von Microsoft für die Cloud. In diesem Tutorial finden Sie die Schritte zum Erstellen eines Blob-Ziels mithilfe der Platform-Benutzeroberfläche.
Verbindung zu Ihrem Azure Blob-Speicher über API oder Benutzeroberfläche herstellen connect-api-or-ui
- Um über die Platform-Benutzeroberfläche eine Verbindung zu Ihrem Speicherort für Azure Blob herzustellen, lesen Sie die Abschnitte Verbindung zum Ziel herstellen und Zielgruppen für dieses Ziel aktivieren weiter unten.
- Um eine programmgesteuerte Verbindung zu Ihrem Speicherort für Azure Blob herzustellen, lesen Sie das Tutorial Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe der Flow Service-API. .
Erste Schritte
Dieses Tutorial setzt ein Grundverständnis der folgenden Komponenten von Adobe Experience Platform voraus:
-
Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
- Grundlagen der Schemakomposition: Machen Sie sich mit den grundlegenden Bausteinen von XDM-Schemata vertraut, einschließlich der wichtigsten Prinzipien und Best Practices bei der Schemaerstellung.
- Tutorial zum Schema-Editor: Erfahren Sie, wie Sie benutzerdefinierte Schemata mithilfe der Benutzeroberfläche des Schema-Editors erstellen können.
-
Real-Time Customer Profile: Bietet ein einheitliches Echtzeit-Kundenprofil, das auf aggregierten Daten aus verschiedenen Quellen basiert.
Wenn Sie bereits über ein gültiges Blob -Ziel verfügen, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum Aktivieren von Zielgruppen für Ihr Ziel fortfahren.🔗
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.
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.
Datensätze exportieren export-datasets
Dieses Ziel unterstützt Datensatzexporte. Vollständige Informationen zum Einrichten von Datensatzexporten finden Sie in den Tutorials:
- Exportieren von Datensätzen mithilfe der Platform-Benutzeroberfläche🔗.
- So exportieren Datensätze programmgesteuert mit der Flow Service-API.
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.
Herstellen einer Verbindung mit dem Ziel connect
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.
-
Verbindungszeichenfolge: Die Verbindungszeichenfolge ist für den Zugriff auf Daten in Ihrem Blob-Speicher erforderlich. Das Blob-Verbindungszeichenfolgenmuster beginnt mit:
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.- Weitere Informationen zur Konfiguration der Blob-Verbindungszeichenfolge finden Sie unter Konfigurieren der Verbindungszeichenfolge für ein Azure-Speicherkonto in der Microsoft-Dokumentation.
-
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.
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 Namen ein, der Ihnen bei der Identifizierung dieses Ziels hilft.
-
Beschreibung: Geben Sie eine Beschreibung dieses Ziels ein.
-
Ordnerpfad: Geben Sie den Pfad zum Zielordner ein, in dem die exportierten Dateien gespeichert werden.
-
Container: Geben Sie den Namen des Azure Blob Storage-Containers ein, der von diesem Ziel verwendet werden soll.
-
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>>.jsonbenannt. 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.
Aktivieren von Zielgruppen für dieses Ziel activate
- 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 🔗.
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profilexportziele .
Überprüfen auf einen erfolgreichen Datenexport exported-data
Überprüfen Sie, ob die Daten erfolgreich exportiert wurden, indem Sie Ihren Azure Blob-Speicher überprüfen, und stellen Sie sicher, dass die exportierten Dateien die erwarteten Profilpopulationen enthalten.