Customer AI에서 점수 다운로드

이 문서는 Customer AI에 대한 점수 다운로드 안내서의 역할을 합니다.

시작하기

고객 AI를 통해 Parquet 파일 형식으로 점수를 다운로드할 수 있습니다. 이 자습서에서는 시작하기 안내서.

또한 Customer AI의 점수에 액세스하려면 실행 상태가 성공적으로 설정된 서비스 인스턴스가 있어야 합니다. 새 서비스 인스턴스를 생성하려면 고객 AI 인스턴스 구성. 최근에 서비스 인스턴스를 만들었지만 여전히 교육 및 점수 책정 중이라면 실행을 완료하려면 24시간을 허용하십시오.

현재 Customer AI 점수를 다운로드하는 방법은 두 가지가 있습니다.

  1. 개별 수준에서 점수를 다운로드하거나 실시간 고객 프로필이 활성화되지 않은 경우 로 이동합니다 데이터 세트 ID 찾기.
  2. 프로필 이 활성화되어 있고 Customer AI를 사용하여 구성한 세그먼트를 다운로드하려면 다음 위치로 이동하십시오. 고객 AI로 구성된 세그먼트 다운로드.

데이터 세트 ID 찾기

Customer AI 인사이트에 대한 서비스 인스턴스 내에서 추가 작업 오른쪽 상단 탐색의 드롭다운을 선택하고 을(를) 선택합니다 점수 책정 액세스.

추가 작업

다운로드 점수 설명서 및 현재 인스턴스에 대한 데이터 세트 ID에 대한 링크가 포함된 새 대화 상자가 나타납니다. 데이터 세트 ID를 클립보드에 복사하여 다음 단계로 진행합니다.

데이터 세트 ID

배치 ID 검색

이전 단계에서 데이터 세트 ID를 사용하여 배치 ID를 검색하려면 카탈로그 API를 호출해야 합니다. 조직에 속한 배치 목록 대신 가장 최근 성공적인 배치를 반환하기 위해 이 API 호출에 추가 쿼리 매개 변수가 사용됩니다. 추가 배치를 반환하려면 제한 쿼리 매개 변수의 수를 반환하려는 금액으로 증가시킵니다. 사용 가능한 쿼리 매개 변수 유형에 대한 자세한 내용은 다음 안내서를 참조하십시오 쿼리 매개 변수를 사용하여 카탈로그 데이터 필터링.

API 형식

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
매개 변수 설명
{DATASET_ID} 데이터 세트 ID는 "액세스 점수" 대화 상자에서 사용할 수 있습니다.

요청

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?dataSet=5cd9146b31dae914b75f654f&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 배치 ID 개체가 포함된 페이로드를 반환합니다. 이 예에서 반환되는 개체의 키 값은 배치 ID입니다 01E5QSWCAASFQ054FNBKYV6TIQ. 다음 API 호출에서 사용할 배치 ID를 복사합니다.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5cd9146b31dae914b75f654f"
            }
        ],
        "id": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "externalId": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "replay": {
            "predecessors": [
                "01E5N7EDQQP4JHJ93M7C3WM5SP"
            ],
            "reason": "Replacing for 2020-04-09",
            "predecessorListingType": "IMMEDIATE"
        },
        "inputFormat": {
            "format": "parquet"
        },
        "imsOrg": "412657965Y566A4A0A495D4A@AdobeOrg",
        "started": 1586715571808,
        "metrics": {
            "partitionCount": 1,
            "outputByteSize": 2380339,
            "inputFileCount": -1,
            "inputByteSize": 2381007,
            "outputRecordCount": 24340,
            "outputFileCount": 1,
            "inputRecordCount": 24340
        },
        "completed": 1586715582735,
        "created": 1586715571217,
        "createdClient": "acp_foundation_push",
        "createdUser": "sensei_exp_attributionai@AdobeID",
        "updatedUser": "acp_foundation_dataTracker@AdobeID",
        "updated": 1586715583582,
        "version": "1.0.5"
    }
}

배치 ID를 사용하여 다음 API 호출을 검색합니다

배치 ID가 있으면에서 새 GET 요청을 수행할 수 있습니다 /batches. 이 요청은 다음 API 요청으로 사용되는 링크를 반환합니다.

API 형식

GET batches/{BATCH_ID}/files
매개 변수 설명
{BATCH_ID} 이전 단계에서 검색한 배치 ID입니다 배치 ID 검색.

요청

