프로필 데이터 보내기
개발자는 고객이 Einstein에 구매자 프로필 특성을 보내는 방법으로 실시간 활동 추적 및 대량 업로드와 같은 두 가지 방법을 설정할 수 있습니다. 두 가지 방법 중 하나 또는 둘 다를 사용하여 Einstein에 구매자 프로필 데이터를 보낼 수 있습니다.
Einstein에 데이터를 제출할 때는 다음에 주의해야 합니다.
- Salesforce는 권장되는 지정된 사용자 식별자 이외의 개인 식별 정보(PII)를 Einstein으로 전송하지 않을 것을 적극 권장합니다.
- 수집된 모든 데이터는 최대 1년 동안 내부에서 보관됩니다. 1년이 지나면 데이터 수명이 만료되고 모든 Einstein 데이터베이스에서 제거됩니다. 이 프로필 데이터를 계속 사용하려면 Einstein에 다시 보내야 합니다.
- Einstein이 기존 구매자 프로필 특성에 대한 최신 값을 수신하면 기존 값에 최신 값이 추가됩니다.
- Einstein은 제공된 모든 프로필 데이터를 사용합니다. 새 데이터는 기존 데이터와 동일하게 취급됩니다.
Salesforce는 고객이 수집한 과거 구매자 프로필 데이터를 업로드할 수 있는 안전한 대량 업로드 엔드포인트를 제공합니다.
대량 업로드 옵션은 다음에 사용하도록 제공됩니다.
- 추적하고 수집하는 모든 구매자 프로필 관련 데이터.
- Einstein이 추가된 구매자 개인화를 위해 사용하려는 신뢰할 수 있는 모든 타사 데이터.
데이터를 대량으로 업로드할 경우 Einstein 데이터에 많은 영향을 줄 수 있습니다. 이러한 이유 때문에 승인된 사용자만 많은 양의 데이터를 업로드하도록 허용하고 있습니다. 또한 각 upload API는 Account Manager에서 확보한 필수 승인 헤더(Bearer) 액세스 토큰을 전달해야 합니다.
참고: Account Manager 서버에서 부하를 줄이기 위해 현재 토큰이 만료될 때까지는 새 토큰을 생성하지 않도록 합니다. bulk upload API 호출에 대한 자세한 내용은 API 사양을 참조하십시오.
Einstein에서 사용할 데이터 대량 업로드를 준비하려면 다음 조건을 충족하는지 확인합니다.
- 대량 파일이 탭으로 구분된 값(TSV) 파일(gzip 형식으로 압축됨)입니다.
- TSV 파일 형식이 올바르고 UTF-8 문자 인코딩을 사용하여 저장됩니다.
- 파일의 mimetype이 gzip 애플리케이션에서 사용하도록 올바르게 설정됩니다.
- 헤더 행이
login_id
식별 필드,email_address
식별 필드 또는 둘 다를 포함해야 합니다. - 보내려는 모든 구매자 프로필 특성에 대해 열을 더 추가할 수 있습니다.
- 값이 문자열 또는 문자열 목록입니다. 문자열 목록인 경우 파이프(|) 구분자를 사용하여 값을 구분해야 합니다. 예를 들어,
orange|yellow
와 같습니다. - 빈 열은 무시됩니다. Einstein이 빈 열을 발견하면 해당 열을 건너뛰고 나머지 사용자 특성 데이터를 계속 처리합니다.
각 구매자에 대한 관련 제품 추천을 생성하는 데 도움을 주기 위해 대량 업로드에서 구매자를 식별하도록 Profile Connector API에는 이러한 사용자 식별자가 필요합니다.
필드 | 설명 |
---|---|
login_id | 구매자의 로그인 ID입니다. 때때로 email_address 값과 같습니다. |
email_address | 구매자의 전체 이메일 주소입니다. 예를 들어, shopper1@somewhere.com과 같습니다. |
다음은 임의의 열 이름을 사용한 TSV 데이터를 포함하는 구매자 프로필 대량 업로드 예시입니다.
login_id | email_address | gender | colors | brand_list |
---|---|---|---|---|
shopper1 | shopper1@somewhere.com | male | orange|yellow | brandA|brandB |
shopper2 | shopper2@somewhere.com | female | blue|black | brandD |
shopper3 | shopper3@somewhere.com | female | red|black|violet | brandB|brandE |
구매자 프로필 대량 업로드를 수행할 때는 다음과 같은 엔드포인트 제한 사항에 주의해야 합니다.
- 한 번에 1개의 파일만 업로드할 수 있습니다. 그러나 여러 개의 파일을 순차적으로 업로드할 수는 있습니다.
- 허용되는 최대 파일 크기는 2GB입니다.
구매자 프로필 대량 데이터 파일을 준비한 후에 각 개별 파일을 gzip으로 압축하고 Einstein의 구매자 프로필 대량 업로드 엔드포인트에 업로드합니다. 자세한 내용은 대량 프로필 전송 엔드포인트를 참조하십시오.
활동 updateProfile 추적 엔드포인트를 사용하여 실시간 구매자 프로필 데이터 업데이트 및 기본 설정을 호출하고 보냅니다. 구매자가 스토어프런트에서 실시간으로 제공하는 정보를 캡처하여 추천 제품에서 이러한 변경 사항을 즉시 반영할 수 있습니다.
실시간 활동 추적 옵션은 다음에 사용하도록 제공됩니다.
- 구매자 기본 설정 활동 실시간 캡처.
- 구매자 프로필 실시간 업데이트.
각 구매자에 대한 관련 제품 추천을 생성하는 데 도움을 주기 위해 실시간 추적에서 구매자를 식별하도록 Profile Connector API는 2개의 사용자 식별자를 제공합니다.
cookieId
(필수) - 익명 구매자의 고유한 식별자입니다. 일반적으로 cookieId는 퍼스트 파티 쿠키의 값입니다.- 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록
cqcid
쿠키 값을 전달합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오. - OCAPI 또는 Salesforce Commerce API를 사용하는 경우에는 자동 활동과 일치하도록 게스트 로그인 응답에서
visit_id
값을 사용합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.
- 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록
userId
(권장) - 로그인한 구매자의 고유한 식별자입니다. 이 매개변수를 사용하면 Einstein이 여러 기기에서 로그인한 동일한 사용자를 링크할 수 있습니다.- 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록
cquid
쿠키 값을 사용합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오. - OCAPI 또는 Salesforce Commerce API를 사용하는 경우에는 자동 활동과 일치하도록 등록된 로그인 응답에서
hashed_login
값을 사용합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.
- 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록
잠재적으로 악의적인 활동을 피하기 위해 사용자 식별자 매개변수는 순차적으로 정렬되지 않아야 합니다. 매개변수에는 시퀀스, 패턴, IP 주소, 이메일 주소, 이름 또는 특정 사람과 연관시킬 수 있는 기타 정보가 포함되어서는 안 됩니다. 모든 사용자 식별자 매개변수는 해싱 또는 기타 메서드를 통해 GDPR(General Data Protection Regulation)을 준수해야 합니다.