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

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:

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.

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:

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:

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 CreateDataIntegrationAPI aufrufen oder den create-data-integrationCLI-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.

Das folgende Codebeispiel zeigt, wie der create-data-integrationCLI-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 CreateDataIntegrationAPI 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 CreateDataIntegrationAssociationAPI aufrufen oder den create-data-integration-associationCLI-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.

Das folgende Codebeispiel zeigt, wie der create-data-integration-associationCLI-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 CreateDataIntegrationAssociationAPI 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 ListDataIntegrationAssociationsAPI aufrufen oder den list-data-integration-associationsCLI-Befehl ausführen.

Das folgende Codebeispiel zeigt, wie der list-data-integration-associationsCLI-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:

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 UpdateDataIntegrationAssociationAPI aufrufen oder den update-data-integration-associationCLI-Befehl ausführen, um den Exportjob zu aktualisieren.

Das folgende Codebeispiel zeigt, wie der update-data-integration-associationCLI-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.