흐름 서비스 API를 사용하여 스트리밍 대상에 연결하고 데이터를 활성화합니다

IMPORTANT
대상에 연결하려면 대상 보기대상 관리 액세스 제어 권한이 필요합니다.
데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기세그먼트 보기 액세스 제어 권한이 필요합니다.
액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

이 자습서에서는 API 호출을 사용하여 Adobe Experience Platform 데이터에 연결하고, 스트리밍 클라우드 스토리지 대상(Amazon Kinesis 또는 Azure Event Hubs)에 연결하고, 새로 만든 대상에 대한 데이터 흐름을 만들고, 새로 만든 대상에 데이터를 활성화하는 방법을 보여줍니다.

이 자습서에서는 모든 예에서 Amazon Kinesis 대상을 사용하지만 단계는 Azure Event Hubs에 대해 동일합니다.

개요 - 스트리밍 대상을 만들고 대상을 활성화하는 단계

플랫폼에서 사용자 인터페이스를 사용하여 대상에 연결하고 데이터를 활성화하려면 대상 연결대상 데이터를 스트리밍 대상 내보내기 대상으로 활성화 튜토리얼을 참조하십시오.

시작하기

이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.

  • Experience Data Model (XDM) System: Experience Platform이 고객 경험 데이터를 구성하는 표준화된 프레임워크입니다.
  • Catalog Service: Catalog은(는) Experience Platform 내의 데이터 위치와 계보에 대한 레코드 시스템입니다.
  • 샌드박스: Experience Platform은 단일 플랫폼 인스턴스를 별도의 가상 환경으로 분할하여 디지털 경험 애플리케이션을 개발하고 발전시키는 데 도움이 되는 가상 샌드박스를 제공합니다.

다음 섹션에서는 Platform의 스트리밍 대상에 데이터를 활성화하기 위해 알아야 하는 추가 정보를 제공합니다.

필요한 자격 증명 수집

이 자습서의 단계를 완료하려면 대상을 연결하고 활성화하는 대상 유형에 따라 다음 자격 증명을 준비해야 합니다.

  • Amazon Kinesis 연결의 경우: accessKeyId, secretKey, region 또는 connectionUrl
  • Azure Event Hubs 연결의 경우: sasKeyName, sasKey, namespace

샘플 API 호출 읽기 reading-sample-api-calls

이 튜토리얼에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 형식의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용된 규칙에 대한 자세한 내용은 Experience Platform 문제 해결 안내서의 예제 API 호출을 읽는 방법에 대한 섹션을 참조하십시오.

필수 및 선택적 헤더에 대한 값 수집 gather-values

Platform API를 호출하려면 먼저 인증 자습서를 완료해야 합니다. 인증 자습서를 완료하면 아래와 같이 모든 Experience Platform API 호출에서 필요한 각 헤더의 값이 제공됩니다.

  • 인증: 전달자 {ACCESS_TOKEN}
  • x-api 키: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Experience Platform의 리소스는 특정 가상 샌드박스로 격리될 수 있습니다. Platform API에 대한 요청에서 작업이 수행될 샌드박스의 이름과 ID를 지정할 수 있습니다. 이러한 매개 변수는 선택 사항입니다.

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Experience Platform의 샌드박스에 대한 자세한 내용은 샌드박스 개요 설명서를 참조하세요.

페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 미디어 유형 헤더가 필요합니다.

  • Content-Type: application/json

Swagger 설명서 swagger-docs

Swagger의 이 자습서에서 모든 API 호출에 대한 동반 참조 설명서를 찾을 수 있습니다. Adobe I/O🔗에서 흐름 서비스 API 설명서를 참조하십시오. 이 자습서와 Swagger 설명서 페이지를 동시에 사용하는 것이 좋습니다.

사용 가능한 스트리밍 대상 목록 가져오기 get-the-list-of-available-streaming-destinations

대상 단계 개요 1단계

첫 번째 단계로 데이터를 활성화할 스트리밍 대상을 결정해야 합니다. 먼저, 대상자를 연결하고 활성화할 수 있는 사용 가능한 대상 목록을 요청하는 호출을 수행합니다. connectionSpecs 끝점에 대해 다음 GET 요청을 수행하여 사용 가능한 대상 목록을 반환합니다.

