설명서Experience Platform대상 안내서

에지에서 실시간으로 프로필 속성 조회

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 사용자

Adobe Experience Platform은(는) 실시간 고객 프로필을(를) 모든 프로필 데이터에 대한 신뢰할 수 있는 단일 소스로 사용합니다. 빠른 실시간 데이터 검색을 위해 Edge Network에 배포되는 간단한 프로필인 Edge 프로필을 사용합니다. 이를 통해 빠르고 실시간 개인화 사용 사례를 만들 수 있습니다.

사용 사례 use-cases

다음은 에지 프로필 조회가 도움이 될 수 있는 두 가지 사용 사례입니다.

  • 실시간 Personalization: Edge 프로필에서 프로필 정보를 빠르게 검색하여 웹 사이트에서 사용자 경험을 개인화합니다.
  • 고객 지원: 고객이 지원 센터 상담원을 호출할 때 실시간으로 프로필 정보를 검색합니다.

이 페이지에서는 개인화 경험을 전달하거나 다운스트림 애플리케이션을 통해 의사 결정 규칙을 알리기 위해 Edge 프로필 데이터를 실시간으로 조회하기 위해 수행해야 하는 단계에 대해 설명합니다.

용어 및 사전 요구 사항 prerequisites

이 페이지에 설명된 사용 사례를 구성할 때는 다음 Experience Platform 구성 요소를 사용하게 됩니다.

  • 데이터스트림: 데이터스트림은 Web SDK에서 들어오는 이벤트 데이터를 수신하고 에지 프로필 데이터로 응답합니다.
  • 병합 정책: 에지 프로필에서 올바른 프로필 데이터를 사용하도록 Active-On-Edge 병합 정책을 만듭니다.
  • 사용자 지정 Personalization 연결: 프로필 특성을 Edge Network에 전송하는 새 사용자 지정 개인화 연결을 구성합니다.
  • Edge Network API: Edge Network API 대화형 데이터 수집 기능을 사용하여 Edge 프로필에서 프로필 특성을 빠르게 검색합니다.

성능 가드레일 guardrails

Edge 프로필 조회 사용 사례는 아래 표에 설명된 특정 성능 가드레일의 영향을 받습니다. Edge Network API 보호 기능에 대한 자세한 내용은 보호 기능 설명서 페이지를 참조하십시오.

Edge Network 서비스
에지 세분화
초당 요청 수
Edge Network API를 통해 사용자 지정 개인화 대상
예
1500
Edge Network API를 통해 사용자 지정 개인화 대상
아니요
1500

1단계: 데이터 스트림 만들기 및 구성 create-datastream

데이터 스트림 구성 설명서의 단계에 따라 다음 Service 설정으로 새 데이터 스트림을 만드십시오.

  • Service:Adobe Experience Platform
  • Personalization Destinations: 활성화됨
  • Edge Segmentation: 가장자리 세분화가 필요한 경우 이 옵션을 사용하도록 설정하십시오. 에지에서 프로필 속성을 찾는 데만 관심이 있지만 에지 프로필을 기반으로 세분화를 수행하지 않으려면 이 옵션을 비활성화합니다.

데이터 스트림 구성 화면을 표시하는 Experience Platform UI 이미지입니다.

2단계: Edge 평가를 위한 대상 구성 audience-edge-evaluation

Edge에서 프로필 속성을 조회하려면 Edge 평가를 위해 대상을 구성해야 합니다.

활성화하려는 대상에 Active-on-Edge 병합 정책이(가) 기본값으로 설정되어 있는지 확인하십시오. Active-On-Edge 병합 정책을 사용하면 대상이 Edge에서 지속적으로 평가되고 실시간 개인화 사용 사례에 사용할 수 있습니다.

병합 정책 만들기의 지침을 따라 Active-On-Edge Merge Policy 전환을 사용하도록 설정하십시오.

IMPORTANT
대상이 다른 병합 정책을 사용하는 경우 에지에서 프로필 속성을 검색할 수 없고 에지 프로필 조회를 수행할 수 없습니다.

