Richten Sie den Massenexport für all Ihre vereinheitlichten Kundenprofildaten ein

PDFRSS

Anmerkung

Um die Schritte in diesem Thema ausführen zu können, benötigen Sie Entwicklerkenntnisse AWS KMS und Erfahrung mit Amazon S3.

Wenn Amazon Connect Customer Profiles ein einheitliches Kundenprofil erstellt, erweitert, verfeinert und verbessert es Rohdaten und Informationen zu einem genaueren Profil, indem Daten aus Quellen von Erstanbietern und Drittanbietern kombiniert werden. Customer Profiles verbessert auch 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. Möglicherweise möchten Sie das vereinheitlichte Kundenprofil beispielsweise für folgende Zwecke 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 Ihre eigenen Tools oder Produkte von Drittanbietern, um Anzeigen zu personalisieren und Kunden anzusprechen.

Um die vereinheitlichten Kundenprofildaten für weitere Anwendungsfälle zu nutzen, können Sie sie in großen Mengen nach Amazon S3 exportieren. In diesem Thema wird erklärt, wie das geht.

Schritt 1: Richten Sie einen KMS-Schlüssel und einen S3-Bucket ein

Um den Massenexport für Ihre Domain zu aktivieren, müssen Sie die folgenden Ressourcen einrichten:

• Ein KMS-Schlüssel mit einer bestimmten Ressourcenrichtlinie

• Ein Ziel-S3-Bucket mit einer bestimmten Ressourcenrichtlinie. Konfigurieren Sie keine Zugriffskontrolllisten (ACLs) für den Bucket.

Diese Schritte werden als Nächstes erklärt.

Erstellen Sie einen neuen KMS-Schlüssel oder verwenden Sie einen vorhandenen KMS-Schlüssel erneut

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 wichtigsten Richtlinie die folgende Erklärung hinzu.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Enable AppIntegrations access to KMS key",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::{{AwsAccountId}}:root"
                ],
                 "Service": [
                    "app-integrations.amazonaws.com"
                ]
            },
            "Action": [
                "kms:Encrypt*",
                "kms:Describe*",
                "kms:Decrypt*",
                "kms:GenerateDataKey*"
            ],
            "Resource": "*"
        }
    ]
}          

Richten Sie einen S3-Ziel-Bucket ein

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.

Im Folgenden finden Sie ein Beispiel für eine Ressourcenrichtlinie.

{
    "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:*-*:{{Region}}:{{AwsAccountId}}:data-integration/*" 
                }
            }
        }
    ]
} 

Schritt 2: Erstellen Sie einen Massenexportauftrag

Um einen Massenexportauftrag zu erstellen, rufen Sie den folgenden Amazon Connect AppIntegrations APIs auf:

1. CreateDataIntegration: Diese API erstellt eine Integration mit der Datenquelle (z. B. Kundenprofile).

2. CreateDataIntegrationAssociation: 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 Sie eine 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 Objekttyp „Kundenprofile“ und eine Domäne „Kundenprofile“ angeben.

Wenn Sie mehrere Objekttypen exportieren möchten, müssen Sie für jeden eine separate Datenintegration erstellen. Wenn Sie beispielsweise _profile sowohl _asset Objekte als auch exportieren möchten, müssen Sie zwei separate Datenintegrationen erstellen.

Anmerkung

Alle Daten, die innerhalb der letzten 30 Minuten aufgenommen wurden, sind möglicherweise nicht im Export enthalten.

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 Sie eine Datenintegrations-Assoziation

Eine Datenintegrationsassoziation stellt das Ziel dar, wohin Sie Ihre Daten exportieren möchten, und einen Zeitraum, in 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 EndTime Eigenschaften StartTime und. Dieser Zeitraum entspricht dem Zeitpunkt, an dem Objekte in Kundenprofilen zuletzt aktualisiert wurden.

Der Ziel-S3-Bucket, den Sie angeben, kann nur der Bucket-Name sein, oder er kann einen zusätzlichen Ordner oder ein S3-Präfix enthalten, in den die Daten exportiert werden sollen.

Anmerkung

Informationen zum Kontingent für gleichzeitige Massenexportaufträge finden Sie unterAmazon Connect Kundenprofile und Servicekontingente. Nachdem ein Massenexportauftrag abgeschlossen wurde oder fehlschlägt, wird er nicht mehr auf das Kontingent für Parallelität angerechnet.

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 Sie den 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: Sehen Sie sich die exportierten Daten in S3 an

Sobald die Datenintegrationszuordnung aktiviert istIN_PROGRESS, werden Sie feststellen, dass Daten in Ihren S3-Bucket kopiert werden.

Die exportierten Daten werden unter Verwendung der folgenden Pfadstruktur geschrieben:

• {BucketNameAndFolderName}

  • {AwsAccountId}

    • {DomainName}

      • {RequestTimestamp}

        • {lStartTime}-{EndTime}

          • {ObjectTypeName}

            • <filename: uuid>

Es folgt ein Beispielpfad:

amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012

Aktualisieren Sie den Massenexportauftrag

Nach Abschluss des Jobs können Sie die Datenintegrationszuordnung mit einer anderen Startzeit für den Datenabruf 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 Ihr letzter Massenexportauftrag beispielsweise vor drei Monaten durchgeführt wurde, können Sie Ihre Datenintegrationszuordnung mit einem Zeitraum von vor 3 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"}}' 

Den Massenexportauftrag löschen oder abbrechen — wird nicht unterstützt

Sie können den Massenexport nicht löschen oder abbrechen. Nach Abschluss eines Exportauftrags wird er nicht mehr auf Ihr Exportkontingent angerechnet.