API 형식

GET /connectionSpecs

요청

curl --location --request GET 'https://platform.adobe.io/data/foundation/flowservice/connectionSpecs' \
--header 'accept: application/json' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'

응답

성공적인 응답에는 사용 가능한 대상 목록과 해당 고유 식별자(id)가 포함되어 있습니다. 사용할 대상의 값을 저장합니다. 이 값은 이후 단계에서 필수입니다. 예를 들어 대상자를 Amazon Kinesis 또는 Azure Event Hubs에 연결하여 전달하려면 응답에서 다음 코드 조각을 찾습니다.

{
    "id": "86043421-563b-46ec-8e6c-e23184711bf6",
  "name": "Amazon Kinesis",
  ...
  ...
}

{
    "id": "bf9f5905-92b7-48bf-bf20-455bc6b60a4e",
  "name": "Azure Event Hubs",
  ...
  ...
}

Experience Platform 데이터에 연결 connect-to-your-experience-platform-data

대상 단계 개요 2단계

다음으로, 프로필 데이터를 내보내고 원하는 대상에서 활성화할 수 있도록 Experience Platform 데이터에 연결해야 합니다. 이 단계는 아래에 설명된 두 개의 하위 단계로 구성됩니다.

  1. 먼저 기본 연결을 설정하여 Experience Platform의 데이터에 대한 액세스 권한을 부여하는 호출을 수행해야 합니다.
  2. 그런 다음 기본 연결 ID를 사용하여 Experience Platform 데이터에 대한 연결을 설정하는 소스 연결을 만드는 다른 호출을 만듭니다.

Experience Platform에서 데이터에 대한 액세스 권한 인증

API 형식

POST /connections

요청

curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/connections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
            "name": "Base connection to Experience Platform",
            "description": "This call establishes the connection to Experience Platform data",
            "connectionSpec": {
                "id": "{CONNECTION_SPEC_ID}",
                "version": "1.0"
            }
}'
  • {CONNECTION_SPEC_ID}: 프로필 서비스에 대한 연결 사양 ID 사용 - 8a9c3494-9708-43d7-ae3f-cda01e5030e1.

응답

성공한 응답에는 기본 연결의 고유 식별자(id)가 포함되어 있습니다. 다음 단계에서 소스 연결을 만드는 데 필요한 대로 이 값을 저장합니다.

{
    "id": "1ed86558-59b5-42f7-9865-5859b552f7f4"
}

Experience Platform 데이터에 연결 connect-to-platform-data

API 형식

POST /sourceConnections

요청

curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
            "name": "Connecting to Profile Service",
            "description": "Optional",
            "connectionSpec": {
                "id": "{CONNECTION_SPEC_ID}",
                "version": "1.0"
            },
            "baseConnectionId": "{BASE_CONNECTION_ID}",
            "data": {
                "format": "json"
            },
            "params": {}
}'
  • {BASE_CONNECTION_ID}: 이전 단계에서 얻은 ID를 사용합니다.
  • {CONNECTION_SPEC_ID}: 프로필 서비스에 대한 연결 사양 ID 사용 - 8a9c3494-9708-43d7-ae3f-cda01e5030e1.

응답

성공한 응답은 프로필 서비스에 새로 만든 원본 연결에 대한 고유 식별자(id)를 반환합니다. 이를 통해 Experience Platform 데이터에 성공적으로 연결되었음을 알 수 있습니다. 이 값은 이후 단계에서 필요한 대로 저장하십시오.

{
    "id": "ed48ae9b-c774-4b6e-88ae-9bc7748b6e97"
}

스트리밍 대상에 연결 connect-to-streaming-destination

대상 단계 개요 3단계

이 단계에서는 원하는 스트리밍 대상에 대한 연결을 설정합니다. 이 단계는 아래에 설명된 두 개의 하위 단계로 구성됩니다.

  1. 먼저 기본 연결을 설정하여 스트리밍 대상에 대한 액세스 권한을 부여하는 호출을 수행해야 합니다.
  2. 그런 다음 기본 연결 ID를 사용하여 저장소 계정에서 내보낸 데이터가 전달될 위치와 내보낼 데이터 형식을 지정하는 대상 연결을 만드는 다른 호출을 만듭니다.