3단계: Edge Network에 프로필 속성 데이터 보내기 configure-custom-personalization-connection

속성 및 대상 멤버십 데이터를 포함하여 에지 프로필을 실시간으로 조회하려면 Edge Network에서 데이터를 사용할 수 있도록 해야 합니다. 이를 위해 Custom Personalization With Attributes 대상에 대한 연결을 만들고 가장자리 프로필에서 조회할 특성을 포함하여 대상을 활성화해야 합니다.

특성 연결을 사용하여 사용자 지정 Personalization 구성

새 대상 연결을 만드는 방법에 대한 자세한 지침은 대상 연결 만들기 자습서를 따르십시오.

새 대상을 구성할 때는 ​ 필드의 ​단계 1 Datastream ID​에서 만든 데이터 스트림을 선택하십시오. Integration alias​의 경우 대상 이름과 같이 나중에 이 대상 연결을 식별하는 데 도움이 되는 모든 값을 사용할 수 있습니다.

특성을 가진 사용자 지정 Personalization 구성 화면을 표시하는 Experience Platform UI 이미지입니다.

속성을 사용한 사용자 지정 Personalization 연결에 대한 대상자 활성화

Custom Personalization With Attributes 연결을 만든 후에는 이제 프로필 데이터를 Edge Network으로 보낼 준비가 되었습니다.

note important
IMPORTANT
  • 데이터를 활성화하고 워크플로우의 매핑 단계을(를) 활성화하려면 View Destinations, Activate Destinations, View Profiles 및 View Segments 액세스 제어 권한이 필요합니다.
액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

  1. Connections > Destinations(으)로 이동하여 Catalog 탭을 선택합니다.

    Experience Platform UI에서 강조 표시된 대상 카탈로그 탭

  2. Custom Personalization With Attributes 대상 카드를 찾은 다음 아래 그림과 같이 Activate audiences​을(를) 선택합니다.

    카탈로그의 대상 카드에 강조 표시된 대상 컨트롤을 활성화합니다.

  3. 이전에 구성한 대상 연결을 선택한 다음 Next​을(를) 선택합니다.

    활성화 워크플로에서 대상 단계를 선택하십시오.

  4. 대상을 선택합니다. 대상 이름 왼쪽의 확인란을 사용하여 대상에 대해 활성화할 대상을 선택한 다음 Next​을(를) 선택합니다.

    출처에 따라 여러 유형의 대상 중에서 선택할 수 있습니다.

    • Segmentation Service: 세분화 서비스에 의해 Experience Platform 내에서 생성된 대상자입니다. 자세한 내용은 세그먼테이션 설명서를 참조하세요.

    • Custom upload: Experience Platform 외부에서 생성되어 Experience Platform에 CSV 파일로 업로드된 대상자입니다. 외부 대상자에 대한 자세한 내용은 대상자 가져오기에 대한 설명서를 참조하십시오.

    • 다른 Adobe 솔루션에서 가져온 다른 유형의 대상(예: Audience Manager).

      여러 대상이 강조 표시된 활성화 워크플로의 대상 선택 단계입니다.

  5. 모서리 프로파일에 사용할 수 있게 하려는 프로파일 속성을 선택합니다.

    • 원본 특성을 선택하십시오. 소스 특성을 추가하려면 Add new field 열에서 Source field 컨트롤을 선택하고 아래와 같이 원하는 XDM 특성 필드를 검색하거나 탐색합니다.

      매핑 단계에서 대상 특성을 선택하는 방법을 보여 주는 화면 기록입니다.

    • 대상 특성을 선택하십시오. 대상 특성을 추가하려면 Add new field 열에서 Target field 컨트롤을 선택하고 원본 특성을 매핑할 사용자 지정 특성 이름을 입력합니다.

      매핑 단계에서 XDM 특성을 선택하는 방법을 보여 주는 화면 녹화

프로필 특성 매핑을 마치면 Next​을(를) 선택합니다.

Review 페이지에서 선택 항목의 요약을 볼 수 있습니다. Cancel​을(를) 선택하여 흐름을 분류하거나, Back​을(를) 선택하여 설정을 수정하거나, Finish​을(를) 선택하여 선택을 확인하고 프로필 데이터를 Edge Network으로 전송합니다.

