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

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

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

이 튜토리얼에서는 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 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 Experience Platform 문제 해결 안내서에서 참조하십시오.

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

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

  • 인증: 전달자 {ACCESS_TOKEN}
  • x-api-key: {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)가 포함된 모든 요청에는 추가 미디어 유형 헤더가 필요합니다.

  • 컨텐츠 유형: application/json

Swagger 설명서 swagger-docs

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

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

대상 단계 개요 1단계

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

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 키 이름을 입력합니다. 에 대한 인증에 대해 알아보기 Azure Event Hubs 의 SAS 키 Microsoft 설명서.
  • {SAS_KEY}: 대상 Azure Event Hubs 연결. SAS 키를 입력합니다. 에 대한 인증에 대해 알아보기 Azure Event Hubs 의 SAS 키 Microsoft 설명서.
  • {EVENT_HUB_NAMESPACE}: 대상 Azure Event Hubs 연결. 다음을 입력합니다. Azure Event Hubs platform이 데이터를 스트리밍하는 네임스페이스입니다. 자세한 내용은 이벤트 허브 네임스페이스 만들기 다음에서 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 platform이 데이터를 스트리밍할 이름입니다. 자세한 내용은 이벤트 허브 만들기 다음에서 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}: 단계에서 얻은 소스 연결 ID를 사용합니다 Experience Platform에 연결.
  • {TARGET_CONNECTION_ID}: 단계에서 얻은 target 연결 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, replace, 및 remove. 데이터 흐름에 대상을 추가하려면 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;
  • 이 문서의 지침에 따라 환경 변수를 입력합니다.
  • 실행 API 의 요청 Postman, 이 문서의 지침을 기반으로 합니다.

API 오류 처리 api-error-handling

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

다음 단계 next-steps

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

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