스트리밍 대상에 대한 액세스 권한 부여

API 형식

POST /connections

요청

IMPORTANT
아래 예에는 // 접두사가 있는 코드 주석이 포함되어 있습니다. 이러한 주석은 서로 다른 스트리밍 대상에 대해 서로 다른 값을 사용해야 하는 위치를 강조 표시합니다. 코드 조각을 사용하기 전에 주석을 제거하십시오.
curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/connections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Connection for Amazon Kinesis/ Azure Event Hubs",
    "description": "summer advertising campaign",
    "connectionSpec": {
        "id": "{_CONNECTION_SPEC_ID}",
        "version": "1.0"
    },
    "auth": {
        "specName": "{AUTHENTICATION_CREDENTIALS}",
        "params": { // use these values for Amazon Kinesis connections
            "accessKeyId": "{ACCESS_ID}",
            "secretKey": "{SECRET_KEY}",
            "region": "{REGION}"
        },
        "params": { // use these values for Azure Event Hubs connections
            "sasKeyName": "{SAS_KEY_NAME}",
            "sasKey": "{SAS_KEY}",
            "namespace": "{EVENT_HUB_NAMESPACE}"
        }
    }
}'
  • {CONNECTION_SPEC_ID}: 사용 가능한 대상 목록 가져오기 단계에서 얻은 연결 사양 ID를 사용합니다.
  • {AUTHENTICATION_CREDENTIALS}: 스트리밍 대상의 이름을 입력하십시오. Aws Kinesis authentication credentials 또는 Azure EventHub authentication credentials.
  • {ACCESS_ID}: Amazon Kinesis개 연결용 입니다. Amazon Kinesis 저장소 위치에 대한 액세스 ID입니다.
  • {SECRET_KEY}: Amazon Kinesis개 연결용 입니다. Amazon Kinesis 저장소 위치에 대한 비밀 키입니다.
  • {REGION}: Amazon Kinesis개 연결용 입니다. Amazon Kinesis 계정의 영역으로서 플랫폼이 데이터를 스트리밍합니다.
  • {SAS_KEY_NAME}: Azure Event Hubs개 연결용 입니다. SAS 키 이름을 입력하십시오. Microsoft 설명서에서 SAS 키를 사용하여 Azure Event Hubs에 인증하는 방법에 대해 알아봅니다.
  • {SAS_KEY}: Azure Event Hubs개 연결용 입니다. SAS 키를 입력하십시오. Microsoft 설명서에서 SAS 키를 사용하여 Azure Event Hubs에 인증하는 방법에 대해 알아봅니다.
  • {EVENT_HUB_NAMESPACE}: Azure Event Hubs개 연결용 입니다. 플랫폼이 데이터를 스트리밍할 Azure Event Hubs 네임스페이스를 채웁니다. 자세한 내용은 Microsoft 설명서의 이벤트 허브 네임스페이스 만들기를 참조하십시오.

응답

성공한 응답에는 기본 연결의 고유 식별자(id)가 포함되어 있습니다. 다음 단계에서 대상 연결을 만드는 데 필요한 대로 이 값을 저장합니다.

{
    "id": "1ed86558-59b5-42f7-9865-5859b552f7f4"
}

저장소 위치 및 데이터 형식 지정

API 형식

POST /targetConnections

요청

