Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Einrichten des Massenexports für alle vereinheitlichten Kundenprofildaten **Anmerkung** Um die Schritte in diesem Thema ausführen zu können, benötigen Sie Entwicklerkenntnisse AWS KMS und Erfahrung mit Amazon S3. Bei der Erstellung eines einheitlichen Kundenprofils in Amazon Connect Customer Profiles werden die Rohdaten und Informationen erweitert, verfeinert und verbessert, sodass ein genaueres Profil entsteht. Hierfür werden aus Quellen von Erst- und Drittanbietern miteinander kombiniert. Customer Profiles verbessert zudem die Qualität der Datensätze durch das Hinzufügen neuer Daten. Sie können die verbesserten Datensätze für zusätzliche Anwendungsfälle verwenden, z. B. um fundiertere und zielgerichtetere Marketing-, Vertriebs- und Kundendienststrategien zu formulieren. Sie können das einheitliche Kundenprofil beispielsweise für Folgendes nutzen: + Prüfen Sie die Kundendaten, über die Sie in der gesamten Domain verfügen. + Führen Sie interne Analysen durch, z. B. für Vertriebs- und Marketingberichte. + Exportieren Sie die Daten in eigene Tools oder Produkte von Drittanbietern, um Anzeigen zu personalisieren und Kunden zu erreichen. Sie können die vereinheitlichten Kundenprofildaten in großen Mengen nach Amazon S3 exportieren und dort für weitere Anwendungsfälle nutzen. In diesem Artikel wird erläutert, wie Sie hier vorgehen. **Topics** + [Schritt 1: Einrichten eines KMS-Schlüssels und eines S3-Buckets](#enable-cpbulk-export) + [Schritt 2: Erstellen eines Massenexport-Auftrags](#create-bulk-export-job) + [Schritt 3: Überprüfen des Status eines Massenexportauftrags](#check-status-bulk-cp-export) + [Schritt 4: Anzeigen der exportierten Daten in S3](#view-bulk-cp-export) + [Aktualisieren des Massenexportauftrags](#update-bulk-cp-export) + [Löschen oder Abbrechen des Massenexportauftrags – wird nicht unterstützt](#delete-bulk-cp-export) ## Schritt 1: Einrichten eines KMS-Schlüssels und eines S3-Buckets Um den Massenexport für Ihre Domain zu aktivieren, müssen Sie die folgenden Ressourcen einrichten: + [Einen KMS-Schlüssel mit einer bestimmten Ressourcenrichtlinie](#cp-kms) + [Einen S3-Ziel-Bucket mit einer bestimmten Ressourcenrichtlinie](#cp-s3-bulk). Konfigurieren Sie keine [Zugriffskontrolllisten (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) im Bucket. Diese Schritte werden als Nächstes erläutert. ### Erstellen eines neuen oder Verwenden eines vorhandenen KMS-Schlüssels Um einen KMS-Schlüssel für den Massenexport einzurichten, müssen Sie einen vorhandenen KMS-Schlüssel erstellen oder wiederverwenden, der sich in derselben AWS Region befindet wie der Amazon S3 S3-Bucket, den Sie als Ihr Massenexportziel konfigurieren möchten. Sie müssen dem Amazon Connect AppIntegrations Connect-Service erlauben, KMS-Aktionen für den Schlüssel durchzuführen. Fügen Sie Ihrer vorhandenen **Schlüsselrichtlinie** die folgende Anweisung hinzu. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "{{Enable AppIntegrations access to KMS key}}", "Effect": "Allow", "Principal": { "AWS": [ "{{arn:aws:iam::{{111122223333}}:root}}" ], "Service": [ "{{app-integrations.amazonaws.com}}" ] }, "Action": [ "kms:Encrypt*", "kms:Describe*", "kms:Decrypt*", "kms:GenerateDataKey*" ], "Resource": "*" } ] } ``` ------ ### Einrichten eines S3-Ziel-Buckets Sie müssen einen neuen oder vorhandenen Bucket in derselben AWS Region wie der KMS-Schlüssel konfigurieren und eine Ressourcenrichtlinie für den S3-Bucket konfigurieren. Achten Sie bei der Konfiguration des Buckets darauf, dass Sie **Verschlüsselung mit SSE-KMS** auswählen und denselben KMS-Schlüssel wie beim vorherigen Verfahren verwenden. Aktivieren Sie die Option außerdem nicht ACLs auf dem S3-Bucket. Es folgt ein Beispiel für eine Ressourcenrichtlinie. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "{{Allow AppIntegrations to write data to destination bucket}}", "Effect": "Allow", "Principal": { "Service": [ "app-integrations.amazonaws.com" ] }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": [ "arn:aws:s3:::{{{{amzn-s3-demo-bucket1}}}}", "arn:aws:s3:::{{{{amzn-s3-demo-bucket2}}}}/*" ], "Condition": { "StringEquals": { "aws:SourceAccount": "{{AwsAccountId}}" }, "ArnEquals": { "aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*" } } } ] } ``` ------ ## Schritt 2: Erstellen eines Massenexport-Auftrags Um einen Massenexportauftrag zu erstellen, rufen Sie den folgenden Amazon Connect AppIntegrations APIs auf: 1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): Diese API erstellt eine Integration mit der Datenquelle (z. B. Kundenprofile). 1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): Diese API schreibt Daten mithilfe der Datenquelle in das Ziel (z. B. einen S3-Bucket). Im Folgenden finden Sie weitere Informationen darüber, wie Sie diese aufrufen können APIs. ### Erstellen einer Datenintegration Eine Datenintegration stellt die *Datenquelle* Ihrer Daten dar. Sie können die [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API aufrufen oder den [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI-Befehl ausführen, um eine Datenintegration zu erstellen. Sie müssen einen Customer-Profiles-*Objekttyp* und eine Customer-Profiles-*Domain* angeben. Wenn Sie mehrere Objekttypen exportieren möchten, müssen Sie für jeden eine separate Datenintegration erstellen. Wenn Sie beispielsweise sowohl `_profile`- als auch `_asset`-Objekte exportieren möchten, müssen Sie zwei separate Datenintegrationen erstellen. **Anmerkung** Alle Daten, die innerhalb der letzten 30 Minuten erfasst wurden, sind möglicherweise nicht im Export enthalten. Das folgende Codebeispiel zeigt, wie der [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI-Befehl ausgeführt wird. ``` aws appintegrations create-data-integration \ --region "us-west-2" \ --name "{{bulk-export-job-01}}" \ --description "{{Data integration for _profile objects}}" \ --kms-key "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}" \ --source-uri "{{AmazonConnect://AppIntegrations}}" \ --object-configuration '{{{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}}}' ``` Das folgende Codebeispiel zeigt, wie die [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API aufgerufen wird. ``` { "Description": "{{Data integration for _profile objects}}", "KmsKey": "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}", "Name": "{{unique-data-integration-name-01}}", "SourceURI": "AmazonConnect://AppIntegrations", "ObjectConfiguration": { "CustomerProfiles": { "domainName": [ "{{my-domain-pdx}}" ], "objectType": [ "_profile" ] } } } ``` ### Erstellen einer Datenintegrationszuordnung Eine Datenintegrationszuordnung stellt das Ziel für den Export der Daten und einen Zeitraum dar, mit dem Sie auswählen können, welche Daten exportiert werden sollen. Sie können die [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API aufrufen oder den [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI-Befehl ausführen, um eine Datenintegration zu erstellen. Sie konfigurieren den Zeitraum mithilfe der Eigenschaften `StartTime` und `EndTime`. Dieser Zeitraum entspricht dem Zeitpunkt, zu dem Objekte in Kundenprofilen zuletzt aktualisiert wurden. Bei dem S3-Ziel-Bucket, den Sie angeben, kann es sich um den bloßen Bucket-Namen handeln oder er kann einen zusätzlichen Ordner oder ein S3-Präfix für den Datenexport enthalten. **Anmerkung** Informationen zum Kontingent für **gleichzeitige Massenexportaufträge** finden Sie unter [Connect Customer Kundenprofile und Servicekontingente](amazon-connect-service-limits.md#customer-profiles-quotas). Nachdem ein Massenexportauftrag abgeschlossen wurde oder fehlgeschlagen ist, wird er nicht mehr auf das Parallelitätskontingent angerechnet. Das folgende Codebeispiel zeigt, wie der [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI-Befehl ausgeführt wird. ``` aws appintegrations create-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "{{unique-data-integration-name-01}}" \ --destination-uri "{{s3://{{amzn-s3-demo-bucket1}}}}" \ --execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}' ``` Das folgende Codebeispiel zeigt, wie die [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API aufgerufen wird. ``` { "DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012", "DestinationURI": "s3://amzn-s3-demo-bucket1", "ExecutionConfiguration": { "ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": { "StartTime": "1713565000004", "EndTime": "1713565000005" } } } ``` ## Schritt 3: Überprüfen des Status eines Massenexportauftrags Um den Status Ihres Massenexportauftrags anzuzeigen, können Sie die [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API aufrufen oder den [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI-Befehl ausführen. Das folgende Codebeispiel zeigt, wie der [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI-Befehl ausgeführt wird. ``` aws appintegrations list-data-integration-associations \ --region "us-west-2" \ --data-integration-identifier "{{unique-data-integration-name-01}}" ``` ## Schritt 4: Anzeigen der exportierten Daten in S3 Sobald die Datenintegrationszuordnung über den Status `IN_PROGRESS` verfügt, werden Sie feststellen, dass Daten in den S3-Bucket kopiert werden. Die exportierten Daten werden unter Verwendung der folgenden Pfadstruktur geschrieben: + {BucketNameAndFolderName} + {AwsAccountId} + {DomainName} + {RequestTimestamp} + {lStartTime}-{EndTime} + {ObjectTypeName} + Es folgt ein Beispielpfad: `amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012` ## Aktualisieren des Massenexportauftrags Nach Abschluss des Auftrags können Sie die Datenintegrationszuordnung mit einer anderen Startzeit und einer anderen Endzeit für den Datenabruf aktualisieren. Dadurch wird ein neuer Massenexportauftrag erstellt. Dies empfiehlt sich möglicherweise, wenn Sie in der Vergangenheit einen Massenexport durchgeführt haben und nur Daten exportieren möchten, die seit dem letzten Export aktualisiert wurden. Wenn der letzte Massenexportauftrag beispielsweise vor drei Monaten durchgeführt wurde, können Sie die Datenintegrationszuordnung mit Daten aus den letzten drei Monaten bis heute aktualisieren. Sie können die [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API aufrufen oder den [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI-Befehl ausführen, um den Exportjob zu aktualisieren. Das folgende Codebeispiel zeigt, wie der [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI-Befehl ausgeführt wird. ``` aws appintegrations update-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "{{unique-data-integration-name-01}}" \ --data-integration-association-identifier "{{arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012}}" \ --execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}' ``` ## Löschen oder Abbrechen des Massenexportauftrags – wird nicht unterstützt Sie können einen Massenexport nicht löschen oder abbrechen. Nach Abschluss eines Exportauftrags wird er nicht mehr auf Ihr Exportkontingent angerechnet.