에서 업데이트 스트리밍 Data Prep 부분 행 업데이트를 다음으로 보낼 수 있습니다. Real-Time Customer Profile 또한 단일 API 요청으로 새 ID 링크를 만들고 설정하는 동안 데이터가 수집됩니다.
업데이트를 스트리밍하면 해당 데이터를 로 번역하면서 데이터 형식을 유지할 수 있습니다 Real-Time Customer Profile 수집 중 PATCH 요청. 입력한 내용을 기반으로, Data Prep 을 사용하면 단일 API 페이로드를 전송하고 데이터를 두 페이로드로 번역할 수 있습니다 Real-Time Customer Profile PATCH 및 Identity Service 요청을 만듭니다.
DCS 인렛을 통한 프로필 업데이트를 위한 XDM(Experience Data Model) 엔티티 업데이트 메시지(JSON PATCH 작업 포함)에 대한 수집이 더 이상 사용되지 않습니다. 또는 다음을 수행할 수 있습니다. 원시 데이터를 DCS 인렛에 수집 및 필요한 데이터 매핑을 지정하여 프로필 업데이트를 위한 XDM 호환 메시지로 데이터를 변환합니다.
이 문서는에서 업데이트를 스트리밍하는 방법에 대한 정보를 제공합니다 Data Prep.
이 개요를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 소스는 스트리밍 업데이트 사용을 지원합니다.
에서 업데이트 스트리밍 Data Prep 는 다음과 같이 작동합니다.
create
, merge
, 및 delete
.create
.새 ID를 연결해야 하는 경우 수신 페이로드에서 추가 데이터 세트를 만들고 전달해야 합니다. ID 데이터 세트를 생성할 때 다음 요구 사항이 충족되는지 확인해야 합니다.
스키마에 필수 필드가 포함된 경우 활성화하려면 데이터 세트의 유효성 검사를 억제해야 합니다 Identity Service id만 받습니다. 다음을 적용하여 유효성 검사를 무시할 수 있습니다. disabled
에 대한 값 acp_validationContext
매개 변수. 아래 예를 참조하십시오.
curl -X POST 'https://platform.adobe.io/data/foundation/catalog/dataSets/62257bef7a75461948ebcaaa' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"tags": {
"acp_validationContext": [
"disabled"
],
"unifiedProfile": [
"enabled:false"
],
"unifiedIdentity": [
"enabled:true"
]
}
}'
ID 데이터 세트와 연결된 스키마에 필수 필드가 없는 경우 추가 구성을 수행할 필요가 없습니다.
다음은 새 ID 링크를 설정하는 수신 페이로드 구조의 예를 보여 줍니다.
{
"header": {
"flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
"imsOrgId": "{ORG_ID}",
"datasetId": "621fc19ab33d941949af16c8",
"operations": {
"data": "create" (default)/"merge"/"delete",
"identity": "create",
"identityDatasetId": "621fc19ab33d941949af16d9"
}
}
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}
매개변수 | 설명 |
---|---|
flowId |
데이터 흐름을 식별하는 고유 ID입니다. 이 데이터 흐름 ID는 로 만든 소스 연결에 해당해야 합니다. Amazon Kinesis, Azure Event Hubs, 또는 HTTP API. 이 데이터 흐름에는 Profile-타겟 데이터 세트로 활성화된 데이터 세트. 참고: 의 ID입니다 Profile-enabled target 데이터 세트는 datasetId 매개 변수. |
imsOrgId |
조직에 해당하는 ID입니다. |
datasetId |
의 ID Profile- 데이터 흐름의 대상 데이터 세트를 활성화했습니다. 참고: 와 동일한 ID입니다. Profile-활성화된 대상 데이터 세트 ID가 데이터 흐름에 있습니다. |
operations |
이 매개 변수는 다음과 같은 작업을 간략하게 설명합니다. Data Prep 은(는) 수신 요청을 기반으로 을(를) 수행합니다. |
operations.data |
수행할 작업을 정의합니다. Real-Time Customer Profile. |
operations.identity |
데이터에 대해 허용되는 작업을 다음 기준으로 정의합니다. Identity Service. |
operations.identityDatasetId |
(선택 사항) 새 ID를 연결해야 하는 경우에만 필요한 ID 데이터 세트의 ID입니다. |
다음 작업은에서 지원됩니다. Real-Time Customer Profile:
작업 | 설명 |
---|---|
create |
기본 작업입니다. 에 대한 XDM 엔티티 만들기 메서드를 생성합니다. Real-Time Customer Profile. |
merge |
에 대한 XDM 엔티티 업데이트 메서드를 생성합니다. Real-Time Customer Profile. |
delete |
에 대한 XDM 엔티티 삭제 메서드를 생성합니다. Real-Time Customer Profile 및 을(를) 통해 Profile Store. |
다음 작업은에서 지원됩니다. Identity Service:
작업 | 설명 |
---|---|
create |
이 매개변수에 대해 허용되는 작업입니다. If create 의 값으로 전달됩니다. operations.identity , 그런 다음 Data Prep 에 대한 XDM 엔티티 만들기 요청을 생성합니다. Identity Service. ID가 이미 존재하는 경우 ID는 무시됩니다. 참고: If operations.identity 이(가) (으)로 설정됨 create , 그런 다음 identityDatasetId 을(를) 지정해야 합니다. 에 의해 내부적으로 생성된 XDM 엔티티 생성 메시지 Data Prep 이 데이터 세트 id에 대한 구성 요소가 생성됩니다. |
새 ID를 연결할 필요가 없는 경우 identity
및 identityDatasetId
작업의 매개 변수. 이렇게 하면 데이터만 Real-Time Customer Profile 을 건너뛰고 Identity Service. 예를 보려면 아래 페이로드를 참조하십시오.
{
"header": {
"flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
"imsOrgId": "{ORG_ID}",
"datasetId": "621fc19ab33d941949af16c8",
"operations": {
"data": "create"/"merge"/"delete",
}
}
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}
XDM 업데이트의 경우 스키마를 활성화해야 합니다. Profile 기본 id를 포함합니다. 다음 두 가지 방법으로 XDM 스키마의 기본 ID를 지정할 수 있습니다.
아래 예에서는 state
, homePhone.number
및 기타 속성은 해당 지정된 값으로 다음에 업데이트됩니다. Profile 의 기본 ID 사용 sampleEmail@gmail.com
. 그런 다음 XDM 엔티티 업데이트 메시지가 스트리밍에 의해 생성됩니다 Data Prep 구성 요소. Real-Time Customer Profile 그런 다음 프로필 레코드를 업데이트할 XDM 업데이트 메시지를 확인합니다.
이 예제에서는 ID에 대해 정의된 작업이 없으므로 ID가 함께 연결되지 않습니다.
curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
-H 'Content-Type: application/json' \
-H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
-d '{
"header": {
"flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
"imsOrgId": "{ORG_ID}",
"datasetId": "62259f817f62d71947929a7b",
"operations": {
"data": "create"
}
},
{
"body": {
"homeAddress": {
"country": "US",
"state": "GA",
"region": "va7"
},
"homePhone": {
"number": "123.456.799"
},
"identityMap": {
"Email": [{
"id": "sampleEmail@gmail.com",
"primary": true
}]
},
"personalEmail": {
"address": "sampleEmail@gmail.com",
"primary": true
},
"personID": "346576345",
"_id": "346576345",
"timestamp": "2021-05-05T17:51:45.1880+02",
"workEmail": "sampleWorkEmail@gmail.com"
}
}'
이 예에서 헤더에는 operations
속성이 identity
및 identityDatasetId
속성. 이렇게 하면 데이터를 병합할 수 있습니다. Real-Time Customer Profile 및 로 전달될 ID에 대해서도 Identity Service.
curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
-H 'Content-Type: application/json' \
-H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
-d '{
"header": {
"flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
"imsOrgId": "{ORG_ID}",
"datasetId": "62259f817f62d71947929a7b",
"operations": {
"data": "merge",
"identity": "create",
"identityDatasetId": "6254a93b851ecd194b64af9e"
}
},
{
"body": {
"homeAddress": {
"country": "US",
"state": "GA",
"region": "va7"
},
"homePhone": {
"number": "123.456.799"
},
"identityMap": {
"Email": [{
"id": "sampleEmail@gmail.com",
"primary": true
}]
},
"personalEmail": {
"address": "sampleEmail@gmail.com",
"primary": true
},
"personID": "346576345",
"_id": "346576345",
"timestamp": "2021-05-05T17:51:45.1880+02",
"workEmail": "sampleWorkEmail@gmail.com"
}
}'
다음은 로 업데이트를 스트리밍할 때 고려할 알려진 제한 사항 목록을 간략하게 설명합니다. Data Prep:
identity
작업은 항상 만들도록 설정해야 합니다. ID가 이미 존재하는 경우 작업이 no-op입니다.이제에서 업데이트를 스트리밍하는 방법을 이해할 수 있습니다 Data Prep 에 부분 행 업데이트를 보내려면 Real-Time Customer Profile 데이터를 캡처하는 동시에 단일 API 요청으로 ID를 만들고 연결합니다. 기타 정보 Data Prep 기능, 다음을 읽으십시오. Data Prep 개요. 내에서 매핑 세트를 사용하는 방법을 알아보려면 Data Prep API, 다음을 읽으십시오. Data Prep 개발자 안내서.