IMPORTANT
아래 예에는 // 접두사가 있는 코드 주석이 포함되어 있습니다. 이러한 주석은 서로 다른 스트리밍 대상에 대해 서로 다른 값을 사용해야 하는 위치를 강조 표시합니다. 코드 조각을 사용하기 전에 주석을 제거하십시오.
curl --location --request POST 'https://platform.adobe.io/data/foundation/flowservice/targetConnections' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Amazon Kinesis/ Azure Event Hubs target connection",
    "description": "Connection to Amazon Kinesis/ Azure Event Hubs",
    "baseConnectionId": "{BASE_CONNECTION_ID}",
    "connectionSpec": {
        "id": "{CONNECTION_SPEC_ID}",
        "version": "1.0"
    },
    "data": {
        "format": "json"
    },
    "params": { // use these values for Amazon Kinesis connections
        "stream": "{NAME_OF_DATA_STREAM}",
        "region": "{REGION}"
    },
    "params": { // use these values for Azure Event Hubs connections
        "eventHubName": "{EVENT_HUB_NAME}"
    }
}'
  • {BASE_CONNECTION_ID}: 위의 단계에서 얻은 기본 연결 ID를 사용하십시오.
  • {CONNECTION_SPEC_ID}: 사용 가능한 대상 목록 가져오기 단계에서 얻은 연결 사양을 사용합니다.
  • {NAME_OF_DATA_STREAM}: Amazon Kinesis개 연결용 입니다. Amazon Kinesis 계정에 기존 데이터 스트림의 이름을 제공합니다. 플랫폼에서 데이터를 이 스트림으로 내보냅니다.
  • {REGION}: Amazon Kinesis개 연결용 입니다. Platform에서 데이터를 스트리밍할 Amazon Kinesis 계정의 지역입니다.
  • {EVENT_HUB_NAME}: Azure Event Hubs개 연결용 입니다. 플랫폼이 데이터를 스트리밍할 Azure Event Hub 이름을 입력합니다. 자세한 내용은 Microsoft 설명서에서 이벤트 허브 만들기를 참조하십시오.

응답

응답이 성공하면 스트리밍 대상에 새로 만든 대상 연결에 대한 고유 식별자(id)가 반환됩니다. 이 값은 이후 단계에서 필요에 따라 저장합니다.

{
    "id": "12ab90c7-519c-4291-bd20-d64186b62da8"
}

데이터 흐름 만들기

대상 단계 개요 4단계

이제 이전 단계에서 얻은 ID를 사용하여 Experience Platform 데이터와 데이터를 활성화할 대상 사이에 데이터 흐름을 만들 수 있습니다. 이 단계는 나중에 Experience Platform과 원하는 대상 간에 데이터가 흐르는 파이프라인을 구성하는 것으로 생각됩니다.

데이터 흐름을 만들려면 페이로드 내에 아래에 언급된 값을 제공하면서 아래 표시된 대로 POST 요청을 수행합니다.

데이터 흐름을 만들려면 다음 POST 요청을 수행하십시오.

API 형식

POST /flows

요청

curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/flows' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d  '{
  "name": "Azure Event Hubs",
  "description": "Azure Event Hubs",
  "flowSpec": {
    "id": "{FLOW_SPEC_ID}",
    "version": "1.0"
  },
  "sourceConnectionIds": [
    "{SOURCE_CONNECTION_ID}"
  ],
  "targetConnectionIds": [
    "{TARGET_CONNECTION_ID}"
  ],
  "transformations": [
    {
      "name": "GeneralTransform",
      "params": {
        "profileSelectors": {
          "selectors": [

          ]
        },
        "segmentSelectors": {
          "selectors": [

          ]
        }
      }
    }
  ]
}
  • {FLOW_SPEC_ID}: 프로필 기반 대상의 흐름 사양 ID는 71471eba-b620-49e4-90fd-23f1fa0174d8입니다. 호출에서 이 값을 사용합니다.
  • {SOURCE_CONNECTION_ID}: Experience Platform에 연결 단계에서 얻은 원본 연결 ID를 사용합니다.
  • {TARGET_CONNECTION_ID}: 스트리밍 대상에 연결 단계에서 얻은 대상 연결 ID를 사용합니다.

응답

성공한 응답은 새로 만든 데이터 흐름의 ID(id) 및 etag을(를) 반환합니다. 두 값을 모두 기록해 둡니다. 다음 단계에서 수행할 것처럼 대상자를 활성화합니다.

{
    "id": "8256cfb4-17e6-432c-a469-6aedafb16cd5",
    "etag": "8256cfb4-17e6-432c-a469-6aedafb16cd5"
}

새 대상에 데이터 활성화 activate-data

대상 단계 개요 5단계