자체 배치 ID를 사용하여 다음 요청을 수행합니다.

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/035e2520-5e69-11ea-b624-51evfeba55d1/files' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 다음을 포함하는 페이로드를 반환합니다 _links 개체. 내 _links 개체는 href 를 값으로 새 API 호출로 사용. 이 값을 복사하여 다음 단계로 진행합니다.

{
    "data": [
        {
            "dataSetFileId": "035e2520-5e69-11ea-b624-51ecfeba55d0-1",
            "dataSetViewId": "5e3b2fe3fe4b9f18a8b7a3db",
            "version": "1.0.0",
            "created": "1583361894479",
            "updated": "1583361894479",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

파일 검색

사용 href 이전 단계에서 API 호출로 얻은 값을 사용하여 파일 디렉토리를 검색할 새 GET 요청을 만듭니다.

API 형식

GET files/{DATASETFILE_ID}
매개 변수 설명
{DATASETFILE_ID} dataSetFile ID는 href 값에서 이전 단계. 또한 data 개체 유형 아래의 배열 dataSetFileId.

요청

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

응답에는 단일 항목이 있거나 해당 디렉토리에 속하는 파일 목록이 있는 데이터 배열이 포함됩니다. 아래 예에는 파일 목록이 포함되어 있으며 가독성을 위해 요약되어 있습니다. 이 시나리오에서는 파일에 액세스하려면 각 파일의 URL을 따라야 합니다.

{
    "data": [
        {
            "name": "part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet",
            "length": "16214531",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet"
                }
            }
        },
        {
            "name": "...",
            "length": "16235375",
            "_links": {
                "self": {
                    "href": "..."
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 100
    },
    "_links": {
        "next": {
            "href": "..."
        },
        "page": {
            "href": "...",
            "templated": true
        }
    }
}
매개 변수 설명
_links.self.href 디렉토리에서 파일을 다운로드하는 데 사용되는 GET 요청 URL입니다.

를 복사합니다. href 의 모든 파일 객체에 대한 값 data 배열로 이동한 다음 다음 단계로 진행합니다.

파일 데이터 다운로드

파일 데이터를 다운로드하려면 다음에 GET 요청을 하십시오 "href" 이전 단계에서 복사한 값 파일 검색.

노트

명령줄에서 직접 이 요청을 하는 경우 요청 헤더 뒤에 출력을 추가하라는 메시지가 표시될 수 있습니다. 다음 요청 예는 를 사용합니다 --output {FILENAME.FILETYPE}.

API 형식

GET files/{DATASETFILE_ID}?path={FILE_NAME}
매개 변수 설명
{DATASETFILE_ID} dataSetFile ID는 href 값에서 이전 단계.
{FILE_NAME} 파일 이름입니다.

요청

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'filename.parquet'

GET 요청을 수행하기 전에 파일을 저장할 올바른 디렉터리 또는 폴더에 있는지 확인하십시오.

응답

이 응답은 현재 디렉터리에서 요청한 파일을 다운로드합니다. 이 예에서 파일 이름은 "filename.parquet"입니다.

터미널

고객 AI로 구성된 세그먼트 다운로드

점수 데이터를 다운로드하는 또 다른 방법은 대상을 데이터 세트로 내보내는 것입니다. 세분화 작업이 성공적으로 완료된 후( status 속성이 "성공")이면 대상을 액세스 및 작업할 수 있는 데이터 세트로 내보낼 수 있습니다. 세그멘테이션에 대해 자세히 알아보려면 세분화 개요.

중요

이 내보내기 방법을 활용하려면 데이터 세트에 대해 실시간 고객 프로필을 활성화해야 합니다.

다음 세그먼트 내보내기 세그먼트 평가 안내서의 섹션에서 대상 데이터 세트를 내보내는 데 필요한 단계를 다룹니다. 안내서에서는 다음 예를 간략하게 설명하고 제공합니다.

  • 타겟 데이터 세트 만들기: 대상 구성원을 보유할 데이터 세트를 만듭니다.
  • 데이터 집합에서 대상 프로필을 생성합니다. 세그먼트 작업 결과를 기반으로 데이터 세트를 XDM 개별 프로필로 채웁니다.
  • 내보내기 진행 모니터링: 내보내기 프로세스의 현재 진행 상태를 확인합니다.
  • 대상 데이터 읽기: 대상자의 구성원을 나타내는 결과 XDM 개별 프로필을 검색합니다.

다음 단계

이 문서에서는 Customer AI 점수를 다운로드하는 데 필요한 단계에 대해 간략하게 설명합니다. 이제 다른 항목을 계속 탐색할 수 있습니다 Intelligent Services 안내도 있습니다

이 페이지에서는