프로필 데이터 보내기

개발자는 고객이 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_idemail_addressgendercolorsbrand_list
shopper1shopper1@somewhere.commaleorange|yellowbrandA|brandB
shopper2shopper2@somewhere.comfemaleblue|blackbrandD
shopper3shopper3@somewhere.comfemalered|black|violetbrandB|brandE

구매자 프로필 대량 업로드를 수행할 때는 다음과 같은 엔드포인트 제한 사항에 주의해야 합니다.

  • 한 번에 1개의 파일만 업로드할 수 있습니다. 그러나 여러 개의 파일을 순차적으로 업로드할 수는 있습니다.
  • 허용되는 최대 파일 크기는 2GB입니다.

구매자 프로필 대량 데이터 파일을 준비한 후에 각 개별 파일을 gzip으로 압축하고 Einstein의 구매자 프로필 대량 업로드 엔드포인트에 업로드합니다. 자세한 내용은 대량 프로필 전송 엔드포인트를 참조하십시오.

활동 updateProfile 추적 엔드포인트를 사용하여 실시간 구매자 프로필 데이터 업데이트 및 기본 설정을 호출하고 보냅니다. 구매자가 스토어프런트에서 실시간으로 제공하는 정보를 캡처하여 추천 제품에서 이러한 변경 사항을 즉시 반영할 수 있습니다.

실시간 활동 추적 옵션은 다음에 사용하도록 제공됩니다.

  • 구매자 기본 설정 활동 실시간 캡처.
  • 구매자 프로필 실시간 업데이트.

각 구매자에 대한 관련 제품 추천을 생성하는 데 도움을 주기 위해 실시간 추적에서 구매자를 식별하도록 Profile Connector API는 2개의 사용자 식별자를 제공합니다.

  • cookieId(필수) - 익명 구매자의 고유한 식별자입니다. 일반적으로 cookieId는 퍼스트 파티 쿠키의 값입니다.
    • 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록 cqcid 쿠키 값을 전달합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오.
    • OCAPI 또는 Salesforce Commerce API를 사용하는 경우에는 자동 활동과 일치하도록 게스트 로그인 응답에서 visit_id 값을 사용합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.
  • userId(권장) - 로그인한 구매자의 고유한 식별자입니다. 이 매개변수를 사용하면 Einstein이 여러 기기에서 로그인한 동일한 사용자를 링크할 수 있습니다.
    • 기존 Commerce Cloud 스토어프런트에서 API 요청을 제출할 때 기존 스토어프런트에서 자동 활동 추적과 일치하도록 cquid 쿠키 값을 사용합니다. 자세한 내용은 브라우저 기반 로컬 데이터 저장을 참조하십시오.
    • OCAPI 또는 Salesforce Commerce API를 사용하는 경우에는 자동 활동과 일치하도록 등록된 로그인 응답에서 hashed_login 값을 사용합니다. 자세한 내용은 OCAPI 고객 문서를 참조하십시오.

잠재적으로 악의적인 활동을 피하기 위해 사용자 식별자 매개변수는 순차적으로 정렬되지 않아야 합니다. 매개변수에는 시퀀스, 패턴, IP 주소, 이메일 주소, 이름 또는 특정 사람과 연관시킬 수 있는 기타 정보가 포함되어서는 안 됩니다. 모든 사용자 식별자 매개변수는 해싱 또는 기타 메서드를 통해 GDPR(General Data Protection Regulation)을 준수해야 합니다.