모든 연결 및 데이터 흐름을 만들었으므로 이제 프로필 데이터를 스트리밍 플랫폼에 활성화할 수 있습니다. 이 단계에서는 대상으로 전송할 대상과 프로필 속성을 선택하고 데이터를 예약하고 대상으로 전송할 수 있습니다.

새 대상에 대상을 활성화하려면 아래 예제와 유사한 JSON PATCH 작업을 수행해야 합니다. 한 번의 호출로 여러 대상과 프로필 속성을 활성화할 수 있습니다. JSON PATCH에 대한 자세한 내용은 RFC 사양을 참조하세요.

API 형식

PATCH /flows

요청

curl --location --request PATCH 'https://platform.adobe.io/data/foundation/flowservice/flows/{DATAFLOW_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--header 'If-Match: "{ETAG}"' \
--data-raw '[
  {
    "op": "add",
    "path": "/transformations/0/params/segmentSelectors/selectors/-",
    "value": {
      "type": "PLATFORM_SEGMENT",
      "value": {
        "name": "Name of the audience that you are activating",
        "description": "Description of the audience that you are activating",
        "id": "{SEGMENT_ID}"
      }
    }
  },
  {
    "op": "add",
    "path": "/transformations/0/params/profileSelectors/selectors/-",
    "value": {
      "type": "JSON_PATH",
      "value": {
        "operator": "EXISTS",
        "path": "{PROFILE_ATTRIBUTE}"
      }
    }
  }
]
속성
설명
{DATAFLOW_ID}
URL에서 이전 단계에서 생성한 데이터 흐름의 ID를 사용합니다.
{ETAG}

이전 단계의 응답에서 {ETAG}을(를) 가져옵니다. 데이터 흐름 만들기. 이전 단계의 응답 형식에서 따옴표를 이스케이프 처리했습니다. 요청의 헤더에서 이스케이프되지 않은 값을 사용해야 합니다. 아래 예제를 참조하십시오.

  • 응답 예: "etag":""7400453a-0000-1a00-0000-62b1c7a90000""
  • 요청에 사용할 값: "etag": "7400453a-0000-1a00-0000-62b1c7a90000"

데이터 흐름이 성공적으로 업데이트될 때마다 etag 값이 업데이트됩니다.

{SEGMENT_ID}
이 대상으로 내보낼 대상 ID를 제공합니다. 활성화하려는 대상에 대해 대상 ID를 검색하려면 Experience Platform API 참조에서 대상 정의 검색을 참조하십시오.
{PROFILE_ATTRIBUTE}
예, "person.lastName"
op
데이터 흐름을 업데이트하는 데 필요한 작업을 정의하는 데 사용되는 작업 호출입니다. 작업에는 add, replaceremove이(가) 포함됩니다. 데이터 흐름에 대상을 추가하려면 add 작업을 사용하십시오.
path
플로우에서 업데이트할 부분을 정의합니다. 데이터 흐름에 대상을 추가할 때는 예제에 지정된 경로를 사용하십시오.
value
매개 변수를 업데이트할 새 값입니다.
id
대상 데이터 흐름에 추가할 대상자의 ID를 지정합니다.
name
선택 사항. 대상 데이터 흐름에 추가할 대상자의 이름을 지정합니다. 이 필드는 필수가 아니므로 이름을 제공하지 않고 대상 데이터 흐름에 대상을 성공적으로 추가할 수 있습니다.

응답

202 OK 응답을 찾습니다. 응답 본문이 반환되지 않습니다. 요청이 올바른지 확인하려면 다음 단계인 데이터 흐름 유효성 검사를 참조하십시오.

데이터 흐름 유효성 검사

대상 단계 개요 6단계

자습서의 마지막 단계에서는 대상 및 프로필 속성이 실제로 데이터 흐름에 올바르게 매핑되었는지 확인해야 합니다.

유효성을 검사하려면 다음 GET 요청을 수행하십시오.

API 형식

GET /flows

요청

curl --location --request PATCH 'https://platform.adobe.io/data/foundation/flowservice/flows/{DATAFLOW_ID}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'Content-Type: application/json' \
--header 'x-sandbox-name: prod' \
--header 'If-Match: "{ETAG}"'
  • {DATAFLOW_ID}: 이전 단계의 데이터 흐름을 사용합니다.
  • {ETAG}: 이전 단계의 etag를 사용합니다.