검토 단계의 선택 요약입니다.

동의 정책 평가

조직에서 Adobe Healthcare Shield 또는 Adobe Privacy & Security Shield​을(를) 구입한 경우 View applicable consent policies​을(를) 선택하여 적용되는 동의 정책 및 그 결과로 활성화에 포함되는 프로필 수를 확인합니다. 자세한 내용은 동의 정책 평가를 참조하세요.

데이터 사용 정책 확인

Review 단계에서 Experience Platform은 데이터 사용 정책 위반도 확인합니다. 다음은 정책이 위반되는 예입니다. 위반을 해결할 때까지 대상 활성화 워크플로우를 완료할 수 없습니다. 정책 위반을 해결하는 방법에 대한 자세한 내용은 데이터 거버넌스 설명서 섹션에서 데이터 사용 정책 위반을 읽어 보십시오.

데이터 정책 위반의 예입니다.

대상자 필터링

Review 단계에서는 페이지에서 사용 가능한 필터를 사용하여 이 워크플로우의 일부로 일정이나 매핑이 업데이트된 대상자만 표시할 수 있습니다. 보려는 테이블 열을 전환할 수도 있습니다.

검토 단계에서 사용 가능한 대상 필터를 보여 주는 화면 기록입니다.

선택한 내용에 만족하고 정책 위반이 발견되지 않은 경우 Finish​을(를) 선택하여 선택 내용을 확인합니다.

4단계: 모서리에서 프로필 속성 조회 configure-edge-profile-lookup

이제 데이터 스트림 구성을 완료하고 특성 대상 연결이 있는 새 사용자 지정 Personalization을 만들었습니다. 그리고 이 연결을 사용하여 프로필 특성을 보냅니다. 그러면 Edge Network을 조회할 수 있습니다.

다음 단계는 Edge 프로필에서 프로필 속성을 검색하도록 개인화 솔루션을 구성하는 것입니다.

IMPORTANT
프로필 속성에 중요한 데이터가 포함될 수 있습니다. 이 데이터를 보호하려면 Edge Network API를 통해 프로필 특성을 검색해야 합니다. 또한 API 호출을 인증하려면 Edge Network API 대화형 데이터 수집 끝점을 통해 프로필 특성을 검색해야 합니다.
위의 요구 사항을 따르지 않는 경우 개인화는 대상 멤버십만을 기반으로 하며 프로필 속성을 사용할 수 없습니다.

단계 1에서 구성한 데이터 스트림이 이제 들어오는 이벤트 데이터를 수락하고 Edge 프로필 정보로 응답할 준비가 되었습니다.

아래 예에 표시된 대로 Edge 프로필 정보를 검색하도록 통합을 구성합니다.

요청 request

Edge 프로필 데이터를 검색하려면 아래와 같이 이벤트에 포함된 프로필 특성을 찾는 기본 ID를 사용하여 빈 POST 호출을 /interact 끝점으로 보냅니다.

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
    "event":
    {
        "xdm": {
            "identityMap": {
                "Email": [
                    {
                        "id":"test123@adobetest.com",
                        "primary":true
                    }
                ]
            }
        }
    }

}'
매개변수
유형
필수 여부
설명
dataStreamId
String
예.
단계 1에서 만든 데이터 스트림의 데이터 스트림 ID입니다.

응답 response

성공적인 응답은 프로필이 에지에서 발견되었는지 여부에 따라 아래 탭의 예제와 유사한 정보를 포함하는 200 OK 개체와 함께 HTTP 상태 Handle을(를) 반환합니다.

NOTE
API 응답은 모듈식이며 handle 개체에는 다양한 유형의 여러 payload 개체가 포함될 수 있습니다. 에지 프로필 조회와 관련된 정보는 payload을(를) 사용하여 "type": "activation:pull" 개체 아래에 그룹화됩니다.
프로필이 가장자리에 있음

