Azure Blob-Verbindung
Ziel-Änderungsprotokoll changelog
Mit der Experience Platform-Version vom Juli 2023 wird die Azure Blob Das Ziel bietet 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.
Verbinden Sie Ihre Azure Blob Speicher über API oder Benutzeroberfläche connect-api-or-ui
- So stellen Sie eine Verbindung zu Ihrer Azure Blob Speicherort mithilfe der Platform-Benutzeroberfläche, lesen Sie die Abschnitte . Mit Ziel verbinden und Aktivieren von Zielgruppen für dieses Ziel unten.
- So stellen Sie eine Verbindung zu Ihrer Azure Blob Speicherort programmgesteuert, lesen Sie die Aktivieren von Zielgruppen für dateibasierte Ziele mithilfe des Tutorials zur 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 eine gültige Blob Ziel, können Sie den Rest dieses Dokuments überspringen und mit dem Tutorial zum Aktivieren von Zielgruppen für Ihr Ziel.
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.
Exportieren von Datensätzen 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 Zielgruppendaten, erstellt Platform eine .csv, parquetoder .json -Datei an dem Speicherort gespeichert, den Sie bereitgestellt haben. Weitere Informationen zu den Dateien finden Sie unter unterstützte Dateiformate für den Export im Tutorial zur Aktivierung der Zielgruppe.
Beim Exportieren Datensätze, erstellt Platform eine .parquet oder .json -Datei an dem Speicherort gespeichert, den Sie bereitgestellt haben. Weitere Informationen zu den Dateien finden Sie unter Ü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 der Azure Blob Storage Container, der von diesem Ziel verwendet werden soll.
-
Dateityp: Wählen Sie das Format aus, das Experience Platform für die exportierten Dateien verwenden soll. Wenn Sie CSV können Sie auch 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 JSON-Manifestdatei mit Informationen zum Exportspeicherort, zur Exportgröße und mehr enthalten. Das Manifest wird im Format
manifest-<<destinationId>>-<<dataflowRunId>>.json. Anzeigen von Beispielmanifestdatei. Die Manifestdatei enthält die folgenden Felder:flowRunId: Die dataflow run die die exportierte Datei generiert hat.scheduledTime: Die Uhrzeit in UTC, zu der die Datei exportiert wurde.exportResults.sinkPath: Der Pfad in Ihrem Speicherort, unter dem die exportierte Datei abgelegt wird.exportResults.name: Der Name der exportierten Datei.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 Ziele anzeigen, Ziele aktivieren, Anzeigen von Profilen, und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Export identities, benötigen Sie die Identitätsdiagramm anzeigen Zugriffsberechtigung.
Siehe Aktivieren von Zielgruppendaten für Batch-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel.
Ü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.