Amazon Kinesis 연결

개요

다음 Kinesis Data Streams 서비스 기준 Amazon Web Services 에서는 대용량 데이터 레코드를 실시간으로 수집 및 처리할 수 있습니다.

에 대한 실시간 아웃바운드 연결을 만들 수 있습니다 Amazon Kinesis Adobe Experience Platform에서 데이터를 스트리밍할 수 있는 스토리지.

• 에 대한 자세한 정보 Amazon Kinesis를 참조하고 Amazon 설명서.
• 에 연결하려면 Amazon Kinesis 프로그래밍 방식으로 스트리밍 대상 API 자습서.
• 에 연결하려면 Amazon Kinesis platform 사용자 인터페이스를 사용하여 아래 섹션을 참조하십시오.

사용 사례

다음과 같은 스트리밍 대상 사용 Amazon Kinesis를 사용하면 고부가가치 세그먼테이션 이벤트 및 관련 프로필 속성을 선택한 시스템에 쉽게 제공할 수 있습니다.

예를 들어 잠재 고객이 백서를 다운로드하여 "전환율이 높은" 세그먼트로 분류하는 경우 잠재 고객이 속한 세그먼트를 Amazon Kinesis 대상, 이 이벤트를 Amazon Kinesis. 이 환경에서는 엔터프라이즈 IT 시스템에 가장 적합한 방식으로 IT 방식을 사용하고 이벤트 이외에도 비즈니스 논리를 설명할 수 있습니다.

내보내기 유형 및 빈도

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

IP 주소 허용 목록에 추가하다

Experience Platform은 고객의 보안 및 규정 준수 요구 사항을 충족하기 위해 Amazon Kinesis 대상. 을(를) 참조하십시오. 스트리밍 대상을 위한 IP 주소 허용 목록 을 클릭하여 검색할 IP의 전체 목록을 허용 목록에 추가하다 확인합니다.

필수 여부 Amazon Kinesis 권한

데이터를 성공적으로 연결하고 로 내보내려면 Amazon Kinesis 스트림, Experience Platform은 다음 작업에 대한 권한이 필요합니다.

• kinesis:ListStreams
• kinesis:PutRecord
• kinesis:PutRecords

이러한 권한은 Kinesis Platform 사용자 인터페이스에서 Kinesis 대상을 구성한 후 Platform에서 확인합니다.

아래 예에는 데이터를 로 성공적으로 내보내는 데 필요한 최소 액세스 권한이 표시됩니다 Kinesis 대상.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams",
                "kinesis:PutRecord",
                "kinesis:PutRecords"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}

액세스 제어에 대한 자세한 정보 Kinesis 데이터 스트림, 다음 읽기 Kinesis 문서.

대상에 연결

이 대상에 연결하려면 대상 구성 자습서. 이 대상에 연결할 때 다음 정보를 제공해야 합니다.

인증 정보

아래 필드를 입력하고 을(를) 선택합니다 대상에 연결:

• Amazon Web Services액세스 키 및 비밀 키: in Amazon Web Services, 생성 access key - secret access key 플랫폼에 대한 액세스 권한을 부여하기 위한 쌍 Amazon Kinesis 계정이 필요합니다. 자세한 내용은 Amazon Web Services 설명서.
• 지역: 표시할 항목 Amazon Web Services 데이터를 스트리밍할 영역입니다.

대상 세부 사항

Amazon Kinesis 대상에 인증 연결을 설정한 후 대상에 대해 다음 정보를 제공합니다.

• 이름: 연결할 이름을 입력합니다 Amazon Kinesis
• 설명: 연결에 대한 설명을 제공합니다 Amazon Kinesis.
• 스트림: 에 기존 데이터 스트림의 이름을 입력합니다 Amazon Kinesis 계정이 필요합니다. Platform에서 데이터를 이 스트림으로 내보냅니다.
• 세그먼트 이름 포함: 데이터 내보내기에 내보낼 세그먼트의 이름이 포함되도록 하려면 전환합니다. 이 옵션을 선택한 데이터 내보내기의 예는 를 참조하십시오. 내보낸 데이터 섹션을 참조하십시오.
• 세그먼트 타임스탬프 포함: 세그먼트가 생성 및 업데이트될 때 데이터 내보내기에 UNIX 타임스탬프와 세그먼트가 활성화 대상에 매핑될 때 UNIX 타임스탬프를 포함하려면 을 전환합니다. 이 옵션을 선택한 데이터 내보내기의 예는 를 참조하십시오. 내보낸 데이터 섹션을 참조하십시오.

세그먼트를 이 대상에 활성화

자세한 내용은 스트리밍 프로필 내보내기 대상으로 대상 데이터 활성화 대상 세그먼트를 이 대상으로 활성화하는 방법에 대한 지침입니다.

프로필 내보내기 동작

Experience Platform은 프로필 내보내기 동작을 로 최적화합니다 Amazon Kinesis 대상: 세그먼트 자격 또는 기타 중요한 이벤트에 따라 프로필에 대한 관련 업데이트가 발생한 경우에만 데이터를 대상에 내보냅니다. 프로필은 다음과 같은 상황에서 대상에 내보내집니다.

