결합 끝점

결합(또는 결합 보기)은 동일한 클래스(XDM ExperienceEvent 또는 XDM Individual Profile)를 공유하고 Real-time Customer Profile에 대해 활성화된 모든 스키마의 필드를 집계하는 시스템 생성, 읽기 전용 스키마입니다.

이 문서에서는 다양한 작업에 대한 샘플 호출을 포함하여 스키마 레지스트리 API에서 결합 작업을 위한 필수 개념을 다룹니다. XDM의 조합에 대한 일반적인 자세한 내용은 스키마 구성🔗의 기본 사항 섹션에서 조합에 대한 섹션을 참조하십시오.

결합 스키마 필드

Schema Registry은(는) 결합 스키마 내에 세 개의 키 필드를 자동으로 포함합니다. identityMap, timeSeriesEventssegmentMembership.

ID 맵

결합 스키마의 identityMap은 결합의 연결된 레코드 스키마 내에 있는 알려진 ID를 나타냅니다. ID 맵은 ID를 네임스페이스로 사용하는 다른 배열로 구분합니다. 나열된 각 ID는 고유한 id 값을 포함하는 객체 자체입니다. 자세한 내용은 ID 서비스 설명서를 참조하십시오.

시계열 이벤트

timeSeriesEvents 배열은 결합과 연관된 레코드 스키마와 관련된 시계열 이벤트 목록입니다. 프로필 데이터를 데이터 세트로 내보내면 이 배열이 각 레코드에 대해 포함됩니다. 이 기능은 모델이 레코드 특성 외에 프로필의 전체 동작 기록을 필요로 하는 기계 학습과 같은 다양한 사용 사례에 유용합니다.

세그먼트 멤버십 맵

segmentMembership 맵은 세그먼트 평가 결과를 저장합니다. 세그먼테이션 API를 사용하여 세그먼트 작업을 성공적으로 실행하면 맵이 업데이트됩니다. segmentMembership 또한 Platform에 수집되는 사전 평가된 대상 세그먼트를 저장하여 Adobe Audience Manager과 같은 다른 솔루션과 통합할 수 있습니다. 자세한 내용은 API를 사용하여 세그먼트 만들기에 대한 자습서를 참조하십시오.

조합 목록 검색

스키마에 union 태그를 설정하면 Schema Registry은 스키마를 기준으로 하는 클래스에 대한 스키마에 스키마를 자동으로 추가합니다. 해당 클래스에 대한 조합이 없으면 새 조합이 자동으로 생성됩니다. 조합의 $id 은 다른 Schema Registry 리소스의 표준 $id 리소스와 비슷하며, 두 밑줄이 추가된 유일한 차이는 "union"(__union)입니다.

/tenant/unions 종단점에 GET을 요청하여 사용 가능한 조합 목록을 볼 수 있습니다.

API 형식

GET /tenant/unions

요청

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

응답 형식은 요청에서 전송된 Accept 헤더에 따라 다릅니다. 다음 Accept 헤더는 조합을 나열할 수 있습니다.

Accept 헤더 설명
application/vnd.adobe.xed-id+json 각 리소스에 대한 간단한 요약을 반환합니다. 리소스를 나열하는 데 권장되는 헤더입니다. (제한: 300)
application/vnd.adobe.xed+json 원래 $refallOf이 포함된 각 리소스에 대한 전체 JSON 클래스를 반환합니다. (제한: 300)

응답

성공적인 응답은 응답 본문에 HTTP 상태 200(OK) 및 results 배열을 반환합니다. 결합이 정의된 경우 각 결합에 대한 세부 정보가 배열 내의 개체로 제공됩니다. 정의된 조합이 없는 경우 HTTP 상태 200(OK)이 여전히 반환되지만 results 배열은 비어 있습니다.

{
    "results": [
        {
            "title": "XDM Individual Profile",
            "$id": "https://ns.adobe.com/xdm/context/profile__union",
            "meta:altId": "_xdm.context.profile__union",
            "version": "1"
        },
        {
            "title": "Property",
            "$id": "https://ns.adobe.com/{TENANT_ID}/classes/19e1d8b5098a7a76e2c10a81cbc99590__union",
            "meta:altId": "_{TENANT_ID}.classes.19e1d8b5098a7a76e2c10a81cbc99590__union",
            "version": "1"
        }
    ]
}

조합 찾기

$id을 포함하는 GET 요청을 수행하고 Accept 헤더에 따라 조합의 세부 정보의 일부 또는 전부를 선택하여 특정 결합을 볼 수 있습니다.

노트

결합 조회는 /unions/schemas 종단점을 사용하여 데이터 집합으로 내보내기에서 사용할 수 있도록 할 수 있습니다.Profile

API 형식

GET /tenant/unions/{UNION_ID}
GET /tenant/schemas/{UNION_ID}
매개 변수 설명
{UNION_ID} 조회하려는 합계의 URL 인코딩 $id URI입니다. 결합 스키마에 대한 URI가 "__union"에 추가됩니다.

요청

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions/https%3A%2F%2Fns.adobe.com%2Fxdm%2Fcontext%2Fprofile__union \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed+json; version=1'

결합 조회 요청은 수락 헤더에 version이 포함되어야 합니다.

결합 스키마 조회에는 다음 Accept 헤더를 사용할 수 있습니다.

