Experience Platform 대상자 수집 및 활용

Experience Platform UI에서 다음 작업을 수행합니다.

1. 고객 > 대상​을 선택합니다.

2. 찾아보기​를 선택하고 Customer Journey Analytics에서 수집 및 사용할 대상을 검색합니다. 나중에 사용할 수 있도록 각 대상에 대해 대상 ID​를 참고하십시오.

   

요청

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

위치:

• DATASET_NAME은(는) 데이터 집합에 대한 알기 쉬운 이름입니다. (예: Segment Export Job Dataset for CJA)

응답

["@/dataSets/{DATASET_ID}"]

위치:

• DATASET_ID은(는) 생성된 데이터 세트에 대한 데이터 세트 식별자입니다.

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

수행

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES은(는) _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName과(와) 같은 것일 수 있습니다. 고객 여정 분석에 사용할 최소 관련 필드(예: personID(이메일))를 포함해야 합니다.
• AUDIENCE_ID_x은(는) 내보내려는 대상의 대상 식별자입니다.
• DATASET_ID은(는) 사용자가 만든 데이터 세트입니다.

응답

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

수행

• EXPORT_JOB_ID은(는) 내보내기 작업의 식별자입니다.

요청

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

Experience Platform UI에서 다음 작업을 수행합니다.

1. 데이터 관리 > 데이터 세트​를 선택합니다.

2. 만든 데이터 세트를 선택합니다(예: CJA에 대한 세그먼트 내보내기 작업 데이터 세트).

   

3. 수집된 일괄 처리를 확인합니다. 데이터 집합에 실패한 일괄 처리가 포함되어 있는 경우 데이터 관리 > 모니터링​을 사용하여 이유를 확인하세요. 예를 들어 스키마에 존재하지 않는 필드 이름을 사용했습니다.

4. 데이터 집합의 테이블 이름​을(를) 복사합니다. 예: segment_export_job_dataset_for_cja. 다음 단계에서 해당 이름을 사용합니다.

Experience Platform 쿼리 서비스에 연결하는 PSQL 클라이언트를 사용합니다.

Experience Platform UI에서 다음 작업을 수행합니다.

1. 데이터 관리 > 쿼리​를 선택합니다.
2. 자격 증명​을 선택합니다.

자격 증명을 사용하여 Customer Journey Analytics 쿼리 서비스에 연결하도록 PSQL 클라이언트를 구성합니다.

쿼리

이 쿼리를 실행하여 데이터 세트에서 대상 데이터를 검색합니다.

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

위치:

• IDENTITY_TO_USE_AS_PERSON_ID은(는) 내보내기 작업의 일부로 정의한 필드 중 하나입니다. 예: _demoemea.identification.core.email.
• DATASET_TABLE_NAME은(는) 데이터 집합의 테이블 이름입니다.
• AUDIENCE_ID_x은(는) 내보내기 작업의 일부로 정의한 대상입니다. 내보내기 작업의 사양이 행 수준 필터이므로 이러한 대상을 한 번 더 지정해야 합니다. 해당 행 수준 필터는 각 프로필에 대한 모든 세그먼트 멤버십이 있는 지정된 세그먼트에 대한 프로필을 반환합니다.

결과

쿼리 결과는 JSON 형식으로 다음과 같아야 합니다.

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

위치:

• PERSON_ID_x은(는) 개인 ID로 사용할 식별자의 식별자 값입니다. 예를 들어 전자 메일을 사용하는 경우 john.doe@gmail.com입니다.
• AUDIENCE_ID_x은(는) 대상 식별자입니다.

최종 JSON은 다음과 같아야 합니다.

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

위치:

• TENANT_NAME은(는) 테넌트의 이름입니다. 예: _demoemea.
• PERSON_ID_x은(는) 개인 ID로 사용할 식별자의 식별자 값입니다. 예를 들어 전자 메일을 사용하는 경우 john.doe@gmail.com입니다.
• AUDIENCE_ID_x은(는) 대상 식별자입니다.
• AUDIENCE_FRIENDLY_NAME_x은(는) 대상 ID에 친숙한 대상 이름입니다. 예: Luma - Blue+ Members.