• 프로필 업데이트는 대상에 매핑된 세그먼트 중 하나 이상에 대한 세그먼트 멤버십 변경에 의해 결정됩니다. 예를 들어 프로필이 대상에 매핑된 세그먼트 중 하나에 적격이거나 대상에 매핑된 세그먼트 중 하나를 끝냈습니다.
• 프로필 업데이트는 id 맵. 예를 들어 대상에 매핑된 세그먼트 중 하나에 대해 이미 자격이 있는 프로필이 ID 맵 속성에 새 ID를 추가했습니다.
• 프로필 업데이트는 대상에 매핑된 특성 중 하나 이상에 대한 특성 변경에 의해 결정됩니다. 예를 들어 매핑 단계에서 대상에 매핑된 속성 중 하나가 프로필에 추가됩니다.

위에 설명된 모든 경우 관련 업데이트가 발생한 프로필만 대상으로 내보내집니다. 예를 들어 대상 플로우에 매핑된 세그먼트에 100개의 멤버가 있고 5개의 새 프로필이 세그먼트에 대한 자격이 있는 경우 대상에 내보내기는 증분 결과이며 5개의 새 프로필만 포함합니다.

변경 사항이 있는 위치에 상관없이 모든 매핑된 속성이 프로필에 대해 내보내집니다. 따라서 위의 예에서 이러한 5개의 새 프로필에 대해 매핑된 속성은 속성 자체가 변경되지 않았더라도 내보내집니다.

데이터 내보내기와 내보내기에 포함된 내용을 결정하는 것은 무엇입니까?

주어진 프로필에 대해 내보낸 데이터에 대해서는 의 두 가지 개념을 이해하는 것이 중요합니다 는 로 데이터 내보내기를 결정합니다 Amazon Kinesis 대상 및 내보내기에 포함된 데이터.

예를 들어 이 데이터 흐름을 Amazon Kinesis 대상: 데이터 흐름에서 세 개의 세그먼트를 선택하고 네 개의 속성이 대상에 매핑됩니다.

대상에 대한 프로필 내보내기는 하나 또는 둘 중 하나에 대해 자격이 있는 프로필로 결정할 수 있습니다 3개의 매핑된 세그먼트. 그러나 데이터 내보내기에서 segmentMembership 개체(참조 내보낸 데이터 아래 섹션)을 사용하면, 특정 프로필이 해당 세그먼트의 구성원일 경우 매핑되지 않은 다른 세그먼트가 나타날 수 있습니다. 프로가 DeLorinan Cars 세그먼트를 통해 고객 자격을 얻지만 또한 Viewed "Back to the Future" 영화 및 SF 팬의 멤버인 경우 다른 두 세그먼트도 함께 제공됩니다 segmentMembership 데이터가 데이터 플로우에 매핑되지 않더라도 데이터 내보내기의 객체입니다.

프로필 속성 POV에서 위에 매핑된 4개의 속성에 대한 변경 사항이 대상 내보내기를 결정하며 프로필에 있는 4개의 매핑된 속성이 데이터 내보내기에 표시됩니다.

내역 데이터 채우기

기존 대상에 새 세그먼트를 추가하거나 새 대상을 만들고 세그먼트를 대상에 매핑하면 Experience Platform이 내역 세그먼트 자격 데이터를 대상으로 내보냅니다. 세그먼트에 적합한 프로필 이전 대상에 추가된 세그먼트는 약 1시간 이내에 대상에 내보내집니다.

내보낸 데이터

내보낸 Experience Platform 데이터가 Amazon Kinesis JSON 형식으로 대상을 타깃팅합니다. 예를 들어 아래 내보내기에는 특정 세그먼트에 대해 자격이 있고 다른 두 세그먼트의 구성원이며 다른 세그먼트를 종료한 프로필이 포함되어 있습니다. 내보내기에는 프로필 속성 이름, 성, 생년월일 및 개인 이메일 주소도 포함됩니다. 이 프로필의 ID는 ECID 및 이메일입니다.

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
   "ups":{
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
         "lastQualificationTime":"2022-01-11T21:24:39Z",
         "status":"exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
         "lastQualificationTime":"2022-01-02T23:37:33Z",
         "status":"existing"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"existing"
      },
      "5114d758-ce71-43ba-b53e-e2a91d67b67f":{
         "lastQualificationTime":"2022-01-11T23:37:33Z",
         "status":"realized"
      }
   }
},
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

아래는 의 연결 대상 플로우에서 선택한 UI 설정에 따라 내보낸 데이터의 추가 예입니다 세그먼트 이름 포함 및 세그먼트 타임스탬프 포함 옵션:

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

제한 및 다시 시도 정책

시간의 95%에서 Experience Platform은 각 데이터 플로우에 대해 HTTP 대상에 대한 초당 10.000 미만의 요청과 함께 성공적으로 전송된 메시지에 대해 10분 미만의 처리량 지연을 제공하기 위해 시도합니다.

HTTP API 대상에 대한 요청이 실패한 경우 Experience Platform은 실패한 요청을 저장하고 엔드포인트로 요청을 다시 두 번 전송합니다.