Accept 설명
application/vnd.adobe.xed+json; version=1 $refallOf이 있는 원시. 제목 및 설명을 포함합니다.
application/vnd.adobe.xed-full+json; version=1 $ref 특성과 allOf 해결됨. 제목 및 설명을 포함합니다.

응답

성공적인 응답은 요청 경로에 $id이 제공된 클래스를 구현하는 모든 스키마의 결합 보기를 반환합니다.

응답 형식은 요청에서 전송된 Accept 헤더에 따라 다릅니다. 다른 Accept 헤더로 실험을 통해 응답을 비교하고 사용 사례에 가장 적합한 헤더를 확인해 보십시오.

{
    "type": "object",
    "description": "Union view of all schemas that extend https://ns.adobe.com/xdm/context/profile",
    "allOf": [
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
        },
        {
            "$ref": "https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
        }
    ],
    "meta:extends": [
        "https://ns.adobe.com/xdm/context/profile",
        "https://ns.adobe.com/xdm/data/record",
        "https://ns.adobe.com/xdm/context/identitymap",
        "https://ns.adobe.com/xdm/common/extensible",
        "https://ns.adobe.com/xdm/common/auditable",
        "https://ns.adobe.com/xdm/context/profile-person-details",
        "https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599",
        "https://ns.adobe.com/xdm/context/profile-personal-details"
    ],
    "title": "Union object for https://ns.adobe.com/xdm/context/profile",
    "$id": "https://ns.adobe.com/xdm/context/profile__union",
    "meta:containerId": "tenant",
    "meta:class": "https://ns.adobe.com/xdm/context/profile",
    "meta:altId": "_xdm.context.profile__union",
    "version": "1.0",
    "meta:resourceType": "unions",
    "meta:registryMetadata": {}
}

결합 멤버십에 대한 스키마 활성화

스키마를 해당 클래스의 조합에 포함하려면 union 태그를 스키마의 meta:immutableTags 속성에 추가해야 합니다. 해당 스키마에 union 단일 문자열 값이 있는 meta:immutableTags 배열을 추가하도록 PATCH 요청을 수행하면 이 작업을 수행할 수 있습니다. 자세한 예는 스키마 엔드포인트 안내서를 참조하십시오.

결합 스키마 나열

특정 합성의 일부인 스키마를 확인하려면 /tenant/schemas 종단점에 대한 GET 요청을 수행할 수 있습니다. property 쿼리 매개 변수를 사용하면 meta:immutableTags 필드 및 meta:class가 액세스 중인 공용 구조체와 동일한 스키마를 반환하도록 응답을 구성할 수 있습니다.

API 형식

GET /tenant/schemas?property=meta:immutableTags==union&property=meta:class=={CLASS_ID}
매개 변수 설명
{CLASS_ID} 결합 사용 스키마를 나열하려는 클래스의 $id

요청

다음 요청은 XDM Individual Profile 클래스에 대한 결합에 속하는 모든 스키마 목록을 검색합니다.

curl -X GET \
  'https://platform.adobe.io/data/foundation/schemaregistry/tenant/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile' \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답 형식은 요청에서 전송된 Accept 헤더에 따라 다릅니다. 스키마를 나열할 때 다음 Accept 헤더를 사용할 수 있습니다.

Accept 헤더 설명
application/vnd.adobe.xed-id+json 각 리소스에 대한 간단한 요약을 반환합니다. 리소스를 나열하는 데 권장되는 헤더입니다. (제한: 300)
application/vnd.adobe.xed+json 원래 $refallOf이 포함된 각 리소스에 대한 전체 JSON 스키마를 반환합니다. (제한: 300)

응답

성공적인 응답은 조합 멤버십에 대해 활성화된 지정된 클래스에 속하는 스키마만 포함하는 필터링된 스키마 목록을 반환합니다. 여러 쿼리 매개 변수를 사용할 때는 AND 관계를 가정합니다.

{
    "results": [
        {
            "title": "Schema 1",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/142afb78d8b368a5ba97a6cc8fc7e033",
            "meta:altId": "_{TENANT_ID}.schemas.142afb78d8b368a5ba97a6cc8fc7e033",
            "version": "1.2"
        },
        {
            "title": "Schema 2",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/e7297a6ddfc7812ab3a7b504a1ab98da",
            "meta:altId": "_{TENANT_ID}.schemas.e7297a6ddfc7812ab3a7b504a1ab98da",
            "version": "1.5"
        },
        {
            "title": "Schema 3",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/50f960bb810e99a21737254866a477bf",
            "meta:altId": "_{TENANT_ID}.schemas.50f960bb810e99a21737254866a477bf",
            "version": "1.2"
        },
        {
            "title": "Schema 4",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/a39655ca8ea3d5c1f36a463b45fccca8",
            "meta:altId": "_{TENANT_ID}.schemas.a39655ca8ea3d5c1f36a463b45fccca8",
            "version": "1.1"
        },
        {
            "title": "Schema 5",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/c063fac45c6d6285ef33b0e2af09f633",
            "meta:altId": "_{TENANT_ID}.schemas.c063fac45c6d6285ef33b0e2af09f633",
            "version": "1.2"
        },
        {
            "title": "Schema 6",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/dfebb19b93827b70bbad006137812537",
            "meta:altId": "_{TENANT_ID}.schemas.dfebb19b93827b70bbad006137812537",
            "version": "1.7"
        }
    ],
    "_links": {
        "global_schemas": {
            "href": "https://platform.adobe.io/data/foundation/schemaregistry/global/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile"
        }
    }
}

이 페이지에서는