즐겨 사용하는 도구를 사용하여 원본 JSON을 이 형식으로 변환합니다.

스키마를 생성하려면:

Experience Platform UI에서 다음 작업을 수행합니다.

1. 데이터 관리 > 스키마​를 선택합니다.

2. 스키마 만들기​를 선택합니다. 드롭다운 메뉴에서 표준​을(를) 선택합니다.

3. 스키마 만들기 대화 상자에서 수동​을 선택하고 선택​을 사용하여 계속하십시오.

4. 스키마 만들기 마법사의 클래스 선택 단계:

   1. 개별 프로필​을 선택하세요.
   2. 다음​을 선택합니다.

5. 스키마 만들기 마법사의 이름 및 검토 단계:

   1. 스키마 표시 이름​을 입력하십시오. 예: Audience Export for CJA Schema.
   2. (선택 사항) 설명​을 입력합니다.
   3. 마침​을 선택합니다.

6. audienceMembershipId 및 audienceMembershipName(이)라는 두 개의 필드를 포함하는 사용자 지정 필드 그룹(예: Audience Membership)을 포함하도록 스키마를 설정하십시오.

7. personID 필드가 ID, 기본 ID​이고 I​ ​ ​ID 네임스페이스​​로서 이메일이 있는지 ​.

   

8. 모든 변경 내용을 적용​합니다. 저장​을 선택하여 스키마를 저장합니다.

Experience Platform UI에서 다음 작업을 수행합니다.

1. 데이터 관리 > 데이터 세트​를 선택합니다.

2. 데이터 집합 만들기​를 선택합니다.

3. 스키마에서 데이터 세트 만들기​를 선택합니다.

4. 스키마에서 데이터 집합 만들기 마법사의 스키마 선택 단계:

   1. 방금 생성한 스키마를 선택합니다. 예: CJA 스키마에 대한 대상 내보내기.
   2. 다음​을 선택합니다.

5. 스키마에서 데이터 집합 만들기 마법사의 데이터 집합 구성 단계에서 다음을 수행합니다.

   1. 데이터 집합에 대한 이름​을(를) 입력하십시오.
   2. (선택 사항) 데이터 집합에 대한 설명​을 입력합니다.
   3. 마침​을 선택합니다.

6. 데이터 세트 > 데이터 세트 이름​에서 변환된 JSON 데이터 파일을 끌어다 파일 끌어다 놓기​로 놓습니다. 이 작업은 내보낸 JSON 데이터를 데이터 세트로 수집을 시작합니다.

7. 수집된 일괄 처리를 확인합니다. 데이터 집합에 실패한 일괄 처리가 포함되어 있는 경우 데이터 관리 > 모니터링​을 사용하여 이유를 확인하세요. 예를 들어 스키마에 존재하지 않는 JSON의 필드 이름을 정의했습니다.

Customer Journey Analytics UI에서:

1. 데이터 관리 > 연결​을 선택합니다.

2. 새 연결을 만들고 연결 설정 및 데이터 설정​을 정의합니다. 또는 기존 연결을 선택하고 연결 편집​을 사용하여 연결을 편집하세요.

3. 데이터 세트 추가​를 선택합니다.

4. 생성한 데이터 세트와 변환된 JSON 데이터를 수집한 데이터 세트를 선택합니다.

5. 데이터 세트를 구성합니다. 예:

   

6. 연결을 저장​합니다.

1. 데이터 관리 > 데이터 보기​를 선택합니다.

2. 기존 데이터 보기를 편집하거나 새 데이터 보기를 만듭니다.

3. 데이터 보기의 구성 요소 탭에서 대상 멤버십 ID 및 대상 멤버십 이름​이 차원 구성 요소로 추가되었는지 확인하십시오.

   

4. 데이터 보기를 저장하려면 저장 및 계속​을 선택하십시오.