프로필이 Edge에 존재하는 경우 Edge에 대해 활성화된 프로필 속성 및 대상에 따라 아래 속성과 유사한 속성 및 대상 멤버십을 갖는 응답을 기대할 수 있습니다.

code language-json 
{
  "requestId": "3c600138-d785-42ca-a025-bb725f4b5da9",
  "handle": [
    {
      "payload": [
        {
          "type": "profileLookup",
          "destinationId": "9218b727-ec59-4a46-b8b9-05503f138c5d",
          "alias": "rk-demo-custom-personalization-XXXX",
          "attributes": {
            "zip": {
              "value": "19000"
            },
            "firstName": {
              "value": "Test"
            },
            "lastName": {
              "value": "User123"
            },
            "gender": {
              "value": "male"
            },
            "city": {
              "value": "Philadelphia"
            },
            "state": {
              "value": "PA"
            },
            "email": {
              "value": "test123@adobetest.com"
            }
          },
          "segments": [
            {
              "id": "85018bd8-7ad1-4e17-ae30-8389c04bd3c0",
              "namespace": "ups"
            },
            {
              "id": "d09a8159-8b30-4178-b2f2-7a8c5e3168d9",
              "namespace": "ups"
            }
          ]
        }
      ],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

handle 개체는 아래 표에 설명된 정보를 제공합니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto
매개변수 설명
payload 에지 조회 정보가 포함된 payload 개체입니다. 이 응답에는 에지 조회와 관련 없는 payload 개체가 여러 개 더 포함될 수 있습니다.
type 페이로드는 응답에서 유형별로 그룹화됩니다. 에지 프로필 조회에 대한 페이로드 유형이 항상 profileLookup(으)로 설정되어 있습니다.
destinationId Custom Personalization​단계 3에서 만든 ​ 연결 인스턴스의 ID입니다.
alias 사용자 지정 Personalization 대상 연결을 만들 때 사용자가 구성한 대상 연결의 별칭입니다.
attributes 이 배열에는 3단계에서 활성화한 대상자의 Edge 프로필 특성이 포함되어 있습니다.
segments 이 배열에는 3단계에서 활성화한 대상이 포함되어 있습니다.
type handle개의 개체가 유형별로 그룹화되었습니다. 에지 프로필 조회 사용 사례의 경우 handle 개체의 유형은 항상 activation:pull입니다.
eventIndex Edge Network은 클라이언트로부터 배열 형태로 이벤트를 수신합니다. 배열의 이벤트 순서는 처리 중에 유지되며 이 인덱스에 반영됩니다. 이벤트 인덱싱이 0(으)로 시작됩니다.
프로필이 가장자리에 없습니다

프로필이 에지에 존재하지 않으면 아래 응답과 유사한 응답을 예상할 수 있습니다.

code language-json 
{
  "requestId": "531b541a-4541-419e-ac99-fd7e452f0c0f",
  "handle": [
    {
      "payload": [],
      "type": "activation:pull",
      "eventIndex": 0
    }
  ]
}

handle 개체는 아래 표에 설명된 정보를 제공합니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
매개변수 설명
payload 프로필이 가장자리에 없으면 payload 개체가 비어 있습니다.
type payload개의 개체가 유형별로 그룹화되었습니다. 에지 프로필 조회 사용 사례의 경우 payload 개체의 유형은 항상 activation:pull입니다.
eventIndex Edge Network은 클라이언트로부터 배열 형식으로 이벤트를 수신합니다. 배열의 이벤트 순서는 처리 중에 유지되며 이 인덱스에 반영됩니다. 이벤트 인덱싱이 0(으)로 시작됩니다.
SUCCESS
통합을 올바로 구성한 경우 이제 Edge 프로필 데이터에 액세스할 수 있으며 Edge 프로필의 속성 및 대상 멤버십을 사용하여 다운스트림 개인화 엔진에서 실시간 개인화를 트리거할 수 있습니다.

결론 conclusion

위의 단계를 따라 실시간으로 Edge 프로필 속성을 효율적으로 조회할 수 있으므로 개인화된 경험을 구현하고 다운스트림 애플리케이션을 통해 정보에 기반한 의사 결정을 내릴 수 있습니다.

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