프로필 데이터 보내기

개발자는 고객이 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에는 이러한 사용자 식별자가 필요합니다.

다음은 임의의 열 이름을 사용한 TSV 데이터를 포함하는 구매자 프로필 대량 업로드 예시입니다.

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

• 한 번에 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 고객 문서를 참조하십시오.