3.5 세그먼트 만들기 - API

이 연습에서는 Adobe Experience Platform의 API를 사용하여 Postman 및 Adobe I/O을 사용하여 세그먼트를 만들고 해당 세그먼트의 결과를 데이터 세트로 저장합니다.

Story

실시간 고객 프로필에서는 모든 프로필 데이터가 이벤트 데이터 및 기존 세그먼트 멤버십과 함께 표시됩니다. 표시되는 데이터는 Adobe 애플리케이션 및 외부 솔루션에서 가져온 것입니다. 경험 기록 시스템인 Adobe Experience Platform에서 가장 강력한 보기입니다.

연습 3.5.1 - 플랫폼 API를 통해 세그먼트 만들기

Postman으로 이동합니다.

컬렉션을 찾습니다._Adobe Experience Platform 지원. 이 컬렉션에는 2 폴더가 표시됩니다. 세그먼테이션. 이 연습에서는 이러한 요청을 사용할 것입니다.

세그먼테이션

다음으로 API를 통해 세그먼트를 만드는 데 필요한 모든 단계를 수행합니다. 간단한 세그먼트를 만듭니다."ldap - 모든 여성 고객"

1단계 - 세그먼트 정의 만들기

1단계 - 프로필:세그먼트 정의​를 만듭니다.

세그먼테이션

이 요청의 Body 섹션으로 이동합니다.

세그먼테이션

이 요청의 Body​에 다음 내용이 표시됩니다.

세그먼테이션

이 요청에 사용되는 언어를 프로필 쿼리 언어 또는 PQL​라고 합니다.

PQL 에서에 대한 자세한 정보와 설명서를 찾을 수 있습니다.

주의:ldap​을 특정 ldap​로 대체하여 아래 요청에서 변수 name​을 업데이트하십시오.

{
    "name" : "ldap - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "ldap",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

특정 ldap​을 추가한 후 본문은 다음과 유사해야 합니다.

{
    "name" : "vangeluw - API - All Female Customer",
    "expression" : {"type":"PQL", "format":"pql/json", "value":"{\"nodeType\":\"fnApply\",\"fnName\":\"in\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"gender\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"person\",\"object\":{\"nodeType\":\"literal\",\"literalType\":\"XDMObject\",\"value\":\"profile\"}}},{\"literalType\":\"List\",\"nodeType\":\"literal\",\"value\":[\"female\"]}]}"},
    "createdBy": "vangeluw",
    "schema" : { "name" : "_xdm.context.profile"},
    "ttlInDays" : 90
}

또한 요청의 Header 필드도 확인해야 합니다. Headers​로 이동합니다. 그러면 다음 내용이 표시됩니다.

포스트맨

x-sandbox-name --aepSandboxId--
노트

사용 중인 Adobe Experience Platform 샌드박스의 이름을 지정해야 합니다. x-sandbox-name은 --aepSandboxId--이어야 합니다.

이제 파란색 보내기 단추를 클릭하여 세그먼트를 만들고 그 결과를 확인합니다.

세그먼테이션

이 단계 후에는 플랫폼 UI에서 세그먼트 정의를 볼 수 있습니다. 이를 확인하려면 Adobe Experience Platform에 로그인하고 세그먼트​로 이동합니다.

세그먼테이션

2단계 - 세그먼트 POST 작업 만들기

이전 연습에서는 스트리밍 세그먼트를 만들었습니다. 스트리밍 세그먼트는 지속적으로 자격 조건을 실시간으로 평가합니다. 여기서 수행하는 작업은 batch 세그먼트를 만드는 것입니다. 배치 세그먼트는 자격 측면에서 세그먼트가 표시될 수 있는 모습을 미리 볼 수 있지만, 세그먼트가 실제로​을 실행했음을 의미하지는 않습니다. 현재 아무도 이 세그먼트​에 사용할 수 없습니다. 사람들에게 자격을 부여하려면 배치 세그먼트를 실행해야 합니다. 이 작업이 바로 여기에서 수행할 작업입니다.

이제 POST 작업을 살펴보겠습니다.

Postman으로 이동합니다.

세그먼테이션

Postman 컬렉션에서 2단계 - POST 세그먼트 작업​이라는 요청을 클릭하여 엽니다.

세그먼테이션

또한 요청의 Header 필드도 확인해야 합니다. Headers​로 이동합니다. 그러면 다음 내용이 표시됩니다.

포스트맨

x-sandbox-name --aepSandboxId--
노트

사용 중인 Adobe Experience Platform 샌드박스의 이름을 지정해야 합니다. x-sandbox-name은 --aepSandboxId--이어야 합니다.

파란색 보내기 단추를 클릭합니다.

다음과 유사한 결과가 표시됩니다.

세그먼테이션

현재 이 세그먼트 작업이 실행 중이며 시간이 좀 걸릴 수 있습니다. 3단계에서는 이 작업의 상태를 확인할 수 있습니다.

3단계 - GET 세그먼트 작업 상태

Postman으로 이동합니다.

세그먼테이션

Postman 컬렉션에서 3단계 - GET 세그먼트 작업 상태​라는 요청을 클릭합니다.

세그먼테이션

또한 요청의 Header 필드도 확인해야 합니다. Headers​로 이동합니다. 그러면 다음 내용이 표시됩니다.

포스트맨

x-sandbox-name --aepSandboxId--
노트

사용 중인 Adobe Experience Platform 샌드박스의 이름을 지정해야 합니다. x-sandbox-name은 --aepSandboxId--이어야 합니다.

파란색 보내기 단추를 클릭합니다.

다음과 유사한 결과가 표시됩니다.

세그먼테이션

이 예에서는 작업의 status​이 QUEUED​로 설정됩니다.

status​가 SUCCEEDED​로 설정될 때까지 몇 분마다 파란색 Send 단추를 클릭하여 이 요청을 반복합니다.

세그먼테이션

상태가 SUCCEEDED​이면 세그먼트 작업이 실행되고 이제 고객이 세그먼트에 대해 자격을 갖습니다.

세분화 연습을 완료했습니다. 이제 실시간 고객 프로필을 전사적으로 활성화하는 방법을 살펴보겠습니다.

다음 단계:3.6 콜 센터에서 실시간 고객 프로필 살펴보기

모듈 3으로 돌아가기

모든 모듈로 돌아가기

이 페이지에서는