응답

반환된 응답에는 이전 단계에서 제출한 대상 및 프로필 특성이 transformations 매개 변수에 포함되어야 합니다. 응답의 샘플 transformations 매개 변수는 다음과 같습니다.

"transformations": [
    {
        "name": "GeneralTransform",
        "params": {
            "profileSelectors": {
                        "selectors": [
                            {
                                "type": "JSON_PATH",
                                "value": {
                                    "path": "personalEmail.address",
                                    "operator": "EXISTS"
                                }
                            },
                            {
                                "type": "JSON_PATH",
                                "value": {
                                    "path": "person.lastname",
                                    "operator": "EXISTS"
                                }
                            }
                        ]
                    },
            "segmentSelectors": {
                "selectors": [
                    {
                        "type": "PLATFORM_SEGMENT",
                        "value": {
                            "name": "Men over 50",
                            "description": "",
                            "id": "72ddd79b-6b0a-4e97-a8d2-112ccd81bd02"
                        }
                    }
                ]
            }
        }
    }
],

내보낸 데이터

IMPORTANT
새 대상으로 데이터 활성화 단계의 프로필 특성 및 대상 외에 AWS Kinesis 및 Azure Event Hubs에서 내보낸 데이터에는 ID 맵에 대한 정보도 포함됩니다. 내보낸 프로필의 ID(예: ECID, 모바일 ID, Google ID, 이메일 주소 등)를 나타냅니다. 아래 예를 참조하십시오.
{
  "person": {
    "email": "yourstruly@adobe.com"
  },
  "segmentMembership": {
    "ups": {
      "72ddd79b-6b0a-4e97-a8d2-112ccd81bd02": {
        "lastQualificationTime": "2020-03-03T21:24:39Z",
        "status": "exited"
      },
      "7841ba61-23c1-4bb3-a495-00d695fe1e93": {
        "lastQualificationTime": "2020-03-04T23:37:33Z",
        "status": "realized"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Postman 컬렉션을 사용하여 스트리밍 대상에 연결 collections

이 자습서에서 설명한 스트리밍 대상에 보다 능률적인 방식으로 연결하려면 Postman을(를) 사용할 수 있습니다.

Postman은(는) API를 호출하고 사전 정의된 호출 및 환경의 라이브러리를 관리하는 데 사용할 수 있는 도구입니다.

이 자습서에서는 다음 Postman개의 컬렉션이 첨부되어 있습니다.

  • AWS Kinesis Postman 컬렉션
  • Azure Event Hubs Postman 컬렉션

컬렉션 보관 파일을 다운로드하려면 여기를 클릭하세요.

각 컬렉션에는 각각 AWS Kinesis 및 Azure Event Hub에 필요한 요청과 환경 변수가 포함되어 있습니다.

Postman 컬렉션을 사용하는 방법 how-to-use-postman-collections

첨부된 Postman 컬렉션을 사용하여 대상에 성공적으로 연결하려면 다음 단계를 수행하십시오.

  • Postman 다운로드 및 설치
  • 첨부된 컬렉션을 다운로드하고 압축 해제합니다.
  • 해당 폴더에서 Postman (으)로 컬렉션을 가져옵니다.
  • 이 문서의 지침에 따라 환경 변수를 입력합니다.
  • 이 문서의 지침에 따라 Postman에서 API 요청을 실행합니다.

API 오류 처리 api-error-handling

이 자습서의 API 끝점은 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 오류 응답 해석에 대한 자세한 내용은 플랫폼 문제 해결 안내서의 API 상태 코드요청 헤더 오류를 참조하십시오.

다음 단계 next-steps

이 자습서에 따라 선호하는 스트리밍 대상 중 하나에 플랫폼을 연결하고 각 대상에 대한 데이터 흐름을 설정했습니다. 이제 나가는 데이터를 고객 분석 또는 수행하려는 기타 데이터 작업을 위한 대상에서 사용할 수 있습니다. 자세한 내용은 다음 페이지를 참조하십시오.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6