세분화 서비스 API를 사용하여 세그먼트 정의 만들기

이 문서에서는 다음을 사용하여 세그먼트 정의를 개발, 테스트, 미리 보기 및 저장하는 자습서를 제공합니다. Adobe Experience Platform Segmentation Service API.

사용자 인터페이스를 사용하여 세그먼트 정의를 작성하는 방법에 대한 자세한 내용은 세그먼트 빌더 안내서.

시작하기

이 자습서에서는 다양한 을(를) 작업 이해해야 합니다 Adobe Experience Platform 세그먼트 정의 생성과 관련된 서비스입니다. 이 자습서를 시작하기 전에 다음 서비스에 대한 설명서를 검토하십시오.

다음 섹션에서는 를 성공적으로 호출하기 위해 알아야 하는 추가 정보를 제공합니다. Platform API.

샘플 API 호출 읽기

이 튜토리얼에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 형식의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 다음에서 Experience Platform 문제 해결 가이드.

필수 헤더에 대한 값 수집

을 호출하기 위해 Platform API, 먼저 다음을 완료해야 합니다. 인증 자습서. 인증 튜토리얼을 완료하면 아래와 같이 모든 Experience Platform API 호출의 필수 헤더 각각에 대한 값이 제공됩니다.

  • 인증: 전달자 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

의 모든 리소스 Experience Platform 특정 가상 샌드박스로 격리됩니다. 에 대한 모든 요청 Platform API에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
의 샌드박스에 대한 자세한 내용 Platform, 다음을 참조하십시오. 샌드박스 개요 설명서.

페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 헤더가 필요합니다.

  • Content-Type: application/json

세그먼트 정의 개발

세그먼테이션의 첫 번째 단계는 세그먼트 정의를 정의하는 것입니다. 세그먼트 정의는 작성된 쿼리를 캡슐화하는 개체입니다 Profile Query Language (PQL). 이 개체를 PQL 술어라고도 합니다. PQL 조건자는 제공한 레코드 또는 시계열 데이터와 관련된 조건을 기반으로 세그먼트 정의에 대한 규칙을 정의합니다 Real-Time Customer Profile. 다음을 참조하십시오. PQL 안내서 PQL 쿼리 작성에 대한 자세한 정보입니다.

에 POST 요청을 하여 새 세그먼트 정의를 만들 수 있습니다. /segment/definitions 의 엔드포인트 Segmentation API. 다음 예제에서는 세그먼트 정의를 성공적으로 정의하는 데 필요한 정보를 포함하여 정의 요청의 형식을 지정하는 방법을 간략하게 설명합니다.

세그먼트 정의를 정의하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 세그먼트 정의 개발자 안내서.

대상자 예측 및 미리보기 estimate-and-preview-an-audience

세그먼트 정의를 개발할 때 내의 예상 및 미리보기 도구를 사용할 수 있습니다. Real-Time Customer Profile 예상되는 대상을 격리하는 데 도움이 되는 요약 수준 정보를 봅니다. 예상치는 예상 대상 크기 및 신뢰 구간과 같은 세그먼트 정의에 대한 통계 정보를 제공합니다. 미리 보기는 세그먼트 정의에 대해 페이지가 매겨진 자격 프로필 목록을 제공하므로 결과를 예상과 비교할 수 있습니다.

대상자를 예측하고 미리 보면 원하는 결과가 나올 때까지 PQL 술어를 테스트하고 최적화하여 업데이트된 세그먼트 정의에 사용할 수 있습니다.

세그먼트 정의를 미리 보거나 예상 값을 가져오는 데 필요한 두 가지 단계가 있습니다.

예상 생성 방법

실시간 고객 프로필에 대해 활성화된 데이터가 Platform으로 수집되면 프로필 데이터 저장소 내에 저장됩니다. 프로필 스토어로 레코드를 수집하면 총 프로필 수가 5% 이상 증가하거나 감소하면 샘플링 작업이 트리거되어 수를 업데이트합니다. 프로필 수가 5% 이상 변경되지 않으면 샘플링 작업이 매주 자동으로 실행됩니다.

샘플이 트리거되는 방법은 사용 중인 수집 유형에 따라 다릅니다.

  • 스트리밍 데이터 워크플로의 경우 5% 증가 또는 감소 임계값이 충족되었는지 확인하기 위해 시간별로 검사가 수행됩니다. 이 임계값이 충족되면 샘플 작업이 자동으로 트리거되어 카운트를 업데이트합니다.
  • 일괄 처리 수집의 경우, 프로필 스토어에 일괄 처리를 성공적으로 수집한 후 15분 이내에 5% 증가 또는 감소 임계값이 충족되면 카운트를 업데이트하는 작업이 실행됩니다. 프로필 API를 사용하면 최근에 성공한 샘플 작업을 미리 볼 수 있으며, 데이터 세트 및 ID 네임스페이스별로 프로필 분포를 나열할 수 있습니다.

샘플 크기는 프로필 스토어에 있는 전체 엔티티 수에 따라 다릅니다. 이러한 샘플 크기는 다음 표에 나와 있습니다.

프로필 저장소의 엔티티
샘플 크기
100만 미만
전체 데이터 세트
1000~2000만
100만
2,000만 이상
총 5%

예측은 일반적으로 10-15초 동안 실행되며, 대략적인 예측부터 시작하여 더 많은 기록을 읽을수록 구체화됩니다.

미리보기 작업 만들기

에 POST 요청을 하여 새 미리보기 작업을 생성할 수 있습니다. /preview 엔드포인트.

미리보기 작업 생성에 대한 자세한 지침은 미리 보기 및 예상 끝점 안내서.

예상 보기 또는 미리 보기

서로 다른 쿼리가 완료되는 데 시간이 오래 걸릴 수 있으므로 예상 및 미리보기 프로세스는 비동기적으로 실행됩니다. 쿼리가 시작되면 API 호출을 사용하여 예측이나 미리보기가 진행되는 현재 상태를 검색(GET)할 수 있습니다.

사용 Segmentation Service API를 사용하면 미리보기 작업의 현재 상태를 해당 ID로 조회할 수 있습니다. 상태가 "RESULT_READY"이면 결과를 볼 수 있습니다. 미리보기 작업의 현재 상태를 조회하려면 의 섹션을 참조하십시오. 미리보기 작업 섹션 검색 미리 보기 및 예상 엔드포인트 안내서에서 참조하십시오. 예상 작업의 현재 상태를 조회하려면 다음 섹션을 참조하십시오. 예상 작업 검색 중 미리 보기 및 예상 엔드포인트 안내서에서 참조하십시오.

다음 단계

세그먼트 정의를 개발, 테스트 및 저장했으면 다음을 사용하여 대상을 구축하는 세그먼트 작업을 생성할 수 있습니다. Segmentation Service API. 다음 튜토리얼 참조: 세그먼트 결과 평가 및 액세스 을 수행하는 방법에 대한 자세한 단계입니다.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871